WeAct 2.9″ E-Paper — чёрно-белый 128 × 296

WeAct Studio · WeActStudio EpaperModule 2.9″, BW, SSD1680, 128 × 296

Информационная строка, домашняя метеопанель или экран автономного датчика.

Автор: SLDV LAB

Опубликовано · Обновлено

СложностьСредне
Проекты с компонентом

О МОДУЛЕ

Что делает WeActStudio EpaperModule 2.9″, BW, SSD1680, 128 × 296

Карточка относится к чёрно-белому WeAct 2.9″ на SSD1680, для которого производитель приводит пример с GxEPD2_290_BS. Информационная строка, домашняя метеопанель или экран автономного датчика. Электрофоретическая панель отражает внешний свет и сохраняет изображение без постоянной перерисовки; подсветки у неё нет.

Помимо чёрно-белого исполнения есть чёрно-бело-красное и четырёхцветное. У четырёхцветного 2,9″ другая матрица: 168 × 384 и JD79667, поэтому размер и драйвер нельзя брать из этого примера. Подтверждайте цветность, разрешение и маркировку своей партии до выбора класса GxEPD2. Название класса библиотеки описывает совместимый профиль и не означает, что плата произведена Waveshare или Good Display.

Полное обновление сопровождается заметным миганием. Это экран для редко меняющихся данных, не для анимации. Частичные обновления могут оставлять следы; используйте их только для подтверждённой панели с периодическим полным очищением. После вывода переводите панель в сон; стекло и шлейф требуют осторожного обращения.

WeAct Studio EpaperModule 2,9″, чёрно-белая панель. Сохранены реальные надписи экрана, шлейф и язычок защитной плёнки. Пример соединений относится к ESP32-DevKitC V4 с WROOM-32E, питание и сигналы3,3В.

Источник фотографии: https://www.rcscomponents.kiev.ua/product/dysplei-chornylnyi-2-9-e-paper-chornyi-bilyi-weact-studio_198647.html . Оригиналы: https://www.rcscomponents.kiev.ua/img/dch2-9e-paperbwweactstudio-1.jpg . Исходный фон удалён; выполнены равномерное масштабирование и размещение на фоне. Отверстие под язычком плёнки не дорисовывалось. Схема соединений SLDV LAB составлена по первичной документации: https://github.com/WeActStudio/WeActStudio.EpaperModule/blob/master/Hardware/WeAct-EpaperModule-2.13_2.9%20SchDoc.pdf . Разрешение на повторное использование фотографии не установлено; открытая лицензия не заявляется.

Характеристики

Диагональ
2.9 дюйм
Видимое разрешение
128 × 296
Контроллер выбранного BW-варианта
SSD1680
Цветность
Чёрный / белый
Интерфейс
4-wire SPI + BUSY
Подсветка
Отсутствует
Питание модуля
В примере VDD модуля и логические сигналы: 3,3 В от ESP32-DevKitC V4. Входы SPI/RES/D/C не допускают 5-В логику; наличие регулятора на иной ревизии не делает сигналы 5-В совместимыми.

ПРАКТИКА

Подключение

Контакт модуляКонтакт платыНазначение
VDD3V3Плата ESP32 питается через USB; перед подключением проверить маркировку питания и ревизию WeAct
GNDGNDОбщая земля
SCLGPIO18Это SCK последовательного SPI, не I²C SCL
SDAGPIO23Это MOSI последовательного SPI, не I²C SDA
CSGPIO27ESP32-DevKitC V4 с ESP32-WROOM-32E; для WROVER/S3/C3 распиновку выбирать заново
D/CGPIO17ESP32-DevKitC V4 с ESP32-WROOM-32E; для WROVER/S3/C3 распиновку выбирать заново
RESGPIO16ESP32-DevKitC V4 с ESP32-WROOM-32E; для WROVER/S3/C3 распиновку выбирать заново
BUSYGPIO4Вход контроллера; обратный сигнал готовности панели

Подходит для ESP32, Arduino. Выберите контакты по документации своей платы.

ВАШ ПРОЕКТ · ВАШ ДАТЧИК

Интегрируйте модуль с ChatGPT

Скопируйте запрос в ChatGPT. Укажите свою плату и среду разработки — получите подключение и код для своего проекта.

