当前位置：首页 > news >正文

嵌入式空气检测仪串口屏HMI开发实战：STM32与大彩屏通信协议解析

news 2026/6/4 4:08:05

1. 项目概述：当空气检测仪遇上串口屏

最近在做一个空气检测仪的项目，客户对显示界面的要求不低，既要能实时显示PM2.5、甲醛、温湿度、TVOC等一堆数据，又希望界面美观、操作流畅，最好还能支持历史曲线查看和参数设置。如果用传统的单片机驱动段码屏或者点阵屏，开发周期长，UI设计更是噩梦。这时候，一个成熟的串口屏解决方案就成了最优选。我们最终选用了大彩串口屏，它本质上是一个集成了显示驱动、图形处理和触摸功能的独立模块，主控MCU只需要通过简单的串口指令，就能控制它显示丰富的界面和响应触摸事件，把开发者从繁琐的底层GUI开发中彻底解放出来。

这个方案的核心价值在于“解耦”。空气检测仪的主控芯片（比如常见的STM32、ESP32）可以专心处理传感器数据采集、算法分析和逻辑控制，而所有关于“显示”和“人机交互”的脏活累活，全部丢给串口屏。两者之间仅通过TX、RX、GND三根线（如果不需要触摸反馈，甚至两根线也行）进行通信，极大简化了硬件连接和软件架构。对于空气检测仪这类需要频繁更新数据、且对UI友好性有要求的设备来说，这种分工协作的模式效率极高。

2. 方案选型与核心设计思路

2.1 为什么选择串口屏而非其他方案？

在空气检测仪的人机界面（HMI）方案上，通常有几个备选：裸屏+驱动芯片、带GUI库的MCU、以及串口屏。我们来做个快速对比：

裸屏+驱动芯片（如SPI/I2C接口的OLED、TFT）：
- 优点：成本最低，硬件尺寸灵活。
- 缺点：所有图形绘制、字体显示、触摸处理逻辑都需要在主MCU上实现，极度消耗MCU的RAM、Flash和CPU资源。开发一个带多级菜单、滑动、动画的界面，工作量巨大，且后期UI修改等于重写代码。
- 结论：适合显示内容极其简单、静态，且对成本极度敏感的场景。对于功能复杂的空气检测仪，这基本是条“苦力”路线。
高性能MCU+GUI库（如LVGL、emWin）：
- 优点：灵活性最高，可实现任何酷炫效果，与主控逻辑结合紧密。
- 缺点：对MCU性能要求高（通常需要Cortex-M4以上，且RAM>128KB），GUI库本身有学习成本，开发调试周期长。UI和业务逻辑代码混杂，维护复杂度高。
- 结论：适合有专业GUI开发团队、对UI效果和性能有极致追求，且硬件资源充足的大型项目。
串口屏（如大彩、迪文、淘晶驰等品牌）：
- 优点：
  1. 开发极简：主MCU只需发送串口指令，如“在坐标(100,50)处显示数字123”。UI设计在PC端专用软件上通过拖拽完成，所见即所得。
  2. 资源解放：不占用主MCU的图形处理资源，低端MCU（如STM32F103）也能驾驭复杂UI。
  3. 稳定可靠：屏体自带独立处理器和Flash，运行稳定，抗干扰能力强。
  4. 快速迭代：UI修改只需在PC软件调整后更新屏内工程文件，无需改动主控代码。
- 缺点：硬件成本比裸屏方案高；通信速率受串口限制，大量图片刷新时可能有延迟。
- 结论：在开发效率、稳定性、UI复杂度之间取得了最佳平衡，是空气检测仪这类消费级或工业级嵌入式产品的“甜点”方案。

注意：选择大彩，一方面是因其开发工具（Lua脚本、C脚本支持）和社区资料相对丰富，另一方面是其产品线齐全，从低成本到高性能都有覆盖，方便后续产品升级选型。

2.2 空气检测仪的系统架构设计

基于串口屏的方案，整个系统的架构变得非常清晰：

