ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

STM32F103 FSMC驱动ILI9486屏与XPT2046触摸

STM32F103 FSMC驱动ILI9486屏与XPT2046触摸

简介:这份资源面向正在学习 STM32 嵌入式开发的初学者与进阶者,提供基于 STM32F103 与 HAL 库驱动 3.5 寸 ILI9486 触摸屏的完整工程,解决了从零搭建显示与触摸交互时外设配置繁琐、驱动移植困难的问题。压缩包共 153 个文件、约 4.77MB,以 21 个 c 源文件与 51 个 h 头文件为核心,配套 Keil 工程文件(uvprojx、uvoptx、sct、axf、hex)、STM32CubeMX 配置(ioc、mxproject)以及编译中间产物,可直接烧录验证。工程将 ILI9486 初始化、分辨率与颜色模式设置、清屏、画点画线、字符与图像显示等功能封装为独立驱动文件,并保留 SPI 通信与 GPIO 控制接口;触摸部分配合 XPT2046 一类控制器,涉及 ADC 采样、坐标换算与中断处理。已有 1705 人学习,适合作为图形界面与人机交互设计的入门起点,也可在现有代码上二次开发菜单、波形或仪表盘界面。

1. 一块 480×320 的 ILI9486,为什么“能点亮”和“能用”是两回事

手上这套 STM32F103 驱动 3.5 寸 ILI9486 触摸屏的代码是 HAL 库版本,全量源码,编译过就能烧。先说清楚一件事:这块屏在 STM32F103 上,“亮起来”和“跑得动”是两个难度级别。480×320 分辨率、16 位色,一整帧就是 307200 字节,而 F103 里带 FSMC 的大容量型号 SRAM 也只有 64KB,全屏显存基本不用考虑。所以这份代码最有价值的地方不在点屏那一步,而在它把命令与数据切换、FSMC 时序参数、ILI9486 初始化序列、XPT2046 标定这几件最容易出问题的事都固定下来了。适合三类人:手上有 F103 板子和并口屏想验证硬件的人、要从零搭一套能跑界面的嵌入式显示工程的人、以及被花屏和触摸乱跳折腾过的单片机开发者。

2. 选型与接线:FSMC 决定这块屏在你手上能跑多快

2.1 同一块屏,SPI 版和并口版性能差一个量级

ILI9486 这个驱动 IC 同时有并口(8080/6800)和 SPI 两种接口形态,市面上 3.5 寸 480×320 的模块两种都有人做。很多人拿到屏先看排针数量,觉得 SPI 省引脚就选 SPI,结果跑起 UI 来一帧要几百毫秒,滑动条拖一下卡三下,回头再换并口,等于重做一遍。

先把账算清楚。一帧像素数是 480 × 320 = 153600,RGB565 每像素 16 位,总数据量 307200 字节,折成位是 2457600 位。

接口方式有效速率假设理论单帧耗时实际可用性
SPI @ 18MHz(1 线)18 Mbps,扣掉命令开销约 70%约 195 ms只能做参数面板,不能做动效
SPI @ 36MHz(1 线,超频)36 Mbps,扣掉开销约 70%约 97 ms屏能扛,但飞线一长就出错
FSMC 并口 16 位,写周期 70ns每次 2 字节,153600 次写约 10.7 ms刷全屏肉眼可见地跟手
GPIO 模拟并口(软件翻转)每次写 6~10 个指令周期约 60~100 ms能用但吃满 CPU,别拿来跑 UI

表里 FSMC 和 SPI 的差距接近 18 倍,这不是优化能补回来的,是物理总线位宽决定的。所以只要你的 F103 带 FSMC,就别犹豫走并口。

2.2 F103 型号筛选:不是每颗 F103 都有 FSMC

这是最容易在动手前就出错的一步。STM32F103 家族里,只有大容量(High-density)产品线才集成 FSMC 控制器,中容量和小容量的型号是没有的。

型号段Flash 容量是否带 FSMC能不能直接跑这套代码
F103x6 / F103x8 / F103xB(如 C8T6、CBT6、RBT6)32~128KB无不能,只能改 GPIO 模拟并口或换 SPI 屏
F103xC / F103xD / F103xE(如 VCT6、VET6、RCT6、ZET6)256~512KB有可以,本文所有配置按这个写
F103xF / F103xG768KB~1MB有可以,引脚分配略有出入要核原理图

