Компоненты · 8 мин чтения

TFT LCD шилд 2,4″ для Arduino: MCUFRIEND_kbv, сенсорный экран и SD

TFT LCD шилд 2,4″ на Arduino: установка MCUFRIEND_kbv, чтение ID драйвера, белый экран, калибровка сенсора, кнопки, BMP-картинки с SD и пины.

TFT LCD шилд 2,4″ для Arduino — это цветной сенсорный экран 240×320 пикселей, который надевается прямо на Arduino Uno. Ни проводов, ни пайки: сажаешь шилд на разъёмы Uno или Mega, ставишь нужную библиотеку — и через несколько минут на экране уже цветной текст, фигуры, сенсорные кнопки и картинки с SD-карты. Стоит он недорого, поэтому попадается в бесчисленных стартовых наборах и школьных проектах; по той же причине вопрос «почему у меня экран просто белый?» — один из самых частых в интернете.

В этом руководстве разберёмся, почему шилд иногда показывает белый экран и как это исправляет библиотека MCUFRIEND_kbv. Мы узнаем ID драйвера, откалибруем сенсорную панель, починим сенсор, который работает наоборот, будем управлять светодиодом с экранных кнопок и выведем картинки с карты microSD. Ещё поговорим о том, какие пины занимает шилд, какие остаются свободными и на что обратить внимание с Mega, ESP32 и Pico.

Плата Arduino Uno
TFT-шилд 2,4″ надевается на эту плату сверху и занимает почти все её пины; свободными остаются только A5, D0–D1 и, если не использовать SD-карту, D10–D13.

Что такое TFT-шилд 2,4″ и как он работает?

Шилд состоит из трёх частей: цветной TFT-панели, наклеенного поверх неё резистивного сенсорного слоя и слота для карты microSD на обратной стороне. Дисплей подключён не по последовательной шине вроде SPI, а по 8-битной параллельной шине; за раз передаётся целый байт, поэтому на Uno он рисует быстрее SPI-модулей, но занимает много пинов. Микросхема драйвера панели работает от 3,3 V; благодаря стабилизатору на 3,3 V и преобразователю уровней типа 74HC245 на плате сигналы 5 V от Uno для неё безопасны.

ПараметрЗначение
ДисплейTFT 2,4 дюйма, 240×320 пикселей
Цвет16 бит (RGB565), 65 536 цветов
Интерфейс8-битный параллельный (D0–D7) + 5 управляющих линий
Микросхема драйвераБывает разной: ILI9341, ILI9325, ST7781, SPFD5408, HX8347 и другие
Сенсор4-проводной резистивный, делит пины с дисплеем
Слот SDmicroSD по SPI (D10–D13)
Питание5 V (стабилизатор на 3,3 V на плате)
ТокОколо 80–120 mA, в основном на подсветку
Совместимые платыArduino Uno, Arduino Mega 2560

Шилд или SPI-модуль?

В продаже есть два разных изделия одного размера, и оба называют «TFT 2,4″». Шилд — это параллельная модель: надеваешь на Uno — и можно работать. У SPI-модуля один ряд штырьков вдоль края, и подключается он перемычками; его сенсорную панель обычно читают по SPI через чип XPT2046. Это руководство посвящено шилду; о SPI-модуле читай в нашем руководстве по TFT-дисплею ILI9341.

Модуль TFT-дисплея ILI9341 с интерфейсом SPI
Родственник шилда: SPI-модуль подключается перемычками через одну гребёнку пинов и гораздо лучше ладит с ESP32 и Pico.
ПараметрШилд 2,4″ для UnoSPI-модуль 2,4″
ПодключениеНадевается на Uno или Mega, без проводовОт 7 до 14 перемычек
Занятые пиныD2–D9, A0–A4 (с SD ещё D10–D13)5 для дисплея, 8–9 с сенсором и SD
Скорость отрисовки на UnoВысокая (параллельная шина)Ниже (SPI)
БиблиотекаMCUFRIEND_kbvAdafruit_ILI9341, TFT_eSPI
Чтение сенсораАналоговое, пины общие с дисплеемЧип XPT2046 по SPI
ESP32 и PicoНе подходитПодходит
Свободные пины для датчиковПочти нетМного

