Перейти к содержимому
Display Engineer
Руководство

Круглый дисплей 1,28 дюйма с ESP32 (GC9A01): подключение, библиотеки и советы по круглому интерфейсу

Как управлять круглым TFT GC9A01 240×240 с ESP32: подключение по SPI, настройка TFT_eSPI / LovyanGFX / ESP-IDF, реальная частота кадров и правила компоновки для круглых экранов.

DEDisplay Engineer Applications Team · Инженеры по применению дисплеевПроверено инженером 11 окт. 2026 г.

Что такое круглый дисплей 1,28 дюйма

Большинство малых круглых TFT — это панель 240×240 пикселей, обрезанная по кругу, с контроллером GC9A01. Контроллер по-прежнему работает с квадратным кадровым буфером; просто в углах нет видимых пикселей. Этот формат используют носимые устройства, ручки, шкалы и контроллеры умного дома.

Подключение (4-проводный SPI)

Сигнал

Назначение

SCLK

Тактовая частота SPI

MOSI (SDA)

Данные SPI в панель

CS

Выбор микросхемы

DC

Выбор данные / команда

RST

Сброс (или на сброс MCU)

BL

Подсветка (ШИМ для регулировки)

MISO обычно не используется. Проверенную эталонную карту выводов смотрите на странице платы Waveshare ESP32-S3-Touch-LCD-1.28.

Библиотеки

Библиотека

Настройка

TFT_eSPI (Arduino)

#define GC9A01_DRIVER, 240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

компонент espressif/esp_lcd_gc9a01

LVGL

любая из перечисленных как flush-драйвер с частичными буферами отрисовки

На странице GC9A01 есть шаблоны конфигурации для скачивания.

Как быстро обновляется экран?

Полный кадр в RGB565 — 240 × 240 × 16 бит = 921 600 бит (112,5 КБ). Теоретический предел SPI — около 43 кадр/с при 40 МГц и 86 кадр/с при 80 МГц. Реальный интерфейс медленнее из-за накладных расходов на команды и времени отрисовки, поэтому LVGL обычно перерисовывает только изменённые области. На ESP32 80 МГц возможны только на выделенных выводах SPI; безопасное значение по умолчанию — 40 МГц.

Полный кадр помещается во внутреннюю RAM, но LVGL хорошо работает с двумя частичными буферами по 1/10 экрана (около 11 КБ), оставляя RAM приложению.

Дизайн для круга

  • Держите текст внутри вписанного квадрата. Наибольший квадрат, помещающийся в круг диаметром 240 пикселей, — около 170×170 пикселей; размещайте подписи и цифры в нём.
  • Используйте дуги и кольца для данных. Шкалы, кольца прогресса и радиальные меню используют край, который прямоугольники теряют.
  • Сенсор сообщает квадратные координаты. На круглых платах панель часто сочетается с контроллером сенсора CST816S; он возвращает x/y в квадрате 240×240, поэтому игнорируйте касания вне круга.
  • Сверьте видимую область с ободком. Что видит пользователь, определяет активная область панели, а не стекло.

Круглые дисплеи в нашем каталоге

Наши прямые фабрики выпускают круглые модули, включая IPS SPI модуль 1,28 дюйма 240×240, версию 1,3 дюйма 360×360 с ёмкостным сенсором и версию 2,1 дюйма 480×480. Смотрите все круглые LCD-дисплеи; контроллер уточняйте по даташиту, так как в других размерах он может отличаться от GC9A01. Образцы от 1 шт.

Частые вопросы

Какое разрешение у круглого дисплея 1,28 дюйма?

Обычно 240×240 пикселей с контроллером GC9A01; видимая область — круг, вписанный в этот квадрат.

Может ли ESP32 управлять GC9A01 на 60 кадр/с?

Полноэкранная перерисовка теоретически ограничена примерно 43 кадр/с при SPI 40 МГц. Частичные обновления, которые использует LVGL, позволяют получить плавную анимацию для типичных интерфейсов шкал и часов.

Какие выводы нужны дисплею GC9A01?

SCLK, MOSI, CS, DC, сброс и подсветка. MISO обычно не подключается.

Модули, упомянутые в руководстве

Не знаете, какой дисплей подойдёт вашему проекту?

Пришлите размер, интерфейс и хост-процессор. Инженер по дисплеям в течение 12 часов ответит с 2–3 вариантами, даташитами и кодом инициализации. Образцы от 1 шт.