所以买板子之前先看丝印,STM32F103ZET6、STM32F103VET6这类带 E 的才对。手上有 C8T6 最小系统板的人不少,那套代码烧进去必然是白屏,别浪费时间怀疑屏坏了——是芯片压根没有这个外设。

这里有个经验:带 FSMC 的型号引脚多、封装大,一般做成 100 脚或 144 脚的开发板,屏通常直接焊在板上或者用 40Pin 排线连。用杜邦线飞 16 根数据线再加 5 根控制线,长度一过 10cm 就开始出问题,能焊就焊。

2.3 接线表:数据线、控制线和那根关键的 A16

按 144 脚大容量型号的 FSMC Bank1、NE1 片选来分配,下面这套是常见接法,具体一定对着自己板子的原理图核一遍,引脚复用是死的,屏厂给的线序是活的。

屏幕引脚作用MCU 引脚GPIO 模式
D0 ~ D7低 8 位数据PD14, PD15, PD0, PD1, PE7, PE8, PE9, PE10复用推挽 50MHz
D8 ~ D15高 8 位数据PE11, PE12, PE13, PE14, PE15, PD8, PD9, PD10复用推挽 50MHz
/WR写使能PD5(FSMC_NWE)复用推挽 50MHz
/RD读使能PD4(FSMC_NOE)复用推挽 50MHz
/CS片选PD7(FSMC_NE1)复用推挽 50MHz
RS / DC命令数据选择PD11(FSMC_A16)复用推挽 50MHz
/RESET硬复位任意 GPIO,如 PE6推挽输出
BL / LED背光使能任意 GPIO,如 PE5推挽输出

RS 接 A16 这一根线决定了后面所有代码的写法。因为 FSMC 把外部器件映射成内存地址,A16 为 0 时地址是0x60000000,A16 为 1 时地址要按数据宽度偏移。16 位总线宽度下,地址线 A16 对应字节偏移是1 << (16 + 1),也就是0x20000。如果你把 RS 接的是 A17、A18,这个偏移量就得跟着改,接错了典型现象是:写命令写进了数据寄存器,屏上出现随机色块。

2.4 HAL 层的 FSMC 初始化:一个字段抄错就编译不过

先上时钟和 GPIO 复用配置。这段没什么技巧,但漏一个引脚就花屏,所以建议照着表格敲完之后再逐条比对。

#include "stm32f1xx_hal.h" /* RS 接 FSMC_A16,16 位总线宽度下的字节偏移 */ #define LCD_BASE ((uint32_t)0x60000000) #define LCD_REG (*(volatile uint16_t *)(LCD_BASE)) /* A16 = 0,写命令 */ #define LCD_DATA (*(volatile uint16_t *)(LCD_BASE + 0x20000)) /* A16 = 1,写数据 */ static void LCD_GPIO_Init(void) { GPIO_InitTypeDef gpio = {0}; __HAL_RCC_GPIOD_CLK_ENABLE(); __HAL_RCC_GPIOE_CLK_ENABLE(); gpio.Mode = GPIO_MODE_AF_PP; /* FSMC 全部走复用推挽 */ gpio.Pull = GPIO_NOPULL; gpio.Speed = GPIO_SPEED_FREQ_HIGH; /* F103 的 HIGH 就是 50MHz 档 */ /* PD0/1 是 D2/D3,PD4/5 是 NOE/NWE,PD7 是 NE1, PD8~10 是 D13~D15,PD11 是 A16,PD14/15 是 D0/D1 */ gpio.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_7 | GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_14 | GPIO_PIN_15; HAL_GPIO_Init(GPIOD, &gpio); /* PE7~PE15 一口气覆盖 D4~D12 */ gpio.Pin = GPIO_PIN_7 | GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15; HAL_GPIO_Init(GPIOE, &gpio); /* 复位和背光用普通推挽,先给高电平避免上电闪屏 */ gpio.Mode = GPIO_MODE_OUTPUT_PP; gpio.Speed = GPIO_SPEED_FREQ_LOW; gpio.Pin = GPIO_PIN_5 | GPIO_PIN_6; HAL_GPIO_Init(GPIOE, &gpio); HAL_GPIO_WritePin(GPIOE, GPIO_PIN_5 | GPIO_PIN_6, GPIO_PIN_SET); }