Таблица пинов: какие пины занимает шилд?

Пин шилдаПин Arduino UnoНазначение
LCD_RDA0Строб чтения
LCD_WRA1Строб записи (может быть общим с сенсором)
LCD_RS (CD)A2Команда или данные? (общий с сенсором)
LCD_CSA3Выбор чипа дисплея (может быть общим с сенсором)
LCD_RSTA4Сброс дисплея
LCD_D0, LCD_D1D8, D9Первые два бита шины данных
LCD_D2–LCD_D7D2–D7Остальные шесть битов шины данных
SD_SS / SD_DI / SD_DO / SD_SCKD10 / D11 / D12 / D13Карта microSD (SPI)
5V, 3V3, GND5V, 3.3V, GNDПитание
С надетым шилдом у Uno почти не остаётся пинов для датчиков. A4 занят линией сброса дисплея, поэтому шина I2C на A4/A5 недоступна, и добавить датчик или дисплей с I2C не получится. Что остаётся: A5 (на большинстве шилдов никуда не подключён), D0–D1, которые общие с загрузкой по USB, и D10–D13, если не использовать SD-карту. Если нужно больше датчиков, надень шилд на Arduino Mega или перейди на SPI-модуль.

Установка библиотеки MCUFRIEND_kbv

  1. Открой в Arduino IDE «Менеджер библиотек», найди MCUFRIEND_kbv и установи её.
  2. Там же установи Adafruit GFX Library: из неё берутся функции для текста, линий, окружностей и кнопок.
  3. Для сенсора установи библиотеку Adafruit TouchScreen (в коде она подключается как TouchScreen.h).
  4. Для SD-карты ничего устанавливать не нужно: библиотека SD идёт в комплекте с Arduino IDE.

Почему именно MCUFRIEND_kbv? Эти шилды могут выглядеть одинаково, но внутри у них разные микросхемы драйвера: два шилда, купленные у одного продавца с разницей в два месяца, могут оказаться один на ILI9341, а другой на ST7781. Старые библиотеки вроде Adafruit_TFTLCD или SPFD5408 знают лишь несколько чипов; если чип не тот, дисплей так и не инициализируется, и получается знаменитый белый экран. MCUFRIEND_kbv сначала запрашивает у чипа его ID, а затем отправляет команды инициализации, подходящие именно этому чипу.

Узнаём ID драйвера: readID()

Первым делом спросим у шилда, кто он такой. Код ниже выводит ID в монитор порта и на экран, а затем рисует три цветных прямоугольника. В мониторе порта выставь скорость 9600 бод.

C++ (Arduino IDE)
1#include <Adafruit_GFX.h>
2#include <MCUFRIEND_kbv.h>
3
4MCUFRIEND_kbv tft;
5
6void setup() {
7  Serial.begin(9600);
8  uint16_t id = tft.readID();                 // sürücü kimliğini oku / read the driver ID
9  Serial.print(F("TFT ID = 0x"));
10  Serial.println(id, HEX);
11  if (id == 0xD3D3) id = 0x9341;              // salt yazılır shield: kimliği elle ver / write-only shield: set the ID by hand
12  tft.begin(id);
13  tft.setRotation(1);                         // yatay, 320x240 / landscape, 320x240
14  tft.fillScreen(0x0000);                     // siyah / black
15  tft.setTextColor(0xFFFF);                   // beyaz / white
16  tft.setTextSize(3);
17  tft.setCursor(20, 20);
18  tft.print(F("BlueGrays"));
19  tft.setTextSize(2);
20  tft.setCursor(20, 70);
21  tft.print(F("ID: 0x"));
22  tft.print(id, HEX);
23  tft.fillRect(20, 120, 80, 60, 0xF800);      // kırmızı / red
24  tft.fillRect(120, 120, 80, 60, 0x07E0);     // yeşil / green
25  tft.fillRect(220, 120, 80, 60, 0x001F);     // mavi / blue
26}
27
28void loop() {
29}
Прочитанный IDЧипЧто делать
0x9341ILI9341Самая распространённая модель; работает сразу
0x9325 / 0x9328ILI9325 / ILI9328Старый, но надёжный; работает сразу
0x7783ST7781Работает сразу
0x5408SPFD5408Работает сразу; старая библиотека SPFD5408 не нужна
0x4747 / 0x9595HX8347-D / HX8347-IРаботает сразу
0x1505 / 0x0154R61505 / S6D0154Работает сразу
0xD3D3Шилд без подключённой линии чтенияВпиши ID в код вручную; на 2,4″ сначала попробуй 0x9341
0x0000 или 0xFFFFНет ответаШилд надет не до конца, погнут пин или плата неисправна

