WeAct Studio Epaper Module 1.54″ 4C
WeAct Studio · Epaper Module 1.54 inch 4C
Показывает статичные изображения четырьмя цветами.
Автор: SLDV LAB
Опубликовано · Обновлено
О МОДУЛЕ
Что делает Epaper Module 1.54 inch 4C
WeAct Studio Epaper Module 1.54″ 4C — четырёхцветный дисплей на электронных чернилах для автономных табличек, ценников и редко обновляемой информации. Белый, чёрный, красный и жёлтый — отдельные цвета палитры; обозначение 4C не означает четыре уровня серого. Экран отражает окружающий свет и сохраняет изображение после отключения питания.
В репозитории WeAct это исполнение подтверждено datasheet GDEM0154F51H и отдельным выбором модели в официальном Arduino-примере. На чертеже панели указан JD79660AA, а в комментарии примера — семейство JD79660. Отдельный чертёж или фотография готовой платы именно 1.54″ 4C в репозитории не приведены, поэтому размеры обычной WeAct 1.54″ здесь не выданы за размеры этого исполнения.
Пример питания готового модуля от 3.3 В опубликован автором Camera with Digital Film на Strange Inventions Lab: в составе его сборки названы шесть WeAct 1.54″ Black/White/Red/Yellow. Это независимый первичный отчёт о применении, а не электрическая спецификация производителя. Распиновка ESP32 в этой карточке по-прежнему взята из официального примера WeAct.
Обновление сопровождается изменением экрана и занимает заметно больше времени, чем у LCD. Цветовой режим и таблица сигналов обновления должны соответствовать установленной панели. Возможность частичного обновления определяет конкретный драйвер; пример WeAct проверяет его флаги. Не переносите быстрые режимы чёрно-белых панелей на цветное исполнение. После вывода статичного кадра контроллер переводят в сон; постоянная анимация для такого применения не подходит. В проверенной GxEPD2 1.6.9 у этого 4C-драйвера hasFastPartialUpdate=false; быстрый полный цикл и быстрое частичное обновление — разные возможности.
Паспорт панели задаёт рабочую температуру 0…40 °C. Для длительного использования Good Display рекомендует освежать изображение не реже одного раза в сутки и хранить панель с белым экраном. Типовые времена и электрические параметры datasheet относятся к панели и предусмотренной для неё форме сигналов, а не к измеренному потреблению всей платы WeAct.
Источники изображений
Реальная фотография WeAct 1.54″ 4C взята из карточки HU Turing Lab Hardware Shop. Оригинал 313×202 px: сохранены его пропорции, надписи и цвета, недостающие детали не дорисовывались. Иллюстрация подключения показывает имена сигналов и GPIO классической ESP32, а не физическую нумерацию или расположение контактов PCB; подписи своего разъёма нужно сверить до включения.
Характеристики
- Диагональ панели
- 1.54 дюйм
- Разрешение панели
- 200×200 пикс.
- Цвета
- Чёрный, белый, красный, жёлтый
- Контроллер по datasheet панели
- JD79660AA
- Панель в документации WeAct
- GDEM0154F51H
- Интерфейс модуля
- 4-проводный SPI, отдельные D/C, RES и BUSY
- Уровни GPIO
- 3.3 В
- Активная область панели
- 27.00×27.00 мм
- Габариты самой панели, не платы
- 31.80×37.32×1.00 мм
- Температура панели
- 0…40 °C
- Обновление по datasheet панели
- 20 с (полное) / 12 с (быстрое), при 23 °C; данные панели, не результат испытания WeAct
- Питание модуля
- В примере подключения используется стабилизированное питание 3.3 В на VCC. Основание: автор проекта Camera with Digital Film на Strange Inventions Lab описывает WeAct 1.54″ Black/White/Red/Yellow и указывает питание модулей 3.3 В. Это опубликованный опыт автора сборки, не спецификация допустимого входного диапазона WeAct. Полный диапазон входного питания именно этой платы не подтверждён. Сигналы SPI и управления — 3.3 В. Перед включением сверьте обозначения VCC и GND на своём модуле; расположение контактов нельзя определять по похожей плате. Не подавайте 5 В на модуль или GPIO. Диапазон 2.3–3.6 В в datasheet относится к самой панели.
ПРАКТИКА
Подключение
| Контакт модуля | Контакт платы | Назначение |
|---|---|---|
| VCC / VDD | 3V3 — питание 3.3 В в примере | 3.3 В опубликованы автором Camera with Digital Film (Strange Inventions Lab) для WeAct 1.54″ B/W/R/Y. Это пример применения, не полный допустимый диапазон производителя. До подключения сверить маркировку VCC/GND на своей плате; 5 В не подавать. |
| GND | GND | Общая земля дисплея и классической ESP32 DevKit с модулем ESP32-WROOM-32. Сверить обозначение GND на самом модуле; таблица задаёт имена сигналов, не физические номера или позиции контактов. |
| SCL / SCK | GPIO18 | Тактовая линия SPI, не I²C. |
| SDA / DIN / MOSI | GPIO23 | Данные SPI от ESP32 к дисплею, не I²C. MISO в этом подключении не используется. |
| CS | GPIO5 | CS_PIN в официальном ESP32-примере. |
| D/C | GPIO17 | DC_PIN=17. Вводный комментарий оригинала перепутан; здесь использовано фактическое значение #define. |
| RES / RST | GPIO16 | RES_PIN=16. На некоторых ESP32 с PSRAM эти выводы заняты; данная разводка не универсальна. |
| BUSY | GPIO4 | Вход ESP32 от дисплея. Полярность готовности задаёт выбранный драйвер; не переносить её между BWR и 4C. |
Подходит для ESP32, Arduino. Выберите контакты по документации своей платы.
ВАШ ПРОЕКТ · ВАШ ДАТЧИК
Интегрируйте модуль с ChatGPT
Скопируйте запрос в ChatGPT. Укажите свою плату и среду разработки — получите подключение и код для своего проекта.
Помоги интегрировать именно WeAct Studio Epaper Module 1.54″ 4C, панель GDEM0154F51H, в мой проект. Сначала уточни точную плату-управляющий контроллер, ревизию и фото модуля, среду разработки, питание и назначение устройства. Цвета: чёрный, белый, красный, жёлтый. В качестве подтверждённого профиля WeAct используй GxEPD2_154c_GDEM0154F51H с GxEPD2_4C.h; исходный пример зафиксирован на commit a7bf2574b413938a0cf1de163961a0d6ee824754. Для классической ESP32 в нём задано SCK18, MOSI23, CS5, BUSY4, RES16, D/C17. Вводный комментарий перепутал RES/DC: приоритет у #define. Не переносить GPIO на ESP32-C3/S3 или плату с PSRAM. Разделяй входное питание платы, питание панели и логику 3.3 В. Для этого примера используй питание модуля 3.3 В по опубликованному опыту автора Camera with Digital Film (Strange Inventions Lab); полный допустимый диапазон производителя не подтверждён. Перед включением проверь обозначения VCC/GND на конкретной плате. Не назначай физические номера и позиции контактов по аналогии с другой версией. Не подавать 5 В на модуль или GPIO. GPIO из Raspberry Pi-проекта не переносить в приведённую схему ESP32. Начни с проверенных исходников GxEPD2 1.6.9, Adafruit GFX 1.12.6 и BusIO 1.17.4; это не аппаратно испытанная связка. Укажи выбранную версию Arduino core отдельно. Оставь ровно одно объявление display и инициализацию display.init(115200,true,50,false). Дай схему для моей платы и минимальный пример, учитывающий BUSY, время полного обновления и сон. Не обещай частичное обновление или серую палитру без подтверждения конкретным драйвером. Объясни диагностику белого экрана, неверных цветов и зависания BUSY, затем порядок проверки на реальном устройстве. Отдельно укажи, что подтверждено исходниками, что скомпилировано и что действительно проверено на оборудовании.
Библиотеки
Установите библиотеку для своей среды и откройте пример из её документации.
Что именно прописать
- Исходный пример и ревизия
EpaperModuleTest_Arduino_ESP32.ino @ a7bf2574b413938a0cf1de163961a0d6ee824754Аудит исходного текста. Версию установленной GxEPD2 и Arduino-ESP32 нужно зафиксировать отдельно; компиляция здесь не выполнялась.
- Среда подключения
Arduino; классическая ESP32 / ESP32-WROOM-32Разводка: SCK18, MOSI23, CS5, BUSY4, RES16, D/C17. Не переносить на ESP32-C3/S3 или платы с занятыми GPIO16/17.
- Питание в примере подключения
3.3 ВОпубликованный пример автора Camera with Digital Film, Strange Inventions Lab, для WeAct 1.54″ B/W/R/Y; не полный диапазон производителя. До включения сверить VCC/GND на плате; 5 В не подавать.
- Библиотеки
GxEPD2 1.6.9; Adafruit GFX Library 1.12.6; Adafruit BusIO 1.17.4Классы и API GxEPD2 проверены по commit de82887e77a78528ea386e68bba2cb0291d2c319. Версии GFX и BusIO подтверждены их метаданными; это аудит исходников, не испытанная сборка. SPI.h предоставляет Arduino core выбранной платы.
- Заголовок цветового класса
#include <GxEPD2_4C.h>Выбирается по цветовому исполнению панели.
- Драйвер в примере WeAct
GxEPD2_154c_GDEM0154F51HРаскомментировать только одно объявление display. Имя драйвера не заменяет проверку маркировки панели.
- Контейнер и буфер
GxEPD2_4C<GxEPD2_154c_GDEM0154F51H, GxEPD2_154c_GDEM0154F51H::HEIGHT>Объявление с полным буфером высоты взято из выбора модели в оригинальном примере.
- Инициализация WeAct
display.init(115200,true,50,false);Строка из setup() официального ESP32-скетча; сигнатура сверена с GxEPD2 1.6.9. 50 — длительность импульса сброса в этом вызове API. Оставить остальные части оригинала.
- После завершения вывода
display.hibernate();Сохранить в конце setup() официального демонстрационного скетча. Сон не равнозначен отключению питания платы.
Выбор точного цветового профиля в официальном ESP32-примере
cpp#define ENABLE_GxEPD2_GFX 0
#include <GxEPD2_4C.h>
#include <Fonts/FreeMonoBold9pt7b.h>
#define CS_PIN (5)
#define BUSY_PIN (4)
#define RES_PIN (16)
#define DC_PIN (17)
GxEPD2_4C<GxEPD2_154c_GDEM0154F51H, GxEPD2_154c_GDEM0154F51H::HEIGHT>
display(GxEPD2_154c_GDEM0154F51H(CS_PIN, DC_PIN, RES_PIN, BUSY_PIN));Это фрагмент выбора модели для полного официального ESP32-скетча, не самостоятельная программа. Вставить вместо блока выбора display; сохранить setup(), loop(), helloWorld() и остальные функции оригинала. Удалены только противоречивые комментарии возле GPIO, значения макросов сохранены. Компиляция, прошивка и аппаратные испытания не выполнялись. Для других Arduino-примеров WeAct нельзя просто раскомментировать 4C: у C3/S3/ESP8266 в этой ревизии отсутствует подключение GxEPD2_4C.h. API, конструктор и наличие класса сверены с GxEPD2 1.6.9.
Проекты с этим компонентом
Все проектыСвязанные проекты пока не опубликованы.