[传感器阵列] -> [主控MCU] <-UART-> [大彩串口屏] <-用户-> (PM2.5,甲醛,温湿度) (数据处理、逻辑) (显示与触摸交互)

数据流：传感器数据经主控MCU采集、校准、处理后，封装成预定义的串口指令帧，定时或触发式发送给串口屏。
指令流：串口屏解析指令，更新屏幕上对应的文本、进度条、曲线图等控件。
交互流：用户在屏幕上点击按钮、滑动滑块，串口屏将这些触摸事件编码成指令帧，发送给主控MCU。MCU解析后执行相应的功能，如切换页面、设置报警阈值、开关风扇等。

这种架构下，主控MCU的程序几乎就是一个“串口命令调度器”，逻辑非常纯粹。我们甚至可以为串口屏的通信协议封装一个独立的、高内聚的驱动层，使得业务逻辑代码异常清晰。

3. 核心细节解析与实操要点

3.1 大彩串口屏开发流程拆解

使用大彩串口屏的开发，主要分为两个并行且相对独立的部分：屏端UI工程开发和主控端通信协议实现。

屏端开发（使用大彩的VisualTFT或Luatools软件）：

新建工程：选择对应的屏型号（如DMG80480C070_03WTC）和分辨率。
UI设计：在画布上拖放控件。对于空气检测仪，核心控件包括：
- 文本控件：用于显示数值（如“PM2.5: 25 μg/m³”）。需要设置字体、颜色、对齐方式，并记住其“变量名”（如txt_pm25）。
- 进度条/仪表盘控件：直观展示污染物浓度等级。可设置范围、颜色分段（绿/黄/红）。
- 曲线图控件：用于绘制PM2.5、温度等参数的历史趋势曲线。需要配置时间轴、数值轴、曲线颜色等。
- 按钮控件：用于页面切换、功能操作（如“校准”、“静音”）。每个按钮可以关联一个“触摸事件”。
- 图片控件：显示背景、图标、动画帧。
事件与脚本：这是进阶功能。例如，点击一个“详情”按钮，跳转到历史曲线页面。这个跳转逻辑可以直接在屏端的Lua脚本中编写，无需主控干预，减轻了主控负担。
变量关联：将控件（如文本控件txt_pm25）与一个“变量地址”绑定。这个地址是主控MCU通过串口指令读写该控件内容的唯一标识。
编译与下载：将设计好的UI工程编译成二进制文件，通过USB或SD卡下载到串口屏的Flash中。

主控端开发：

硬件连接：连接主控MCU的UART_TX到屏的RX，UART_RX到屏的TX，并共地。注意电平匹配（通常是3.3V TTL）。
协议驱动实现：根据大彩的《串口指令手册》，实现核心指令的发送函数。最常用的指令是“写变量值”和“读触摸事件”。
数据封装与发送：定时（如每秒）将传感器数据，按照协议格式，调用“写变量值”指令，更新到屏上对应的变量地址。
触摸事件解析：在串口接收中断中，解析屏上传来的触摸事件报文，获取被按下的按钮ID或滑块值，并执行相应回调函数。

3.2 通信协议：指令集与数据帧解析

大彩屏通常支持两种协议模式：基本指令集和Modbus RTU。对于空气检测仪，基本指令集更常用，也更灵活。

一个典型的“写变量值”指令帧（用于更新显示）结构如下（十六进制）：

AA 69 [地址高位] [地址低位] [数据长度] [数据...] [校验和] CC 33 C3 3C

AA 69：帧头。
地址：16位，对应UI工程中控件绑定的变量地址。
数据长度：后续数据字节数。
数据：要写入的内容。如果是文本，就是字符串的ASCII码；如果是数值，可能是按字节拆分。
校验和：从“地址高位”到“数据”最后一个字节的累加和（取低8位）。
CC 33 C3 3C：帧尾。