Если прямоугольники идут в порядке красный, зелёный, синий, всё хорошо. Если вместо красного виден синий, скорее всего, ID задан вручную и на дисплей ушли не те команды инициализации; используй значение, которое нашла readID. Если цвета похожи на негатив, добавь после begin строку tft.invertDisplay(true). Если ID какой-то странный, пример библиотеки «Файл › Примеры › MCUFRIEND_kbv › LCD_ID_readreg» выводит все регистры чипа, и этот вывод — самый быстрый способ понять, в чём дело. А пример graphictest_kbv проверяет все функции дисплея за один раз.

Белый экран и другие проблемы с дисплеем

Белый экран — это на самом деле подсказка: подсветка получает питание, но микросхема драйвера так и не была инициализирована. Когда панель не получает команд, её пиксели пропускают свет, и весь экран выглядит белым. Пройди по таблице сверху вниз:

СимптомВероятная причинаРешение
Белый экран со старой библиотекойБиблиотека не знает твой чипУстанови MCUFRIEND_kbv и запускай дисплей через readID
Белый экран, ID 0x0000 или 0xFFFFШилд надет не до конца или погнут пинСними шилд, выпрями пины и надави, чтобы он сел до упора
Белый экран, ID 0xD3D3Линии чтения нет, поэтому ID не читаетсяЗадай ID вручную, например tft.begin(0x9341); если не помогло, попробуй 0x9325 и 0x7783
Цвета как на негативе (белый выглядит чёрным)У чипа другая настройка инверсииtft.invertDisplay(true) после begin
Красный и синий поменялись местамиЗаданный вручную ID не соответствует чипуИспользуй ID, который находит readID, и обнови библиотеку до последней версии
Зеркальный текстЗаданный вручную ID не соответствует панелиПолучи ID через readID; проверь все четыре ориентации примером aspect_kbv
Изображение рассыпается при касанииПосле чтения сенсора общие пины остались входамиПосле getPoint верни YP и XM в режим OUTPUT
На Uno работает, на Mega белый экранБиблиотека не знает распиновку MegaMCUFRIEND_kbv поддерживает Mega; удали старую библиотеку

Калибровка сенсорной панели

Резистивная сенсорная панель состоит из двух тонких резистивных слоёв с крошечным зазором между ними. При нажатии слои соприкасаются; библиотека подаёт напряжение на один слой и аналоговым входом читает напряжение на другом — так получаются координаты X и Y. Эти показания — сырые числа, примерно от 100 до 900, и у каждой панели они свои, поэтому, чтобы превратить их в пиксели, нужна калибровка. К тому же сенсорная панель делит пины с дисплеем, а какие именно четыре пина идут к сенсорному слою, зависит от шилда.

  1. Открой пример TouchScreen_Calibr_native из меню «Файл › Примеры › MCUFRIEND_kbv» и загрузи его.
  2. Открой монитор порта на скорости 9600 бод; сначала пример сам определит пины сенсора.
  3. По очереди нажимай на крестики, которые появляются на экране, и держи палец или стилус на каждом, пока не сменится текст.
  4. Когда всё закончится, в мониторе порта под заголовком «COPY-PASTE» появятся две строки: const int XP=...,XM=...,YP=...,YM=... и const int TS_LEFT=...,TS_RT=...,TS_TOP=...,TS_BOT=....
  5. Вставь эти две строки вместо значений-примеров в начале скетчей ниже.
