STM32 HAL库串口通信实战：从点灯到串口屏交互开发

简介：本资源是一套基于STM32G030C8T6与中显串口屏SDWn035T63T的嵌入式人机交互实战项目，面向单片机初学者及HAL库进阶开发者，解决串口屏通信、多传感器融合控制与LED动态调光等典型工程问题。压缩包共1048个文件，涵盖567个C源码、243个头文件（含硬件驱动与GUI逻辑）、30余个编译中间文件（.o/.d）及26个图像资源（.bmp/.img），另有Keil工程配置（.uvprojx/.ioc）、固件镜像（.bin/.hex）和数学库支持文件（.a/.lib），整体大小26.85MB。已有1796人学习下载，配套B站实操视频完整演示按键控制、呼吸灯、光敏调光、温光数据实时刷新等全部功能。读者可直接复现完整系统：包含立创EDA设计的主控板与灯板原理图、DS18B20+GY-30双传感器驱动、4路LED差异化控制策略及串口屏VGUS协议解析代码，具备良好可扩展性与定制化基础。

1. 项目概述：从点灯到串口屏交互的跨越

搞嵌入式开发的朋友，对“点灯”这个操作肯定再熟悉不过了。它就像是程序员的“Hello World”，是验证硬件、软件环境是否正常工作的第一步。但今天我们要聊的，远不止是让一个LED闪烁那么简单。这个项目的核心，是让STM32这颗“大脑”，通过串口（UART）与一块“中显串口屏”进行对话，并最终通过屏幕上的一个虚拟按钮，来控制一个真实的LED灯。这看似简单的“点灯”背后，实际上完成了一次从单片机到人机交互界面的完整通信链路搭建。

为什么说这是一个有意义的跨越？传统的点灯，我们可能通过按键、定时器或者简单的串口命令来控制，交互方式原始且信息有限。而引入串口屏后，我们获得了一个图形化、可定制、信息丰富的交互前端。你可以设计漂亮的界面，显示传感器数据，设置复杂的参数，并通过触摸屏进行控制。这对于智能家居控制面板、工业设备操作台、仪器仪表显示等场景来说，是刚需。STM32 HAL库的引入，则大大简化了我们对底层硬件的操作，让我们能更专注于应用逻辑的开发，而不是纠结于寄存器配置的细节。

所以，这个项目适合两类朋友：一是已经熟悉STM32基本操作，想进阶学习如何与外部智能模块通信的开发者；二是正在寻找一种快速、低成本为嵌入式设备添加友好人机界面方案的工程师。通过这个项目，你将掌握STM32 HAL库串口通信的核心配置、理解与串口屏的通信协议、并实现一个完整的“屏控硬件”的闭环。

2. 核心思路与通信协议解析

要实现STM32与串口屏的通信并控制LED，我们需要先理清整个数据流的逻辑。这不是一个单向的“发指令-执行”过程，而是一个包含触发、反馈的交互循环。

2.1 系统工作流程拆解

整个系统的运行，可以分解为以下几个核心步骤：

1. 初始化：STM32上电后，初始化系统时钟、GPIO（用于控制LED）、串口外设（用于与屏幕通信）。
2. 界面触发：用户在串口屏上设计好的界面中，点击一个“按钮”控件。
3. 指令下发：串口屏检测到触摸事件后，根据预先的设置，通过串口TX线向STM32发送一条约定好的指令数据。
4. 指令接收与解析：STM32的串口外设在中断或轮询模式下，接收到这条指令，并将其存入缓冲区。
5. 指令处理：STM32的主程序解析缓冲区中的数据。例如，判断指令是否是“开灯”命令（如收到字节0x01），或者“关灯”命令（如收到字节0x00）。
6. 执行控制：根据解析结果，STM32通过HAL库的GPIO写函数，控制连接LED的引脚输出高电平（点亮）或低电平（熄灭）。
7. 状态反馈（可选但推荐）：STM32在改变LED状态后，可以通过串口再向屏幕发送一条状态更新指令，让屏幕上的按钮图标或文字颜色随之改变（例如，灯亮时按钮显示为绿色，灯灭时显示为灰色），实现视觉反馈，提升用户体验。