接下来是 FSMC 控制器本体。这段代码最容易翻车的地方是字段名——F1 系列的SRAM_InitTypeDef和 F4 系列长得不一样,没有AsynchronousWait、WriteBurst、PageSize这几个成员,从别的工程直接抄过来会编译报 unknown field。

static SRAM_HandleTypeDef hsram; static void LCD_FSMC_Init(void) { FSMC_NORSRAM_TimingTypeDef timing = {0}; __HAL_RCC_FSMC_CLK_ENABLE(); LCD_GPIO_Init(); hsram.Instance = FSMC_NORSRAM_DEVICE; hsram.Extended = FSMC_NORSRAM_EXTENDED_DEVICE; hsram.Init.NSBank = FSMC_NORSRAM_BANK1; /* 对应 NE1 */ hsram.Init.DataAddressMux = FSMC_DATA_ADDRESS_MUX_DISABLE; hsram.Init.MemoryType = FSMC_MEMORY_TYPE_SRAM; /* 屏当 SRAM 用 */ hsram.Init.MemoryDataWidth = FSMC_NORSRAM_MEM_BUS_WIDTH_16; hsram.Init.BurstAccessMode = FSMC_BURST_ACCESS_MODE_DISABLE; hsram.Init.WaitSignalPolarity = FSMC_WAIT_SIGNAL_POLARITY_LOW; hsram.Init.WrapMode = FSMC_WRAP_MODE_DISABLE; hsram.Init.WaitSignalActive = FSMC_WAIT_TIMING_BEFORE_WS; hsram.Init.WriteOperation = FSMC_WRITE_OPERATION_ENABLE; hsram.Init.WaitSignal = FSMC_WAIT_SIGNAL_DISABLE; hsram.Init.ExtendedMode = FSMC_EXTENDED_MODE_DISABLE; /* 72MHz 下一个 HCLK 是 13.9ns,写周期 =(ADDSET+1 + DATAST+1)× 13.9ns */ timing.AddressSetupTime = 1; /* 约 27.8ns 的地址建立 */ timing.AddressHoldTime = 0; timing.DataSetupTime = 2; /* 合计约 69ns,压着 ILI9486 的写周期下限 */ timing.BusTurnAroundDuration = 0; timing.CLKDivision = 0; timing.DataLatency = 0; HAL_SRAM_Init(&hsram, &timing, &timing); }

几个参数的实际含义得说清楚。AddressSetupTime = 1表示地址拉出来到 NWE 有效之间留一个 HCLK,这是给屏的地址锁存留余量;DataSetupTime = 2表示数据保持三个 HCLK,约 41.7ns。两者相加得到整个写周期的宽度。ILI9486 的写周期下限大致在 66ns 这个量级,69ns 刚好卡在安全线上。如果你把DataSetupTime压到 1,总周期只剩 55ns,多数屏还能亮,但温度一高或者排线一长就开始出零星花点——这种偶发问题最难查,我一般宁可留两档余量。

反过来,如果你用的是 100 脚型号、HCLK 只有 56MHz,同样的参数计算出来周期更短,反而更容易出问题,得把DataSetupTime加到 3。这就是为什么时序参数不能照抄,得拿公式自己算一遍。

3. 点亮第一屏:时序、初始化序列和最小绘图集

3.1 写命令和写数据的两个底层函数

所有上层操作最终都落到这两个函数上,写得好不好直接决定刷屏速度。有人喜欢做成LCD_WriteCmd(uint8_t cmd)然后在里面调用HAL_Delay,那是把屏当低频外设使,一帧下来全是等待。正确做法是直接对着映射地址赋值,让编译器生成单条存储指令。

