“整定“这件事做控制或调试的朋友应该都不陌生。不管你是调PID参数、校传感器零点还是给设备配通信地址最原始的办法就是改代码、重烧、看串口周而复始。上一期我们聊到固件整体框架之后这期我想换个角度在动手整定任何参数之前先花半天时间给固件加上一个人机界面。别小看这个步骤它能在后续所有调试环节里帮你省下大量时间。这篇内容适合正在做MCU固件开发、想给设备加屏显示和交互功能的朋友。不管你的平台是STM32、ESP32还是其他常见MCU思路都通用。我会从方案选型讲到界面布局再给出可直接抄作业的代码框架最后把我在实际项目里踩过的坑一并交代清楚。1. 为什么整定之前先做一个人机界面1.1 串口调试的痛点你我都懂我最早调参数也是串口流printf一糊串口助手一开数据啪啪往外打。但用久了就会发现这玩法有几个非常难受的地方。第一参数看不到全貌。你调一个PID想看当前误差、上次误差、输出量、积分累积值一次printf只能打一长串数字人眼盯半天才能对应上。第二改参数要重新编译烧录。改Kp改成0.5编译、烧录、复位、重新触发整个过程几十秒一天下来几百次时间全耗在等编译器上了。第三现场条件往往很恶劣。设备装在电机柜里旁边就是强电笔记本拖着串口线插过去调试安全性和便利性都成问题。后来我试着用上位机配合串口协议来做效果确实好很多但有一个绕不开的前提上位机得跟着你的固件走。协议一变就要同步改这是个无形的维护负担。所以我在一次设备改造项目中试了给固件直接加一块屏做了按钮和参数编辑界面之后整个调试体验完全变了样。从那一刻起我才真正理解那句话好的工具不是功能多而是能让你不打断思路地工作。1.2 人机界面在固件里的真实定位有人一说人机界面就想到手机App那种炫酷动画这种预期放在MCU上本身就不现实也没必要。固件里的人机界面核心职责就三条显示状态、调整参数、触发动作。显示状态是把ADC采回来的原始值、换算后的工程量、运行模式、报警标志等关键信息直观摆出来。一条屏显胜过十行printf因为你扫一眼就知道设备现在正不正常。调整参数是让你在不下电、不拆机、不重新编译的前提下直接把Kp从1.2改成1.5写进Flash下次开机还是你的新值。触发动作是给你一个手动入口比如手动开关阀门、强制进入校准模式、触发一次自检这对现场调试太重要了。换句话说人机界面在固件里的角色不是“好看”而是“可控”。它把调试者和设备之间的沟通成本降到了最低。我后来的习惯是任何需要多次整定的固件第一版就预留界面框架哪怕只有一屏也先搭起来后续扩展非常快。2. 方案选型屏幕、驱动与交互怎么搭才稳妥2.1 屏幕硬件的选择思路屏幕是界面的大前提选型主要看三个维度接口方式、尺寸分辨率、驱动资源占用。接口方式直接决定你接线和驱动复杂度。常见的有SPI、I2C、并口、RGB、MIPI这几类。对MCU项目来说SPI屏最省引脚、驱动也最成熟ILI9341、ST7735这些经典驱动芯片几乎到处都有现成库。I2C屏能做但帧率一般适合只显示少量文字或数字的极简场景。并口屏刷新快但引脚消耗大一般得看MCU富余资源。RGB/MIPI屏效果好但基本得上专用显示控制器或者高性能MPU普通MCU别碰。分辨率方面要看内容量。如果你只需要显示几行参数和状态1.3寸到2.4寸的屏完全够用。如果要显示曲线、图表或者复杂菜单至少2.8寸起步320x240是底线。我自己用过最多的是2.4寸240x320 SPI屏配ILI9341性价比高、资料多、出问题容易查。尺寸再小一点的话ST7735的1.8寸屏也很常用做手持小设备刚好。驱动的资源占用也要提前算。驱动一个320x240的SPI屏如果用SPI硬件外设加DMACPU占用其实可以压得很低。但如果你在刷屏的同时还要跑PID运算、通信协议、数据采集最好量一下FPS和主频的余量。我在STM32F103主频72MHz上驱动240x320 SPI屏跑一个基础刷新实测CPU占用不到20%完全不影响控制逻辑。2.2 GUI框架选型自己画还是用现成库屏幕点亮之后下一个决策点就是界面逻辑自己写还是套GUI库。自己写的优势是零依赖、完全掌控、代码量小。适合那种界面非常简单、只有几个固定页面和少量按键逻辑的项目。缺点是扩展性差菜单层级一多代码就乱而且按键状态机、焦点管理、重绘优化都得自己处理调起来挺费心思的。我在早期一个项目里手写过几十个界面的切换逻辑后来再加新页面产物变得很脆改一处崩三处。用现成GUI库的优点是省心。嵌入式领域比较常见的几种方案LVGL算是功能最全、社区最活跃的支持控件多、动画流畅、有PC模拟器可以直接在电脑上预览界面效果。u8g2主打字体和显示协议支持轻量适合纯文本/简单图形的需求。AWTK和TouchGFX也各有特点但学习成本和资源占用都相对高一些。我的选择习惯很简单资源够、需要复杂交互选LVGL只是显示数据加简单按键u8g2就很舒服。DMA不DMA其实不是GUI库的事而是底层驱动的事。无论用哪个库底层画点、画矩形、填充这些函数如果借用DMA传输刷新率能明显提升。LVGL内部有lv_disp_flush_cb回调你把SPI DMA发送放在回调里就能实现“CPU只管生成帧数据传输交给DMA”。2.3 交互部分按键、编码器还是触摸屏界面有了人怎么操作这个环节决定了调试时的效率选择也是一门学问。最常见的是独立按键方案。几个GPIO接微动开关直接用轮询或外部中断处理。优点是稳定、便宜、防水好做缺点是键少菜单层级必须设计得简洁。我的习惯是保留“上、下、确认、返回”四个键再复杂也不追加了因为菜单层级深了按键效率太低。旋转编码器是工程师的老朋友。带按键的旋转编码器一个就能替代上/下/确认三个键旋转调参数的手感比按键爽太多了。而且编码器的读数逻辑本质上就是AB相脉冲计数驱动代码非常稳定。如果你做的是仪器类设备强烈建议上编码器整定参数的时候你就知道多舒服了。触摸屏是体验最好的方案但要考虑成本、贴合工艺、驱动复杂度和意外触摸误触的问题。工业现场如果油污多、操作者戴手套电阻触摸比电容触摸更实用。我通常在功能验证阶段用按键或编码器等产品形态完全定了再考虑触摸的导入这样能规避不少早期返工成本。3. 界面布局与交互逻辑把“整定”场景拆解成界面结构3.1 明确你的界面要给谁看、用来干什么做界面最忌讳一上来就画控件。先想清楚这个界面服务的对象是谁。对象不同信息组织方式完全不同。如果是车间操作工用的界面要突出“当前状态”和“故障提示”操作尽可能少最好一键开机、一键停机参数页面最好带密码保护。如果对象是调试工程师也就是整定这种场景界面就要突出“参数可见性”和“调节的即时反馈”最好能把关键数据实时动态刷新出来参数改完立刻能看到效果。3.2 页面结构设计状态页优先参数页分层以我做过的电机驱动类设备为例当时的界面分成了四层结构。主状态页是开机默认页显示设备模式、运行速度、母线电压、电流、温度这几个核心量。这部分逻辑最简单就是定时刷新文本标签。参数菜单页是入口按功能分组PID参数、通信设置、校准设置、系统信息。用户按“菜单”键进来用“上/下”选分组按“确认”进入子菜单。这里的核心设计理念是能聚类的参数绝不摊平否则菜单一长串翻页翻到怀疑人生。参数编辑页是关键。这一页显示两个关键信息参数名和当前值。进入编辑态后数值开始闪烁此时上/下键可以改数值长按可以快速加减步进加速确认键保存整定值并写Flash返回键放弃改动。具体逻辑我后面在代码部分给出来这里先把思路定清楚。3.3 布局原则大数字优先、常用操作靠手边界面布局上的小心思实际调试体验影响很大。参数数字一定要大。调试的时候人经常站在设备前面离屏幕有一定距离数字小了看不清就得凑近移来移去很烦。我通常至少让数值占屏幕宽度的三分之一用粗体或大号字体显示。当前选中项要明显。不管是用按键还是编码器焦点在哪个控件上必须一眼就知道。LVGL里就是给控件加状态样式聚焦时边框高亮或背景变色。u8g2这种纯绘制的话我一般会在选中行前面画一个“”符号或者在数值外面画一个矩形框。状态页和参数页之间的切换要顺。短按菜单键回主状态页长按菜单键直接进参数菜单这种操作习惯一旦养成效率很高。另一个小技巧是所有页面都支持“长按返回键回到主状态页”不管层级多深一键脱身这在现场操作的时候特别救急。4. 核心代码实现一个能跑的固件界面框架4.1 底层显示驱动初始化我以STM32 SPI ILI9341为例给出核心代码。前提是你已经用STM32CubeMX建好工程SPI2配置为硬件SPI启用DMA波特率设在40MHz左右。这一步可以省去逐字节发送的等待时间大幅提升刷新率。先看ILI9341初始化序列的关键部分。读取ID之后按厂商时序完成初始化然后用回调接口对接上层GUI库。// ili9341.h 关键定义 #define ILI9341_WIDTH 240 #define ILI9341_HEIGHT 320 typedef struct { void (*reset)(uint8_t level); void (*select)(uint8_t en); void (*dc)(uint8_t level); void (*spi_send)(uint8_t *buf, uint32_t len); } ili9341_io_t; uint8_t ili9341_init(ili9341_io_t *io); void ili9341_set_window(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1); void ili9341_fill_rect(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color);初始化的时候有个容易踩的坑复位脚的时序。有些屏的复位脚要求先拉低至少10ms再拉高如果复位时序不够屏会随机花屏或者白屏。我第一次调这块屏的时候就是复位时序太短导致上电偶尔不显示后来把延时加大到20ms才稳定。底层发送函数建议用DMA。每次flush前先把数据填到缓冲里再启动DMA发送发送完成后在中断里清标志并回调。这样CPU在等待传输时可以去刷新下一帧。4.2 LVGL的对接与移植文件LVGL移植到STM32其实很成熟把底层驱动挂到lv_conf.h和lv_port_disp.c即可。下面是flush回调的典型实现void lv_port_disp_flush(lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p) { ili9341_io_t *io g_lcd_io; uint32_t w lv_area_get_width(area); uint32_t h lv_area_get_height(area); ili9341_set_window(area-x1, area-y1, area-x2, area-y2); io-select(0); io-dc(1); io-spi_send((uint8_t *)color_p, w * h * 2); io-select(1); // 重要提示模拟器或真机上必须调用 lv_disp_flush_ready lv_disp_flush_ready(disp_drv); }这里颜色格式要注意。LVGL的LV_COLOR_DEPTH设置为16位时lv_color_t默认是RGB565格式正好和ILI9341一致不需要额外转换。但如果你不小心把LVGL配成了32位就必须做格式转换否则颜色全乱。还有一个容易被忽略的点是刷新缓冲大小。LVGL的LV_DISP_BUF_SIZE可以是部分缓冲比如屏幕面积的1/10也能正常工作。缓冲越大刷新越流畅但对MCU RAM压力越大。我一般取240 * 20这种行缓冲级别既省RAM又不会觉得卡。4.3 参数编辑页的状态机逻辑参数编辑是整定场景的核心交互。我设计了一个简单的状态机三种状态分别是显示态、编辑态、保存确认态。typedef enum { PARAM_DISPLAY, PARAM_EDIT, PARAM_SAVE_CONFIRM } param_edit_state_t; typedef struct { param_edit_state_t state; int16_t value; int16_t original_value; uint8_t digit_index; uint16_t tick; } param_editor_t; void param_editor_init(param_editor_t *ed, int16_t init_val) { ed-state PARAM_DISPLAY; ed-value init_val; ed-original_value init_val; ed-digit_index 0; ed-tick 0; } void param_editor_on_key(param_editor_t *ed, uint8_t key, uint8_t repeated) { switch (ed-state) { case PARAM_DISPLAY: if (key KEY_ENTER) { ed-state PARAM_EDIT; ed-tick 0; } break; case PARAM_EDIT: if (key KEY_UP) { if (repeated) ed-value 10; else ed-value 1; } else if (key KEY_DOWN) { if (repeated) ed-value - 10; else ed-value - 1; } else if (key KEY_ENTER) { ed-state PARAM_SAVE_CONFIRM; } else if (key KEY_BACK) { ed-value ed-original_value; ed-state PARAM_DISPLAY; } break; case PARAM_SAVE_CONFIRM: if (key KEY_ENTER) { // 写Flash并更新original_value nvm_write_param(ed-value); ed-original_value ed-value; ed-state PARAM_DISPLAY; } else if (key KEY_BACK) { ed-value ed-original_value; ed-state PARAM_DISPLAY; } break; default: break; } }这段代码逻辑本身简单但设计上有几个细节值得琢磨。第一个是“长按加速”用repeated标志位实现快速加减在参数跨度大的时候非常省时间。第二个是“保存前确认”这一态防止手滑改坏了直接写Flash调试时参数写坏了再恢复很麻烦。第三个是“放弃修改返回原值”这个习惯一定要养成等你给编码器改了一百次参数的时候就会感谢这个功能。4.4 参数快速切换调试效率的决定因素虽然现在每次只能编辑一个参数但整定过程经常要在多个参数之间来回切换。比如调PIDKp、Ki、Kd三个参数可能要交替反复改十几次。为了提高效率我把参数页做成了“参数列表当前参数值”的形式。参数列表在左侧显示当前选中的参数高亮右侧是它的实时值。上下键切换参数项左右键或在编辑态下增减数值。这样一次进入参数菜单后所有参数都摊在你面前来回改非常快不需要频繁进出菜单。具体到LVGL的实现列表可以用lv_list或几个lv_label手动摆关键是焦点切换时要同步刷新右侧的值区域。如果你用u8g2这种方式纯绘制思路也一样维护当前选中索引重绘时根据选中项渲染不同背景色。5. 中文显示与字库最容易翻车的环节5.1 中文字库的方案选择做中文界面第一个问题就是字库。英文ASCII每个字模小内置字库随随便便就能装下。中文GB2312常用字三千多个一个16x16的点阵字模是32字节三千字就是96KB直接用数组放Flash里也不算大但排版提取和制作过程会麻烦点。我常用的做法分三种。第一种是全部用英文界面这是最省事的但车间操作工看不懂英文的场景得慎重。第二种是用全字库把项目里可能出现的所有汉字一次性提取出来生成一个bin文件放在外部Flash或内部Flash里运行时按GB2312编码索引查字模。第三种是只做动态字库程序运行到哪个界面需要哪些字就只加载对应字模节省Flash但会增加逻辑复杂度。实测下来对于界面文本基本固定、不涉及用户输入的场景“全字库bin文件”是最稳的方案。你可以在PC上用工具把GB2312编码范围内的汉字全部生成一个16x16点阵或24x24点阵的bin烧到外置Flash里MCU上电后直接映射访问。MCU端的解码就是查表偏移很稳定不用每次上电现生成。5.2 字模索引与绘制代码示例以16x16点阵为例GB2312汉字内码两个字节H和L区位码换算公式是区位码 (H - 0xA0) * 94 (L - 0xA0) // 这里从1开始0表示无效如果我把所有汉字按GB2312顺序连成bin那么某个汉字的偏移就是uint32_t offset (area_code - 1) * 32; // 每个汉字16x16点阵占32字节绘制的时候按从左到右、从上到下扫点阵1就画点0就跳过。比如这样void draw_gb2312_char(uint16_t x, uint16_t y, uint8_t *code, uint16_t color) { uint8_t buf[32]; uint32_t offset gb2312_offset(code); flash_read(g_font_base offset, buf, 32); for (int row 0; row 16; row) { for (int col 0; col 16; col) { if (buf[row * 2 col / 8] (0x80 (col % 8))) { lcd_draw_pixel(x col, y row, color); } } } }这套代码写一次后面所有页面都能复用。但要注意如果MCU的Flash本来就紧张中文字库就尽量外挂或放到外部Flash别占用代码空间否则后面加功能时会很痛苦。6. 常见问题与排查技巧实录6.1 屏幕白屏或花屏现象是上电后屏幕全白或者麻花状乱码。九成原因是初始化时序不对。我排查的固定顺序是先看复位电平时序再看供电电压是否为3.3V且纹波不大然后检查SPI时钟极性空闲电平是不是和屏匹配最后确认初始化命令序列是否完整。ILI9341的初始化命令序列如果漏了某些关键指令比如进入正常模式或关闭睡眠屏幕就会白屏。建议用逻辑分析仪抓一次SPI波形和厂家的参考驱动时序对比差一条命令都能看出来。6.2 有显示但触摸不灵或按键没反应如果界面正常显示但操作没响应优先排查中断或轮询逻辑。按键的抖动处理没做好会导致“按一次变两次”很烦人。最土也最有效的方案是软件消抖检测到IO电平变化后延时20ms再读一次确认稳定再上报。对于旋转编码器我之前踩过一个坑两个GPIO没有配置内部上下拉导致编码器静止时电平悬空MCU疯狂计数。后来把GPIO配置为带上拉的输入模式问题立刻消失。6.3 参数写不进Flash调试正High参数编辑完一确认重启又变回旧值这个非常打击信心。排查思路是先确认写Flash的地址有没有和代码区重叠再确认你写的是不是整页擦除、若写入长度不足一页要不要做备份处理最后确认写Flash期间有没有关中断有些MCU在Flash写操作期间不允许中断服务程序执行Flash读操作否则直接进HardFault。我的建议是写Flash操作尽量放进一个专门的模块里统一做地址管理、擦写预算和校验别在参数编辑页里散着写。很多量产设备写坏就是因为Flash擦写次数控制不当或者掉电瞬间写一半导致参数区损坏。6.4 刷新慢到没法用界面卡顿的原因一般是几个叠加SPI速度太低、没有用DMA、LVGL缓冲太小、主频太低、或者你的绘制代码里用了软件取模频繁访问Flash。排查建议从最底层开始先把SPI时钟提到芯片允许的最高频率用DMA替代阻塞发送再适当增加LVGL刷新缓冲。如果还是慢考虑降低屏幕分辨率或者减少每帧需要重绘的控件数量。实测下来只要SPI到了36MHz以上240x320的屏幕做文本刷新就不会觉得卡了。7. 实操总结我的建议和踩坑心得最后分享几个从项目里总结下来的经验这些在文档里通常不会写但每一条都是真金白银换来的。如果你从来没有在固件里加过人机界面第一条建议是先用模拟器把界面流程跑通再碰硬件。LVGL官方有PC模拟器可以在电脑上编辑、调试界面布局和交互确认没问题了再移植到MCU上。这样能把“逻辑调试”和“硬件调试”解耦少走很多弯路。第二条建议是界面框架要在项目早期就搭好但内容可以后补。也就是说第一版只需要一个能翻页的壳子每一个参数页先放着占位。等真实整定需求来了直接往壳子里填参数就行不需要重新搭框架。前期这半天投入后期能给你省下好几天。第三条建议是参数存储的格式和地址从一开始就要留好。别等到后面加了一百个参数才发现地址规划不合理统一迁移Flash布局是很痛苦的。我习惯把所有运行参数的NVM地址集中放在一个头文件里每个参数分配固定偏移预留扩展槽位同时预留版本号和校验字段为以后做固件升级也打了基础。这个界面框架后续还能怎么扩展我这边已经在往两个方向走一个是通过通信接口进行远程界面同步和参数下发另一个是把界面屏幕换成支持曲线的型号直接把历史波形画在屏上。这两个方向都是在当前框架上的自然生长不需要推倒重来。希望这篇内容能给你一些启发也欢迎实际操作中遇到过其他坑的朋友来交流。