
Постановка задачи.
Подключить ILI9341 к микроконтроллеру. Написать драйвер. Прочитать ID дисплея.
Научиться зажигать пиксели в разные цвета по координатам. Научиться отображать русский текст.
Аппаратная часть
Эксперименты я делал вот на этом модуле

Дисплей ILI9341 это весьма сложное иделие.

При внимательном рассмотрении можно увидеть, что внутри куча разных трансиверов, SRAM память, драйвер LCD панели. К слову, без подсветки дисплей полностью потухает.

Распиновка того красного ILI9341 модуля такая:
Пин | Номер на вилке | Комментарий | Активный | Возможные значения |
D/CX | 5 | Управление типом передачи | -- | 0-команда; 1-параметр |
VCC | 1 | Питание | hi | |
GND | 2 | Заземление | low | |
CS | 3 | Выбор чипа | low | |
RESET | 4 | Сброс чипа | low | |
MOSI | 6 | Вход данных экрану | -- | |
SCK | 7 | Тактирование | -- | |
LED | 8 | Подсветка | hi | |
MISO | 9 | выход данных от экрана | -- |
Самый простой способ подключения- это через SPI интерфейс с переключением команды и данных GPIO пином D/CX. В спецификации ILI9341 это именуется как 4-проводной 8-битный интерфейс.

Вот схема его подключения: 4-line Serial Interface II

Схема подключения Ili9341 к микроконтроллеру
Схему подключения Ili9341 к микроконтроллеру можно представить вот этой таблицей. Для подключения я выбрал SPI1.
Pin | Name | GPIO | Header 1 | Dir4MCU | Active | pull |
1 | VCC | -- | 1 | in | hi | none |
2 | GND | --- | 55 | in | low | none |
3 | CS | PA3 | 28 | out | low | up |
4 | RESET | PA4 | 27 | out | low | up |
5 | DC | PA2 | 25 | out | -- | up |
6 | MOSI | PA7 | 32 | out | -- | none |
7 | SCK | PA5 | 30 | out | -- | none |
8 | LED | PA1 | 26 | out | hi | none |
9 | MISO | PA6 | 29 | in | -- | none |
Интерфейс связи между микроконтроллером и ili9341
Согласно спецификации тактирование SPI должно быть менее 10MHz. Нужно активировать SPI Mode 0. Биты захватываются по положительному перепаду на тактировании. Биты передавать старшим битом вперед (MSB).

Временная диаграмма показана вот тут

Чтение байта

Чтение трех байт.

Чтение двойного слова