C++ (Arduino IDE)
1#include <Adafruit_GFX.h>
2#include <MCUFRIEND_kbv.h>
3#include <TouchScreen.h>
4
5MCUFRIEND_kbv tft;
6
7// Kalibrasyon örneğinin çıktısını buraya yapıştır / paste the calibration sketch output here
8const int XP = 6, XM = A2, YP = A1, YM = 7;
9const int TS_LEFT = 907, TS_RT = 136, TS_TOP = 942, TS_BOT = 139;
10
11TouchScreen ts = TouchScreen(XP, YP, XM, YM, 300);   // 300 ohm X plakası / 300 ohm X plate
12const int MINPRESSURE = 200;
13const int MAXPRESSURE = 1000;
14
15bool readTouch(int &x, int &y) {
16  TSPoint p = ts.getPoint();
17  pinMode(YP, OUTPUT);                 // ortak pinleri ekrana geri ver / give the shared pins back to the display
18  pinMode(XM, OUTPUT);
19  digitalWrite(YP, HIGH);
20  digitalWrite(XM, HIGH);
21  if (p.z < MINPRESSURE || p.z > MAXPRESSURE) return false;
22  x = map(p.x, TS_LEFT, TS_RT, 0, tft.width());    // dikey yön için / for portrait
23  y = map(p.y, TS_TOP, TS_BOT, 0, tft.height());
24  return true;
25}
26
27void setup() {
28  tft.begin(tft.readID());
29  tft.setRotation(0);                  // dikey, kalibrasyonla aynı / portrait, same as calibration
30  tft.fillScreen(0x0000);
31  tft.fillRect(0, 0, 240, 30, 0x001F);
32  tft.setTextColor(0xFFFF);
33  tft.setTextSize(2);
34  tft.setCursor(10, 8);
35  tft.print(F("Ciz / Draw"));
36}
37
38void loop() {
39  int x, y;
40  if (readTouch(x, y)) {
41    if (y < 30) tft.fillRect(0, 30, 240, 290, 0x0000);   // başlığa dokun: temizle / tap the header: clear
42    else tft.fillCircle(x, y, 3, 0xFFE0);                 // sarı nokta / yellow dot
43  }
44}

Эта маленькая рисовалка — лучший способ проверить калибровку: точка должна появляться почти точно под пальцем. p.z — это сила нажатия; если она не попадает между MINPRESSURE и MAXPRESSURE, касание не засчитывается, и это отсеивает лёгкие задевания и электрические помехи. Строки pinMode внутри readTouch() критически важны: во время чтения библиотека TouchScreen превращает общие пины в аналоговые входы и такими их и оставляет; без этих строк последующие команды рисования до дисплея не дойдут, и изображение рассыплется. Совет: резистивная панель реагирует на нажим, поэтому ногтем или стилусом рисовать точнее, чем подушечкой пальца.

СимптомПричинаРешение
Касаешься справа, а точка появляется слеваОсь X перевёрнутаПоменяй местами значения TS_LEFT и TS_RT
Касаешься сверху, а точка появляется снизуОсь Y перевёрнутаПоменяй местами значения TS_TOP и TS_BOT
В альбомной ориентации X и Y перепутаныsetRotation(1) повернула осиДля x бери p.y, а для y — p.x, либо оставайся в книжной ориентации
Касание вообще не определяетсяXP, XM, YP, YM заданы неверноЗапусти пример калибровки ещё раз и возьми пины, которые он покажет
Точки появляются без касанияПорог нажатия слишком низкийПодними MINPRESSURE до 300–400
Точки смещены на несколько пикселейКалибровка сделана наспехОткалибруй заново, дольше удерживая нажатие точно в центре каждого крестика

Интерфейс с сенсорными кнопками

Класс Adafruit_GFX_Button из библиотеки Adafruit GFX рисует кнопки с рамкой и подписью в несколько строк кода и сам определяет, попало ли касание по кнопке. Код ниже двумя кнопками включает и выключает светодиод на A5; мы выбрали A5, потому что с надетым шилдом это практически единственный свободный пин Uno. Не забудь подключить светодиод через резистор 220 Ω.