这个流程的关键在于第3步和第5步：通信协议。STM32和屏幕必须说同一种“语言”。

2.2 串口屏通信协议浅析

市面上主流的串口屏（如大彩、迪文、淘晶驰等）虽然各有自己的上位机配置软件和指令集，但其底层通信本质都是基于串口的自定义协议。协议通常包含以下几个部分：

• 帧头：用于标识一帧数据的开始，常见的有0xAA、0x5A、0xA5等，用于在数据流中进行帧同步。
• 指令/地址码：指明这条指令要做什么。比如，0x01代表“写寄存器”，0x03代表“读寄存器”。对于触摸事件，屏幕通常会自动发送控件ID和事件类型。
• 数据长度：指示后面跟随的有效数据有多少个字节。
• 数据域：具体的控制参数或信息。例如，要写入的寄存器地址、要显示的文本内容、或者是控件的状态值。
• 校验和：用于验证数据传输过程中是否出错，常见的有和校验、异或校验、CRC校验等。接收方会重新计算校验和并与接收到的进行比对。

对于本项目，我们为了简化，可以和屏幕约定一个极其简单的协议。例如，我们在屏幕上做一个按钮，设置其“按下发送数据”为0x01，另一个按钮发送0x00。这样，STM32只需要判断接收到的字节是0x01还是0x00即可。

注意：在实际复杂项目中，必须严格按照屏幕厂商提供的协议手册来组包和解包数据。简单协议仅适用于学习和快速验证。

2.3 为什么选择HAL库？

STM32的开发库主要有标准外设库（Standard Peripheral Library）和硬件抽象层库（Hardware Abstraction Layer, HAL）。HAL库是ST主推的新一代库，优势明显：

• 跨系列兼容性：HAL库的API在不同系列的STM32芯片上高度统一，项目移植成本低。
• CubeMX集成：通过STM32CubeMX图形化工具，可以一键生成包含HAL库的初始化代码，极大提升开发效率，避免繁琐的底层配置。
• 中间件支持：HAL库是ST生态（如FreeRTOS, USB, FATFS等中间件）的基础。
• 维护性：ST持续维护和更新HAL库，而标准库已停止更新。

对于串口通信这种常用外设，HAL库提供了HAL_UART_Transmit(),HAL_UART_Receive(),HAL_UART_Receive_IT()（中断接收）,HAL_UART_Receive_DMA()（DMA接收）等一系列函数，封装完善，使用起来比直接操作寄存器或标准库更直观、安全。

3. 硬件连接与工程环境搭建

在写代码之前，正确的硬件连接和软件开发环境是成功的基石。

3.1 硬件清单与接线

你需要准备以下硬件：

1. STM32最小系统板（如STM32F103C8T6，即常见的“蓝色药丸”板）。
2. 中显串口屏（型号不限，需支持UART通信，如带TJC、DWIN、USART HMI等标识的屏幕）。
3. USB转TTL串口模块（用于调试和可能给屏幕下载工程）。
4. LED灯和限流电阻（通常开发板已自带用户LED，如PC13）。
5. 杜邦线若干。

接线示意图（关键部分）：

串口屏的TX引脚 ----> STM32的串口RX引脚 (例如：PA10, 如果使用USART1) 串口屏的RX引脚 ----> STM32的串口TX引脚 (例如：PA9, 如果使用USART1) 串口屏的GND引脚 ----> STM32的GND引脚 串口屏的VCC引脚 ----> STM32的5V或3.3V引脚 (请严格参照屏幕规格书供电！) STM32的LED控制引脚 (例如：PC13) ----> LED阳极，LED阴极接GND（若使用板载LED则无需额外接线）

