物联网省赛代码包拆解：矩阵按键、LoRa与电位器ADC实战

简介面向2024年蓝桥杯第十五届物联网省赛备赛者与嵌入式学习者这份完整代码围绕矩阵按键扫描、LoRa无线通信和电位器取值展开可作为赛题实现参考与联调模板。压缩包共371个文件约11.27MB包含111个.h头文件、55个.c源文件、55个.crf及57个.o、57个.d等编译中间文件并配有uvprojx工程、ioc配置、hex烧录文件和STM32L0xx HAL库源码便于还原工程结构。现有189人学习读者可从中梳理LoRa A/B双端通信、按键与ADC数据处理、数据封装发送及工程配置思路适合对照排查编译与硬件联调问题。1. 省赛物联网代码包拆解矩阵按键、LoRa、电位器三件事怎么落到一块板子上拿到一份 2024 年某省级物联网竞赛的完整代码第一反应不应该是插上下载器烧录。先看三个数据通路有没有打通矩阵按键把物理动作变成键值事件电位器把模拟电压变成 ADC 采样值LoRa 通信把这两类数据装进帧发到另一端。这个代码包解决的就是物联网省赛里最常考的三块底层落地——矩阵按键扫描、LoRa 点对点收发、电位器 ADC 取值适合正在准备省赛、需要一套能改参数就能跑的参考工程的人。它不替代模块手册也不教你画板子但把扫描周期、采样滤波、帧格式和超时重传这些联调时容易翻车的点摆在了明面上。先别急着看业务层把引脚、时钟、DMA 和串口分配对一遍后面能少熬两个晚上。2. 工程结构与配置先把引脚、时钟和 DMA 定死2.1 代码包目录与模块边界这类完整代码包最常见的组织方式是“板级支持 驱动 应用”三层。不要把所有逻辑塞进main.c否则矩阵按键的 10 ms 扫描和 LoRa 的串口接收会互相拖死。下面是一份常见目录结构不同工程的文件名可能略有差异但边界基本一致。目录/文件作用改动频率Core/Src/main.c初始化、任务调度骨架低BSP/key.c矩阵按键扫描、消抖、键值映射中BSP/adc_pot.c电位器 ADC 启动、滤波、量程换算中BSP/lora_port.cLoRa 串口收发、超时、重传中App/app_protocol.c帧组装、解析、命令分发高App/app_tasks.c周期任务调度高Drivers/底层库与启动文件低我一般会先看main.c里有没有把初始化顺序写反。ADC 的 DMA 必须在 ADC 校准之后启动LoRa 串口必须在 GPIO 复用配置之后初始化矩阵按键的行列引脚最好在时钟使能后统一配。顺序错一个现象往往不是报错而是“偶尔能跑”。2.2 时钟、GPIO 与 ADC/DMA 的配置参数配置表比口头描述可靠。下面这张表是这类省赛板卡上比较常见的起手参数具体引脚号以原理图为准不要照抄。外设/模块关键参数建议值说明系统时钟主频按板卡晶振与手册先保证串口波特率误差小于 2%矩阵按键行线GPIO 模式推挽输出扫描时逐行拉低矩阵按键列线GPIO 模式上拉输入读低电平判断按下电位器 ADC分辨率12 bit04095电位器 ADC采样时间71.5 cycles 起电位器源阻抗高时加长电位器 ADC转换模式连续 DMA 循环避免主循环反复启动调试串口波特率115200只用于打印不接 LoRaLoRa 串口波特率9600 起以模块手册为准两端一致按键扫描节拍定时器/系统节拍10 ms消抖计数按 23 次初始化骨架可以写成下面这样。注意ADC_Start_DMA放在校准之后LoRa 和按键的初始化放在 GPIO 之后。/* main.c 初始化顺序先时钟和 GPIO再外设再启动 DMA */ int main(void) { HAL_Init(); SystemClock_Config(); /* 时钟先定串口波特率才准 */ MX_GPIO_Init(); /* 矩阵按键行列、LoRa 复位脚 */ MX_DMA_Init(); /* ADC 和串口接收都依赖 DMA */ MX_ADC_Init(); /* 电位器通道、连续转换 */ MX_USART1_UART_Init(); /* 调试串口115200 */ MX_USART2_UART_Init(); /* LoRa 串口9600 起 */ Key_Init(); /* 行线输出低、列线上拉输入 */ LoRa_Init(); /* 拉复位、等启动、清空接收缓冲 */ HAL_ADCEx_Calibration_Start(hadc); /* 校准后再启动 DMA */ HAL_ADC_Start_DMA(hadc, (uint32_t *)adc_buf, ADC_BUF_LEN); while (1) { Key_Scan_10ms(); /* 10 ms 节拍调用一次 */ LoRa_Rx_Task(); /* 非阻塞解析接收帧 */ App_Report_Task(); /* 组帧上报按键与电位器值 */ HAL_Delay(1); } }这段代码的逻辑是把“启动顺序”和“周期任务”分开初始化只做一次while(1)里只跑非阻塞任务。参数上ADC_BUF_LEN常见取 8 或 16取太小滤波窗口不够取太大实时性变差HAL_Delay(1)只是让出节拍不能拿它当按键消抖。LoRa 的接收不要在HAL_Delay里等串口空闲中断或 DMA 接收更稳。提示调试串口和 LoRa 串口不要共用同一个 USART。省赛板卡上经常把两个模块接到同一组引脚飞线之前先看原理图。2.3 把“软件/插件/网络”三个词落到工程里这份代码包的价值不只在三个外设驱动还在它把“软件分层、协议插件、网络拓扑”拆开了。软件层负责周期调度和状态机插件层负责不同命令的解析网络层负责 LoRa 点对点链路的帧收发。应用层只关心“按键事件”和“电位器工程量”不关心底层是串口还是 SPI。一个常见做法是用函数指针注册命令处理函数新增一条命令时不用改解析主循环/* app_protocol.c命令插件注册解析器只认命令字 */ typedef void (*cmd_handler_t)(const uint8_t *payload, uint8_t len); typedef struct { uint8_t cmd; cmd_handler_t handler; } cmd_plugin_t; static void on_key_event(const uint8_t *payload, uint8_t len); static void on_pot_value(const uint8_t *payload, uint8_t len); static const cmd_plugin_t plugin_table[] { {0x01, on_key_event}, /* 按键事件上报 */ {0x02, on_pot_value}, /* 电位器值上报 */ }; void App_Dispatch(uint8_t cmd, const uint8_t *payload, uint8_t len) { for (uint8_t i 0; i sizeof(plugin_table) / sizeof(plugin_table[0]); i) { if (plugin_table[i].cmd cmd) { plugin_table[i].handler(payload, len); return; } } /* 未知命令只记计数不阻塞接收 */ }这段代码的逻辑是把命令字和处理函数解耦参数cmd是帧里的命令字节payload指向载荷len是载荷长度。新增命令时只改plugin_table不改App_Dispatch。在 LoRa 点对点网络里两端命令字必须一致但载荷长度可以按命令变化长度字段一定要在解析前校验否则越界读会让整个工程跑飞。3. 矩阵按键扫描从行扫描到消抖状态机3.1 矩阵键盘的电气连接与扫描原理矩阵按键不是“每个键一根线”而是行线和列线交叉。常见接法是行线推挽输出、列线上拉输入。扫描时每次只把一行拉低读所有列线如果某一列读到低电平就说明该行该列的键被按下。4×4 矩阵只需要 8 根 GPIO比独立按键省引脚但代价是扫描逻辑和鬼键问题。信号配置电平含义注意行线 ROW0ROW3推挽输出低电平有效同一时刻只拉低一行列线 COL0COL3上拉输入低电平表示按下内部上拉弱长线要外部上拉扫描周期10 ms消抖计数 23 次不要放在 1 ms 中断里狂扫长按阈值800 ms 起按项目定义与短按事件分开入队扫描流程不复杂拉低第 0 行读四列恢复第 0 行拉低第 1 行再读四列四行轮完得到原始键值。真正的坑在消抖和组合键。机械按键抖动一般 520 ms10 ms 扫一次、连续两次一致再确认比HAL_Delay(20)可靠得多。3.2 扫描函数与状态机实现下面这份扫描代码把“原始键值”和“稳定键值”分开。Key_Scan_10ms每 10 ms 调一次内部用计数器消抖不阻塞主循环。/* key.c4×4 矩阵按键扫描10 ms 节拍调用 */ #define KEY_DEBOUNCE_CNT 2 /* 连续 2 次一致才确认约 20 ms */ #define KEY_NONE 0xFF static uint8_t key_stable KEY_NONE; static uint8_t key_last_raw KEY_NONE; static uint8_t debounce_cnt 0; static uint8_t Key_Read_Raw(void) { uint8_t raw KEY_NONE; for (uint8_t row 0; row 4; row) { Key_Row_Write(row, 0); /* 当前行拉低 */ for (uint8_t col 0; col 4; col) { if (Key_Col_Read(col) 0) /* 列线低电平 */ { raw row * 4 col; /* 键值 015 */ } } Key_Row_Write(row, 1); /* 恢复高电平 */ } return raw; } void Key_Scan_10ms(void) { uint8_t raw Key_Read_Raw(); if (raw key_last_raw) { if (debounce_cnt KEY_DEBOUNCE_CNT) { debounce_cnt; } else if (raw ! key_stable) { key_stable raw; /* 确认新键值 */ Key_Event_Push(key_stable); /* 事件入队不在这里做业务 */ } } else { key_last_raw raw; debounce_cnt 0; } }逻辑说明Key_Read_Raw只负责电气扫描返回 015 或KEY_NONEKey_Scan_10ms负责时间维度上的确认。参数KEY_DEBOUNCE_CNT取 2 对应约 20 ms抖动大的板子可以取 3Key_Event_Push只是把键值放进环形队列业务层再取避免在扫描函数里做 LoRa 发送或长延时。注意行线拉低后要留一点建立时间再读列线。代码里如果读得太快长排线或高容性负载会出现“有时灵有时不灵”的玄学现象加几个空操作或把扫描周期放到 10 ms 节拍里通常能缓解。3.3 键值映射与长按/短按处理原始键值 015 只是物理位置业务层需要的是“键 A 短按”“键 B 长按”。映射表单独放改键位不碰扫描代码。长按用计数器实现按下时开始计数超过阈值发长按事件并置标志松开时如果没发过长按再发短按。/* key_event.c键值映射与长短按识别 */ typedef enum { KEY_EVT_SHORT, KEY_EVT_LONG } key_evt_type_t; typedef struct { uint8_t key_id; uint8_t short_cmd; uint8_t long_cmd; } key_map_t; static const key_map_t key_map[] { {0, 0x10, 0x20}, /* 物理键 0短按命令 0x10长按 0x20 */ {1, 0x11, 0x21}, {5, 0x15, 0x25}, }; static uint16_t press_ms 0; static uint8_t long_sent 0; void Key_Event_Process(uint8_t raw_key, uint16_t elapsed_ms) { if (raw_key ! KEY_NONE) { press_ms elapsed_ms; if (press_ms 800 !long_sent) { long_sent 1; Key_Send_Command(Key_Find_Long_Cmd(raw_key)); } } else { if (press_ms 0 press_ms 800 !long_sent) { Key_Send_Command(Key_Find_Short_Cmd(raw_key)); } press_ms 0; long_sent 0; } }参数上长按阈值 800 ms 是常见起点赛题如果要求 1 s 就改press_ms 1000短按不要在按下瞬间发否则长按会先触发一次短按。映射表里key_id用物理键值short_cmd和long_cmd是协议命令字LoRa 发送时直接把这些命令字装进载荷接收端不需要知道矩阵的行列关系。4. 电位器取值ADC 采样、滤波与量程换算4.1 ADC 通道、采样时间与 DMA 缓冲区电位器取值不是“读一次 ADC 就完事”。电位器抽头电压随旋钮变化但 ADC 输入阻抗、采样保持电容和电源噪声都会让原始值跳。常见做法是连续转换加 DMA 循环主循环只读缓冲区再用滤波压抖动。参数建议值原因ADC 分辨率12 bit04095够省赛使用参考电压按板卡常见 3.3 V换算前先确认 VREF采样时间71.5 cycles 起电位器源阻抗高时加长转换模式连续转换减少软件启动开销DMA 模式循环缓冲区自动覆盖缓冲区长度8 或 16滤波窗口与实时性折中上报周期50100 ms不必每次 ADC 都发 LoRa初始化时先校准再启动 DMA顺序反了会出现前几个采样值明显偏移。下面这段只保留关键调用/* adc_pot.c电位器 ADC 启动与缓冲区读取 */ #define ADC_BUF_LEN 16 static uint16_t adc_buf[ADC_BUF_LEN]; void Pot_Init(void) { HAL_ADCEx_Calibration_Start(hadc); /* 先校准 */ HAL_ADC_Start_DMA(hadc, (uint32_t *)adc_buf, ADC_BUF_LEN); /* 循环模式在 Cube 配置里开 */ } uint16_t Pot_Read_Raw(void) { /* DMA 循环覆盖读最新一个样本即可滤波在应用层做 */ return adc_buf[ADC_BUF_LEN - 1]; }逻辑说明HAL_ADC_Start_DMA让 ADC 连续转换并把结果搬到adc_bufCPU 不用轮询。ADC_BUF_LEN取 16 时滤波窗口可以用最近 8 个样本保留一半余量给 DMA 覆盖。参数Pot_Read_Raw返回的是原始码值不要在这里直接换算电压换算放到应用层方便换参考电压。4.2 滑动平均与中值滤波的取舍滑动平均对周期性噪声有效但会把阶跃响应拖慢中值滤波对单点毛刺有效但计算量稍大。省赛场景里我一般用“中值 滑动平均”两级先取 5 点中值去掉明显坏点再对中值结果做 4 点滑动平均。/* filter.c5 点中值 4 点滑动平均 */ static uint16_t win[5]; static uint8_t win_idx 0; static uint32_t sum 0; static uint16_t avg_buf[4] {0}; static uint8_t avg_idx 0; uint16_t Pot_Filter(uint16_t raw) { win[win_idx % 5] raw; uint16_t tmp[5]; for (uint8_t i 0; i 5; i) tmp[i] win[i]; /* 简单插入排序取中值5 个元素足够 */ for (uint8_t i 1; i 5; i) { uint16_t v tmp[i]; int8_t j i - 1; while (j 0 tmp[j] v) { tmp[j 1] tmp[j]; j--; } tmp[j 1] v; } uint16_t med tmp[2]; sum - avg_buf[avg_idx]; avg_buf[avg_idx] med; sum med; avg_idx (avg_idx 1) % 4; return (uint16_t)(sum / 4); }参数说明中值窗口 5 适合去掉偶发尖峰滑动平均窗口 4 让输出变化平缓但不过分迟滞。如果赛题要求快速响应把平均窗口改成 2如果要求显示稳定改成 8。不要用float做每样本滤波整数运算足够也避免在中断里跑浮点。4.3 把 ADC 值变成可上报的工程量原始码值对业务层没有意义接收端要的是电压、百分比或档位。换算前先确认参考电压和分压比不要拿 3.3 V 硬套 5 V 板卡。/* pot_convert.c码值转电压与百分比带死区 */ #define ADC_FULL_SCALE 4095.0f #define VREF_MV 3300.0f #define POT_DEADBAND 20 /* 码值死区抑制末端抖动 */ uint16_t Pot_To_Millivolt(uint16_t code) { return (uint16_t)((code * VREF_MV) / ADC_FULL_SCALE); } uint8_t Pot_To_Percent(uint16_t code) { if (code POT_DEADBAND) code 0; if (code (4095 - POT_DEADBAND)) code 4095; return (uint8_t)((code * 100UL) / 4095); }逻辑说明Pot_To_Millivolt把 04095 映射到 03300 mVPot_To_Percent先做末端死区再算百分比。死区参数POT_DEADBAND取 20 码值约 16 mV能压住旋钮拧到底时的末位跳动。上报时我一般发百分比加原始码值两个字段接收端既能显示进度条也能做二次校准。5. LoRa 通信避坑帧格式、超时重传与五条联调记录5.1 点对点网络与帧格式参数LoRa 在省赛里通常是点对点链路一块板子发另一块板子收或者两端互发。它不是一个“插上就能通”的透明串口频率、扩频因子、带宽、编码率、前导码和串口波特率任何一项不一致现象都是收不到。下面这张表是联调前必须对齐的参数。参数常见起点必须两端一致说明频率按模块手册与现场要求是不要照抄代码默认值扩频因子 SF9是越大越远速率越低带宽 BW125 kHz是窄带抗噪但速率低编码率 CR4/5是与模块配置一致前导码8是接收端同步用串口波特率9600是模块与 MCU 两端一致发送超时200 ms 起否按空中速率调整重传次数3否业务层控制帧格式不要用“裸字符串”。带帧头、长度、命令、载荷和 CRC 的二进制帧更容易排查。下面是一份常见定义字段长度示例作用帧头2 B0xAA 0x55快速定位帧起点长度1 B载荷长度解析前校验命令1 B0x01按键 /0x02电位器插件分发载荷N B键值、ADC 值业务数据CRC162 B查表或位运算丢弃坏帧5.2 发送接收代码与超时状态机发送不要用死等。先组帧进缓冲区启动串口发送然后用状态机等“发送完成”或超时。接收侧用空闲中断或 DMA 半满中断收包解析器只认帧头和长度不认“一次串口中断就是一帧”。/* lora_protocol.c组帧、CRC 与发送超时状态机 */ typedef enum { LORA_IDLE, LORA_TX_WAIT, LORA_RETRY } lora_state_t; static lora_state_t tx_state LORA_IDLE; static uint32_t tx_tick 0; static uint8_t retry_cnt 0; static uint16_t crc16(const uint8_t *data, uint8_t len) { uint16_t crc 0xFFFF; for (uint8_t i 0; i len; i) { crc ^ data[i]; for (uint8_t b 0; b 8; b) { crc (crc 1) ? ((crc 1) ^ 0xA001) : (crc 1); } } return crc; } void LoRa_Send_Frame(uint8_t cmd, const uint8_t *payload, uint8_t len) { uint8_t buf[32]; uint8_t idx 0; buf[idx] 0xAA; buf[idx] 0x55; buf[idx] len; buf[idx] cmd; for (uint8_t i 0; i len; i) buf[idx] payload[i]; uint16_t crc crc16(buf[2], len 2); /* 长度命令载荷 */ buf[idx] crc 0xFF; buf[idx] crc 8; LoRa_Uart_Write(buf, idx); tx_state LORA_TX_WAIT; tx_tick HAL_GetTick(); retry_cnt 0; } void LoRa_Tx_Task(void) { if (tx_state LORA_TX_WAIT) { if (LoRa_Tx_Done()) { tx_state LORA_IDLE; } else if (HAL_GetTick() - tx_tick 200) { tx_state LORA_RETRY; } } else if (tx_state LORA_RETRY) { if (retry_cnt 3) { LoRa_Resend_Last(); tx_tick HAL_GetTick(); tx_state LORA_TX_WAIT; } else { tx_state LORA_IDLE; /* 丢帧计数上报不阻塞主循环 */ } } }逻辑说明crc16只校验“长度 命令 载荷”帧头不参与接收端按同样范围算。LoRa_Send_Frame负责组帧和启动发送LoRa_Tx_Task负责超时与重传。参数上发送超时 200 ms 是起点空中速率低时要加重传 3 次后仍失败就丢弃并计数不能让主循环卡死。接收端解析时先找0xAA 0x55再读长度长度超过缓冲区上限直接丢。5.3 五条联调踩坑记录现象、原因、解决第一条两端都上电串口有打印但 LoRa 一直收不到。现象是发送端显示“已发送”接收端没有任何帧。原因通常是频率、扩频因子或串口波特率不一致也有可能是天线没接或模块处于休眠。解决顺序先确认两端串口波特率一致再读模块参数回显逐项对齐频率、SF、BW、CR 和前导码最后看天线座有没有虚焊。不要一上来就改代码。第二条近距离能通隔一堵墙就大量丢包。现象是 RSSI 看起来还行但重传次数飙升。原因常见是供电跌落、天线贴近金属、扩频因子设得太小或发送间隔太密。解决给 LoRa 模块单独加去耦电容天线离板边和金属件远一点把 SF 调大一档发送间隔从 20 ms 放到 100 ms 以上接收缓冲区加大避免 DMA 覆盖未解析的帧。第三条矩阵按键一按LoRa 就丢一帧。现象是按键事件和周期上报撞在一起。原因是扫描函数里做了阻塞发送或者串口发送和接收共用缓冲区。解决按键扫描只入队发送任务从队列取事件LoRa 发送用独立缓冲区发送完成前不覆盖串口接收用 DMA 空闲中断解析和发送分开。第四条电位器数值在 LoRa 发送瞬间跳变。现象是 ADC 原始值平时稳定一发送就抖十几码。原因是射频发射瞬间电源噪声耦合到模拟域或者 ADC 采样时刻刚好落在发送窗口。解决ADC 用连续 DMA滤波窗口取发送前的样本射频模块电源加 LC 滤波上报周期和发送窗口错开别在射频忙时启动新的 ADC 校准。第五条调试串口一开LoRa 模块就不响应。现象是接上调试串口后LoRa 配置命令回显乱码或干脆没回。原因是两个串口共用 USART或者调试串口的中断优先级高于 LoRa 串口把接收字节丢了。解决物理上分开两组 USART中断优先级上让 LoRa 接收高于调试打印调试打印加环形缓冲不要在中断里直接printf。注意LoRa 参数以模块手册和现场要求为准代码里的默认值只是起点。频率、功率和占空比要符合当地使用要求不要拿实验室能通当唯一标准。6. 从能跑到能交付三路数据合帧与上电自检的固定动作代码能跑通三路外设只是及格线能交付的工程还要做合帧和自检。我一般把矩阵按键事件、电位器百分比、LoRa 链路状态合成一帧周期上报命令字用0x02载荷 4 字节键值、百分比、重传计数、保留位。接收端按同一结构体解析联调时一眼能看出是哪一路出了问题。/* app_report.c三路数据合帧周期 100 ms */ typedef struct { uint8_t key_id; /* 最近一次按键0xFF 表示无 */ uint8_t pot_percent; /* 电位器百分比 0100 */ uint8_t retry_cnt; /* LoRa 重传计数排查链路 */ uint8_t reserved; } report_payload_t; void App_Report_Task(void) { static uint32_t last 0; if (HAL_GetTick() - last 100) return; last HAL_GetTick(); report_payload_t p; p.key_id Key_Get_Last(); p.pot_percent Pot_To_Percent(Pot_Filter(Pot_Read_Raw())); p.retry_cnt LoRa_Get_Retry_Count(); p.reserved 0; LoRa_Send_Frame(0x02, (uint8_t *)p, sizeof(p)); }上电自检我固定做四步串口打印一行版本和参数读一次 LoRa 模块参数并回显扫描一遍矩阵按键确认无键按下时全为高采 16 次 ADC打印最小值和最大值。四步都过再进主循环。这个习惯来自一次翻车当时只测了按键没测 ADC 参考电压现场电位器拧到底直接饱和排查了两个小时。从那以后我每次烧录前都强制走一遍自检表不省这一步。希望帮到你。本文还有配套的精品资源点击获取