例如，要向地址0x1000（对应PM2.5显示文本框）写入数值“35”，指令可能是：AA 69 10 00 02 00 23 B5 CC 33 C3 3C（假设00 23是整数35的十六进制，B5是校验和）。

触摸事件上报的帧格式类似，其中会包含事件类型（按下、释放）和控件ID。

实操心得：务必自己编写一个轻量级的协议解析状态机，而不要简单用scanf或字符串匹配。因为串口数据是流式的，可能存在粘包、断包。状态机（状态：找帧头、收长度、收数据、验校验）是嵌入式领域处理这类自定义协议的标准且可靠的方法。

3.3 UI设计中的性能与体验优化

空气检测仪的UI设计并非简单的控件堆砌，需要考虑用户体验和性能。

数据更新策略：
- 定时轮询 vs 变化触发：对于温湿度这类变化较慢的数据，可以每2-3秒更新一次。对于PM2.5，可能每秒更新。更优的策略是，主控端判断数值是否发生“有意义”的变化（如变化超过阈值），再发送更新指令，减少不必要的串口通信。
- 局部刷新：大彩屏支持指定区域刷新。如果只是更新一个小数字，可以只刷新该文本控件所在的矩形区域，而不是整屏或整个页面刷新，速度更快。
界面布局与交互逻辑：
- 主界面：突出核心数据（PM2.5、甲醛、AQI），用大字体和颜色编码（绿/黄/红）直观显示空气质量等级。辅以温湿度、时间等次要信息。
- 二级界面：通过底部导航栏或侧滑菜单进入。包括历史曲线（支持按小时/日/周查看）、设备设置（报警阈值、Wi-Fi配置）、关于页面等。
- 动画与反馈：在数据刷新时，可以添加简单的淡入淡出或数字滚动动画（这通常需要在屏端用Lua脚本实现）。按钮按下时应有明显的视觉反馈（颜色变化）。
字体与图片处理：
- 字体：优先使用屏厂提供的点阵字体工具生成字体文件，体积小，显示速度快。避免使用过多、过大的TrueType字体，会占用大量Flash并影响加载速度。
- 图片：所有UI图片务必在PC端工具中进行优化和索引色处理，转换为屏支持的格式（如RGB565，索引色）。一张未经优化的全屏BMP图片可能几百KB，而优化后可能只有几十KB，这对屏的启动速度和内存占用至关重要。

4. 实操过程与核心环节实现

4.1 硬件连接与驱动层代码实现

假设我们使用STM32F103作为主控，通过USART1连接大彩串口屏。

硬件连接：

STM32 USART1_TX (PA9) -> 串口屏 RX
STM32 USART1_RX (PA10) -> 串口屏 TX
GND -> GND

驱动层代码（伪代码/思路）：

// uart_hmi.h #define HMI_UART &huart1 #define HMI_RX_BUF_SIZE 256 typedef enum { HMI_EVT_BTN_PRESS = 0, HMI_EVT_BTN_RELEASE, HMI_EVT_SLIDER_CHANGE, // ... 其他事件类型 } hmi_event_type_t; typedef struct { hmi_event_type_t type; uint16_t widget_id; // 控件ID uint32_t value; // 对于滑块，是当前值 } hmi_event_t; typedef void (*hmi_event_callback_t)(hmi_event_t *evt); void hmi_init(void); void hmi_send_cmd(const uint8_t *cmd, uint16_t len); bool hmi_write_word(uint16_t addr, uint16_t data); // 写16位变量 bool hmi_write_string(uint16_t addr, const char *str); // 写字符串 void hmi_register_callback(hmi_event_callback_t cb); void hmi_rx_irq_handler(void); // 在串口中断中调用