实操心得：接线时务必先断电！串口屏的供电电压一定要看清，有的是5V，有的是3.3V，接错极易烧毁屏幕。TX/RX要交叉连接，即屏的TX接MCU的RX。如果通信不正常，首先用USB转TTL模块连接电脑，用串口助手工具测试屏幕本身是否能正常发送数据，这是最有效的排查方法。

3.2 使用STM32CubeMX创建工程

1. 打开CubeMX，选择MCU型号：例如 STM32F103C8Tx。
2. 配置系统核心（SYS）：在“SYS”选项卡中，将“Debug”设置为“Serial Wire”（如果要用ST-Link调试）。
3. 配置时钟（RCC）：在“RCC”选项卡中，将高速外部时钟（HSE）选择为“Crystal/Ceramic Resonator”，为系统提供准确时钟源。
4. 配置时钟树：点击“Clock Configuration”标签，通常对于F103，可以直接输入72，然后按回车，软件会自动配置PLL，将系统时钟（HCLK）设置为72MHz。这是F1系列的一个常见高性能配置。
5. 配置GPIO：找到控制LED的引脚（如PC13），将其设置为“GPIO_Output”。模式为“Output Push Pull”，上拉/下拉根据电路选择（通常默认即可），输出速度“Low”即可。
6. 配置串口：
   • 以USART1为例，在左侧引脚图中找到PA9和PA10，将PA9设置为“USART1_TX”，PA10设置为“USART1_RX”。
   • 在左侧“Connectivity”中找到USART1，模式选择“Asynchronous”（异步通信）。
   • 配置参数：波特率（常用115200）、字长（8位）、停止位（1位）、无奇偶校验、无硬件流控。这些参数必须与串口屏的设置完全一致。
   • 最关键的一步：开启串口全局中断。在“NVIC Settings”选项卡中，勾选“USART1 global interrupt”的使能复选框。这样我们才能使用中断方式接收数据，不阻塞主程序。
7. 生成代码：
   • 转到“Project Manager”选项卡，设置项目名称、路径、IDE（如MDK-ARM V5）。
   • 在“Code Generator”中，选择“Copy only necessary library files”以减小工程体积，勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”让代码更模块化。
   • 点击“GENERATE CODE”，生成Keil工程。

3.3 串口屏界面设计（以简单按钮为例）

不同的串口屏使用不同的上位机软件（如迪文的DGUS，淘晶驰的USART HMI）。但基本逻辑相通：

1. 新建一个工程，选择与你的屏幕型号匹配的分辨率。
2. 从控件工具箱中，拖放一个“按钮”控件到画布上。
3. 双击按钮，进入属性设置。你需要关注两个核心属性：
   • 控件ID：给这个按钮一个唯一的编号，比如1。
   • 按下/弹起发送数据：这是核心。设置当按钮被按下时，通过串口发送什么数据。为了简单，我们可以直接设置为“十六进制发送”，数据为01 0A（假设01是开灯指令，0A是自定义的帧尾）。或者更简单地，只发送一个字节0x01。具体格式需参考屏幕的指令手册。
4. 同理，再做一个“关灯”按钮，设置发送数据为00 0A或0x00。
5. 设计完成后，将工程编译并下载到串口屏中（通常通过SD卡或USB口）。

4. 核心代码实现与解析

打开CubeMX生成的Keil工程，我们主要在main.c和stm32f1xx_it.c（中断服务函数文件）中添加业务逻辑。

4.1 全局变量与宏定义

在main.c的顶部，用户代码区添加：

/* Private variables ---------------------------------------------------------*/ UART_HandleTypeDef huart1; // CubeMX已声明 /* Private user code ---------------------------------------------------------*/ #define LED_PIN GPIO_PIN_13 #define LED_PORT GPIOC #define CMD_LED_ON 0x01 #define CMD_LED_OFF 0x00 uint8_t uart_rx_buffer[1]; // 用于中断接收的缓冲区 uint8_t received_cmd = 0; // 存储接收到的命令