/* 写命令:A16 = 0,FSMC 自动拉低 NWE,一个总线周期完成 */ static inline void LCD_WriteCmd(uint16_t cmd) { LCD_REG = cmd; } /* 写数据:A16 = 1 */ static inline void LCD_WriteData(uint16_t data) { LCD_DATA = data; } /* 带参数的写命令,ILI9486 的初始化序列几乎都是这种形式 */ static void LCD_WriteCmdData(uint16_t cmd, const uint16_t *buf, uint16_t len) { LCD_WriteCmd(cmd); while (len--) { LCD_WriteData(*buf++); } } /* 硬复位:整条序列必须给足时间,省掉延时是最常见的白屏原因 */ static void LCD_Reset(void) { HAL_GPIO_WritePin(GPIOE, GPIO_PIN_6, GPIO_PIN_RESET); HAL_Delay(20); HAL_GPIO_WritePin(GPIOE, GPIO_PIN_6, GPIO_PIN_SET); HAL_Delay(120); }

inline这个修饰不是装饰。这两个函数在刷全屏时会被调用十几万次,如果做成普通函数调用,光压栈出栈就吃掉可观的时间。加了inline之后编译器会把LCD_DATA = data直接内联成一条STRH指令,配合-O2优化,实测能比函数调用版本快三成左右。

3.2 ILI9486 初始化序列:三个必须先确认的寄存器

ILI9486 的官方初始化序列有一百多条命令,网上流传的版本大多是屏厂改过的。这套代码里的序列是通用的,但上电后必须逐条确认三个寄存器的值,否则就是花屏、镜像、偏色三选一。

寄存器名称本项目取值作用与调法
0x36Memory Access Control0x48控制扫描方向、RGB/BGR 顺序、行列镜像
0x3APixel Format Set0x550x55 = 16 位 RGB565,改成 0x66 是 18 位
0xB6Display Function Control0x02 0x22 0x3B扫描方向、门极电压、面板驱动能力

0x36 这个寄存器最值得单独说。它的低三位是 MX、MY、MV,分别对应横向镜像、纵向镜像、行列交换。3.5 寸 480×320 的屏,物理面板其实是 320×480 竖屏,所以横屏显示必须把 MV 位置 1,也就是行列互换。常见组合就四种:0x28、0x48、0xE8、0x88,一个一个试,试到方向和颜色都对为止。如果红色和蓝色反了,那不是 MX/MY 的问题,是 BGR 位——0x36 的 bit3 就是 RGB/BGR 选择,翻转一下即可。

初始化序列的核心片段如下:

static void LCD_Init(void) { LCD_Reset(); LCD_WriteCmd(0x01); /* 软复位 */ HAL_Delay(120); LCD_WriteCmd(0x11); /* 退出睡眠,这一条后面必须等 120ms */ HAL_Delay(120); { const uint16_t v[] = {0x0F, 0x0F}; LCD_WriteCmdData(0xC0, v, 2); /* Power Control 1 */ } { const uint16_t v[] = {0x41}; LCD_WriteCmdData(0xC1, v, 1); /* Power Control 2 */ } { const uint16_t v[] = {0x00, 0x3A, 0x80}; LCD_WriteCmdData(0xC5, v, 3); /* VCOM Control */ } { const uint16_t v[] = {0x48}; /* 横屏 + BGR,方向不对先改这里 */ LCD_WriteCmdData(0x36, v, 1); } { const uint16_t v[] = {0x55}; /* RGB565 */ LCD_WriteCmdData(0x3A, v, 1); } { const uint16_t v[] = {0xB0, 0x11}; LCD_WriteCmdData(0xB1, v, 2); /* 帧率控制 */ } { const uint16_t v[] = {0x02, 0x22, 0x3B}; LCD_WriteCmdData(0xB6, v, 3); /* Display Function Control */ } { const uint16_t v[] = {0x02}; LCD_WriteCmdData(0xB4, v, 1); /* 显示反转,偏色时试着改成 0x00 */ } /* 正负 Gamma 各 15 个参数,缺省值可跑,色阶不满意再逐条调 */ { const uint16_t pos[] = {0x0F,0x1F,0x1C,0x0C,0x0F,0x08,0x48,0x98, 0x37,0x0A,0x13,0x04,0x11,0x0D,0x00}; LCD_WriteCmdData(0xE0, pos, 15); } { const uint16_t neg[] = {0x0F,0x32,0x2E,0x0B,0x0D,0x05,0x47,0x75, 0x37,0x06,0x10,0x03,0x24,0x20,0x00}; LCD_WriteCmdData(0xE1, neg, 15); } LCD_WriteCmd(0x29); /* 打开显示 */ HAL_Delay(20); }

