Placa de desenvolvimento ESP32-C3 com mini display OLED midi de 0.42 polegadas

Manual do produto: ESP32-C3 Development Board com OLED de 0.42"

Esta placa IoT compacta é baseada no chip ESP32-C3 (RISC-V) e dispõe de um ecrã OLED integrado de 0.42 polegadas. Como o pinout e o controlo do ecrã diferem dos módulos ESP32 padrão, encontrará abaixo as instruções específicas para utilizar a placa corretamente.

1. Especificações importantes de hardware

• Chip: ESP32-C3FN4 (4MB Flash, WiFi & Bluetooth 5.0).
• USB: USB nativo (USB-C). Atenção: ative "USB CDC On Boot" no Arduino IDE para suporte ao Serial Monitor.
• Ecrã OLED: 0.42 polegadas (resolução efetiva 72x40 pixels).
• Formato: Muito compacto (aprox. 20x25mm).

2. Pinout & Ligações (Atenção!)

A documentação online é muitas vezes confusa. Use as atribuições de pinos abaixo para esta placa específica (estilo ABRobot):

• OLED I2C SDA: GPIO 5 (Não 8, como muitas vezes indicado nos esquemas).
• OLED I2C SCL: GPIO 6 (Não 9).
• LED integrado: GPIO 8 (Active LOW: LOW = ligado, HIGH = desligado).
• Botão Boot: GPIO 9.
• Serial de hardware (UART0): TX = GPIO 21, RX = GPIO 20.

3. Definições do Arduino IDE

Para programar esta placa, selecione as seguintes definições no Arduino IDE:

• Board: ESP32C3 Dev Module
• USB CDC On Boot: Enabled (Essencial para poder ver Serial.print).
• Flash Mode: DIO (padrão).

4. Controlar o Ecrã OLED (Crucial)

O ecrã usa um controlador SSD1306, mas tem uma resolução física de apenas 72x40 pixels. No entanto, a buffer interna é 128x64. Deve aplicar um "offset" (deslocamento) para tornar o texto visível.

Biblioteca necessária: Instale a biblioteca U8g2 (de olikraus) através do Arduino Library Manager.

Exemplo de código:

#include 
#include 

// Inicialização para ESP32-C3 com I2C nos pinos 5 (SDA) e 6 (SCL)
// Usamos o driver padrão 128x64, mas apenas uma parte do ecrã.
U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, U8X8_PIN_NONE, 6, 5);

// Definições para o ecrã de 0.42 polegadas
int width = 72;
int height = 40;

// Os offsets são necessários para centrar a saída na buffer 128x64
int xOffset = 30; // 30 funciona melhor na prática
int yOffset = 12; // (64 - 40) / 2 = 12

void setup(void) {
  delay(1000); // Pequena pausa para estabilidade
  
  u8g2.begin();
  u8g2.setContrast(255);      // Brilho máximo
  u8g2.setBusClock(400000);   // Velocidade I2C de 400kHz
  u8g2.setFont(u8g2_font_ncenB10_tr); // Escolha uma fonte legível
}

void loop(void) {
  u8g2.clearBuffer(); // Limpar buffer interno
  
  // Desenhar uma moldura para testar a área visível
  u8g2.drawFrame(xOffset, yOffset, width, height);
  
  // Desenhar texto (tenha em conta xOffset e yOffset!)
  u8g2.setCursor(xOffset + 5, yOffset + 25); 
  u8g2.print("ESP32-C3");
  
  u8g2.sendBuffer(); // Enviar dados para o ecrã
  delay(1000);
}

5. Verificar Pinos Extra (LED Blink)

Quer testar os restantes pinos? Use este loop simples. Atenção: o pino 8 também controla o LED integrado.

// GPIO 8 é o LED integrado (LOW = LIGADO)
#define LED_PIN 8 

void setup() {
  pinMode(LED_PIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_PIN, LOW);  // LED Ligado
  delay(500);
  digitalWrite(LED_PIN, HIGH); // LED Desligado
  delay(500);
}