C++ (Arduino IDE)
1#include <Adafruit_GFX.h>
2#include <MCUFRIEND_kbv.h>
3#include <TouchScreen.h>
4
5MCUFRIEND_kbv tft;
6const int XP = 6, XM = A2, YP = A1, YM = 7;                       // kendi değerlerin / your own values
7const int TS_LEFT = 907, TS_RT = 136, TS_TOP = 942, TS_BOT = 139;
8TouchScreen ts = TouchScreen(XP, YP, XM, YM, 300);
9
10const int LED_PIN = A5;               // shield'in boş bıraktığı pin / the pin the shield leaves unused
11Adafruit_GFX_Button onBtn, offBtn;
12char onLabel[] = "ON";
13char offLabel[] = "OFF";
14
15bool readTouch(int &x, int &y) {
16  TSPoint p = ts.getPoint();
17  pinMode(YP, OUTPUT);
18  pinMode(XM, OUTPUT);
19  digitalWrite(YP, HIGH);
20  digitalWrite(XM, HIGH);
21  if (p.z < 200 || p.z > 1000) return false;
22  x = map(p.x, TS_LEFT, TS_RT, 0, tft.width());
23  y = map(p.y, TS_TOP, TS_BOT, 0, tft.height());
24  return true;
25}
26
27void showState(bool on) {
28  tft.fillRect(20, 40, 200, 60, on ? 0x07E0 : 0x7BEF);  // yeşil ya da gri / green or grey
29  tft.setTextColor(0x0000);
30  tft.setTextSize(3);
31  tft.setCursor(50, 58);
32  tft.print(on ? F("LED ON") : F("LED OFF"));
33}
34
35void setup() {
36  pinMode(LED_PIN, OUTPUT);
37  tft.begin(tft.readID());
38  tft.setRotation(0);
39  tft.fillScreen(0x0000);
40  // merkez x, merkez y, genişlik, yükseklik, çerçeve, dolgu, yazı rengi, etiket, yazı boyu
41  // center x, center y, width, height, outline, fill, text colour, label, text size
42  onBtn.initButton(&tft, 120, 170, 160, 60, 0xFFFF, 0x07E0, 0x0000, onLabel, 3);
43  offBtn.initButton(&tft, 120, 260, 160, 60, 0xFFFF, 0xF800, 0xFFFF, offLabel, 3);
44  onBtn.drawButton();
45  offBtn.drawButton();
46  showState(false);
47}
48
49void loop() {
50  int x = 0, y = 0;
51  bool down = readTouch(x, y);
52  onBtn.press(down && onBtn.contains(x, y));
53  offBtn.press(down && offBtn.contains(x, y));
54  if (onBtn.justPressed()) {
55    onBtn.drawButton(true);             // basılı görünüm / pressed look
56    digitalWrite(LED_PIN, HIGH);
57    showState(true);
58  }
59  if (offBtn.justPressed()) {
60    offBtn.drawButton(true);
61    digitalWrite(LED_PIN, LOW);
62    showState(false);
63  }
64  if (onBtn.justReleased()) onBtn.drawButton();
65  if (offBtn.justReleased()) offBtn.drawButton();
66  delay(20);
67}

press() на каждом проходе записывает, нажата ли кнопка в данный момент; justPressed() возвращает true только на первом проходе, когда кнопка нажата, а justReleased() — только на том проходе, когда её отпустили. Благодаря этому светодиод не получает одну и ту же команду снова и снова, пока палец лежит на кнопке, а экран не перерисовывается впустую. drawButton(true) инвертирует цвета кнопки, чтобы она выглядела нажатой. Подключи к A5 вместо светодиода модуль реле — и можно включать лампу с сенсорного экрана; о безопасном подключении читай в нашем руководстве по модулю реле.

Выводим картинки с SD-карты

Слот microSD на обратной стороне — самый простой способ вывести на экран полноцветные картинки. На компьютере приведи изображение к размеру 240×320 (книжная ориентация) и сохрани его как 24-битный BMP: в Paint выбери «24-разрядный рисунок», в GIMP при экспорте отметь вариант «24 бита». Имя файла должно быть не длиннее 8 символов (например, CAT.BMP), потому что библиотека SD работает с короткими именами, а «KEDI.BMP» в коде замени на имя своего файла. Отформатируй карту в FAT32 или FAT16; карты больше 32 ГБ обычно идут с exFAT и не распознаются.