// uart_hmi.c static uint8_t s_rx_buf[HMI_RX_BUF_SIZE]; static uint16_t s_rx_index = 0; static hmi_event_callback_t s_event_cb = NULL; // 协议解析状态机状态 static enum {STATE_HEADER1, STATE_HEADER2, STATE_LEN, STATE_DATA, STATE_CHECK, STATE_TAIL} s_state = STATE_HEADER1; void hmi_init(void) { // 使能串口接收中断 HAL_UART_Receive_IT(HMI_UART, s_rx_buf, 1); // 每次接收一个字节，在中断中处理 } void hmi_send_cmd(const uint8_t *cmd, uint16_t len) { HAL_UART_Transmit(HMI_UART, cmd, len, 1000); } bool hmi_write_word(uint16_t addr, uint16_t data) { uint8_t cmd[13] = {0xAA, 0x69}; cmd[2] = (addr >> 8) & 0xFF; cmd[3] = addr & 0xFF; cmd[4] = 0x02; // 数据长度：2字节 cmd[5] = (data >> 8) & 0xFF; cmd[6] = data & 0xFF; // 计算校验和 (cmd[2] 到 cmd[6]的累加和低8位) uint8_t sum = 0; for(int i=2; i<=6; i++) sum += cmd[i]; cmd[7] = sum; cmd[8] = 0xCC; cmd[9]=0x33; cmd[10]=0xC3; cmd[11]=0x3C; // 帧尾 hmi_send_cmd(cmd, 12); return true; } // 在串口接收中断回调函数中调用此函数 void hmi_rx_irq_handler(void) { uint8_t byte = s_rx_buf[0]; // 获取刚收到的字节 static uint8_t data_len, data_cnt; static uint8_t checksum_calc; switch(s_state) { case STATE_HEADER1: if(byte == 0xAA) s_state = STATE_HEADER2; break; case STATE_HEADER2: if(byte == 0x69) s_state = STATE_LEN; else s_state = STATE_HEADER1; // 同步失败，重新开始 break; case STATE_LEN: data_len = byte; data_cnt = 0; checksum_calc = 0; // 开始计算校验和 s_state = STATE_DATA; break; case STATE_DATA: // 将数据存入临时缓冲区... checksum_calc += byte; data_cnt++; if(data_cnt >= data_len) { s_state = STATE_CHECK; } break; case STATE_CHECK: if(byte == checksum_calc) s_state = STATE_TAIL; else s_state = STATE_HEADER1; // 校验失败，丢弃 break; case STATE_TAIL: // 验证后续的 0xCC 0x33 0xC3 0x3C ... // 如果帧尾正确，一帧数据接收完成，开始解析触摸事件 if(完整帧接收成功) { hmi_parse_event_frame(临时缓冲区); } s_state = STATE_HEADER1; // 重置状态机，准备接收下一帧 break; } // 重新启动接收中断，等待下一个字节 HAL_UART_Receive_IT(HMI_UART, s_rx_buf, 1); }

4.2 应用层数据同步与业务逻辑

在主程序的应用层，我们只需要关注业务逻辑和调用驱动层提供的接口。