Помоги интегрировать WeAct 2.9″ E-Paper. Сначала уточни точную модель контроллера, среду разработки, цветность, разрешение, маркировку панели и желаемую частоту обновления. Эта карточка описывает только BW 128 × 296 на SSD1680, рекомендованный производителем класс GxEPD2_290_BS, GxEPD2 1.6.9. Дай безопасное питание и 3,3-В сигналы, согласованные GPIO, зависимости и полный пример с полным обновлением, контролем BUSY и переходом в сон. Не подменяй WeAct модулем Waveshare и не выбирай драйвер только по диагонали. Объясни мигание, Busy Timeout, остаточные следы и ограничения частичного обновления.

Библиотеки

Установите библиотеку для своей среды и откройте пример из её документации.

Что именно прописать

Библиотека
GxEPD2 1.6.9

Установить вместе с Adafruit GFX и её зависимостями.

Цветовой класс
GxEPD2_BW

Только чёрно-белая панель. Для 3/4 цветов нужны другие классы и буферы.

Класс панели
GxEPD2_290_BS

Выбор по официальному примеру WeAct для этого BW-размера; сравнить с реальной партией.

SPI
SPI.begin(18, -1, 23, 27);

ESP32-DevKitC V4 WROOM-32E: SCK18, MOSI23, CS27; чтение MISO не используется.

Сброс и диагностика
display.init(115200, true, 50, false, SPI, SPISettings(4000000, MSBFIRST, SPI_MODE0));

Диагностика Serial115200; полный начальный цикл; reset50мс как в примере WeAct; SPI4МГц выбран для короткого макетного подключения.

После обновления
display.hibernate();

Отключает активную работу панели; перед следующим использованием может понадобиться повторный reset/init.

ESP32-DevKitC V4: тестовая табличка и сон панели

cpp
#include <SPI.h>
#include <GxEPD2_BW.h>
#include <Fonts/FreeMonoBold9pt7b.h>

constexpr int EPD_CS = 27;
constexpr int EPD_DC = 17;
constexpr int EPD_RST = 16;
constexpr int EPD_BUSY = 4;
GxEPD2_BW<GxEPD2_290_BS, GxEPD2_290_BS::HEIGHT> display(
  GxEPD2_290_BS(EPD_CS, EPD_DC, EPD_RST, EPD_BUSY));

void setup() {
  Serial.begin(115200);
  SPI.begin(18, -1, 23, EPD_CS); // SCK, no MISO, MOSI, CS
  display.init(115200, true, 50, false, SPI,
               SPISettings(4000000, MSBFIRST, SPI_MODE0));
  display.setRotation(1);
  display.setFont(&FreeMonoBold9pt7b);
  display.setTextColor(GxEPD_BLACK);
  display.setFullWindow();
  display.firstPage();
  do {
    display.fillScreen(GxEPD_WHITE);
    display.drawRect(0, 0, display.width(), display.height(), GxEPD_BLACK);
    display.setCursor(12, 28);
    display.print("SLDV LAB");
    display.setCursor(12, 56);
    display.print("WeAct 2.9 BW");
    display.setCursor(12, 84);
    display.print("Full refresh test");
  } while (display.nextPage());

  if (digitalRead(EPD_BUSY) == HIGH) {
    Serial.println("Panel still busy: check power, driver, BUSY and RST");
    while (true) { delay(1000); }
  }
  display.hibernate();
  Serial.println("Sequence ended; verify the image visually");
}
void loop() {
  delay(1000); // no repeated refresh; image remains visible
}

Полный скетч для ESP32-DevKitC V4 с ESP32-WROOM-32E, Arduino-ESP32 3.3.0 и GxEPD2 1.6.9. Класс GxEPD2_290_BS сверён с официальным примером WeAct и API библиотеки; аппаратный тест не выполнялся. GxEPD2 ограничивает ожидание BUSY и печатает Busy Timeout, но не возвращает универсальный код результата обновления. Если появился timeout, остановите обновления и проверьте питание, BUSY/RES и точную панель. Даже низкий BUSY не доказывает наличие изображения: проверьте его визуально. Питание и распиновка относятся к выбранному исполнению; частичный режим намеренно не используется при первом запуске.

Проекты с этим компонентом

Все проекты

Связанные проекты пока не опубликованы.

Связанные материалы и компоненты