ESP32-C3 разработъчна платка с мини 0.42 inch midi OLED дисплей

Ръководство за продукта: ESP32-C3 Development Board с 0.42" OLED

Тази компактна IoT платка е базирана на чипа ESP32-C3 (RISC-V) и разполага с интегриран 0.42 inch OLED екран. Тъй като pinout-ът и управлението на екрана се различават от стандартните ESP32 модули, по-долу ще намерите конкретните инструкции за правилното използване на платката.

1. Важни хардуерни спецификации

• Чип: ESP32-C3FN4 (4MB Flash, WiFi & Bluetooth 5.0).
• USB: Native USB (USB-C). Внимание: активирайте "USB CDC On Boot" в Arduino IDE за Serial Monitor support.
• OLED екран: 0.42 inch (ефективна резолюция 72x40 pixels).
• Формат: Много компактен (ок. 20x25mm).

2. Pinout & Свързвания (Внимание!)

Онлайн документацията често е объркваща. Използвайте следните pin-to-assignments за тази конкретна платка (ABRobot-style):

• OLED I2C SDA: GPIO 5 (Не 8, както често е посочено в схеми).
• OLED I2C SCL: GPIO 6 (Не 9).
• Onboard LED: GPIO 8 (Active LOW: LOW = включено, HIGH = изключено).
• Boot Button: GPIO 9.
• Hardware Serial (UART0): TX = GPIO 21, RX = GPIO 20.

3. Настройки в Arduino IDE

За да програмирате тази платка, изберете следните настройки в Arduino IDE:

• Board: ESP32C3 Dev Module
• USB CDC On Boot: Enabled (Съществено, за да можете да виждате Serial.print).
• Flash Mode: DIO (стандартно).

4. Управление на OLED екрана (Критично)

Екранът използва SSD1306 контролер, но има физическа резолюция само 72x40 pixels. Вътрешният буфер обаче е 128x64. Трябва да приложите "offset" (изместване), за да направите текста видим.

Необходима библиотека: Инсталирайте U8g2 library (от olikraus) чрез Arduino Library Manager.

Примерен код:

#include 
#include 

// Инициализация за ESP32-C3 с I2C на pin 5 (SDA) и 6 (SCL)
// Използваме стандартния 128x64 driver, но само част от екрана.
U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, U8X8_PIN_NONE, 6, 5);

// Настройки за 0.42 inch екрана
int width = 72;
int height = 40;

// Offset-ите са необходими, за да се центрира изходът в 128x64 буфера
int xOffset = 30; // 30 работи най-добре на практика
int yOffset = 12; // (64 - 40) / 2 = 12

void setup(void) {
  delay(1000); // Кратка пауза за стабилност
  
  u8g2.begin();
  u8g2.setContrast(255);      // Максимална яркост
  u8g2.setBusClock(400000);   // 400kHz I2C скорост
  u8g2.setFont(u8g2_font_ncenB10_tr); // Изберете четим font
}

void loop(void) {
  u8g2.clearBuffer(); // Изчисти вътрешния буфер
  
  // Начертайте рамка, за да тествате видимата област
  u8g2.drawFrame(xOffset, yOffset, width, height);
  
  // Начертайте текст (вземете предвид xOffset и yOffset!)
  u8g2.setCursor(xOffset + 5, yOffset + 25); 
  u8g2.print("ESP32-C3");
  
  u8g2.sendBuffer(); // Изпрати данните към екрана
  delay(1000);
}

5. Проверка на допълнителните пинове (LED Blink)

Искате да тествате останалите пинове? Използвайте този прост loop. Внимание: pin 8 управлява и onboard LED.

// GPIO 8 е Onboard LED (LOW = ВКЛ)
#define LED_PIN 8 

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

void loop() {
  digitalWrite(LED_PIN, LOW);  // LED Вкл
  delay(500);
  digitalWrite(LED_PIN, HIGH); // LED Изкл
  delay(500);
}