这里我们定义了一个大小为1的接收缓冲区，因为我们的简易协议每次只发送一个命令字节。received_cmd用于在主循环中判断执行什么操作。

4.2 主函数初始化后开启串口接收中断

在main()函数中，系统初始化之后，用户代码开始处（/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间），启动串口接收中断。

/* USER CODE BEGIN 2 */ // 启动串口1以中断方式接收数据，每次接收1个字节，存入uart_rx_buffer if (HAL_UART_Receive_IT(&huart1, uart_rx_buffer, 1) != HAL_OK) { // 如果启动失败，可以在这里处理错误，比如让LED闪烁报警 Error_Handler(); } // 先关闭LED HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_SET); // 假设LED是低电平点亮，高电平熄灭 /* USER CODE END 2 */

HAL_UART_Receive_IT函数会启动一次中断接收，当收到1个字节后，会触发串口接收完成中断，执行回调函数，然后需要再次调用此函数以准备接收下一个字节。

4.3 编写串口接收完成回调函数

HAL库采用回调机制。当串口接收完成一个字节（或指定长度）的数据后，会自动调用HAL_UART_RxCpltCallback函数。我们需要重写这个函数。

在main.c文件中，/* USER CODE BEGIN 4 */和/* USER CODE END 4 */之间添加：