Программная часть
У данного драйвера 84 SPI команды. Они все перечислены в таблице 8.1. Command List.
8.1. Command List
+--------+------------+-----------------------------+------------------------------------------+
| Код | Название | Параметры | Назначение |
+--------+------------+-----------------------------+------------------------------------------+
| 00h | NOP | нет | Пустая команда (завершает RAMWR/RAMRD) |
| 01h | SWRESET | нет | Программный сброс |
| 04h | RDDIDIF | нет (чтение 24 бит) | Чтение идентификации дисплея |
| 09h | RDDST | нет (чтение 32 бит) | Чтение статуса дисплея |
| 0Ah | RDDPM | нет (чтение 8 бит) | Чтение режима питания |
| 0Bh | RDDMADCTL | нет (чтение 8 бит) | Чтение MADCTL |
| 0Ch | RDDCOLMOD | нет (чтение 8 бит) | Чтение формата пикселя |
| 0Dh | RDDIM | нет (чтение 8 бит) | Чтение режима изображения |
| 0Eh | RDDSM | нет (чтение 8 бит) | Чтение режима сигналов |
| 0Fh | RDDSDR | нет (чтение 8 бит) | Чтение результата самодиагностики |
| 10h | SLPIN | нет | Вход в спящий режим |
| 11h | SLPOUT | нет | Выход из спящего режима |
| 12h | PTLON | нет | Включение частичного режима |
| 13h | NORON | нет | Возврат в нормальный режим |
| 20h | DINVOFF | нет | Отключение инверсии |
| 21h | DINVON | нет | Включение инверсии |
| 26h | GAMSET | 1 байт (GC[2:0]) | Выбор гамма-кривой |
| 28h | DISPOFF | нет | Выключение дисплея |
| 29h | DISPON | нет | Включение дисплея |
| 2Ah | CASET | 4 байта (SC, EC) | Установка колонок (X) |
| 2Bh | PASET | 4 байта (SP, EP) | Установка страниц (Y) |
| 2Ch | RAMWR | N байт (данные) | Запись в память кадра |
| 2Dh | RGBSET | 128 байт (LUT) | LUT-таблица 16→18 бит |
| 2Eh | RAMRD | нет (чтение данных) | Чтение из памяти кадра |
| 30h | PLTAR | 4 байта (SR, ER) | Область частичного режима |
| 33h | VSCRDEF | 6 байт (TFA, VSA, BFA) | Определение вертикальной прокрутки |
| 34h | TEOFF | нет | Выключение TE-сигнала |
| 35h | TEON | 1 байт (M) | Включение TE-сигнала |
| 36h | MADCTL | 1 байт | Управление доступом к памяти |
| 37h | VSCRSADD | 2 байта (VSP) | Стартовый адрес прокрутки |
| 38h | IDMOFF | нет | Выключение Idle-режима |
| 39h | IDMON | нет | Включение Idle-режима |
| 3Ah | COLMOD | 1 байт (DPI, DBI) | Установка формата пикселя |
| 3Ch | WRMEMC | N байт (данные) | Продолжение записи в память |
| 3Eh | RDMEMC | нет (чтение данных) | Продолжение чтения из памяти |
| 44h | STEARS | 2 байта (STS) | Установка строки TE |
| 45h | GSCAN | нет (чтение 2 байт) | Чтение текущей строки сканирования |
| 51h | WRDISBV | 1 байт (DBV) | Запись яркости дисплея |
| 52h | RDDISBV | нет (чтение 1 байт) | Чтение яркости дисплея |
| 53h | WRCTRLD | 1 байт (BCTRL,DD,BL) | Управление подсветкой/яркостью |
| 54h | RDCTRLD | нет (чтение 1 байт) | Чтение управления подсветкой |
| 55h | WRCABC | 1 байт (C[1:0]) | Запись CABC |
| 56h | RDCABC | нет (чтение 1 байт) | Чтение CABC |
| 5Eh | WRCABCMB | 1 байт (CMB) | Мин. яркость CABC |
| 5Fh | RDCABCMB | нет (чтение 1 байт) | Чтение мин. яркости CABC |
| DAh | RDID1 | нет (чтение 1 байт) | Чтение ID1 |
| DBh | RDID2 | нет (чтение 1 байт) | Чтение ID2 |
| DCh | RDID3 | нет (чтение 1 байт) | Чтение ID3 |
+--------+------------+-----------------------------+------------------------------------------+
| B0h | IFMODE | 1 байт | Управление интерфейсом RGB |
| B1h | FRMCTR1 | 2 байта (DIVA, RTNA) | Частота кадров (Normal/Full) |
| B2h | FRMCTR2 | 2 байта (DIVB, RTNB) | Частота кадров (Idle/8 цветов) |
| B3h | FRMCTR3 | 2 байта (DIVC, RTNC) | Частота кадров (Partial/Full) |
| B4h | INVTR | 1 байт (NLA,NLB,NLC) | Управление инверсией |
| B5h | PRCTR | 4 байта (VFP,VBP,HFP,HBP) | Blanking Porch Control |
| B6h | DISCTRL | 4 байта (PTG,PT,REV,GS,SS, | Управление функциями дисплея |
| | | SM,ISC,NL,PCDIV) | |
| B7h | ETMOD | 1 байт (GON,DTE,GAS) | Entry Mode Set |
| B8h | BLCTRL1 | 1 байт (TH_UI) | Backlight Control 1 |
| B9h | BLCTRL2 | 2 байта (TH_MV,TH_ST) | Backlight Control 2 |
| BAh | BLCTRL3 | 1 байт (DTH_UI) | Backlight Control 3 |
| BBh | BLCTRL4 | 2 байта (DTH_MV,DTH_ST) | Backlight Control 4 |
| BCh | BLCTRL5 | 2 байта (DIM2,DIM1) | Backlight Control 5 |
| BEh | BLCTRL7 | 1 байт (PWM_DIV) | Backlight Control 7 |
| BFh | BLCTRL8 | 1 байт (LEDONR,LEDONPOL, | Backlight Control 8 |
| | | LEDPWMPOL) | |
| C0h | PWCTRL1 | 1 байт (VRH) | Power Control 1 |
| C1h | PWCTRL2 | 1 байт (BT) | Power Control 2 |
| C5h | VMCTRL1 | 2 байта (VMH,VML) | VCOM Control 1 |
| C7h | VMCTRL2 | 1 байт (nVM,VMF) | VCOM Control 2 |
| D0h | NVMWR | 2 байта (PGM_ADR,PGM_DATA) | Запись NV Memory |
| D1h | NVMPKEY | 3 байта (KEY) | Ключ защиты NV Memory |
| D2h | RDNVM | нет (чтение 3 байт) | Статус NV Memory |
| D3h | RDID4 | нет (чтение 4 байт) | Чтение ID4 (IC version) |
| E0h | PGAMCTRL | 15 байт | Positive Gamma Correction |
| E1h | NGAMCTRL | 15 байт | Negative Gamma Correction |
| E2h | DGAMCTRL1 | 16 байт (RCA/BCA) | Digital Gamma Control 1 |
| E3h | DGAMCTRL2 | 64 байта (RFA/BFA) | Digital Gamma Control 2 |
| F6h | IFCTL | 3 байта | Interface Control |
+--------+------------+-----------------------------+------------------------------------------+
| CBh | PWCTRLA | 5 байт | Power Control A (extend) |
| CFh | PWCTRLB | 3 байта | Power Control B (extend) |
| E8h | DTCA | 3 байта | Driver Timing Control A (extend) |
| E9h | DTCB | 3 байта | Driver Timing Control B (extend) |
| EAh | DTCB2 | 2 байта | Driver Timing Control B2 (extend) |
| EDh | POSCTRL | 4 байта | Power On Sequence Control (extend) |
| F2h | ENABLE3G | 1 байт (3G_enb) | Enable 3G (extend) |
| F7h | PUMPRATIO | 1 байт (Ratio) | Pump Ratio Control (extend) |
+--------+------------+-----------------------------+------------------------------------------+Для инициализации применяется вот этот массив комманд
/*
Команды драйвера ILI9341 (согласно таблице 8.1 Command List)
*/
typedef enum {
/* --- Основные команды (Level 1) --- */
ILI9341_CMD_NOP = 0x00, // No Operation (пустая команда)
ILI9341_CMD_SWRESET = 0x01, // Software Reset
...............
ILI9341_CMD_RDID3 = 0xDC, // Read ID3
ILI9341_CMD_RDID4 = 0xDD, // Read ID4 (часто используется для точной идентификации)
/* --- Коррекция гаммы --- */
ILI9341_CMD_GMCTRP1 = 0xE0, // 8.3.24. Positive Gamma Correction (E0h)
ILI9341_CMD_GMCTRN1 = 0xE1 // Negative Gamma Correction
} Ili9341Cmd_t;
static const Ili9341InitConfig_t Ili9341InitConfig[]={
{.command=ILI9341_CMD_POWER_CONTROL_A, .data= (const uint8_t[]) {0x39, 0x2C, 0x00, 0x34, 0x02}, .size=5, },
{.command=ILI9341_CMD_PWCTR_B, .data= (const uint8_t[]) {0x00, 0xC1, 0x30}, .size=3, },
{.command=ILI9341_CMD_DRIVER_TIMING_CONTROL_A, .data= (const uint8_t[]) {0x85, 0x00, 0x78}, .size=3, },
{.command=ILI9341_CMD_DRIVER_TIMING_CONTROL_B, .data= (const uint8_t[]) {0x00, 0x00}, .size=2, },
{.command=ILI9341_CMD_POWER_ON, .data= (const uint8_t[]) {0x64, 0x03, 0x12, 0x81}, .size=4, },
{.command=ILI9341_CMD_PUMP_RATIO_CONTROL, .data= (const uint8_t[]) {0x20}, .size=1, },
{.command=ILI9341_CMD_PWCTR1, .data= (const uint8_t[]) {0x23}, .size=1, },
{.command=ILI9341_CMD_PWCTR2, .data= (const uint8_t[]) {0x10}, .size=1, },
{.command=ILI9341_CMD_VMCTR1, .data= (const uint8_t[]) {0x3E, 0x28}, .size=2, },
{.command=ILI9341_CMD_VMCTR2, .data= (const uint8_t[]) {0x86}, .size=1, },
{.command=ILI9341_CMD_MADCTL, .data= (const uint8_t[]) {0x28}, .size=1, },
{.command=ILI9341_CMD_VSCRSADD, .data= (const uint8_t[]) {0x00}, .size=1, },
{.command=ILI9341_CMD_PIXFMT, .data= (const uint8_t[]) {0x55}, .size=1, },
{.command=ILI9341_CMD_FRMCTR1, .data= (const uint8_t[]) {0x00, 0x18}, .size=2, },
{.command=ILI9341_CMD_DFUNCTR, .data= (const uint8_t[]) {0x08, 0x82, 0x27}, .size=3, },
{.command=ILI9341_CMD_ENABLE_3G, .data= (const uint8_t[]) {0x00}, .size=1, },
{.command=ILI9341_CMD_GAMMASET, .data= (const uint8_t[]) {0x01}, .size=1, },
{.command=ILI9341_CMD_GMCTRP1, .data= (const uint8_t[]) {0x0F, 0x31, 0x2B, 0x0C, 0x0E, 0x08, 0x4E, 0xF1, 0x37, 0x07, 0x10, 0x03, 0x0E, 0x09, 0x00}, .size=15, },
{.command=ILI9341_CMD_GMCTRN1, .data= (const uint8_t[]) {0x00, 0x0E, 0x14, 0x03, 0x11, 0x07, 0x31, 0xC1, 0x48, 0x08, 0x0F, 0x0C, 0x31, 0x36, 0x0F}, .size=15, },
};Это в частности значит следующее:
--(0xB1) Frame Rate Control. Division Ratio = fosc (делитель равен 1, без деления). количество тактов на одну строку (Clocks per line) 24.
--Глубина цвета: 16 бит на пиксель (65 536 цветов, RGB 5-6-5).
--(0x36) Альбомная (горизонтальная) ориентация (320x240)
--(0x37) Cбрасывает стартовый адрес вертикальной прокрутки в 0, гарантируя, что после инициализации дисплей будет отображать изображение с самого начала видеопамяти, без смещения.
--(0x26) Применить кривую гаммы 1 (G2.2)
--(0xF2) Отключить управление 3 gamma. 3 Gamma Control — это функция точной цветовой калибровки, позволяющая раздельно корректировать гамму для R, G, B.
Гамма — это математическая зависимость между цифровым значением цвета (кодом, который вы записываете в память дисплея) и фактической яркостью свечения пикселя на экране.
Формат пикселя задается командой 0x3A. Тут есть всего два варианта: 16 бит на пиксель или 18 бит на пиксель. Я выбирал 16 бит на пиксель.