写这段代码时有个细节要注意:每条命令后面HAL_Delay(120)不是随便加的。0x01 软复位和 0x11 退出睡眠这两条,屏内部在重新加载寄存器,这段时间内送任何命令都会被丢弃。我见过一份代码把延时写成HAL_Delay(10),上电十次有三次白屏,剩下七次正常,那种随机故障排查起来能耗掉一整天。

3.3 开窗与填充:所有绘图的地基

ILI9486 的绘图模型很简单:先用 0x2A 和 0x2B 设好一个矩形窗口,然后连续写 0x2C,数据会按窗口自动折行填充。所有画点、画线、贴图、显示字符,本质上都是这个流程的变体。

/* 设置矩形窗口,坐标闭区间 */ static void LCD_SetWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { LCD_WriteCmd(0x2A); /* 列地址 */ LCD_WriteData(x0 >> 8); LCD_WriteData(x0 & 0xFF); LCD_WriteData(x1 >> 8); LCD_WriteData(x1 & 0xFF); LCD_WriteCmd(0x2B); /* 行地址 */ LCD_WriteData(y0 >> 8); LCD_WriteData(y0 & 0xFF); LCD_WriteData(y1 >> 8); LCD_WriteData(y1 & 0xFF); LCD_WriteCmd(0x2C); /* 后面跟的是像素数据 */ } /* 全屏填充,这是测通没通的最快手段 */ void LCD_Fill(uint16_t color) { uint32_t n = (uint32_t)LCD_WIDTH * LCD_HEIGHT; LCD_SetWindow(0, 0, LCD_WIDTH - 1, LCD_HEIGHT - 1); while (n--) { LCD_WriteData(color); } } /* 局部填充,用于脏矩形刷新 */ void LCD_FillRect(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color) { uint32_t n = (uint32_t)w * h; if (x >= LCD_WIDTH || y >= LCD_HEIGHT) return; if (x + w > LCD_WIDTH) w = LCD_WIDTH - x; if (y + h > LCD_HEIGHT) h = LCD_HEIGHT - y; n = (uint32_t)w * h; LCD_SetWindow(x, y, x + w - 1, y + h - 1); while (n--) { LCD_WriteData(color); } }

LCD_Fill跑一遍大约能把全屏写满,这是验证硬件最直接的测试——上电先红、再绿、再蓝,三种颜色轮一遍。如果三色都能正确显示,说明 FSMC 时序、初始化序列、颜色格式全对,后面画什么都不会有大问题。如果红色显示成蓝色,回去查 0x36 的 BGR 位;如果颜色对但位置错乱,查LCD_SetWindow的坐标上限和 0x36 的 MV 位。

3.4 画点、画线与字符:把 16 位总线喂满

画点是最基础的原语,但直接用画点去画线会慢得没法看,因为每个点都要重设一次窗口。正确做法是先把整条线的坐标算出来,开一次窗,然后连续写。

void LCD_DrawPixel(uint16_t x, uint16_t y, uint16_t color) { if (x >= LCD_WIDTH || y >= LCD_HEIGHT) return; LCD_SetWindow(x, y, x, y); LCD_WriteData(color); } /* Bresenham,一次开窗写整条线,比逐点画快两个数量级 */ void LCD_DrawLine(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color) { int16_t dx = (x1 > x0) ? (x1 - x0) : (x0 - x1); int16_t dy = (y1 > y0) ? (y1 - y0) : (y0 - y1); int16_t sx = (x0 < x1) ? 1 : -1; int16_t sy = (y0 < y1) ? 1 : -1; int16_t err = dx - dy; while (1) { LCD_DrawPixel(x0, y0, color); if (x0 == x1 && y0 == y1) break; { int16_t e2 = err << 1; if (e2 > -dy) { err -= dy; x0 += sx; } if (e2 < dx) { err += dx; y0 += sy; } } } }

字符显示是另一个常见瓶颈。这份代码里用的是 16×16 和 8×16 的点阵字库,存在 Flash 里,显示一个汉字要写 256 个像素。如果每个像素都走一次LCD_WriteData,一个 20 字的标题就要写 5120 次,中间还夹着if判断,帧率掉得很明显。