/* USER CODE BEGIN 4 */ /** * @brief 串口接收完成中断回调函数 * @param huart: 串口句柄 * @retval None */ void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { // 判断是否是USART1触发的中断 if (huart->Instance == USART1) { // 将接收到的字节赋值给命令变量 received_cmd = uart_rx_buffer[0]; // 再次启动中断接收，准备接收下一个字节（循环） HAL_UART_Receive_IT(&huart1, uart_rx_buffer, 1); } } /* USER CODE END 4 */

这个函数是中断服务程序的一部分，执行时间要尽可能短。我们只做最简单的数据搬运和重新使能接收中断的操作，复杂的解析和处理放到主循环中。

4.4 主循环中的命令解析与执行

最后，在main()函数的while (1)循环中，我们不断检查received_cmd变量，并执行相应的操作。

/* USER CODE BEGIN WHILE */ while (1) { /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ // 解析并执行接收到的命令 switch(received_cmd) { case CMD_LED_ON: HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_RESET); // 点亮LED received_cmd = 0; // 清除命令，避免重复执行 // 可选：发送状态反馈给屏幕 // uint8_t feedback[] = {0xAA, 0x01, 0x01, 0xAC}; // 示例反馈帧 // HAL_UART_Transmit(&huart1, feedback, sizeof(feedback), 100); break; case CMD_LED_OFF: HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_SET); // 熄灭LED received_cmd = 0; // 清除命令 // 可选：发送状态反馈给屏幕 // uint8_t feedback[] = {0xAA, 0x01, 0x00, 0xAB}; // HAL_UART_Transmit(&huart1, feedback, sizeof(feedback), 100); break; default: // 接收到未知命令，可以忽略或做错误处理 break; } // 这里可以添加其他任务，如传感器读取等 HAL_Delay(10); // 短暂延时，防止CPU占用率过高 } /* USER CODE END 3 */

注意事项：在主循环中处理命令，而不是在中断回调函数中直接控制GPIO，是一个好习惯。这符合“快进快出”的中断设计原则，避免在中断服务程序中执行耗时操作，影响系统对其他中断的响应。同时，通过received_cmd这个“标志”进行通信，也是裸机编程中常见的任务间通信方式。

5. 调试技巧与常见问题排查

即使代码和接线都看似正确，第一次尝试也难免遇到问题。下面是一些实战中总结的排查思路。

5.1 通信失败的“三板斧”排查法

1. 查硬件：

   • 供电：用万用表测量屏幕VCC引脚电压是否正确稳定。
   • 接线：TX/RX是否交叉连接？GND是否共地？这是最常见的问题。
   • 引脚冲突：检查STM32的串口引脚是否被其他功能（如JTAG）复用了。例如PA15、PB3、PB4默认是JTAG引脚，如果要用作普通IO或串口，需要在CubeMX的SYS里禁用JTAG，选择SWD模式。

2. 查配置：

   • 波特率：STM32的串口波特率必须与屏幕设置的波特率精确一致。115200和9600差一点都会导致乱码。建议双方都设置为9600或115200这种常用值。
   • 数据格式：数据位（8位）、停止位（1位）、校验位（无）必须完全匹配。
   • 中断优先级：如果系统中有多个中断，需合理配置NVIC优先级，避免高优先级中断阻塞串口中断。

3. 查数据：

   • 逻辑分析仪/示波器：这是终极武器。直接抓取串口屏TX引脚发出的波形，看其波特率、数据内容是否与预期一致。
   • 串口助手旁路测试：将串口屏的TX线暂时接到USB转TTL模块上，连接电脑，用串口助手（如XCOM，SecureCRT）接收数据。点击屏幕按钮，看电脑是否能收到正确的指令数据。这能直接证明屏幕本身工作是否正常、指令设置是否正确。

5.2 代码层面的常见坑点

• 未重新使能中断接收：在HAL_UART_RxCpltCallback回调函数中，必须再次调用HAL_UART_Receive_IT，否则串口只会接收一次数据。
• 缓冲区溢出：如果屏幕发送数据很快，而主循环处理很慢，可能导致uart_rx_buffer在被处理前就被新的数据覆盖。对于多字节协议，需要使用环形缓冲区（Ring Buffer）来安全地存储数据。我们的单字节例子简单，但扩展到复杂协议时必须考虑。
• HAL库延时问题：避免在中断回调函数中使用HAL_Delay()，这个函数依赖于系统滴答定时器（SysTick），在中断中使用可能导致系统卡死。
• 变量共享冲突：received_cmd在中断回调（写）和主循环（读）中被共同访问。虽然在这个简单例子中，一个字节的读写是原子的，不会出大问题。但在更复杂的系统中，对于多字节变量或结构体，需要考虑使用临界区保护或禁止中断来防止读写冲突。

5.3 功能扩展与优化建议

当基础功能实现后，可以考虑以下优化，让项目更健壮、更实用：

1. 协议规范化：实现一个完整的帧解析函数，包含帧头判断、长度校验、和校验/CRC校验。这能极大提高通信的可靠性。
2. 超时与重发机制：在发送指令给屏幕后，启动一个定时器，如果超时未收到应答，则进行重发或错误处理。
3. 使用DMA接收：对于数据量较大或频率较高的通信（如实时刷新数据），使用DMA代替中断接收可以大大减轻CPU负担。CubeMX可以方便地配置串口DMA。
4. 加入状态反馈：如前所述，在控制LED后，主动发送其状态给屏幕，更新界面显示，实现真正的双向交互。
5. 整合简单调度器：如果后续需要增加其他任务（如读取传感器、扫描按键），可以考虑引入一个像protothreads或简单的状态机，让主循环结构更清晰。

通过这个从“点灯”到“串口屏通信”的项目，你不仅掌握了HAL库串口通信的基本操作，更重要的是理解了嵌入式系统中“感知-决策-控制-反馈”的闭环思想。串口屏作为一个强大的交互终端，其潜力远不止控制一个LED。你可以轻松地将其扩展为数据显示终端（温湿度、电压电流）、参数设置界面（PID参数、阈值设置）、甚至简单的游戏菜单。下次当你需要为你的STM32项目添加一个界面时，不妨就从这块串口屏开始。

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