C++ (Arduino IDE)
1#include <SPI.h>
2#include <SD.h>
3#include <Adafruit_GFX.h>
4#include <MCUFRIEND_kbv.h>
5
6MCUFRIEND_kbv tft;
7const int SD_CS = 10;                 // shield üzerindeki SD seçme pini / SD chip select on the shield
8const byte CHUNK = 20;                // tek seferde okunan piksel / pixels read per step (az RAM / low RAM)
9
10uint16_t read16(File &f) { uint16_t v; f.read((uint8_t *)&v, 2); return v; }
11uint32_t read32(File &f) { uint32_t v; f.read((uint8_t *)&v, 4); return v; }
12
13bool drawBMP(const char *name, int x, int y) {
14  File bmp = SD.open(name);
15  if (!bmp) return false;
16  if (read16(bmp) != 0x4D42) { bmp.close(); return false; }   // "BM" imzası / "BM" signature
17  read32(bmp); read32(bmp);                                   // dosya boyutu, ayrılmış / file size, reserved
18  uint32_t offset = read32(bmp);                              // piksel verisinin başı / start of pixel data
19  read32(bmp);                                                // başlık boyutu / header size
20  int32_t w = read32(bmp);
21  int32_t h = read32(bmp);
22  if (read16(bmp) != 1 || read16(bmp) != 24 || read32(bmp) != 0) {  // 1 düzlem, 24 bit, sıkıştırmasız / 1 plane, 24-bit, uncompressed
23    bmp.close();
24    return false;
25  }
26  bool bottomUp = true;                                       // BMP satırları alttan üste / BMP rows are bottom-up
27  if (h < 0) { h = -h; bottomUp = false; }
28  uint32_t rowSize = (w * 3 + 3) & ~3UL;                      // satır 4 bayta tamamlanır / rows padded to 4 bytes
29  uint8_t raw[CHUNK * 3];
30  uint16_t px[CHUNK];
31  for (int32_t row = 0; row < h; row++) {
32    bmp.seek(offset + (bottomUp ? (h - 1 - row) : row) * rowSize);
33    tft.setAddrWindow(x, y + row, x + w - 1, y + row);        // tek satırlık pencere / one-row window
34    bool first = true;
35    for (int32_t col = 0; col < w; col += CHUNK) {
36      int n = (w - col < CHUNK) ? (w - col) : CHUNK;
37      bmp.read(raw, n * 3);
38      for (int i = 0; i < n; i++) {
39        px[i] = tft.color565(raw[i * 3 + 2], raw[i * 3 + 1], raw[i * 3]);   // BGR -> RGB565
40      }
41      tft.pushColors(px, n, first);
42      first = false;
43    }
44  }
45  tft.setAddrWindow(0, 0, tft.width() - 1, tft.height() - 1); // pencereyi sıfırla / reset the window
46  bmp.close();
47  return true;
48}
49
50void setup() {
51  Serial.begin(9600);
52  tft.begin(tft.readID());
53  tft.setRotation(0);                                         // dikey, 240x320 / portrait, 240x320
54  tft.fillScreen(0x0000);
55  if (!SD.begin(SD_CS)) {
56    Serial.println(F("SD kart yok / no SD card"));
57    return;
58  }
59  if (!drawBMP("KEDI.BMP", 0, 0)) {
60    Serial.println(F("BMP okunamadi / BMP not readable"));
61  }
62}
63
64void loop() {
65}

В файле BMP строки хранятся снизу вверх, и каждая дополняется до длины, кратной 4 байтам; код учитывает обе детали с помощью расчёта rowSize и флага bottomUp. Каждый пиксель занимает 3 байта в порядке синий, зелёный, красный, а color565() превращает его в 16-битный цвет, понятный дисплею. У Uno всего 2 КБ RAM, и 512 байт из них библиотека SD держит под свой буфер, поэтому пиксели мы читаем по 20 штук. На Uno картинка во весь экран рисуется строка за строкой за несколько секунд. О форматировании карты и работе с файлами читай в нашем руководстве по модулю SD-карты.

Работа с Arduino Mega

На разъёмы Mega шилд садится в том же положении, а раз MCUFRIEND_kbv распознаёт Mega, код дисплея и сенсора работает без изменений. Главный выигрыш — пины: свободными остаются D22–D53, A5–A15, три дополнительных последовательных порта и шина I2C на D20–D21, так что Mega — самый удобный выбор для больших проектов с датчиками и дисплеем. Единственная проблема — слот SD: на шилде SD-карта разведена на D10–D13, а аппаратный SPI у Mega находится на D50–D53, поэтому SD.begin() завершается ошибкой. Решение — библиотека SdFat с программным SPI на D10–D13; именно это показывает пример showBMP_not_Uno из MCUFRIEND_kbv. Все пины Mega описаны в нашем руководстве по распиновке Arduino Mega.