优化思路是把字模按行展开后,用连续写的方式发出去:整字开一次窗,然后两层循环遍历 16×16 的位图,黑位写背景色、亮位写前景色,中间不做坐标判断。这样每个字的窗口开销只有一次,剩下的全是纯数据写入。如果字库支持,还可以把常用汉字预先渲染成 RGB565 的小图存在 Flash,显示时直接按行 memcpy 到 FSMC 地址,速度再上一个台阶。

4. XPT2046 触摸:从 12 位 ADC 到可信的屏幕坐标

4.1 硬件连接与 SPI 参数:别超过 2MHz

3.5 寸 ILI9486 模块上的触摸绝大多数是电阻屏配 XPT2046 控制器。这颗芯片本质上是个四线触摸 ADC,通过 SPI 读出 X、Y 两个方向的电压值。它和显示屏共用一组排针,但电气上完全独立:显示走 FSMC 并口,触摸走一路 SPI 加一根笔中断。

XPT2046 引脚接到 MCU说明
/CS任意 GPIO,如 PB12片选,低有效
DCLKPA5(SPI1_SCK)时钟,最高约 2MHz
DINPA7(SPI1_MOSI)命令输入
DOUTPA6(SPI1_MISO)数据输出
/PENIRQPB0(EXTI0)笔按下时拉低,可省

SPI 参数这块有个很实际的限制:XPT2046 的时钟上限大概在 2MHz 附近,超过之后读出来的值会漂。F103 的 SPI1 挂在 APB2 上,主频 72MHz,分频系数选 32 得到 2.25MHz,选 64 得到 1.125MHz。我一般直接用 32 分频,实测在 2.25MHz 下还算稳,如果读出来数值跳动超过 ±50,就降到 64 分频。

static SPI_HandleTypeDef hspi1; static void TP_SPI_Init(void) { hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; /* 一次读 3 字节 */ hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; /* Mode 0,读不出来先换这行 */ hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; hspi1.Init.NSS = SPI_NSS_SOFT; /* 片选用普通 GPIO 手动控制 */ hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_32; /* 72/4/32 ≈ 0.56MHz */ hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB; hspi1.Init.TIMode = SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE; HAL_SPI_Init(&hspi1); }

分频这里多解释一句。SPI1 在 APB2 上,但 SPI1 的时钟源经过一个固定的 2 分频,所以实际是 72/2 = 36MHz 再除以预分频系数。32 分频得到 1.125MHz,64 分频得到 0.56MHz,都在 XPT2046 的舒适区内。

4.2 采样、滤波与去抖

XPT2046 的读数格式是 12 位,配合命令字节决定读哪个通道。常见命令字:0xD0 读 X 位置,0x90 读 Y 位置。整个 SPI 事务要读 3 个字节,第一个字节是命令回显,后两个字节拼出 12 位结果。

#define TP_CS_LOW() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_RESET) #define TP_CS_HIGH() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_SET) static uint16_t TP_ReadRaw(uint8_t cmd) { uint8_t tx[3] = {cmd, 0x00, 0x00}; uint8_t rx[3] = {0}; TP_CS_LOW(); HAL_SPI_TransmitReceive(&hspi1, tx, rx, 3, 10); TP_CS_HIGH(); /* 12 位有效数据在后 12 位,右移 3 位取整;若满量程不到 4095 改移 4 位 */ return (uint16_t)((((uint16_t)rx[1] << 8) | rx[2]) >> 3); } /* 五点采样去掉最大最小,剩下三个求均值,能压掉大部分抖动 */ static uint16_t TP_ReadFiltered(uint8_t cmd) { uint16_t buf[5], tmp; uint32_t sum = 0; uint8_t i, j; for (i = 0; i < 5; i++) { buf[i] = TP_ReadRaw(cmd); HAL_Delay(1); /* 采样之间留一点恢复时间 */ } for (i = 0; i < 4; i++) { for (j = i + 1; j < 5; j++) { if (buf[j] < buf[i]) { tmp = buf[i]; buf[i] = buf[j]; buf[j] = tmp; } } } for (i = 1; i < 4; i++) sum += buf[i]; return (uint16_t)(sum / 3); }

