简介本资源是一套基于STM32F407微控制器与HAL库开发的大彩TFT彩屏串口通信驱动工程面向嵌入式初学者及中级开发者聚焦于ARM Cortex-M4平台下SPI接口驱动TFT屏幕的核心实践问题适用于智能仪表、HMI人机界面等硬件交互类项目开发。压缩包共8个文件4个C源文件4个头文件涵盖命令队列管理cmd_queue、串口指令解析cmd_process、底层硬件驱动hmi_driver及用户UART接口封装hmi_user_uart结构清晰、模块解耦总大小仅13KB轻量易集成。已有2069人学习下载说明其在实际教学与项目移植中具备较高参考价值。读者可直接复用该框架实现屏幕初始化、坐标定位、像素刷新、文本显示等基础功能并深入理解帧缓冲组织、HAL_SPI传输机制及中断/DMA协同设计思路是掌握STM32F4系列外设驱动与TFT屏控制原理的典型实战范例。 做设备调试最烦躁的事情不是算法算不出来而是参数根本没地方看。以前遇到需要显示的场景要么硬啃一块并口TFT自己写GUI要么干脆减配用几个LED灯来猜状态。后来我改用大彩TFT彩屏走串口通信配合STM32F407的HAL库写驱动开发模式一下就变了。屏幕本身自带处理器MCU只通过串口发命令、收事件页面按钮字体波形全部在屏幕端搞定。这篇文章把整套程序的落地过程完整讲一遍从CubeMX配置到驱动代码从协议解析到上电时序再到实测踩坑目标就是让正在纠结怎么给项目加显示功能的嵌入式工程师少走弯路。1. 为什么是STM32F407 HAL库 大彩串口屏这条组合路线1.1 直接驱动一块TFT的真实成本先说说直接驱动TFT的体验。F407本身有FSMC接口接一块16位并口TFT确实能跑得挺快但真正磨人的不是把像素刷上去而是后面的整套生态字库、控件、图片解码、触摸校准、多级菜单状态机哪一样都要自己搭。哪怕用LVGL这类开源图形库底层驱动、内存池分配、中文显示字体、不同屏幕的初始化序列也够你忙活一两周。硬件和软件同时堆工作量在项目周期里非常不划算。1.2 串口屏把UI开发外包给了屏幕端大彩这类串口屏解决问题的思路是“UI外包”。屏幕内部有一颗处理器跑着厂家写好的界面固件你只需要在配套的组态软件里像做PPT一样把页面拖出来再把工程文件下载进屏幕。MCU这边的任务被简化成一条条串口指令切页面、改文本、画直线、响应用户触摸。改界面的时候只需要在电脑上改工程重新下载进屏幕主控代码完全不用动。这在产品定型后调整UI或者同一主板配不同显示风格时优势特别明显。1.3 为什么选F407又为什么用HAL库STM32F407主频168MHz外设接口丰富多路USART可以灵活映射非常适合做“主控”角色。HAL库相比标准库最大的好处是接口统一一个串口句柄加几个回调函数就能把收发流程写完还能用CubeMX快速调整引脚和时钟树。标准库写寄存器更直接但换个系列芯片就得重新啃一遍外设手册这种串口屏项目里没必要自己找麻烦。HAL库虽然代码量大一些但在这个场景下可靠性和开发速度是优先的。2. 大彩屏幕的通信协议和HAL串口的对接模型2.1 命令帧和串口助手的“同构关系”大彩屏通信一般有两种形态。一种是ASCII命令比如在调试模式里直接发page 0\r\n这样带分隔符的字符串人眼可读串口助手里直接敲进去就能看到效果另一种是十六进制帧协议数据以帧头、命令、长度、数据、帧尾组织适合产品固件里使用。正式开发时建议切到十六进制帧模式稳定性和可扩展性都更好。不管哪种模式本质上都是“MCU按约定格式发送一串字节屏幕执行动作”和你在串口助手手动输入命令是一样的只是把操作从人变成了程序。2.2 帧结构拆开看一个常见的大彩十六进制帧长这样字段段长举例说明帧头1字节0xAA固定起始告诉屏幕“新命令来了”命令字1字节0x01页面切换、文本设置等不同动作数据长度2字节0x00 0x02后续数据字节数高字节在前数据区N字节页面号等具体参数帧尾4字节0xCC 0x33 0xC3 0x3C结束标志有些型号还带CRC不同型号的具体命令号会有差异但骨架基本一致。我自己开发时先拿屏幕附带的《指令集手册》查出画面切换和文本设置的命令码然后在串口助手里把帧拼出来测试确认屏幕能执行再开始写HAL上的封装函数。这样能大大减少调试时的不确定性。2.3 UART只负责搬运协议才是“断句”的关键这里要理清一个边界HAL库的HAL_UART_Transmit和HAL_UART_Receive_IT只负责把字节从一个设备搬到另一个设备它不管这一串字节是什么意思。屏幕发送的触摸事件可能半路断开或者多条命令粘在一起这就需要协议层的“断句”。帧头和帧尾就是断句的依据数据长度用来判断数据区该读几个字节。思考串口通信时脑子里可以把UART想象成水流管道而帧结构是水流里一个个打包好的货物接收状态机负责把货物完整地取出来。这个思路在Modbus、自定义协议里全都能复用。2.4 屏幕上报的数据同样要解析大彩屏触摸操作后屏幕会主动向MCU发送事件帧。这种上报信息帧也是同样的帧结构只是命令字和含义不同。MCU收到后要在接收回调里立刻解析出来再根据包里的屏幕控件ID去执行对应动作。所以整条链路是双向的发送命令用HAL_UART_Transmit接收触摸事件用中断加状态机。3. CubeMX里串口配置最容易出错的地方3.1 引脚不要和调试口打架F407上有多个串口比如USART1常用PA9/PA10USART2用PA2/PA3USART3用PB10/PB11USART6在PC6/PC7或PG14/PG9都是复用功能AF7。这个项目里最好单独分配一路UART给屏幕不要和调试printf共用。我之前偷懒把两个功能挤在同一个串口上调试信息把协议帧冲得乱七八糟排查了很久才发现是日志和屏幕数据混线了。各用各的串口一台设备负责打印一台设备负责屏幕互不干扰看起来少一根线实际能省无数时间。3.2 波特率数据位这些参数必须和屏幕配置完全一致大彩屏出厂的默认串口参数可能是9600/8/N/1也可能被配置成115200或者其他值。CubeMX里改串口参数很简单难的是别忘了把屏幕侧的配置也改过来。实际操作时我一般先确认屏幕工程里下载的波特率再回CubeMX填同样的值。参数不一致的典型症状是发送指令后屏幕上出现乱码字符或者干脆没反应。推荐用115200刷新页面和绘制图形时体感流畅距离短、干扰小稳定性完全够用。CubeMX里的USART设置Mode: Asynchronous Baud Rate: 115200 Word Length: 8 Bits Parity: None Stop Bits: 13.3 时钟树不对波特率误差能把屏幕坑到乱码串口的波特率不是凭空来的它由APB总线时钟分频得到。F407主频168MHz时APB2跑84MHzAPB1跑42MHz。如果CubeMX里时钟树配置不对比如PLL参数填错导致主频变成144MHz或者APB分频系数不对HAL库虽然还是会按当前时钟算出USARTDIV但误差可能迅速增大。串口波特率误差超过±2%后长时间传大帧时出错概率急剧上升。所以正确顺序是先配好时钟树把主频确认到168MHz再回到USART界面看CubeMX自动算出的误差。如果误差偏大优先检查时钟配置而不是盲目调波特率。3.4 中断优先级和DMA不是必选项但要知道什么时候用只做文字刷新和简单图形时阻塞收发完全没有问题。但如果你在屏幕上大量刷新曲线、图片或者频繁收触摸事件主循环里用HAL_UART_Transmit发长数据会卡住其他任务。解决办法是发送改用DMA接收用中断加状态机如果屏幕上报帧特别长比如一次传一批坐标数据还可以用串口空闲中断来处理HAL库对应接口是HAL_UARTEx_ReceiveToIdle_IT。中断优先级方面串口中断可以设高一些但别把硬实时任务挤掉具体看项目里哪些事情最不能被延迟。4. 一份可以直接改用的HAL驱动骨架4.1 发送封装把“组帧”和“发串口”拆开驱动代码我习惯分成两层上层业务只需要说“我要切页面2”底层函数负责拼成完整帧并调用HAL发送。这样接手项目的人只需要看业务函数不需要每处都拼一遍字节数组。先看头文件/* screen_drv.h */ #ifndef SCREEN_DRV_H #define SCREEN_DRV_H #include main.h void SCR_Init(void); void SCR_SendCmd(uint8_t cmd, const uint8_t *data, uint16_t len); void SCR_ProcessByte(uint8_t byte); void SCR_Task(void); #endif底层发送函数这样写/* screen_drv.c */ #include screen_drv.h extern UART_HandleTypeDef huart1; #define SCR_HEAD 0xAA #define SCR_TAIL_END1 0xCC #define SCR_TAIL_END2 0x33 #define SCR_TAIL_END3 0xC3 #define SCR_TAIL_END4 0x3C #define TX_BUF_SIZE 128 static uint8_t txbuf[TX_BUF_SIZE]; void SCR_SendCmd(uint8_t cmd, const uint8_t *data, uint16_t len) { uint16_t i 0; uint16_t total len 8; /* 帧头1 命令1 长度2 数据len 帧尾4 */ if (total TX_BUF_SIZE) { return; } txbuf[0] SCR_HEAD; txbuf[1] cmd; txbuf[2] (uint8_t)(len 8); txbuf[3] (uint8_t)(len 0xFF); for (i 0; i len; i) { txbuf[4 i] data[i]; } txbuf[4 len] SCR_TAIL_END1; txbuf[5 len] SCR_TAIL_END2; txbuf[6 len] SCR_TAIL_END3; txbuf[7 len] SCR_TAIL_END4; HAL_UART_Transmit(huart1, txbuf, total, 100); }这里命令字cmd是屏幕手册里定义好的比如切换页面可能是0x01设置文本可能是0x03。这个函数就是“通用压包机”不管什么命令只要传命令号和参数它就帮你把帧尾巴补齐发出去。4.2 接收状态机逐字节拆帧屏幕上报触摸事件时MCU很可能正在忙别的事情所以接收端最好用中断。HAL库里最朴素的做法是每次启动接收一个字节收到后进回调回调里启动下一次接收。字节流再交给一个状态机解析。初始化时static uint8_t rx_byte; void SCR_Init(void) { HAL_UART_Receive_IT(huart1, rx_byte, 1); }串口中断回调里这样处理void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { SCR_ProcessByte(rx_byte); HAL_UART_Receive_IT(huart1, rx_byte, 1); } }状态机拆帧的核心逻辑static uint8_t rx_state; static uint8_t rx_cmd; static uint8_t rx_len_h, rx_len_l; static uint16_t rx_len; static uint8_t rx_buf[128]; static uint16_t rx_index; void SCR_ProcessByte(uint8_t byte) { switch (rx_state) { case 0: /* 等待帧头 */ if (byte SCR_HEAD) rx_state 1; break; case 1: /* 读取命令字 */ rx_cmd byte; rx_state 2; break; case 2: /* 长度高字节 */ rx_len_h byte; rx_state 3; break; case 3: /* 长度低字节 */ rx_len_l byte; rx_len ((uint16_t)rx_len_h 8) | rx_len_l; rx_index 0; if (rx_len sizeof(rx_buf)) { rx_state 0; /* 非法长度重新等帧头 */ } else { rx_state 4; } break; case 4: /* 数据区 */ if (rx_index rx_len) { rx_buf[rx_index] byte; } if (rx_index rx_len) { rx_state 5; } break; case 5: if (byte SCR_TAIL_END1) rx_state 6; else rx_state 0; break; case 6: if (byte SCR_TAIL_END2) rx_state 7; else rx_state 0; break; case 7: if (byte SCR_TAIL_END3) rx_state 8; else rx_state 0; break; case 8: if (byte SCR_TAIL_END4) { /* 一帧完整上报数据到手 */ handle_screen_event(rx_cmd, rx_buf, rx_len); } rx_state 0; break; default: rx_state 0; break; } }这个状态机的思路是不关心“帧与帧之间有没有停顿”只关心“字节和下一个字节的关系”所以哪怕屏幕一次发来很多帧中间的字节也不会丢也不会被拆错。唯一要注意的就是数据区长度字段的位置和帧尾不同型号可能不同拿手册对一遍再改对应常量就行。4.3 长帧上报用空闲中断更稳如果屏幕一次会上报几十个字节比如触摸滑动轨迹逐字节中断加状态机虽然稳定但每个字节都进一次中断CPU占用偏高。STM32的串口空闲中断可以做到“等串口线空闲了再一次性读取接收缓冲区的所有数据”。HAL库实现起来很简单static uint8_t rx_dma_buf[256]; /* 初始化时调用 */ HAL_UARTEx_ReceiveToIdle_IT(huart1, rx_dma_buf, sizeof(rx_dma_buf));然后重写事件回调void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size) { if (huart-Instance USART1) { /* rx_dma_buf 里的前 Size 个字节是一帧完整数据 */ parse_screen_frame(rx_dma_buf, Size); HAL_UARTEx_ReceiveToIdle_IT(huart1, rx_dma_buf, sizeof(rx_dma_buf)); } }这个方案相当于把“拆帧”的活从MCU中断里搬到了DMA搬运效率高很多。但它要求屏幕上报的数据是完整的一包中间没有长时间停顿。如果屏幕上报命令里带流控或者分包发送还是得用逐字节状态机。4.4 DMA发送的注意事项把发送改成DMA后有一个跟阻塞方式完全不同的坑HAL_UART_Transmit_DMA是异步的函数返回时数据可能还没发完所以你传进去的缓冲区必须保持有效不能被栈变量覆盖。最安全的做法是把要发送的数据先拷贝到一个静态数组再启动DMA。另一个坑是上一次DMA还没发完你又启动了新一次HAL库会直接返回Busy错误。发送前可以加个判断void SCR_SendDMA(uint8_t *buf, uint16_t len) { while (HAL_UART_GetState(huart1) ! HAL_UART_STATE_READY); HAL_UART_Transmit_DMA(huart1, buf, len); }5. 实测调用顺序上电、切页、刷新文本、收触摸5.1 上电时序不能省略大彩屏上电后内部的处理器和显示驱动也需要时间启动如果MCU和屏幕同时上电MCU立刻发命令屏幕可能根本没准备好命令直接丢。稳妥的上电流程是这样的给MCU和屏幕供电MCU延时300ms以上等屏幕内核稳定如果屏幕模块有复位引脚拉低50ms再拉高发送第一条命令前可以先发一个“读取固件版本”之类的查询命令返回正常后再继续。实际开发时我习惯把这段初始化放在项目启动的main函数里屏幕未就绪期间只亮背光不操作避免一上电就发一堆无效数据。5.2 切页和刷文本的顺序组态软件里把页面和控件ID设计好之后MCU这边的操作其实特别简单。切到第2页按前面封装的函数写就是uint8_t page_data[2]; page_data[0] 0x00; page_data[1] 0x02; SCR_SendCmd(0x01, page_data, 2); /* 0x01是页面切换命令 */刷新某个文本控件假设控件ID是10显示内容为“25.6”char text_buf[8]; uint8_t data[4]; sprintf(text_buf, %.1f, temper); /* 25.6 */ data[0] 0x00; data[1] 10; /* 控件ID */ data[2] 0x00; data[3] strlen(text_buf); /* 字符串长度 */ SCR_SendCmd(0 p a hrefhttps://download.csdn.net/download/qq_52619462/77385602 stylecolor:#ec7500;font-size:14px; 本文还有配套的精品资源点击获取 /a img altmenu-r.4af5f7ec.gif srchttps://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif stylewidth:16px;margin-left:4px;vertical-align:text-bottom;cursor:text; /p
STM32F407+HAL库+大彩串口屏：从CubeMX配置到驱动实现
简介本资源是一套基于STM32F407微控制器与HAL库开发的大彩TFT彩屏串口通信驱动工程面向嵌入式初学者及中级开发者聚焦于ARM Cortex-M4平台下SPI接口驱动TFT屏幕的核心实践问题适用于智能仪表、HMI人机界面等硬件交互类项目开发。压缩包共8个文件4个C源文件4个头文件涵盖命令队列管理cmd_queue、串口指令解析cmd_process、底层硬件驱动hmi_driver及用户UART接口封装hmi_user_uart结构清晰、模块解耦总大小仅13KB轻量易集成。已有2069人学习下载说明其在实际教学与项目移植中具备较高参考价值。读者可直接复用该框架实现屏幕初始化、坐标定位、像素刷新、文本显示等基础功能并深入理解帧缓冲组织、HAL_SPI传输机制及中断/DMA协同设计思路是掌握STM32F4系列外设驱动与TFT屏控制原理的典型实战范例。 做设备调试最烦躁的事情不是算法算不出来而是参数根本没地方看。以前遇到需要显示的场景要么硬啃一块并口TFT自己写GUI要么干脆减配用几个LED灯来猜状态。后来我改用大彩TFT彩屏走串口通信配合STM32F407的HAL库写驱动开发模式一下就变了。屏幕本身自带处理器MCU只通过串口发命令、收事件页面按钮字体波形全部在屏幕端搞定。这篇文章把整套程序的落地过程完整讲一遍从CubeMX配置到驱动代码从协议解析到上电时序再到实测踩坑目标就是让正在纠结怎么给项目加显示功能的嵌入式工程师少走弯路。1. 为什么是STM32F407 HAL库 大彩串口屏这条组合路线1.1 直接驱动一块TFT的真实成本先说说直接驱动TFT的体验。F407本身有FSMC接口接一块16位并口TFT确实能跑得挺快但真正磨人的不是把像素刷上去而是后面的整套生态字库、控件、图片解码、触摸校准、多级菜单状态机哪一样都要自己搭。哪怕用LVGL这类开源图形库底层驱动、内存池分配、中文显示字体、不同屏幕的初始化序列也够你忙活一两周。硬件和软件同时堆工作量在项目周期里非常不划算。1.2 串口屏把UI开发外包给了屏幕端大彩这类串口屏解决问题的思路是“UI外包”。屏幕内部有一颗处理器跑着厂家写好的界面固件你只需要在配套的组态软件里像做PPT一样把页面拖出来再把工程文件下载进屏幕。MCU这边的任务被简化成一条条串口指令切页面、改文本、画直线、响应用户触摸。改界面的时候只需要在电脑上改工程重新下载进屏幕主控代码完全不用动。这在产品定型后调整UI或者同一主板配不同显示风格时优势特别明显。1.3 为什么选F407又为什么用HAL库STM32F407主频168MHz外设接口丰富多路USART可以灵活映射非常适合做“主控”角色。HAL库相比标准库最大的好处是接口统一一个串口句柄加几个回调函数就能把收发流程写完还能用CubeMX快速调整引脚和时钟树。标准库写寄存器更直接但换个系列芯片就得重新啃一遍外设手册这种串口屏项目里没必要自己找麻烦。HAL库虽然代码量大一些但在这个场景下可靠性和开发速度是优先的。2. 大彩屏幕的通信协议和HAL串口的对接模型2.1 命令帧和串口助手的“同构关系”大彩屏通信一般有两种形态。一种是ASCII命令比如在调试模式里直接发page 0\r\n这样带分隔符的字符串人眼可读串口助手里直接敲进去就能看到效果另一种是十六进制帧协议数据以帧头、命令、长度、数据、帧尾组织适合产品固件里使用。正式开发时建议切到十六进制帧模式稳定性和可扩展性都更好。不管哪种模式本质上都是“MCU按约定格式发送一串字节屏幕执行动作”和你在串口助手手动输入命令是一样的只是把操作从人变成了程序。2.2 帧结构拆开看一个常见的大彩十六进制帧长这样字段段长举例说明帧头1字节0xAA固定起始告诉屏幕“新命令来了”命令字1字节0x01页面切换、文本设置等不同动作数据长度2字节0x00 0x02后续数据字节数高字节在前数据区N字节页面号等具体参数帧尾4字节0xCC 0x33 0xC3 0x3C结束标志有些型号还带CRC不同型号的具体命令号会有差异但骨架基本一致。我自己开发时先拿屏幕附带的《指令集手册》查出画面切换和文本设置的命令码然后在串口助手里把帧拼出来测试确认屏幕能执行再开始写HAL上的封装函数。这样能大大减少调试时的不确定性。2.3 UART只负责搬运协议才是“断句”的关键这里要理清一个边界HAL库的HAL_UART_Transmit和HAL_UART_Receive_IT只负责把字节从一个设备搬到另一个设备它不管这一串字节是什么意思。屏幕发送的触摸事件可能半路断开或者多条命令粘在一起这就需要协议层的“断句”。帧头和帧尾就是断句的依据数据长度用来判断数据区该读几个字节。思考串口通信时脑子里可以把UART想象成水流管道而帧结构是水流里一个个打包好的货物接收状态机负责把货物完整地取出来。这个思路在Modbus、自定义协议里全都能复用。2.4 屏幕上报的数据同样要解析大彩屏触摸操作后屏幕会主动向MCU发送事件帧。这种上报信息帧也是同样的帧结构只是命令字和含义不同。MCU收到后要在接收回调里立刻解析出来再根据包里的屏幕控件ID去执行对应动作。所以整条链路是双向的发送命令用HAL_UART_Transmit接收触摸事件用中断加状态机。3. CubeMX里串口配置最容易出错的地方3.1 引脚不要和调试口打架F407上有多个串口比如USART1常用PA9/PA10USART2用PA2/PA3USART3用PB10/PB11USART6在PC6/PC7或PG14/PG9都是复用功能AF7。这个项目里最好单独分配一路UART给屏幕不要和调试printf共用。我之前偷懒把两个功能挤在同一个串口上调试信息把协议帧冲得乱七八糟排查了很久才发现是日志和屏幕数据混线了。各用各的串口一台设备负责打印一台设备负责屏幕互不干扰看起来少一根线实际能省无数时间。3.2 波特率数据位这些参数必须和屏幕配置完全一致大彩屏出厂的默认串口参数可能是9600/8/N/1也可能被配置成115200或者其他值。CubeMX里改串口参数很简单难的是别忘了把屏幕侧的配置也改过来。实际操作时我一般先确认屏幕工程里下载的波特率再回CubeMX填同样的值。参数不一致的典型症状是发送指令后屏幕上出现乱码字符或者干脆没反应。推荐用115200刷新页面和绘制图形时体感流畅距离短、干扰小稳定性完全够用。CubeMX里的USART设置Mode: Asynchronous Baud Rate: 115200 Word Length: 8 Bits Parity: None Stop Bits: 13.3 时钟树不对波特率误差能把屏幕坑到乱码串口的波特率不是凭空来的它由APB总线时钟分频得到。F407主频168MHz时APB2跑84MHzAPB1跑42MHz。如果CubeMX里时钟树配置不对比如PLL参数填错导致主频变成144MHz或者APB分频系数不对HAL库虽然还是会按当前时钟算出USARTDIV但误差可能迅速增大。串口波特率误差超过±2%后长时间传大帧时出错概率急剧上升。所以正确顺序是先配好时钟树把主频确认到168MHz再回到USART界面看CubeMX自动算出的误差。如果误差偏大优先检查时钟配置而不是盲目调波特率。3.4 中断优先级和DMA不是必选项但要知道什么时候用只做文字刷新和简单图形时阻塞收发完全没有问题。但如果你在屏幕上大量刷新曲线、图片或者频繁收触摸事件主循环里用HAL_UART_Transmit发长数据会卡住其他任务。解决办法是发送改用DMA接收用中断加状态机如果屏幕上报帧特别长比如一次传一批坐标数据还可以用串口空闲中断来处理HAL库对应接口是HAL_UARTEx_ReceiveToIdle_IT。中断优先级方面串口中断可以设高一些但别把硬实时任务挤掉具体看项目里哪些事情最不能被延迟。4. 一份可以直接改用的HAL驱动骨架4.1 发送封装把“组帧”和“发串口”拆开驱动代码我习惯分成两层上层业务只需要说“我要切页面2”底层函数负责拼成完整帧并调用HAL发送。这样接手项目的人只需要看业务函数不需要每处都拼一遍字节数组。先看头文件/* screen_drv.h */ #ifndef SCREEN_DRV_H #define SCREEN_DRV_H #include main.h void SCR_Init(void); void SCR_SendCmd(uint8_t cmd, const uint8_t *data, uint16_t len); void SCR_ProcessByte(uint8_t byte); void SCR_Task(void); #endif底层发送函数这样写/* screen_drv.c */ #include screen_drv.h extern UART_HandleTypeDef huart1; #define SCR_HEAD 0xAA #define SCR_TAIL_END1 0xCC #define SCR_TAIL_END2 0x33 #define SCR_TAIL_END3 0xC3 #define SCR_TAIL_END4 0x3C #define TX_BUF_SIZE 128 static uint8_t txbuf[TX_BUF_SIZE]; void SCR_SendCmd(uint8_t cmd, const uint8_t *data, uint16_t len) { uint16_t i 0; uint16_t total len 8; /* 帧头1 命令1 长度2 数据len 帧尾4 */ if (total TX_BUF_SIZE) { return; } txbuf[0] SCR_HEAD; txbuf[1] cmd; txbuf[2] (uint8_t)(len 8); txbuf[3] (uint8_t)(len 0xFF); for (i 0; i len; i) { txbuf[4 i] data[i]; } txbuf[4 len] SCR_TAIL_END1; txbuf[5 len] SCR_TAIL_END2; txbuf[6 len] SCR_TAIL_END3; txbuf[7 len] SCR_TAIL_END4; HAL_UART_Transmit(huart1, txbuf, total, 100); }这里命令字cmd是屏幕手册里定义好的比如切换页面可能是0x01设置文本可能是0x03。这个函数就是“通用压包机”不管什么命令只要传命令号和参数它就帮你把帧尾巴补齐发出去。4.2 接收状态机逐字节拆帧屏幕上报触摸事件时MCU很可能正在忙别的事情所以接收端最好用中断。HAL库里最朴素的做法是每次启动接收一个字节收到后进回调回调里启动下一次接收。字节流再交给一个状态机解析。初始化时static uint8_t rx_byte; void SCR_Init(void) { HAL_UART_Receive_IT(huart1, rx_byte, 1); }串口中断回调里这样处理void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { SCR_ProcessByte(rx_byte); HAL_UART_Receive_IT(huart1, rx_byte, 1); } }状态机拆帧的核心逻辑static uint8_t rx_state; static uint8_t rx_cmd; static uint8_t rx_len_h, rx_len_l; static uint16_t rx_len; static uint8_t rx_buf[128]; static uint16_t rx_index; void SCR_ProcessByte(uint8_t byte) { switch (rx_state) { case 0: /* 等待帧头 */ if (byte SCR_HEAD) rx_state 1; break; case 1: /* 读取命令字 */ rx_cmd byte; rx_state 2; break; case 2: /* 长度高字节 */ rx_len_h byte; rx_state 3; break; case 3: /* 长度低字节 */ rx_len_l byte; rx_len ((uint16_t)rx_len_h 8) | rx_len_l; rx_index 0; if (rx_len sizeof(rx_buf)) { rx_state 0; /* 非法长度重新等帧头 */ } else { rx_state 4; } break; case 4: /* 数据区 */ if (rx_index rx_len) { rx_buf[rx_index] byte; } if (rx_index rx_len) { rx_state 5; } break; case 5: if (byte SCR_TAIL_END1) rx_state 6; else rx_state 0; break; case 6: if (byte SCR_TAIL_END2) rx_state 7; else rx_state 0; break; case 7: if (byte SCR_TAIL_END3) rx_state 8; else rx_state 0; break; case 8: if (byte SCR_TAIL_END4) { /* 一帧完整上报数据到手 */ handle_screen_event(rx_cmd, rx_buf, rx_len); } rx_state 0; break; default: rx_state 0; break; } }这个状态机的思路是不关心“帧与帧之间有没有停顿”只关心“字节和下一个字节的关系”所以哪怕屏幕一次发来很多帧中间的字节也不会丢也不会被拆错。唯一要注意的就是数据区长度字段的位置和帧尾不同型号可能不同拿手册对一遍再改对应常量就行。4.3 长帧上报用空闲中断更稳如果屏幕一次会上报几十个字节比如触摸滑动轨迹逐字节中断加状态机虽然稳定但每个字节都进一次中断CPU占用偏高。STM32的串口空闲中断可以做到“等串口线空闲了再一次性读取接收缓冲区的所有数据”。HAL库实现起来很简单static uint8_t rx_dma_buf[256]; /* 初始化时调用 */ HAL_UARTEx_ReceiveToIdle_IT(huart1, rx_dma_buf, sizeof(rx_dma_buf));然后重写事件回调void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size) { if (huart-Instance USART1) { /* rx_dma_buf 里的前 Size 个字节是一帧完整数据 */ parse_screen_frame(rx_dma_buf, Size); HAL_UARTEx_ReceiveToIdle_IT(huart1, rx_dma_buf, sizeof(rx_dma_buf)); } }这个方案相当于把“拆帧”的活从MCU中断里搬到了DMA搬运效率高很多。但它要求屏幕上报的数据是完整的一包中间没有长时间停顿。如果屏幕上报命令里带流控或者分包发送还是得用逐字节状态机。4.4 DMA发送的注意事项把发送改成DMA后有一个跟阻塞方式完全不同的坑HAL_UART_Transmit_DMA是异步的函数返回时数据可能还没发完所以你传进去的缓冲区必须保持有效不能被栈变量覆盖。最安全的做法是把要发送的数据先拷贝到一个静态数组再启动DMA。另一个坑是上一次DMA还没发完你又启动了新一次HAL库会直接返回Busy错误。发送前可以加个判断void SCR_SendDMA(uint8_t *buf, uint16_t len) { while (HAL_UART_GetState(huart1) ! HAL_UART_STATE_READY); HAL_UART_Transmit_DMA(huart1, buf, len); }5. 实测调用顺序上电、切页、刷新文本、收触摸5.1 上电时序不能省略大彩屏上电后内部的处理器和显示驱动也需要时间启动如果MCU和屏幕同时上电MCU立刻发命令屏幕可能根本没准备好命令直接丢。稳妥的上电流程是这样的给MCU和屏幕供电MCU延时300ms以上等屏幕内核稳定如果屏幕模块有复位引脚拉低50ms再拉高发送第一条命令前可以先发一个“读取固件版本”之类的查询命令返回正常后再继续。实际开发时我习惯把这段初始化放在项目启动的main函数里屏幕未就绪期间只亮背光不操作避免一上电就发一堆无效数据。5.2 切页和刷文本的顺序组态软件里把页面和控件ID设计好之后MCU这边的操作其实特别简单。切到第2页按前面封装的函数写就是uint8_t page_data[2]; page_data[0] 0x00; page_data[1] 0x02; SCR_SendCmd(0x01, page_data, 2); /* 0x01是页面切换命令 */刷新某个文本控件假设控件ID是10显示内容为“25.6”char text_buf[8]; uint8_t data[4]; sprintf(text_buf, %.1f, temper); /* 25.6 */ data[0] 0x00; data[1] 10; /* 控件ID */ data[2] 0x00; data[3] strlen(text_buf); /* 字符串长度 */ SCR_SendCmd(0 p a hrefhttps://download.csdn.net/download/qq_52619462/77385602 stylecolor:#ec7500;font-size:14px; 本文还有配套的精品资源点击获取 /a img altmenu-r.4af5f7ec.gif srchttps://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif stylewidth:16px;margin-left:4px;vertical-align:text-bottom;cursor:text; /p