Данный дисплей в теории можно использовать как SPI RAM память, однако в данном красном модуле провод MISO не подключен к ILI9341 и можно только загружать данные в экран.
Запись пикселей
Печать символа на экране сводится к тому что надо прописать внутреннюю память дисплея. Делается это в неcколько этапов:
1) Прописать адрес начала по оси X (колонка) (0x2A)
2) Прописать адрес конца по оси X (колонка) (0x2A)

3) Прописать адрес начала по оси Y (страница) (0x2B)
4) Прописать адрес конца по оси Y(страница) (0x2B)

5) Прописать значения пикселей. Чтобы что-то появилось на экране надо записать в память экрана. Для этого есть команда Memory Write (0x2C).

Чтение пикселей
Вычитывать данные из памяти позволяет команда 0x2E.

В частности так в теории можно делать скриншот (фото экрана).

Шрифты
Существует множество утилит для рисования и генерации бинарных массивов под шрифты. Вот например утилита matrixFont позволяет генерировать шрифты. Сперва для генерации шрифтов можно прописать вот такие настройки:

Утилита генерирует Cи код для представления массива на букву. Можно отображать генератор прямиком в бинарное представление пиксельных строк.

Работа с UTF-8 кодировкой
Для работы с кириллическими символами нужна кодировка UTF-8. Как минимум функции вычисления длинны UTF-8 строки
uint32_t utf8_strlen(const char *s) {
uint32_t count = 0;
for (; *s; ++s) {
if ((*s & 0xC0) != 0x80){ // не continuation byte
++count;
}
LOG_DEBUG(STR_LG,"Cnt:%u,0x%02x=0b%s=[%c]",count, *s , utoa_bin8(*s),*s);
}
return count;
}
и извлечения начала символа по индексу.
char * utf8_str_get_i(const char * const str, const uint32_t index) {
/* Longest UTF-8 sequence: 4 bytes + terminating zero. */
char * result = NULL;
if (str) {
static char buf[8] = {0};
const uint8_t * p = (const uint8_t *)str;
uint32_t i = 0U;
uint32_t len = 0U;
uint32_t k = 0U;
bool found = false;
/* Skip `index` code points. */
while ((0U != p[0]) && (i < index)) {
if (0x00U == (0x80U & p[0])) {
p += 1;
} else if (0xC0U == (0xE0U & p[0])) {
p += 2;
} else if (0xE0U == (0xF0U & p[0])) {
p += 3;
} else if (0xF0U == (0xF8U & p[0])) {
p += 4;
} else {
p += 1;
}
i++;
}
/* Determine length of the code point at `p`. */
if (0U == p[0]) {
len = 0U;
} else if (0x00U == (0x80U & p[0])) {
len = 1U;
} else if (0xC0U == (0xE0U & p[0])) {
len = 2U;
} else if (0xE0U == (0xF0U & p[0])) {
len = 3U;
} else if (0xF0U == (0xF8U & p[0])) {
len = 4U;
} else {
len = 0U;
}
found = (i == index) && (0U != len);
if (found) {
for (k = 0U; k < len; k++) {
buf[k] = (char)p[k];
}
buf[len] = '\0';
result = buf;
}
}
return result;
}
Каждую русскую буквы можно хранить в виде обыкновенной Си строки. Просто такая строка из одного символа будет занимать длину два байта. Далее сравнивая не символы, а строки можно найти шрифт для каждой русской буквы.
#include "fonts_russian.h"
#include <string.h>
#include "macro_utils.h"
const FontLettetInfo_t FontLettetInfo[] = {
{ .index=0, .utf8="А", },
........
{ .index=65, .utf8="я", },
{ .index=67, .utf8="!", },
{ .index=78, .utf8=",", },
/*
А Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ъ Ы Ь Э Ю Я
а б в г д е ё ж з и й к л м н о п р с т у ф х ц ч ш щ ъ ы ь э ю я
*/
};
const FontLettetInfo_t* FontLetterToInfo(const char* const start){
FontLettetInfo_t* Node = NULL;
uint32_t cnt = ARRAY_SIZE(FontLettetInfo);
uint32_t i = 0;
for(i=0; i<cnt; i++) {
uint32_t len = strlen(FontLettetInfo[i].utf8);
int ret = strncmp(start, FontLettetInfo[i].utf8, len);
if(0==ret) {
Node = &FontLettetInfo[i];
break;
}
}
return Node;
}
static const uint16_t FontRus7x10[] = {
/* ============ ПРОПИСНЫЕ А..Я (0x0410..0x044F) ============ */
/* 'А' */ 0x1000, 0x2800, 0x2800, 0x2800, 0x2800, 0x7C00, 0x4400, 0x4400, 0x0000, 0x0000,
/* 'Б' */ 0x7E00, 0x4000, 0x4000, 0x7C00, 0x4200, 0x4200, 0x4200, 0x7C00, 0x0000, 0x0000,
/* 'В' */ 0x7C00, 0x4200, 0x4200, 0x7C00, 0x4200, 0x4200, 0x4200, 0x7C00, 0x0000, 0x0000,
....
/* 'ю' */ 0x0000, 0x0000, 0x4400, 0x4A00, 0x7A00, 0x4A00, 0x4A00, 0x4400, 0x0000, 0x0000,
/* 'я'65 */ 0x0000, 0x0000, 0x3E00, 0x4200, 0x3E00, 0x1200, 0x2200, 0x4200, 0x0000, 0x0000,
0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, //66 sp
0x1000, 0x1000, 0x1000, 0x1000, 0x1000, 0x1000, 0x0000, 0x1000, 0x0000, 0x0000, //67 !
0x2800, 0x2800, 0x2800, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, //68 "
0x2400, 0x2400, 0x7C00, 0x2400, 0x4800, 0x7C00, 0x4800, 0x4800, 0x0000, 0x0000, //69 #
.....
0x3800, 0x4400, 0x0400, 0x0800, 0x1000, 0x1000, 0x0000, 0x1000, 0x0000, 0x0000, //97 ?
0x3800, 0x4400, 0x4C00, 0x5400, 0x5C00, 0x4000, 0x4000, 0x3800, 0x0000, 0x0000, //98 @
0x1000, 0x2800, 0x2800, 0x2800, 0x2800, 0x7C00, 0x4400, 0x4400, 0x0000, 0x0000, //99 A
0x7800, 0x4400, 0x4400, 0x7800, 0x4400, 0x4400, 0x4400, 0x7800, 0x0000, 0x0000, //100 B
0x3800, 0x4400, 0x4000, 0x4000, 0x4000, 0x4000, 0x4400, 0x3800, 0x0000, 0x0000, //101 C
0x7000, 0x4800, 0x4400, 0x4400, 0x4400, 0x4400, 0x4800, 0x7000, 0x0000, 0x0000, // D
0x7C00, 0x4000, 0x4000, 0x7C00, 0x4000, 0x4000, 0x4000, 0x7C00, 0x0000, 0x0000, // E
0x7C00, 0x4000, 0x4000, 0x7800, 0x4000, 0x4000, 0x4000, 0x4000, 0x0000, 0x0000, // F
0x3800, 0x4400, 0x4000, 0x4000, 0x5C00, 0x4400, 0x4400, 0x3800, 0x0000, 0x0000, // G
......
0x0000, 0x0000, 0x0000, 0x7400, 0x4C00, 0x0000, 0x0000, 0x0000, 0x0000, 0x0000, // ~
};
FontDef FontRus_7x10 = {7,10,FontRus7x10};
Отладка
Я написал несколько модульных тестов. Один их них просто печатает алфавит. Как можно заметить буквы в самом деле отображаются.