这里有个坑要说清楚:>> 3这个移位量不是固定的,取决于屏里 XPT2046 的连接方式。判断方法很简单,用手指按住屏幕一个角落,看输出的原始值。如果最大只能到 511,说明移位量应该减 1;如果一直在 4095 附近饱和,说明移位量太大。正常满量程应该在 200~3900 之间,留出边缘余量。

4.3 两点标定:把 ADC 值映射到 0~479

原始 ADC 值和屏幕像素坐标之间是个线性关系,只差两个系数。理论上一组 kx、bx 就够,但实际上 X 和 Y 方向的电阻不同、走线长度不同,必须分开算。

标定流程用两点法:在屏幕两个已知位置画十字准星,比如 (40, 40) 和 (440, 280),让用户依次点中,记录下两次的原始 ADC 值,然后解这个二元一次方程组。

typedef struct { float kx, bx; float ky, by; } TP_Calib_t; static TP_Calib_t calib; /* 用两点标定结果生成映射系数 */ void TP_SetCalib(uint16_t ax1, uint16_t ay1, uint16_t ax2, uint16_t ay2) { /* 第一次点在屏幕 (X1,Y1),第二次在 (X2,Y2) */ const float X1 = 40.0f, Y1 = 40.0f; const float X2 = 440.0f, Y2 = 280.0f; calib.kx = (X2 - X1) / ((float)ax2 - (float)ax1); calib.bx = X1 - calib.kx * (float)ax1; calib.ky = (Y2 - Y1) / ((float)ay2 - (float)ay1); calib.by = Y1 - calib.ky * (float)ay1; } /* 把原始值转成屏幕坐标,越界钳位 */ void TP_GetPoint(uint16_t *x, uint16_t *y) { uint16_t ax = TP_ReadFiltered(0xD0); uint16_t ay = TP_ReadFiltered(0x90); int32_t px = (int32_t)(calib.kx * ax + calib.bx); int32_t py = (int32_t)(calib.ky * ay + calib.by); if (px < 0) px = 0; if (px > LCD_WIDTH - 1) px = LCD_WIDTH - 1; if (py < 0) py = 0; if (py > LCD_HEIGHT - 1) py = LCD_HEIGHT - 1; *x = (uint16_t)px; *y = (uint16_t)py; }

两点法的局限要提一句:如果屏的线性度差,中间区域会有 5~10 像素的偏差,做按钮点击足够,做手写板就不够。这种情况下得用四点或五点标定,解最小二乘,把系数存到 Flash 里,开机时读出来——这套代码里预留了这个结构,改起来不难。

4.4 触摸中断与主循环的分工

XPT2046 的 /PENIRQ 引脚在笔按下时拉低,可以直接接 EXTI。但要注意,这个中断是电平型的,只要笔没松开就一直是低,所以在中断里不能直接做长时间处理,否则会反复进中断把主循环饿死。

我的做法是:中断里只置一个标志位,立刻退出;主循环检测到标志才去读坐标。而且读坐标本身要带超时——如果连续读三次都超出量程范围,判定为误触发直接丢弃。这套代码里用的是 20ms 的软件节流,也就是两次有效采样间隔至少 20ms,既能过滤抖动,又不影响手感。

另一个细节:触摸读完之后要等 XPT2046 内部放电,两次采样之间至少隔 1ms。这个时间太短会导致相邻两次读数互相干扰,表现为坐标在小范围内来回跳。

5. 避坑与排查:白屏、花屏、坐标乱跳的现场记录

5.1 上电先查这四个前提,能省掉八成排查时间

不管后面遇到什么现象,先按顺序确认这四件事,顺序不能乱。

第一,背光。BL 引脚给高电平了没有?很多模块的背光是通过三极管或者 MOS 管驱动的,极性可能是反的,也就是拉低才亮。用万用表量一下背光正极有没有 3.3V 或者 5V,没有就是这一步的问题。

第二,复位。/RESET在上电后必须有一个完整的低脉冲,至少 10ms 低电平,然后释放后等 120ms。用示波器看,或者干脆在代码里加大延时。我见过因为复位引脚被外部电容拖住、一直处于低电平的板子,屏怎么都不亮。

第三,供电。3.5 寸屏的背光电流可能到 100mA 以上,如果从 MCU 的 3.3V LDO 取电,很可能拉低整个系统电压导致复位。背光单独走一路电源,或者用 USB 的 5V 经限流电阻。