Можно ли использовать его с ESP32 или Raspberry Pi Pico?

Короткий ответ: не рекомендуется. Параллельному шилду нужны 13 пинов и разъём в формате Uno, рассчитанный на 5 V. На платах ESP32 в форм-факторе Uno (ESPDuino-32, D1 R32 и подобных) пины A2–A4 разъёма обычно идут на GPIO 34–36, которые работают только как входы; управлять линиями дисплея с них нельзя, да и сенсорная панель не находит подходящих пинов для аналоговых измерений. Некоторым удаётся запустить шилд, перекинув провода и включив параллельный режим в настройках TFT_eSPI, но возни с этим много. Для ESP32 и Pico куда разумнее взять SPI-модуль с тем же разрешением: он подключается четырьмя-пятью проводами и оставляет свободными большинство пинов. Подробности — в нашем руководстве по TFT-дисплею ILI9341, а вариант поменьше и почётче — в руководстве по TFT-дисплею ST7789.

Идеи проектов с TFT-шилдом 2,4″

  • Сенсорный калькулятор: нарисуй сетку кнопок 4×4 и выводи результат крупным шрифтом; логика та же, что в нашем руководстве «Калькулятор на Arduino».
  • Цифровая фоторамка: показывай BMP-файлы с SD-карты по очереди и переходи к следующему по касанию экрана.
  • Кодовый замок: нарисуй на экране цифровую клавиатуру и переключай реле на A5, когда введён верный код; логика клавиатуры — в руководстве по матричной клавиатуре.
  • Игры: Pong, «Змейка» или сенсорные крестики-нолики; идеи ищи в руководстве «Игры на Arduino».
  • График температуры: подключи DHT11 к Mega и показывай температуру за последний час в виде бегущего линейного графика.
  • Простой осциллограф: рисуй сигнал, считанный с A5, в виде осциллограммы; для медленных сигналов это увлекательный учебный инструмент.
Если экран мерцает, не стирай весь дисплей через fillScreen() на каждом проходе; очищай с помощью fillRect() только ту область, которая меняется, и перерисовывай её. Постоянный текст, обёрнутый в F(), экономит RAM. Чтобы фон под меняющимися числами очищался автоматически, используй форму setTextColor(text, background).

С подходящей библиотекой TFT-шилд 2,4″ запускается за считаные минуты, а его сенсорная панель даёт проектам настоящий пользовательский интерфейс. Если хочется начать с дисплея попроще, в приложении BlueGrays есть пошаговые проекты со схемами подключения и кодом: I2C LCD, бегущая строка на LCD 16x2, игры Pong и T-Rex на OLED и игра-раннер на LCD.

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

Почему TFT-шилд 2,4″ показывает белый экран?

Белый экран означает, что подсветка горит, а микросхема драйвера не инициализирована. Самая частая причина — библиотека не распознаёт чип твоего шилда. Чаще всего помогает такой порядок: установить MCUFRIEND_kbv, прочитать ID через tft.readID() и запустить дисплей через tft.begin(ID); если ID возвращается равным 0x0000, шилд надет неплотно.

Какую библиотеку использовать для TFT-шилда 2,4″?

Для дисплея — MCUFRIEND_kbv вместе с Adafruit GFX Library, для сенсора — Adafruit TouchScreen, а для карты — библиотеку SD, которая идёт с Arduino IDE. Старые библиотеки SPFD5408 и Adafruit_TFTLCD поддерживают лишь несколько чипов, поэтому на новых шилдах обычно дают белый экран.

Как узнать, какая микросхема драйвера стоит в TFT-дисплее?

Вызови tft.readID() из MCUFRIEND_kbv и выведи результат в монитор порта: 0x9341 означает ILI9341, 0x9325 — ILI9325, а 0x7783 — ST7781. Пример LCD_ID_readreg из библиотеки выводит все регистры чипа, если нужны подробности.