// main.c 或 app_air_quality.c static uint16_t g_pm25_value = 0; static float g_temperature = 25.0f; static float g_humidity = 50.0f; // 定义UI控件变量地址 (这些地址需与屏端工程严格对应) #define ADDR_PM25_VALUE 0x1000 #define ADDR_TEMP_VALUE 0x1002 #define ADDR_HUMI_VALUE 0x1004 #define ADDR_AQI_LEVEL 0x1010 // AQI等级图标变量 #define BTN_ID_HISTORY 0x0001 // 历史按钮ID void sensor_data_update_task(void) { // 1. 读取传感器数据（模拟或真实I2C/SPI读取） g_pm25_value = read_pm25_sensor(); g_temperature = read_temp_sensor(); g_humidity = read_humi_sensor(); // 2. 更新串口屏显示 hmi_write_word(ADDR_PM25_VALUE, g_pm25_value); hmi_write_word(ADDR_TEMP_VALUE, (uint16_t)(g_temperature * 10)); // 放大10倍传输，保留一位小数 hmi_write_word(ADDR_HUMI_VALUE, (uint16_t)(g_humidity * 10)); // 3. 根据PM2.5值更新AQI等级图标（屏端可通过Lua脚本根据变量值自动切换图片，也可主控控制） uint16_t aqi_level = calculate_aqi_level(g_pm25_value); hmi_write_word(ADDR_AQI_LEVEL, aqi_level); // 0:优, 1:良, 2:轻度污染... } // 触摸事件回调函数 void on_hmi_event(hmi_event_t *evt) { switch(evt->type) { case HMI_EVT_BTN_PRESS: if(evt->widget_id == BTN_ID_HISTORY) { // 用户按下了“历史”按钮 // 发送指令让串口屏切换到历史曲线页面（页面ID=2） uint8_t cmd[] = {0xAA, 0x69, 0x00, 0x80, 0x02, 0x00, 0x02, 0x84, 0xCC, 0x33, 0xC3, 0x3C}; // 写系统变量“当前页面” hmi_send_cmd(cmd, sizeof(cmd)); } break; case HMI_EVT_SLIDER_CHANGE: // 处理滑块值变化，例如调节屏幕亮度 set_screen_brightness(evt->value); break; default: break; } } int main(void) { // 硬件初始化... hmi_init(); hmi_register_callback(on_hmi_event); // 注册触摸事件回调 while(1) { sensor_data_update_task(); HAL_Delay(1000); // 每秒更新一次数据 // 其他系统任务... } }

5. 常见问题与排查技巧实录

在实际开发中，一定会遇到各种问题。以下是一些典型问题及解决方法：

5.1 通信类问题

问题1：屏幕无显示或显示乱码。

排查步骤：
1. 查电源：首先确认屏幕供电是否稳定、足额（电流是否足够）。大尺寸屏上电瞬间电流较大。
2. 查接线：TX/RX是否接反？GND是否共地？这是最常见错误。
3. 查波特率：主控与屏的波特率、数据位、停止位、校验位设置是否完全一致？大彩屏默认通常是115200, 8N1。
4. 查指令：用USB转TTL工具连接屏幕，通过PC串口助手手动发送一条简单的指令（如切页指令），看屏幕是否有反应。这能隔离主控程序问题。
5. 逻辑分析仪：如果条件允许，用逻辑分析仪抓取TX、RX线上的波形，看数据是否正常发出，电平是否正确。

问题2：触摸不灵敏或坐标错乱。

可能原因：
1. 校准问题：首次使用或更换触摸面板后必须进行四点校准。校准指令可通过串口发送。
2. 干扰：电源噪声或电磁干扰可能影响触摸IC。确保电源干净，触摸排线远离高频信号线。
3. 固件版本：检查触摸屏控制器的固件是否为最新，旧版本驱动可能存在bug。

5.3 显示与性能类问题

问题3：图片显示慢或刷新有闪烁感。

优化方案：
1. 图片优化：如前所述，务必在PC工具中对图片进行“转换”和“压缩”，使用索引色而非真彩色。
2. 局部刷新：对于频繁更新的数据区域，使用“部分刷新”指令，而不是刷新整个页面。
3. 双缓冲：一些高性能的大彩屏支持“画面缓冲区”切换。可以在后台缓冲区绘制好完整画面，然后一次性切换显示，避免绘制过程中的闪烁。
4. 减少透明控件：大量重叠的透明控件会增加渲染计算量。

问题4：串口通信偶尔丢数据，导致显示不同步。

解决方案：
1. 增加超时与重发：在驱动层实现简单的应答重传机制。例如，发送一条重要指令后，等待屏的应答帧（如果协议支持），超时未收到则重发（最多2-3次）。
2. 流量控制：如果数据量很大，可以考虑使用硬件流控（RTS/CTS）或软件流控（XON/XOFF），但大多数空气检测仪应用数据量不大，通常不需要。
3. 提高中断优先级：确保串口接收中断的优先级足够高，不会被其他长时间的中断（如SD卡读写）阻塞。
4. 缓冲区管理：确保接收缓冲区足够大，并能及时处理。如果使用DMA，注意处理半满和全满中断。