第四,地。FSMC 是 16 位并口,16 根数据线同时翻转时地线上的回流电流不小,屏的地和 MCU 的地必须可靠连接,排线太长还要考虑加地线隔离。

5.2 显示异常的三种现场

现象一:全白屏,背光亮着但没有任何内容。原因通常是初始化序列没有执行完,或者用了不匹配的初始化序列。解决:在LCD_WriteCmd(0x29)之后加一句LCD_Fill(0xF800),如果此时能刷出红色,说明屏已经工作了,是前面的图像内容没写对;如果还是白的,用示波器看 NWE 上有没有波形,没有就是 FSMC 没使能,检查__HAL_RCC_FSMC_CLK_ENABLE()有没有漏。

现象二:花屏,能看到内容但有随机色块或者错位。原因几乎都是时序不够。把DataSetupTime从 2 加到 3,AddressSetupTime从 1 加到 2,问题通常会消失。如果加了还是花,检查地址偏移量——RS 接的不是 A16 而是 A17/A18 的话,0x20000这个偏移就是错的,写命令会写进数据寄存器。判断方法:把偏移改大一倍或一半,看现象有没有变化。

现象三:颜色不对,红蓝互换。改 0x36 寄存器的 bit3,把 0x48 改成 0x40,或者反过来。这一位是 RGB/BGR 顺序选择,不改的话所有颜色都是错的。顺带一提,如果整个画面上下颠倒,那是 MY 位的问题,0x48 改 0x88 试试;左右颠倒改 MX,0x48 改 0x28。

5.3 触摸异常的两种现场

现象:读出来的原始值恒定不变,或者全是 0 或 4095。这是 SPI 通信没通。先查 CS 引脚有没有真的拉低——用万用表量,别信代码。然后查 SPI 模式,XPT2046 支持 Mode 0 和 Mode 3,如果 Mode 0 读出来不变,把CLKPolarity改成SPI_POLARITY_HIGH、CLKPhase改成SPI_PHASE_2EDGE试一次。最后查 MOSI/MISO 有没有接反,这两个接反了现象就是读数恒定。

现象:坐标能读到,但点击位置和实际位置偏差很大,或者边缘点不到。这通常是标定系数不对或者采样没滤波。先做一次两点标定,标定的时候手指要垂直按在准星中心,斜着按会引入几像素的系统误差。如果标定完中间还是偏,说明触摸屏线性度不好,改用四点标定。还有一种情况是坐标被LCD_SetWindow的方向影响了——如果显示用了 0x36 的 MV 位做横屏,触摸的 X/Y 也要对应交换,否则会出现“横着划竖着走”的现象。

6. 进阶:在 64KB RAM 里把刷新率提升出来

全屏显存是 307200 字节,F103ZE 的 64KB SRAM 装不下,所以“先画到内存再整屏 DMA 推出去”这条路走不通。可行的路子是脏矩形加行缓冲。

脏矩形的核心思路是记录上一帧和这一帧发生变化的区域,只重绘那块。比如做一个数字时钟,只有秒位那几十个像素在变,其他区域完全不动,一帧只需要几毫秒。实现上维护一个简单的矩形合并结构,每帧开始时清空,控件更新时把自身包围盒并进去,帧末统一提交一次。

第二种是行缓冲。在 SRAM 里开一行 480 像素的uint16_t缓冲,也就是 960 字节,把要显示的内容先在这行里拼好,然后一次性memcpy到 FSMC 地址。这里有个加速技巧:直接对LCD_DATA做循环赋值,编译器会生成连续的STRH指令;如果缓冲区是uint32_t对齐的,还能用 32 位写把两次 16 位写合并,实际带宽再涨一截。

刷新策略单帧理论耗时(72MHz,DATAST=2)适用场景
逐点LCD_DrawPixel约 40ms(含窗口重设开销)只适合零星几个点
整屏LCD_Fill连续写约 11ms清屏、切页
脏矩形局部刷新0.5~3ms(按面积)仪表盘、状态栏、按钮反馈
行缓冲 + 32 位写整屏约 9ms图片、图表、滚动列表

最后一个技巧是字库裁剪。完整的中文字库动辄几百 KB,F103 的 Flash

本文还有配套的精品资源,点击获取

返回列表