Работает ли TFT-шилд 2,4″ с Arduino Mega?

Да, шилд надевается и на Mega, и MCUFRIEND_kbv её поддерживает. Сразу не заработает только слот SD, потому что пины SPI у Mega находятся на D50–D53; для SD-карты понадобится библиотека SdFat с программным SPI. Зато появляется множество свободных пинов.

Как исправить перевёрнутый сенсор на TFT-шилде?

Сначала ещё раз запусти пример TouchScreen_Calibr_native и вставь в код значения, которые он выведет. Если перепутаны лево и право, поменяй местами TS_LEFT и TS_RT; если верх и низ — TS_TOP и TS_BOT. Если оси путаются в альбомной ориентации, для x бери p.y, а для y — p.x.

Какие пины остаются свободными с надетым TFT-шилдом?

На Uno остаются только A5, D0–D1 (общие с загрузкой по USB) и, если не использовать SD-карту, D10–D13. A4 занят линией сброса дисплея, поэтому I2C недоступен. Если нужно подключить больше датчиков, лучше подойдёт Arduino Mega или TFT-модуль с интерфейсом SPI.

Все проекты
LCD-экран с I2C
AR-32Новичок
Premium

LCD-экран с I2C

Дай своему Arduino собственный экран и заставь его написать первое сообщение. Двухстрочный LCD-экран подключается всего несколькими проводами; в верхней строке появляется приветствие, затем второе…

4.8(53)
70
Вывод сообщения на LCD-экран 2x16
AR-29Продвинутый
Premium

Вывод сообщения на LCD-экран 2x16

Твой первый шаг к выводу текста на экран. Двухстрочный LCD-экран сначала показывает сообщение ожидания, затем пишет приветствие в верхней строке и печатает слово по букве в нижней строке, как пишущая…

4.6(37)
51
Прыгающий текст на LCD
AR-30Продвинутый
Premium

Прыгающий текст на LCD

В верхней строке LCD-экрана слово BLUEGRAYS скользит от одного края к другому и отскакивает, как мяч от стены, снова и снова без конца.

4.5(29)
40
Игра в пинг-понг — SSD1306
AR-86Средний
Premium

Игра в пинг-понг — SSD1306

Мяч, две ракетки и ты: на маленьком OLED-экране ты играешь в настольный теннис — одну из самых первых видеоигр.

4.5(47)
65
OLED T-Rex Run: игра с динозавром на Arduino
AR-87Продвинутый
Premium

OLED T-Rex Run: игра с динозавром на Arduino

Игра с динозавром, которая появляется, когда пропадает интернет, теперь у тебя на столе: динозавр бежит по маленькому OLED-экрану, навстречу едут кактусы, а прыгаешь ты одной кнопкой.

4.7(33)
53
Игра-бегалка на LCD с Arduino
AR-96Средний
Premium

Игра-бегалка на LCD с Arduino

Бесконечная игра-бегалка с горизонтальной прокруткой на символьном LCD-экране 16x2. Герой бежит сам, а игрок перепрыгивает препятствия нажатием кнопки. Случайные препятствия появляются в верхней и нижней строке. Пассивный зуммер играет вступительную мелодию, звук прыжка, праздничный звук на 50 очков и мелодию конца игры. При запуске показывается заставка «BlueGrays - Arduino Projects». Счёт обновляется сразу в правом верхнем углу экрана.

4.6(32)
56
Калькулятор на Arduino с I2C
AR-94Средний
Premium

Калькулятор на Arduino с I2C

Калькулятор на Arduino, который выполняет сложение, вычитание, умножение и деление с помощью плёночной клавиатуры 4x4 и LCD-дисплея 16x2 с I2C. Благодаря I2C дисплей подключается всего 2 проводами, поэтому проводов меньше, а свободных пинов больше. Поддерживаются ввод дробных чисел и отрицательные числа.

5.0(31)
43
Кодовый замок с клавиатурой 4x4 и LCD
AR-64Продвинутый
Premium

Кодовый замок с клавиатурой 4x4 и LCD

Маленький электронный дверной замок, который не пускает тех, кто не знает кода. Ты нажимаешь клавишу решётки и вводишь код на клавиатуре; если он верный, экран сообщает, что доступ разрешён…

4.8(59)
75