Итоги
Удалось научиться отображать прямоугольные фигуры на экране дисплея ILI9341, печатать символы на разных шрифтах, отображать кириллический текст на экране ILI9341.
Этот текст лишь пояснительная записка к коду драйвера, который выложен на github. Все подробности можно проследить в сборке jl_32f4xx_ili9341_gcc_m
Источники
Название | URL |
2.8 Inch 240x320 2.8" SPI TFT LCD Touch Panel Serial Port Module ILI9341 / ST7789V SPI Serial Display With/Without Touch | |
Модульные тесты ILI9341 | https://github.com/aabzel/trunk/tree/main/source/unit_tests/test_set_hw/test_ili9341 |
Драйвер ILI9341 | https://github.com/aabzel/trunk/tree/main/source/asics/ili9341 |
Драйвер SPI | https://github.com/aabzel/trunk/tree/main/source/mcal/mcal_common/spi |
Тестировочная сборка jl_32f4xx_ili9341_gcc_m | https://github.com/aabzel/trunk/tree/main/source/projects/jl\_32f4xx\_ili9341\_gcc\_m |
Шрифты | https://github.com/aabzel/trunk/tree/main/source/third_party/storage/fonts |
STM32 - TFT дисплей часть первая | |
LCD Vision | https://radio-hobby.org/modules/tdmdownloads/singlefile.php?lid=107&ysclid=mw3jyrp4cx241107753 |
DisplayTFT-ILI9341 | https://michiel.vanderwulp.be/domotica/Modules/DisplayTFT-ILI9341/ |
STM32F4XX | |
Подключаем дисплей SPI LCD ILI9341 к одноплатному компьютеру Banana Pi BPI-M64 или любому другому на ОС Armbian | |
STM32 Nucleo. Подключаем TFT LCD на базе чипа ILI9341 |
Вопросы:
--Как аппаратный SPI на STM32 может выдать 9 бит данных (или 17 бит данных)?

--Как сделать скриншот изображения экрана ili9341?

Комментарии 0