产品经理把需求发过来的时候往往不会直接画好界面只会留下一句话“屏幕换成彩色的要好看还要能显示湿度和模式。” 这是很多除湿机/家电项目里非常典型的需求升级。过去用段码屏或数码管显示一个数字、几个图标足够但当产品要展示当前湿度、目标湿度、干衣/除湿/自动模式、水箱满、滤网清理提醒时黑白段码的排版能力很快就不够用了。给除湿机这类中小家电做彩屏显示方案比较务实的选择是一块 2.8 寸、320X240 分辨率的 TFT 屏搭配 LT165A 这一类 MCU/方案型号来负责屏驱动和界面绘制。320X240 分辨率通常被叫做 QVGA在 2.8 寸尺寸下能呈现清晰的曲线、图标和中文大字号同时刷新压力和主控资源占用又比 480X320、800X480 小很多很适合嵌入式产品做低成本彩色交互。这篇文章会围绕“LT165A 2.8 寸 320X240 彩屏”在除湿机上的落地展开内容覆盖方案选型、硬件接线、屏幕初始化、UI 布局、状态机切换、常见驱动问题以及量产阶段要注意的工程化建议。无论你是刚开始接触小家电彩屏开发的应届生还是准备给老产品做显示升级的嵌入式工程师都可以按这套思路走一遍。1. LT165A 与 320X240 彩屏方案背景1.1 为什么除湿机要换成彩屏显示除湿机和加湿器、空气净化器类似用户需要直接读懂的信息很多当前环境湿度、目标湿度、当前温度、运行模式、风速档位、水箱状态、定时时间、故障代码。如果只用段码屏设计上只能用固定的丝印图标和 7 段数码管拼内容界面设计很受限甚至同一个位置在不同模式下要表达完全不同的含义。彩屏方案能把这些信息统一到同一块屏幕上用“主界面”的方式一次性呈现。比如用户一开机就能看到一个大号的当前湿度数字配合左侧的目标湿度和状态图标视觉上更接近消费电子产品。除湿机本身属于每天可能看几次的家电不是强交互设备因此界面不需要复杂核心是把数据读起来直观、按键操作路径短。这也是现阶段很多家电显示升级的切入点不追求做手机一样的高清大屏而是把信息层级、文字可读性和交互反馈做好。2.8 寸、320X240 的彩屏方案刚好落在“成本可控”和“显示体验够用”的平衡点上。1.2 LT165A 在整个方案中的角色在项目选型表里LT165A 通常作为整套彩屏方案的主控型号出现。它负责几件关键事情驱动 320X240 TFT 屏发送初始化序列和显存数据读取湿度、温度传感器数据扫描按键并处理 UI 页面切换根据湿度阈值控制压缩机、风机等负载维护整机运行状态和故障显示。也就是说LT165A 不只是“屏幕驱动芯片”除湿机整机的主控逻辑也会在它上面跑。开发时屏幕驱动、传感器采集、控制逻辑和 UI 绘制需要放到同一个工程里协同工作。关于这款芯片的具体频率、Flash/RAM 大小、片上外设资源建议以原厂选型手册和开发板 SDK 为准。不同批次或者不同封装引脚定义也可能存在差异。下面文章重点讲设计方案代码部分会保留底层平台抽象层方便你根据自己的 SDK 替换。1.3 320X240 分辨率在小家电 UI 上的优势320X240 虽然不是高分辨率但对 2.8 寸屏幕来说已经足够细腻。它的优势主要有三个。第一字体显示效果好。中文字库在这个分辨率下可以做到 16x16、24x24 或 32x32 点阵显示湿度和温度主数字可以做到大字号老年用户也能看清。第二图形绘制压力小。如果使用 RGB565 格式320X240 一帧全屏数据大约是 320 × 240 × 2 153600 字节约 150KB。很多小家电主控内部 RAM 不够直接存一帧但屏幕模组通常自带显示 RAM主控只需要通过 SPI 或并口往屏幕发送数据即可并不需要在本地缓存整帧。第三UI 设计空间充足。除湿机主界面可以做到“当前湿度大数字 模式图标 目标湿度 实时曲线”同屏显示不会让人感觉拥挤。对没有触摸屏的按键交互设备来说这种尺寸也方便做菜单和设置页。2. 系统总体架构与硬件接线2.1 除湿机彩屏方案的硬件组成一个完整的除湿机彩屏显示系统并不只是“主控 屏幕”这么简单。从整机角度看硬件至少包含以下部分模块常见器件/接口说明主控 MCULT165A负责驱动屏、采集数据、控制负载显示屏2.8 寸 TFT320X240显示界面和状态LCD 驱动 IC常见为兼容 ILI9341/ST7789V 等具体以模组规格书为准环境传感器温湿度传感器采集当前环境湿度、温度水箱检测干簧管或电极检测水满时提醒用户按键GPIO 扫描电源、模式、加减、定时负载控制继电器/可控硅控制压缩机和风机启停电源适配器 LDO/DC-DC给主控、传感器和背光供电硬件方案设计阶段最容易忽略的是背光供电。2.8 寸屏的背光 LED 电流虽然不大但如果直接从主控 LDO 上取电屏幕亮度高时会影响主控电压稳定性出现复位或者花屏。一般建议背光使用独立供电或者至少预留足够电流余量并在背光正极串联限流电阻、在输出端加滤波电容。2.2 常见的屏幕接口方式2.8 寸 320X240 彩屏模组常见的接口有三种SPI、8080 并口、RGB 接口。选哪种要看主控资源和实时性要求。SPI 接口占用 IO 少通常 4 线 SPISCK、MOSI、CS、DC加 RESET 和背光就能工作。缺点是刷全屏速度比并口慢适合静态界面较多、局部刷新的场景。8080 并口需要 8 根或 16 根数据线加上 WR、RD、CS、DC 等控制线IO 占用较多但像素写入速度快适合动态变化比较频繁的界面。RGB 接口需要主控持续向屏输出 RGB 数据和同步时钟一般用于没有内置 RAM 的纯面板。小家电主控很少直接用除非主控内部带了 TFT LCD 控制器。面向除湿机如果 LT165A 内部 RAM 和 GPIO 资源够用我会优先评估 8080 并口或高速 SPI。如果 UI 本身不复杂不追求全屏动画SPI 其实已经够用而且还能把节省下来的 GPIO 留给按键、传感器和继电器控制。2.3 接线与工程样板注意事项以 SPI 方式为例屏幕和主控之间的基础接线如下屏幕引脚主控引脚功能说明SCKSPI 时钟时钟频率需根据主控和屏驱动 IC 限制调整MOSI/SDASPI 数据输出主控向屏写数据MISO/SDOSPI 数据输入某些屏支持读取不读时可不接CS片选低电平有效DC/RS数据/命令选择写命令时拉低写数据时拉高RESET复位低电平复位BL背光控制可用 PWM 调亮度VCC/GND电源和地注意电压等级样板焊接时要注意几点排线尽量短避免 SPI 时钟信号走太长导致波形畸变DC 引脚不要接错否则屏幕会把命令当成数据出现连续花屏RESET 最好由主控 GPIO 控制并在代码里做上电延时复位不要只靠 RC 复位电路否则初始化时序不一致时容易出现“十片里有几片不正常”的现象。3. 开发环境准备与工程搭建3.1 开发工具链与调试器LT165A 具体使用什么内核和开发环境以原厂 SDK 为准。可能是 Keil MDK、IAR、Eclipse 或 GCC 工具链这可能取决于芯片是 ARM Cortex-M 内核还是 RISC-V 内核。拿到开发板后第一件事情是确认三样东西编译环境能否编译官方例程烧录器能否识别芯片型号官方 SDK 里是否已经带 LCD 驱动例程。如果原厂已经提供 LCD 驱动例程建议优先在例程基础上改不要自己从头写底层初始化。屏幕初始化序列属于“看着简单、调试痛苦”的部分往往需要按屏厂给的序列逐个寄存器调自己推测很容易出现显示偏色、反白、无法点亮等问题。调试过程中最好准备一个逻辑分析仪或示波器。SPI 模式的屏幕点不亮时用逻辑分析仪抓一下 SCK、MOSI、DC、CS 的波形能立刻确认主控到底有没有正常发命令。单纯看代码很多时候看不出问题。3.2 软件工程目录划分小家电显示工程很容易越写越乱尤其是需求频繁改版后UI 代码、驱动代码、控制逻辑混在一起后期维护成本非常高。推荐一开始就按分层目录组织代码下面给出一个可参考的目录结构project ├── app │ ├── ui │ │ ├── page_main.c │ │ ├── page_setting.c │ │ └── ui_common.c │ ├── service │ │ ├── app_state.c │ │ ├── humi_control.c │ │ └── key_process.c ├── bsp │ ├── lcd │ │ ├── lcd_driver.c │ │ ├── lcd_gui.c │ │ └── lcd_spi.c │ ├── key │ ├── sensor │ └── board ├── middleware │ ├── gui │ └── font ├── main.c └── Makefile / *.uvprojxapp/ui 放界面代码app/service 放业务逻辑和状态机bsp 放板级驱动middleware 放第三方 GUI 或者字库。好处是当你想把屏幕从 A 方案换成 B 方案时只需要替换 bsp/lcd 以下文件UI 层接口保持不变即可。后面维护或者产品改新款时会轻松很多。3.3 显示驱动 IC 资料准备正式开始写代码前把以下资料准备齐全屏厂给的 LCD 模组规格书确认接口时序、VCC 电压、背光电流驱动 IC 数据手册确认初始化寄存器命令官方例程或屏厂初始化代码屏幕默认显示方向和扫描方向说明。同一个尺寸、同一个分辨率的屏幕可能会用不同的驱动 IC。同样是 2.8 寸 320X240有的模组是 ILI9341有的是 ST7789V初始化寄存器会不太一样。不要因为“都是 320X240”就照搬另一块屏的初始化代码否则可能出现颜色通道反了、图像镜像、滚动方向不对等问题。4. 屏幕驱动层从初始化到图形库适配4.1 底层 SPI 读写接口抽象不管上层 UI 写多复杂最终所有图像都要通过底层接口发送到屏幕。通常需要抽象下面几个函数写命令、写数据、写像素数据块、设置窗口、复位延时。先看一个典型的 SPI 写命令/写数据实现框架// 文件路径bsp/lcd/lcd_spi.c #define LCD_CS_L() gpio_write(LCD_CS_PORT, LCD_CS_PIN, 0) #define LCD_CS_H() gpio_write(LCD_CS_PORT, LCD_CS_PIN, 1) #define LCD_DC_L() gpio_write(LCD_DC_PORT, LCD_DC_PIN, 0) #define LCD_DC_H() gpio_write(LCD_DC_PORT, LCD_DC_PIN, 1) void lcd_spi_init(void) { // 初始化 SPI 主机配置 SCK、MOSI、CS 引脚 // 注意 DC 引脚要单独配置为 GPIO 输出 spi_master_init(SPI_BUS_LCD, 40000000); gpio_write(LCD_BL_PORT, LCD_BL_PIN, 0); // 先关背光 } static void lcd_write_cmd(uint8_t cmd) { LCD_DC_L(); LCD_CS_L(); spi_write_byte(SPI_BUS_LCD, cmd); LCD_CS_H(); } static void lcd_write_data(uint8_t data) { LCD_DC_H(); LCD_CS_L(); spi_write_byte(SPI_BUS_LCD, data); LCD_CS_H(); } void lcd_write_pixels(const uint8_t *buf, uint32_t len) { // 批量写像素数据省去反复切换 DC 电平的时间 LCD_DC_H(); LCD_CS_L(); spi_write_bytes(SPI_BUS_LCD, buf, len); LCD_CS_H(); }关键点在于 DC 线的切换。写命令时 DC 为低写数据时 DC 为高这个时序错一处屏幕显示就会整体错乱。批量写像素时不要每个字节都重新拉高拉低 CS/DC否则刷新效率会很差尤其在全屏清屏或者绘制矩形时会明显卡顿。如果主控 SPI 硬件支持 DMA建议在批量写显存数据时配合 DMA 传输这样可以减轻 CPU 负担让主控在刷屏的同时继续处理传感器和按键扫描。否则全屏刷新过程中可能出现其他任务响应变慢的问题。4.2 LCD 初始化序列参考屏幕初始化的目标是让驱动 IC 进入可显示状态并按预期设置颜色格式、扫描方向和显示开关。下面给出一段简洁的参考初始化序列实际开发中请用屏厂提供的初始化代码替换void lcd_init_sequence(void) { lcd_send_cmd(0x01); // Soft Reset软复位 lcd_delay_ms(120); // 复位后需要延时 lcd_send_cmd(0x11); // Sleep Out退出睡眠 lcd_delay_ms(150); // 等待内部电源稳定 lcd_send_cmd(0x3A); // 接口像素格式设置 lcd_send_data(0x55); // 0x55 表示 RGB56516bit 颜色 // 屏厂初始化代码通常还会包含电源、Gamma、显示窗口等设置 // 这里省略实际项目以屏厂提供的 init code 为准 lcd_send_cmd(0x29); // Display ON打开显示 lcd_delay_ms(20); }为什么复位后必须延时LCD 驱动 IC 内部需要等待振荡器稳定、DCDC 电压建立如果复位后立即发初始化命令某些寄存器会写入失败出现第一批命令丢失、后续画面异常的现象。延时时间一般几十到几百毫秒具体以上电时序要求为准。需要注意一点0x3A 参数 0x55 代表 RGB565 颜色格式这是很多驱动 IC 的通用表示方式但并非所有 IC 完全一致。部分驱动把 16bit 格式定义为 0x05有的定义为 0x55所以最稳妥的方法还是查驱动 IC 手册不要盲目照抄网上代码。4.3 设置显示窗口并画点320X240 屏幕画图的核心思想是“设置窗口 写像素”。比如要在屏幕上画一个点先通过列地址和行地址命令告诉驱动 IC 要写哪块区域然后向该区域连续写入颜色数据。#define LCD_WIDTH 320 #define LCD_HEIGHT 240 void lcd_set_window(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { // 列地址设置 lcd_send_cmd(0x2A); lcd_send_data(x0 8); lcd_send_data(x0 0xFF); lcd_send_data(x1 8); lcd_send_data(x1 0xFF); // 行地址设置 lcd_send_cmd(0x2B); lcd_send_data(y0 8); lcd_send_data(y0 0xFF); lcd_send_data(y1 8); lcd_send_data(y1 0xFF); // 开始写入显存之后连续写入的像素会按顺序填充该窗口 lcd_send_cmd(0x2C); } void lcd_draw_pixel(uint16_t x, uint16_t y, uint16_t color) { if (x LCD_WIDTH || y LCD_HEIGHT) { return; } lcd_set_window(x, y, x, y); uint8_t buf[2]; buf[0] color 8; buf[1] color 0xFF; lcd_write_pixels(buf, 2); }如果只用画点函数绘制整屏界面效率会很低因为每个点都要发一次窗口设置命令。实际项目中建议实现“区域填充”函数用于画背景、按钮、数字和矩形块。比如清除某块区域时一次设置窗口然后批量发送相同颜色数据。4.4 图形库与自绘 UI 的取舍很多新手一上来就想移植 LVGL 到 320X240 彩屏但小家电除湿机界面并不复杂主界面加两三个设置页用自绘方式完全能实现。是否使用图形库需要看主控资源和界面复杂度。如果芯片 Flash/RAM 比较大内存超过几十 KBUI 控件多、需要滑动列表、动画效果用 LVGL、TouchGFX 等图形库更合适。如果芯片资源有限界面就那几页显示内容主要是数字、图标和简单曲线建议直接自绘。减少图形库的内存消耗和移植工作量。即使使用图形库底层也需要封装“画点”“填充矩形”“批量写显存”这几个接口。图形库在界面刷新时会回调 flush 函数把一整个显示区域的数据送到底层屏幕。底层 flush 做得高效整个 UI 才会流畅。5. 除湿机主界面 UI 与数据展示设计5.1 主界面布局如何规划除湿机主界面应遵循“重要信息一眼看到”的原则。优先级最高的是当前湿度第二是目标湿度第三是运行模式和风扇档位最后是环境温度、水满警告、定时时间等辅助信息。一个推荐的布局是屏幕最顶部模式文字 运行状态小图标例如“自动除湿 / 干衣 / 送风”外加 Wi-Fi 图标或水箱满图标屏幕中间当前环境湿度大数字旁边标注“RH”或“当前湿度”屏幕左侧或右侧目标湿度用小字显示旁边有上下方向键提示屏幕下方环境温度、定时时间、滤网清洁提醒。界面设计时要注意320X240 屏幕尺寸有限不要在一屏里塞太多内容。宁可把不常用功能放到二级页面也不要让用户一开机就面对密密麻麻的图标。除湿机不是手机界面简单反而显得可靠。5.2 环境数据的采集与格式化显示显示湿度前主控需要通过温湿度传感器采集当前环境湿度。传感器类型很多常见的有单总线型、I2C 型。这里不讨论具体传感器型号先定义一份统一的数据结构方便 UI 层读取// 文件路径app/service/env_service.h typedef struct { int16_t humi_x10; // 当前湿度乘以10表示如 523 表示 52.3% int16_t temp_x10; // 当前温度乘以10表示如 253 表示 25.3℃ uint8_t water_full; // 水箱满标志 uint8_t mode; // 运行模式 uint8_t fan_level; // 风机档位 uint8_t timer_hour; // 定时时间单位小时 } env_status_t; void env_service_init(void); void env_service_update(void); env_status_t *env_service_get_status(void);温度值使用整数乘 10 的方式可以避免在 MCU 上使用浮点格式化既节省 Flash 和 RAM也避免浮点打印带来的性能问题。显示的时候通过整数运算拆出整数位和小数位。char buf[16]; int humi_int status-humi_x10 / 10; int humi_dec status-humi_x10 % 10; snprintf(buf, sizeof(buf), %d.%d%%, humi_int, humi_dec); lcd_draw_string(100, 60, buf, FONT_SIZE_32, COLOR_BLUE, COLOR_WHITE);如果 UI 需要不断刷新建议不要整屏重绘。当前湿度数字变了只需要把原来数字所在的矩形区域填充成背景色再在新的位置绘制新数字即可。否则每次刷新都闪烁视觉体验会很差。5.3 简单湿度趋势图绘制除湿机彩屏方案里湿度趋势曲线是非常实用的一项显示。它能让用户直观看到除湿机运行一段时间后室内湿度是否在下降。受限于 MCU 算力和刷新方式不必做复杂平滑曲线折线图即可满足需求。下面是一段示例用来在屏幕底部绘制一条 60 点的湿度曲线// 文件路径app/ui/ui_trend.c #define TREND_X_START 10 #define TREND_Y_START 140 #define TREND_Y_HEIGHT 50 #define TREND_POINT_NUM 60 #define HUMI_MAX 90 // 曲线量程上限 #define HUMI_MIN 30 // 曲线量程下限 static int16_t s_humi_history[TREND_POINT_NUM]; void ui_trend_record(int16_t humi) { // 将历史数据左移最旧的数据丢弃最新数据放到末尾 for (int i 0; i TREND_POINT_NUM - 1; i) { s_humi_history[i] s_humi_history[i 1]; } s_humi_history[TREND_POINT_NUM - 1] humi; } void ui_trend_draw(void) { // 先清除曲线区域 lcd_fill_rect(TREND_X_START - 1, TREND_Y_START - 1, TREND_X_START (TREND_POINT_NUM - 1) * 2 1, TREND_Y_START TREND_Y_HEIGHT 1, COLOR_WHITE); for (int i 0; i TREND_POINT_NUM - 1; i) { int16_t h0 s_humi_history[i]; int16_t h1 s_humi_history[i 1]; if (h0 0) { continue; } int16_t x0 TREND_X_START i * 2; int16_t x1 TREND_X_START (i 1) * 2; int16_t y0 TREND_Y_START (HUMI_MAX - h0) * TREND_Y_HEIGHT / (HUMI_MAX - HUMI_MIN); int16_t y1 TREND_Y_START (HUMI_MAX - h1) * TREND_Y_HEIGHT / (HUMI_MAX - HUMI_MIN); lcd_draw_line(x0, y0, x1, y1, COLOR_BLUE); } }这里每个采样点横向间隔 2 个像素60 个点总宽 118 像素不会占满整个屏幕。如果产品界面想显示更多数据可以压缩采样间隔比如每隔 1 像素画一点横向宽度为 59 像素适合放在主界面右下角。趋势曲线最关键的是数组下标边界。记录历史数据时要保证最新数据一定写入数组末尾绘制时也按顺序读取。如果出现数组越界可能把屏幕边缘以外的坐标写进显存导致画面上出现随机横线。6. 交互流程与状态机设计6.1 按键扫描与软件去抖除湿机多数使用实体按键。按键扫描不是简单的 GPIO 读取延时 20ms因为用户按一下可能时间很短也可能长按如果每次按下都立即触发界面跳转会出现一次按键触发两次甚至多次动作的问题。常用的做法是先做去抖再判断边沿。uint8_t key_scan(void) { static uint8_t last_state 0; static uint8_t stable_cnt 0; uint8_t level (gpio_read(KEY_MODE_PIN) 0) ? 1 : 0; if (level last_state) { stable_cnt; } else { stable_cnt 0; } if (stable_cnt 5) { stable_cnt 5; return level; // 返回去抖后的稳定电平 } return 0xFF; // 表示状态不稳定忽略本次扫描 }实际 UI 层需要判断的是“按键按下的一瞬间”而不是持续电平。可以先把去抖后的电平保存下来再用上一次状态和当前状态做边沿检测只在下降沿触发一次按键事件这样能避免按住键时页面一直刷新。6.2 页面切换状态机除湿机界面一般存在多级页面比如主页、设定页、模式切换页、定时页。用 if-else 处理页面会越写越乱推荐使用状态机。先定义页面枚举typedef enum { PAGE_MAIN 0, PAGE_SET_HUMI, PAGE_SET_TIMER, PAGE_INFO, PAGE_MAX } app_page_t;然后在主循环或者定时中断里根据当前页面和按键事件决定执行哪个页面处理函数void ui_main_loop(void) { uint8_t key key_get_event(); switch (app_ctx.page) { case PAGE_MAIN: page_main_handle(key); break; case PAGE_SET_HUMI: page_set_humi_handle(key); break; case PAGE_SET_TIMER: page_set_timer_handle(key); break; case PAGE_INFO: page_info_handle(key); break; default: break; } }页面处理函数内部只需要关心本页面的按键响应。例如在 PAGE_MAIN 页面按“”键就进入目标湿度设置页在 PAGE_SET_HUMI 页面按“”键则目标湿度增加 5%同时更新界面上的目标湿度显示。这样拆分的好处是新增一个页面时不需要改动其他页面逻辑只需要添加一个枚举值、增加一个 case 分支再写一个对应的页面处理函数即可。并且每页的数据刷新任务也能单独管理避免所有绘制都堆在主页面函数里。6.3 湿度控制与 UI 显示的时序配合除湿机显示方案里有一个容易出现的问题显示刷新频率过高会干扰控制逻辑。除湿机采集的湿度数值本身是波动的如果显示层每 10ms 刷新一次湿度数字用户会看到数字不断跳动看起来很不稳定。建议把控制周期和显示刷新周期分开。压缩机控制逻辑可以用 1 秒到几秒的周期判断湿度阈值UI 显示则固定几百毫秒刷新一次。湿度曲线则按分钟级别采集比如每 30 秒记录一个点连续显示 30 分钟内的趋势更有参考意义。可以把传感器任务做成一个定时器回调每次更新全局环境结构体UI 任务只从结构体取最新数据不直接阻塞读取传感器。这样即使 I2C 或单总线传感器偶尔出现应答超时也不会导致整机 UI 卡死。7. 常见问题排查与调试建议7.1 白屏、花屏与颜色异常问题现象常见原因解决思路白屏无任何显示初始化未执行、复位脚未拉高、背光未开用示波器看 RESET 和 BL确认初始化命令是否发出花屏且颜色杂乱DC 脚电平接反或驱动 IC 初始化错误检查 DC 切换逻辑对比屏厂初始化序列全屏颜色偏红/偏绿/偏蓝RGB 颜色通道顺序不对检查 RGB565 数据高低字节发送顺序必要时在应用层做交换屏幕内容镜像或方向不对扫描方向寄存器设置错误调整驱动 IC 的扫描方向寄存器或者通过旋转坐标处理白屏问题最常见的原因是复位时序不对。如果主控上电比屏幕模组慢屏可能在内部还没准备好时收到了初始化命令后续命令全部无效。建议复位脚用 GPIO 控制初始化前先拉低一段时间再拉高等待几十毫秒后再发送初始化序列。花屏问题的排查重点在 DC 线和初始化序列。可以用逻辑分析仪抓取命令阶段的数据内容和屏厂示例代码输出对比看是否在命令位置多写了数据或者在数据位置误发了命令。7.2 屏幕闪烁与刷新残影显示刷新过程中出现闪烁通常不是屏幕质量问题而是刷新策略不合理。常见原因包括整屏频繁重绘、清屏和绘制之间间隔太长、背光 PWM 频率偏低。解决思路是先做局部刷新。比如当前湿度数字从 52% 变成 53%只需要刷新数字所在矩形区域不要调用全屏清屏函数。如果必须整屏刷新可以先关闭显示把图像数据全部写入显示 RAM再打开显示这样用户不会看到“涂抹过程”。背光 PWM 频率建议设置在 1kHz 以上。如果 PWM 频率低于几百 Hz视觉上能明显感觉到闪烁。另外背光直接使用低频 PWM 调光时摄像头拍摄时更容易看到扫描纹量产测试时要留意。7.3 湿度数字显示异常跳动除湿机 UI 上湿度数字跳动经常会被误认为是显示 bug实际上可能是数据本身波动。湿度传感器放在出风口附近除湿机运行时局部湿度会快速变化采集值自然会震荡。排查步骤包括先把传感器采集值通过串口打印出来确认数字跳动是 UI 问题还是传感器数据问题对湿度采样值做软件滤波例如连续采集 5 次去掉最大最小后取平均显示时增加变化门限例如湿度变化在 0.5% 以内时不更新界面避免无意义刷新传感器要避免紧贴蒸发器和出风口位置应能代表房间环境湿度。如果串口打印的数据稳定但屏幕上偶尔显示旧值或错值多数是刷新时没有同步。UI 读取传感器数据时可以先关中断或读取保护取完数据后再恢复保证多字节读取过程不被高优先级中断打断。7.4 继电器动作导致屏幕闪动除湿机在启动压缩机的瞬间继电器吸合会产生比较大的电流跳变和电磁干扰。如果屏幕供电和继电器驱动共用一个电源干扰可能会传导到屏的逻辑电路导致闪屏或瞬间花屏。工程上可以从几个方向处理在继电器线圈两端并联续流二极管或 RC 吸收电路屏幕逻辑电源使用单独的 LDO并增加 100nF 和 10uF 去耦电容主控、屏幕、继电器驱动的地线采用单点接地或大面积铺地避免形成地环路SPI 线尽量远离继电器驱动线和压缩机负载线。这种问题在开发板上往往复现不出来因为开发板供电来自 USB继电器负载也比较小。到了整机测试阶段用实际压缩机负载做长时间老化测试才能暴露干扰问题。7.5 代码升级后屏幕方向变了如果项目开发到一半换了同分辨率但不同扫描方向的屏幕模组可能会出现之前的代码显示方向不对。这个不是 bug而是因为新模组的驱动 IC 内部扫描方向和旧模组不同。解决办法是修改扫描方向寄存器常见命令 0x36的参数然后在窗口设置函数中同步调整坐标原点。注意修改扫描方向后行地址和列地址的原点也要保持一致否则会出现图像只显示一部分另一部分是花屏或空白的情况。调整坐标时可以封装成一个函数把屏幕坐标转换成底层驱动 IC 坐标这样 UI 层永远按照 0 到 319、0 到 239 的逻辑坐标画界面屏幕本身的物理方向变化只在驱动层处理。8. 工程化与量产落地建议8.1 UI 刷新应避免阻塞主循环除湿机显示方案虽然重点是屏幕但主控还要同时处理传感器、按键、压缩机控制。如果 UI 刷新函数里包含大量阻塞延时例如每个像素发送后都等待 SPI 中断会导致整机实时性下降。比较好的做法是把界面绘制拆成两个阶段。第一阶段计算当前页面需要更新的区域和数据内容第二阶段把绘制数据写入显示缓冲区并批量发送。如果使用不带缓冲的直接写屏方式则尽量保证单次绘制函数的执行时间可控不要在中断服务函数里做耗时绘制。8.2 菜单动作不要太快用户按下“模式”键后如果按键和页面切换速度太快用户会感觉按键不跟手相反的如果去抖时间太长又会觉得反应迟钝。一般菜单按键事件触发到页面切换可以控制在几十毫秒内但页面上的高亮变化最好有 50ms 到 100ms 的确认感让用户意识到按键已经生效。而在目标湿度调整场景按住“”键不放时希望数值连续增加。这时需要增加长按计数逻辑通常按住超过 500ms 后进入连发模式每 200ms 左右加一档。这个细节对体验提升很大很多低价小家电的 UI 恰恰在这里做得比较粗糙。8.3 屏幕初始化代码要固化版本屏幕初始化寄存器序列看着很底层却是最容易在量产阶段出问题的部分。建议把初始化序列放到独立文件里并在代码注释中记录初始化序列来源、适配模组型号、修改日期和修改人。示例/* * 模组型号: XXX-TFT28 2.8寸 320X240 * 驱动 IC : ILI9341 兼容 * 初始化来源: 屏厂 demo 代码 2025-01-10 * 修改记录: * - 2025-01-10: 初始版本适配样机 * - 2025-02-13: 修正 RGB 高低字节顺序解决颜色偏色问题 */ static const uint8_t s_lcd_init_cmds[] { ... };如果产品有两种不同的屏幕供应商建议在驱动层预留编译宏根据硬件版本选择不同初始化序列。否则同一套代码用在两批屏上可能会出现部分批次花屏而生产测试又很难逐台发现问题。8.4 屏幕与整机功耗控制除湿机虽然使用市电供电不依赖电池但仍需要考虑待机功耗和屏幕寿命。整机待机时屏幕可以进入休眠模式或直接关闭背光用户需要查看状态时再通过按键唤醒屏幕。屏幕长时间显示同一画面虽然不会像 OLED 那样烧屏但从可靠性和功耗角度也建议增加“无操作自动熄屏”功能。例如 5 分钟无按键操作背光调暗10 分钟无按键操作关闭背光只保留指示灯。这样既延长屏幕背光寿命也能降低整机运行功耗。8.5 更稳妥的开发顺序最后建议刚接触 LT165A 彩屏方案的开发者不要急着把控制逻辑和 UI 一次写完。比较稳妥的开发顺序是第一步用官方例程点亮屏幕能显示纯色和中英文字符 第二步接入温湿度传感器把实测数据和显示数字打通 第三步实现主页面布局和状态机保证页面切换可靠 第四步加入湿度曲线、定时、水满告警等辅助功能 第五步整机联调重点测试继电器频繁动作和长时间老化场景。每一步都留一个可复现的版本这样即使某一步出问题也能快速回退定位。屏幕驱动这种底层工作最怕的就是所有功能堆在一起后才开始调试那时候花屏很难判断是硬件、初始化、还是 UI 绘制引入的问题。如果你也正在做同类的家电彩屏显示方案建议先把屏幕初始化、坐标抽象和页面状态机这三块做扎实。芯片型号可以换屏幕接口可以从 SPI 换成并口但一套清晰的显示架构和工程分层能让你在后续改版中省下大量的重复调试时间。彩屏显示方案最终拼的往往不是屏幕效果多炫而是整机长时间运行时的稳定性和可维护性。 LT165A驱动2.8寸320X240彩屏的除湿机显示方案解析
产品经理把需求发过来的时候往往不会直接画好界面只会留下一句话“屏幕换成彩色的要好看还要能显示湿度和模式。” 这是很多除湿机/家电项目里非常典型的需求升级。过去用段码屏或数码管显示一个数字、几个图标足够但当产品要展示当前湿度、目标湿度、干衣/除湿/自动模式、水箱满、滤网清理提醒时黑白段码的排版能力很快就不够用了。给除湿机这类中小家电做彩屏显示方案比较务实的选择是一块 2.8 寸、320X240 分辨率的 TFT 屏搭配 LT165A 这一类 MCU/方案型号来负责屏驱动和界面绘制。320X240 分辨率通常被叫做 QVGA在 2.8 寸尺寸下能呈现清晰的曲线、图标和中文大字号同时刷新压力和主控资源占用又比 480X320、800X480 小很多很适合嵌入式产品做低成本彩色交互。这篇文章会围绕“LT165A 2.8 寸 320X240 彩屏”在除湿机上的落地展开内容覆盖方案选型、硬件接线、屏幕初始化、UI 布局、状态机切换、常见驱动问题以及量产阶段要注意的工程化建议。无论你是刚开始接触小家电彩屏开发的应届生还是准备给老产品做显示升级的嵌入式工程师都可以按这套思路走一遍。1. LT165A 与 320X240 彩屏方案背景1.1 为什么除湿机要换成彩屏显示除湿机和加湿器、空气净化器类似用户需要直接读懂的信息很多当前环境湿度、目标湿度、当前温度、运行模式、风速档位、水箱状态、定时时间、故障代码。如果只用段码屏设计上只能用固定的丝印图标和 7 段数码管拼内容界面设计很受限甚至同一个位置在不同模式下要表达完全不同的含义。彩屏方案能把这些信息统一到同一块屏幕上用“主界面”的方式一次性呈现。比如用户一开机就能看到一个大号的当前湿度数字配合左侧的目标湿度和状态图标视觉上更接近消费电子产品。除湿机本身属于每天可能看几次的家电不是强交互设备因此界面不需要复杂核心是把数据读起来直观、按键操作路径短。这也是现阶段很多家电显示升级的切入点不追求做手机一样的高清大屏而是把信息层级、文字可读性和交互反馈做好。2.8 寸、320X240 的彩屏方案刚好落在“成本可控”和“显示体验够用”的平衡点上。1.2 LT165A 在整个方案中的角色在项目选型表里LT165A 通常作为整套彩屏方案的主控型号出现。它负责几件关键事情驱动 320X240 TFT 屏发送初始化序列和显存数据读取湿度、温度传感器数据扫描按键并处理 UI 页面切换根据湿度阈值控制压缩机、风机等负载维护整机运行状态和故障显示。也就是说LT165A 不只是“屏幕驱动芯片”除湿机整机的主控逻辑也会在它上面跑。开发时屏幕驱动、传感器采集、控制逻辑和 UI 绘制需要放到同一个工程里协同工作。关于这款芯片的具体频率、Flash/RAM 大小、片上外设资源建议以原厂选型手册和开发板 SDK 为准。不同批次或者不同封装引脚定义也可能存在差异。下面文章重点讲设计方案代码部分会保留底层平台抽象层方便你根据自己的 SDK 替换。1.3 320X240 分辨率在小家电 UI 上的优势320X240 虽然不是高分辨率但对 2.8 寸屏幕来说已经足够细腻。它的优势主要有三个。第一字体显示效果好。中文字库在这个分辨率下可以做到 16x16、24x24 或 32x32 点阵显示湿度和温度主数字可以做到大字号老年用户也能看清。第二图形绘制压力小。如果使用 RGB565 格式320X240 一帧全屏数据大约是 320 × 240 × 2 153600 字节约 150KB。很多小家电主控内部 RAM 不够直接存一帧但屏幕模组通常自带显示 RAM主控只需要通过 SPI 或并口往屏幕发送数据即可并不需要在本地缓存整帧。第三UI 设计空间充足。除湿机主界面可以做到“当前湿度大数字 模式图标 目标湿度 实时曲线”同屏显示不会让人感觉拥挤。对没有触摸屏的按键交互设备来说这种尺寸也方便做菜单和设置页。2. 系统总体架构与硬件接线2.1 除湿机彩屏方案的硬件组成一个完整的除湿机彩屏显示系统并不只是“主控 屏幕”这么简单。从整机角度看硬件至少包含以下部分模块常见器件/接口说明主控 MCULT165A负责驱动屏、采集数据、控制负载显示屏2.8 寸 TFT320X240显示界面和状态LCD 驱动 IC常见为兼容 ILI9341/ST7789V 等具体以模组规格书为准环境传感器温湿度传感器采集当前环境湿度、温度水箱检测干簧管或电极检测水满时提醒用户按键GPIO 扫描电源、模式、加减、定时负载控制继电器/可控硅控制压缩机和风机启停电源适配器 LDO/DC-DC给主控、传感器和背光供电硬件方案设计阶段最容易忽略的是背光供电。2.8 寸屏的背光 LED 电流虽然不大但如果直接从主控 LDO 上取电屏幕亮度高时会影响主控电压稳定性出现复位或者花屏。一般建议背光使用独立供电或者至少预留足够电流余量并在背光正极串联限流电阻、在输出端加滤波电容。2.2 常见的屏幕接口方式2.8 寸 320X240 彩屏模组常见的接口有三种SPI、8080 并口、RGB 接口。选哪种要看主控资源和实时性要求。SPI 接口占用 IO 少通常 4 线 SPISCK、MOSI、CS、DC加 RESET 和背光就能工作。缺点是刷全屏速度比并口慢适合静态界面较多、局部刷新的场景。8080 并口需要 8 根或 16 根数据线加上 WR、RD、CS、DC 等控制线IO 占用较多但像素写入速度快适合动态变化比较频繁的界面。RGB 接口需要主控持续向屏输出 RGB 数据和同步时钟一般用于没有内置 RAM 的纯面板。小家电主控很少直接用除非主控内部带了 TFT LCD 控制器。面向除湿机如果 LT165A 内部 RAM 和 GPIO 资源够用我会优先评估 8080 并口或高速 SPI。如果 UI 本身不复杂不追求全屏动画SPI 其实已经够用而且还能把节省下来的 GPIO 留给按键、传感器和继电器控制。2.3 接线与工程样板注意事项以 SPI 方式为例屏幕和主控之间的基础接线如下屏幕引脚主控引脚功能说明SCKSPI 时钟时钟频率需根据主控和屏驱动 IC 限制调整MOSI/SDASPI 数据输出主控向屏写数据MISO/SDOSPI 数据输入某些屏支持读取不读时可不接CS片选低电平有效DC/RS数据/命令选择写命令时拉低写数据时拉高RESET复位低电平复位BL背光控制可用 PWM 调亮度VCC/GND电源和地注意电压等级样板焊接时要注意几点排线尽量短避免 SPI 时钟信号走太长导致波形畸变DC 引脚不要接错否则屏幕会把命令当成数据出现连续花屏RESET 最好由主控 GPIO 控制并在代码里做上电延时复位不要只靠 RC 复位电路否则初始化时序不一致时容易出现“十片里有几片不正常”的现象。3. 开发环境准备与工程搭建3.1 开发工具链与调试器LT165A 具体使用什么内核和开发环境以原厂 SDK 为准。可能是 Keil MDK、IAR、Eclipse 或 GCC 工具链这可能取决于芯片是 ARM Cortex-M 内核还是 RISC-V 内核。拿到开发板后第一件事情是确认三样东西编译环境能否编译官方例程烧录器能否识别芯片型号官方 SDK 里是否已经带 LCD 驱动例程。如果原厂已经提供 LCD 驱动例程建议优先在例程基础上改不要自己从头写底层初始化。屏幕初始化序列属于“看着简单、调试痛苦”的部分往往需要按屏厂给的序列逐个寄存器调自己推测很容易出现显示偏色、反白、无法点亮等问题。调试过程中最好准备一个逻辑分析仪或示波器。SPI 模式的屏幕点不亮时用逻辑分析仪抓一下 SCK、MOSI、DC、CS 的波形能立刻确认主控到底有没有正常发命令。单纯看代码很多时候看不出问题。3.2 软件工程目录划分小家电显示工程很容易越写越乱尤其是需求频繁改版后UI 代码、驱动代码、控制逻辑混在一起后期维护成本非常高。推荐一开始就按分层目录组织代码下面给出一个可参考的目录结构project ├── app │ ├── ui │ │ ├── page_main.c │ │ ├── page_setting.c │ │ └── ui_common.c │ ├── service │ │ ├── app_state.c │ │ ├── humi_control.c │ │ └── key_process.c ├── bsp │ ├── lcd │ │ ├── lcd_driver.c │ │ ├── lcd_gui.c │ │ └── lcd_spi.c │ ├── key │ ├── sensor │ └── board ├── middleware │ ├── gui │ └── font ├── main.c └── Makefile / *.uvprojxapp/ui 放界面代码app/service 放业务逻辑和状态机bsp 放板级驱动middleware 放第三方 GUI 或者字库。好处是当你想把屏幕从 A 方案换成 B 方案时只需要替换 bsp/lcd 以下文件UI 层接口保持不变即可。后面维护或者产品改新款时会轻松很多。3.3 显示驱动 IC 资料准备正式开始写代码前把以下资料准备齐全屏厂给的 LCD 模组规格书确认接口时序、VCC 电压、背光电流驱动 IC 数据手册确认初始化寄存器命令官方例程或屏厂初始化代码屏幕默认显示方向和扫描方向说明。同一个尺寸、同一个分辨率的屏幕可能会用不同的驱动 IC。同样是 2.8 寸 320X240有的模组是 ILI9341有的是 ST7789V初始化寄存器会不太一样。不要因为“都是 320X240”就照搬另一块屏的初始化代码否则可能出现颜色通道反了、图像镜像、滚动方向不对等问题。4. 屏幕驱动层从初始化到图形库适配4.1 底层 SPI 读写接口抽象不管上层 UI 写多复杂最终所有图像都要通过底层接口发送到屏幕。通常需要抽象下面几个函数写命令、写数据、写像素数据块、设置窗口、复位延时。先看一个典型的 SPI 写命令/写数据实现框架// 文件路径bsp/lcd/lcd_spi.c #define LCD_CS_L() gpio_write(LCD_CS_PORT, LCD_CS_PIN, 0) #define LCD_CS_H() gpio_write(LCD_CS_PORT, LCD_CS_PIN, 1) #define LCD_DC_L() gpio_write(LCD_DC_PORT, LCD_DC_PIN, 0) #define LCD_DC_H() gpio_write(LCD_DC_PORT, LCD_DC_PIN, 1) void lcd_spi_init(void) { // 初始化 SPI 主机配置 SCK、MOSI、CS 引脚 // 注意 DC 引脚要单独配置为 GPIO 输出 spi_master_init(SPI_BUS_LCD, 40000000); gpio_write(LCD_BL_PORT, LCD_BL_PIN, 0); // 先关背光 } static void lcd_write_cmd(uint8_t cmd) { LCD_DC_L(); LCD_CS_L(); spi_write_byte(SPI_BUS_LCD, cmd); LCD_CS_H(); } static void lcd_write_data(uint8_t data) { LCD_DC_H(); LCD_CS_L(); spi_write_byte(SPI_BUS_LCD, data); LCD_CS_H(); } void lcd_write_pixels(const uint8_t *buf, uint32_t len) { // 批量写像素数据省去反复切换 DC 电平的时间 LCD_DC_H(); LCD_CS_L(); spi_write_bytes(SPI_BUS_LCD, buf, len); LCD_CS_H(); }关键点在于 DC 线的切换。写命令时 DC 为低写数据时 DC 为高这个时序错一处屏幕显示就会整体错乱。批量写像素时不要每个字节都重新拉高拉低 CS/DC否则刷新效率会很差尤其在全屏清屏或者绘制矩形时会明显卡顿。如果主控 SPI 硬件支持 DMA建议在批量写显存数据时配合 DMA 传输这样可以减轻 CPU 负担让主控在刷屏的同时继续处理传感器和按键扫描。否则全屏刷新过程中可能出现其他任务响应变慢的问题。4.2 LCD 初始化序列参考屏幕初始化的目标是让驱动 IC 进入可显示状态并按预期设置颜色格式、扫描方向和显示开关。下面给出一段简洁的参考初始化序列实际开发中请用屏厂提供的初始化代码替换void lcd_init_sequence(void) { lcd_send_cmd(0x01); // Soft Reset软复位 lcd_delay_ms(120); // 复位后需要延时 lcd_send_cmd(0x11); // Sleep Out退出睡眠 lcd_delay_ms(150); // 等待内部电源稳定 lcd_send_cmd(0x3A); // 接口像素格式设置 lcd_send_data(0x55); // 0x55 表示 RGB56516bit 颜色 // 屏厂初始化代码通常还会包含电源、Gamma、显示窗口等设置 // 这里省略实际项目以屏厂提供的 init code 为准 lcd_send_cmd(0x29); // Display ON打开显示 lcd_delay_ms(20); }为什么复位后必须延时LCD 驱动 IC 内部需要等待振荡器稳定、DCDC 电压建立如果复位后立即发初始化命令某些寄存器会写入失败出现第一批命令丢失、后续画面异常的现象。延时时间一般几十到几百毫秒具体以上电时序要求为准。需要注意一点0x3A 参数 0x55 代表 RGB565 颜色格式这是很多驱动 IC 的通用表示方式但并非所有 IC 完全一致。部分驱动把 16bit 格式定义为 0x05有的定义为 0x55所以最稳妥的方法还是查驱动 IC 手册不要盲目照抄网上代码。4.3 设置显示窗口并画点320X240 屏幕画图的核心思想是“设置窗口 写像素”。比如要在屏幕上画一个点先通过列地址和行地址命令告诉驱动 IC 要写哪块区域然后向该区域连续写入颜色数据。#define LCD_WIDTH 320 #define LCD_HEIGHT 240 void lcd_set_window(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { // 列地址设置 lcd_send_cmd(0x2A); lcd_send_data(x0 8); lcd_send_data(x0 0xFF); lcd_send_data(x1 8); lcd_send_data(x1 0xFF); // 行地址设置 lcd_send_cmd(0x2B); lcd_send_data(y0 8); lcd_send_data(y0 0xFF); lcd_send_data(y1 8); lcd_send_data(y1 0xFF); // 开始写入显存之后连续写入的像素会按顺序填充该窗口 lcd_send_cmd(0x2C); } void lcd_draw_pixel(uint16_t x, uint16_t y, uint16_t color) { if (x LCD_WIDTH || y LCD_HEIGHT) { return; } lcd_set_window(x, y, x, y); uint8_t buf[2]; buf[0] color 8; buf[1] color 0xFF; lcd_write_pixels(buf, 2); }如果只用画点函数绘制整屏界面效率会很低因为每个点都要发一次窗口设置命令。实际项目中建议实现“区域填充”函数用于画背景、按钮、数字和矩形块。比如清除某块区域时一次设置窗口然后批量发送相同颜色数据。4.4 图形库与自绘 UI 的取舍很多新手一上来就想移植 LVGL 到 320X240 彩屏但小家电除湿机界面并不复杂主界面加两三个设置页用自绘方式完全能实现。是否使用图形库需要看主控资源和界面复杂度。如果芯片 Flash/RAM 比较大内存超过几十 KBUI 控件多、需要滑动列表、动画效果用 LVGL、TouchGFX 等图形库更合适。如果芯片资源有限界面就那几页显示内容主要是数字、图标和简单曲线建议直接自绘。减少图形库的内存消耗和移植工作量。即使使用图形库底层也需要封装“画点”“填充矩形”“批量写显存”这几个接口。图形库在界面刷新时会回调 flush 函数把一整个显示区域的数据送到底层屏幕。底层 flush 做得高效整个 UI 才会流畅。5. 除湿机主界面 UI 与数据展示设计5.1 主界面布局如何规划除湿机主界面应遵循“重要信息一眼看到”的原则。优先级最高的是当前湿度第二是目标湿度第三是运行模式和风扇档位最后是环境温度、水满警告、定时时间等辅助信息。一个推荐的布局是屏幕最顶部模式文字 运行状态小图标例如“自动除湿 / 干衣 / 送风”外加 Wi-Fi 图标或水箱满图标屏幕中间当前环境湿度大数字旁边标注“RH”或“当前湿度”屏幕左侧或右侧目标湿度用小字显示旁边有上下方向键提示屏幕下方环境温度、定时时间、滤网清洁提醒。界面设计时要注意320X240 屏幕尺寸有限不要在一屏里塞太多内容。宁可把不常用功能放到二级页面也不要让用户一开机就面对密密麻麻的图标。除湿机不是手机界面简单反而显得可靠。5.2 环境数据的采集与格式化显示显示湿度前主控需要通过温湿度传感器采集当前环境湿度。传感器类型很多常见的有单总线型、I2C 型。这里不讨论具体传感器型号先定义一份统一的数据结构方便 UI 层读取// 文件路径app/service/env_service.h typedef struct { int16_t humi_x10; // 当前湿度乘以10表示如 523 表示 52.3% int16_t temp_x10; // 当前温度乘以10表示如 253 表示 25.3℃ uint8_t water_full; // 水箱满标志 uint8_t mode; // 运行模式 uint8_t fan_level; // 风机档位 uint8_t timer_hour; // 定时时间单位小时 } env_status_t; void env_service_init(void); void env_service_update(void); env_status_t *env_service_get_status(void);温度值使用整数乘 10 的方式可以避免在 MCU 上使用浮点格式化既节省 Flash 和 RAM也避免浮点打印带来的性能问题。显示的时候通过整数运算拆出整数位和小数位。char buf[16]; int humi_int status-humi_x10 / 10; int humi_dec status-humi_x10 % 10; snprintf(buf, sizeof(buf), %d.%d%%, humi_int, humi_dec); lcd_draw_string(100, 60, buf, FONT_SIZE_32, COLOR_BLUE, COLOR_WHITE);如果 UI 需要不断刷新建议不要整屏重绘。当前湿度数字变了只需要把原来数字所在的矩形区域填充成背景色再在新的位置绘制新数字即可。否则每次刷新都闪烁视觉体验会很差。5.3 简单湿度趋势图绘制除湿机彩屏方案里湿度趋势曲线是非常实用的一项显示。它能让用户直观看到除湿机运行一段时间后室内湿度是否在下降。受限于 MCU 算力和刷新方式不必做复杂平滑曲线折线图即可满足需求。下面是一段示例用来在屏幕底部绘制一条 60 点的湿度曲线// 文件路径app/ui/ui_trend.c #define TREND_X_START 10 #define TREND_Y_START 140 #define TREND_Y_HEIGHT 50 #define TREND_POINT_NUM 60 #define HUMI_MAX 90 // 曲线量程上限 #define HUMI_MIN 30 // 曲线量程下限 static int16_t s_humi_history[TREND_POINT_NUM]; void ui_trend_record(int16_t humi) { // 将历史数据左移最旧的数据丢弃最新数据放到末尾 for (int i 0; i TREND_POINT_NUM - 1; i) { s_humi_history[i] s_humi_history[i 1]; } s_humi_history[TREND_POINT_NUM - 1] humi; } void ui_trend_draw(void) { // 先清除曲线区域 lcd_fill_rect(TREND_X_START - 1, TREND_Y_START - 1, TREND_X_START (TREND_POINT_NUM - 1) * 2 1, TREND_Y_START TREND_Y_HEIGHT 1, COLOR_WHITE); for (int i 0; i TREND_POINT_NUM - 1; i) { int16_t h0 s_humi_history[i]; int16_t h1 s_humi_history[i 1]; if (h0 0) { continue; } int16_t x0 TREND_X_START i * 2; int16_t x1 TREND_X_START (i 1) * 2; int16_t y0 TREND_Y_START (HUMI_MAX - h0) * TREND_Y_HEIGHT / (HUMI_MAX - HUMI_MIN); int16_t y1 TREND_Y_START (HUMI_MAX - h1) * TREND_Y_HEIGHT / (HUMI_MAX - HUMI_MIN); lcd_draw_line(x0, y0, x1, y1, COLOR_BLUE); } }这里每个采样点横向间隔 2 个像素60 个点总宽 118 像素不会占满整个屏幕。如果产品界面想显示更多数据可以压缩采样间隔比如每隔 1 像素画一点横向宽度为 59 像素适合放在主界面右下角。趋势曲线最关键的是数组下标边界。记录历史数据时要保证最新数据一定写入数组末尾绘制时也按顺序读取。如果出现数组越界可能把屏幕边缘以外的坐标写进显存导致画面上出现随机横线。6. 交互流程与状态机设计6.1 按键扫描与软件去抖除湿机多数使用实体按键。按键扫描不是简单的 GPIO 读取延时 20ms因为用户按一下可能时间很短也可能长按如果每次按下都立即触发界面跳转会出现一次按键触发两次甚至多次动作的问题。常用的做法是先做去抖再判断边沿。uint8_t key_scan(void) { static uint8_t last_state 0; static uint8_t stable_cnt 0; uint8_t level (gpio_read(KEY_MODE_PIN) 0) ? 1 : 0; if (level last_state) { stable_cnt; } else { stable_cnt 0; } if (stable_cnt 5) { stable_cnt 5; return level; // 返回去抖后的稳定电平 } return 0xFF; // 表示状态不稳定忽略本次扫描 }实际 UI 层需要判断的是“按键按下的一瞬间”而不是持续电平。可以先把去抖后的电平保存下来再用上一次状态和当前状态做边沿检测只在下降沿触发一次按键事件这样能避免按住键时页面一直刷新。6.2 页面切换状态机除湿机界面一般存在多级页面比如主页、设定页、模式切换页、定时页。用 if-else 处理页面会越写越乱推荐使用状态机。先定义页面枚举typedef enum { PAGE_MAIN 0, PAGE_SET_HUMI, PAGE_SET_TIMER, PAGE_INFO, PAGE_MAX } app_page_t;然后在主循环或者定时中断里根据当前页面和按键事件决定执行哪个页面处理函数void ui_main_loop(void) { uint8_t key key_get_event(); switch (app_ctx.page) { case PAGE_MAIN: page_main_handle(key); break; case PAGE_SET_HUMI: page_set_humi_handle(key); break; case PAGE_SET_TIMER: page_set_timer_handle(key); break; case PAGE_INFO: page_info_handle(key); break; default: break; } }页面处理函数内部只需要关心本页面的按键响应。例如在 PAGE_MAIN 页面按“”键就进入目标湿度设置页在 PAGE_SET_HUMI 页面按“”键则目标湿度增加 5%同时更新界面上的目标湿度显示。这样拆分的好处是新增一个页面时不需要改动其他页面逻辑只需要添加一个枚举值、增加一个 case 分支再写一个对应的页面处理函数即可。并且每页的数据刷新任务也能单独管理避免所有绘制都堆在主页面函数里。6.3 湿度控制与 UI 显示的时序配合除湿机显示方案里有一个容易出现的问题显示刷新频率过高会干扰控制逻辑。除湿机采集的湿度数值本身是波动的如果显示层每 10ms 刷新一次湿度数字用户会看到数字不断跳动看起来很不稳定。建议把控制周期和显示刷新周期分开。压缩机控制逻辑可以用 1 秒到几秒的周期判断湿度阈值UI 显示则固定几百毫秒刷新一次。湿度曲线则按分钟级别采集比如每 30 秒记录一个点连续显示 30 分钟内的趋势更有参考意义。可以把传感器任务做成一个定时器回调每次更新全局环境结构体UI 任务只从结构体取最新数据不直接阻塞读取传感器。这样即使 I2C 或单总线传感器偶尔出现应答超时也不会导致整机 UI 卡死。7. 常见问题排查与调试建议7.1 白屏、花屏与颜色异常问题现象常见原因解决思路白屏无任何显示初始化未执行、复位脚未拉高、背光未开用示波器看 RESET 和 BL确认初始化命令是否发出花屏且颜色杂乱DC 脚电平接反或驱动 IC 初始化错误检查 DC 切换逻辑对比屏厂初始化序列全屏颜色偏红/偏绿/偏蓝RGB 颜色通道顺序不对检查 RGB565 数据高低字节发送顺序必要时在应用层做交换屏幕内容镜像或方向不对扫描方向寄存器设置错误调整驱动 IC 的扫描方向寄存器或者通过旋转坐标处理白屏问题最常见的原因是复位时序不对。如果主控上电比屏幕模组慢屏可能在内部还没准备好时收到了初始化命令后续命令全部无效。建议复位脚用 GPIO 控制初始化前先拉低一段时间再拉高等待几十毫秒后再发送初始化序列。花屏问题的排查重点在 DC 线和初始化序列。可以用逻辑分析仪抓取命令阶段的数据内容和屏厂示例代码输出对比看是否在命令位置多写了数据或者在数据位置误发了命令。7.2 屏幕闪烁与刷新残影显示刷新过程中出现闪烁通常不是屏幕质量问题而是刷新策略不合理。常见原因包括整屏频繁重绘、清屏和绘制之间间隔太长、背光 PWM 频率偏低。解决思路是先做局部刷新。比如当前湿度数字从 52% 变成 53%只需要刷新数字所在矩形区域不要调用全屏清屏函数。如果必须整屏刷新可以先关闭显示把图像数据全部写入显示 RAM再打开显示这样用户不会看到“涂抹过程”。背光 PWM 频率建议设置在 1kHz 以上。如果 PWM 频率低于几百 Hz视觉上能明显感觉到闪烁。另外背光直接使用低频 PWM 调光时摄像头拍摄时更容易看到扫描纹量产测试时要留意。7.3 湿度数字显示异常跳动除湿机 UI 上湿度数字跳动经常会被误认为是显示 bug实际上可能是数据本身波动。湿度传感器放在出风口附近除湿机运行时局部湿度会快速变化采集值自然会震荡。排查步骤包括先把传感器采集值通过串口打印出来确认数字跳动是 UI 问题还是传感器数据问题对湿度采样值做软件滤波例如连续采集 5 次去掉最大最小后取平均显示时增加变化门限例如湿度变化在 0.5% 以内时不更新界面避免无意义刷新传感器要避免紧贴蒸发器和出风口位置应能代表房间环境湿度。如果串口打印的数据稳定但屏幕上偶尔显示旧值或错值多数是刷新时没有同步。UI 读取传感器数据时可以先关中断或读取保护取完数据后再恢复保证多字节读取过程不被高优先级中断打断。7.4 继电器动作导致屏幕闪动除湿机在启动压缩机的瞬间继电器吸合会产生比较大的电流跳变和电磁干扰。如果屏幕供电和继电器驱动共用一个电源干扰可能会传导到屏的逻辑电路导致闪屏或瞬间花屏。工程上可以从几个方向处理在继电器线圈两端并联续流二极管或 RC 吸收电路屏幕逻辑电源使用单独的 LDO并增加 100nF 和 10uF 去耦电容主控、屏幕、继电器驱动的地线采用单点接地或大面积铺地避免形成地环路SPI 线尽量远离继电器驱动线和压缩机负载线。这种问题在开发板上往往复现不出来因为开发板供电来自 USB继电器负载也比较小。到了整机测试阶段用实际压缩机负载做长时间老化测试才能暴露干扰问题。7.5 代码升级后屏幕方向变了如果项目开发到一半换了同分辨率但不同扫描方向的屏幕模组可能会出现之前的代码显示方向不对。这个不是 bug而是因为新模组的驱动 IC 内部扫描方向和旧模组不同。解决办法是修改扫描方向寄存器常见命令 0x36的参数然后在窗口设置函数中同步调整坐标原点。注意修改扫描方向后行地址和列地址的原点也要保持一致否则会出现图像只显示一部分另一部分是花屏或空白的情况。调整坐标时可以封装成一个函数把屏幕坐标转换成底层驱动 IC 坐标这样 UI 层永远按照 0 到 319、0 到 239 的逻辑坐标画界面屏幕本身的物理方向变化只在驱动层处理。8. 工程化与量产落地建议8.1 UI 刷新应避免阻塞主循环除湿机显示方案虽然重点是屏幕但主控还要同时处理传感器、按键、压缩机控制。如果 UI 刷新函数里包含大量阻塞延时例如每个像素发送后都等待 SPI 中断会导致整机实时性下降。比较好的做法是把界面绘制拆成两个阶段。第一阶段计算当前页面需要更新的区域和数据内容第二阶段把绘制数据写入显示缓冲区并批量发送。如果使用不带缓冲的直接写屏方式则尽量保证单次绘制函数的执行时间可控不要在中断服务函数里做耗时绘制。8.2 菜单动作不要太快用户按下“模式”键后如果按键和页面切换速度太快用户会感觉按键不跟手相反的如果去抖时间太长又会觉得反应迟钝。一般菜单按键事件触发到页面切换可以控制在几十毫秒内但页面上的高亮变化最好有 50ms 到 100ms 的确认感让用户意识到按键已经生效。而在目标湿度调整场景按住“”键不放时希望数值连续增加。这时需要增加长按计数逻辑通常按住超过 500ms 后进入连发模式每 200ms 左右加一档。这个细节对体验提升很大很多低价小家电的 UI 恰恰在这里做得比较粗糙。8.3 屏幕初始化代码要固化版本屏幕初始化寄存器序列看着很底层却是最容易在量产阶段出问题的部分。建议把初始化序列放到独立文件里并在代码注释中记录初始化序列来源、适配模组型号、修改日期和修改人。示例/* * 模组型号: XXX-TFT28 2.8寸 320X240 * 驱动 IC : ILI9341 兼容 * 初始化来源: 屏厂 demo 代码 2025-01-10 * 修改记录: * - 2025-01-10: 初始版本适配样机 * - 2025-02-13: 修正 RGB 高低字节顺序解决颜色偏色问题 */ static const uint8_t s_lcd_init_cmds[] { ... };如果产品有两种不同的屏幕供应商建议在驱动层预留编译宏根据硬件版本选择不同初始化序列。否则同一套代码用在两批屏上可能会出现部分批次花屏而生产测试又很难逐台发现问题。8.4 屏幕与整机功耗控制除湿机虽然使用市电供电不依赖电池但仍需要考虑待机功耗和屏幕寿命。整机待机时屏幕可以进入休眠模式或直接关闭背光用户需要查看状态时再通过按键唤醒屏幕。屏幕长时间显示同一画面虽然不会像 OLED 那样烧屏但从可靠性和功耗角度也建议增加“无操作自动熄屏”功能。例如 5 分钟无按键操作背光调暗10 分钟无按键操作关闭背光只保留指示灯。这样既延长屏幕背光寿命也能降低整机运行功耗。8.5 更稳妥的开发顺序最后建议刚接触 LT165A 彩屏方案的开发者不要急着把控制逻辑和 UI 一次写完。比较稳妥的开发顺序是第一步用官方例程点亮屏幕能显示纯色和中英文字符 第二步接入温湿度传感器把实测数据和显示数字打通 第三步实现主页面布局和状态机保证页面切换可靠 第四步加入湿度曲线、定时、水满告警等辅助功能 第五步整机联调重点测试继电器频繁动作和长时间老化场景。每一步都留一个可复现的版本这样即使某一步出问题也能快速回退定位。屏幕驱动这种底层工作最怕的就是所有功能堆在一起后才开始调试那时候花屏很难判断是硬件、初始化、还是 UI 绘制引入的问题。如果你也正在做同类的家电彩屏显示方案建议先把屏幕初始化、坐标抽象和页面状态机这三块做扎实。芯片型号可以换屏幕接口可以从 SPI 换成并口但一套清晰的显示架构和工程分层能让你在后续改版中省下大量的重复调试时间。彩屏显示方案最终拼的往往不是屏幕效果多炫而是整机长时间运行时的稳定性和可维护性。