简介：这份资源是2024年蓝桥杯第十五届物联网省赛的完整工程代码，面向备战蓝桥杯物联网赛项的高校学生与嵌入式开发者，聚焦矩阵按键扫描、LoRa无线通信与电位器模拟量采集三大赛题核心模块，可用于对照赛题要求复现方案、理解硬件驱动与通信逻辑。压缩包共371个文件，约11.27MB，以h头文件、c源文件、o目标文件与d依赖文件为主，另有uvprojx工程文件、ioc配置、hex固件及map、lst等编译产物，完整保留了STM32L0系列HAL库工程的构建痕迹。目前已有189人学习下载。代码按LORA_A、LORA_B双节点组织，涵盖LoRa扩频通信收发、矩阵按键多路信号处理、电位器ADC取值与数据封装传输等实现，读者可据此梳理工程目录结构、复用驱动代码并借鉴低功耗与调试排错思路，适合作为赛前实战参考。
1. 省赛现场那套代码，到底值不值得拆开看
蓝桥杯物联网省赛的题面有个特点：硬件平台固定、外设清单固定、评分点固定，但每年总有人栽在矩阵按键的扫描时序或者 LoRa 的收发握手上。这份 15 届省赛完整代码，把矩阵按键、LoRa 通信、电位器 ADC 取值三块拼在一个工程里，正好对应赛题里最容易丢分的三个环节。它不是教学 demo，是照着赛题评分逻辑写出来的工程骨架，适合两类人：一是准备下一届省赛、想找一份能直接跑通的参考实现；二是已经写过一遍但卡在某个外设上，需要对照看别人怎么处理边界的人。下面按「代码怎么组织 → 三个外设怎么落地 → 哪里会翻车」的顺序拆，能抄的部分直接给代码，参数怎么改、失败看哪里都写清楚。
2. 工程骨架与三个外设的初始化顺序
拿到一份省赛代码，先别急着看业务逻辑，先看初始化和主循环怎么排。这份工程的结构很典型：一个 main 里按「时钟 → GPIO → 按键 → ADC → LoRa → 主循环轮询」的顺序初始化，业务全部塞在 while(1) 里做状态机。这个顺序不是随便定的，LoRa 模块上电后需要一段稳定时间，如果放在 ADC 校准之前初始化，某些批次模块会出现首次发送丢包；矩阵按键的行列扫描依赖 GPIO 上拉配置，必须在按键初始化之前把对应端口时钟打开。先把这层骨架理清楚，后面三个外设的代码才有地方挂。
2.1 目录结构与模块划分
工程按外设拆成独立文件，常见做法是每个外设一对 .c/.h，main 只负责调度。这种拆法在赛场上有个实际好处：评分时如果某个模块没做完，注释掉对应初始化不会影响其他模块跑分。典型的文件划分是这样的：
| 文件 | 职责 | 关键函数 |
|---|---|---|
| main.c | 初始化调度、主循环状态机 | System_Init、App_Loop |
| key_matrix.c | 4x4 矩阵按键扫描与消抖 | Key_Scan、Key_GetValue |
| adc_pot.c | 电位器 ADC 采样与滤波 | ADC_Init、ADC_GetAverage |
| lora_drv.c | LoRa 收发、帧封装 | LoRa_Init、LoRa_Send、LoRa_Recv |
| board.h | 引脚宏定义、全局配置 | 引脚映射宏 |
引脚宏全部集中在 board.h 里，这一点很关键。赛场上换板子或者改接线，只动一个头文件就能重编译，不用满工程搜端口号。我见过有人把引脚号硬编码在三个 .c 文件里，改一根线要改三处，赛场上时间根本不够。
2.2 初始化顺序为什么不能乱
主初始化函数的骨架大致如下，顺序本身就是经验：
void System_Init(void) { Board_Clock_Init(); /* 先开时钟，后面所有外设才有得用 */ Board_GPIO_Init(); /* 引脚方向、上下拉先定下来 */ Key_Matrix_Init(); /* 按键依赖 GPIO 上拉，紧跟其后 */ ADC_Pot_Init(); /* ADC 通道与校准 */ LoRa_Init(); /* 射频模块最后初始化，留出上电稳定时间 */ Board_Delay_ms(200); /* 给 LoRa 模块留稳定窗口，别省这 200ms */ }逻辑说明：时钟必须最先开，否则后面写寄存器全是无效操作；GPIO 方向配置要在按键和 ADC 之前，因为按键扫描读的是输入电平，ADC 读的是模拟通道，两者都依赖端口模式已经设对；LoRa 放最后是因为射频模块上电后内部晶振和寄存器需要时间稳定，紧接着就发数据容易首包失败。那个 200ms 延时不是玄学，是实打实踩出来的——去掉之后偶发首包丢失，加上就稳。
参数说明：延时值按模块手册的上电稳定时间给，常见范围 100～300ms，取 200ms 是折中；如果赛场供电偏弱，可以加到 300ms，代价是启动慢一点，但省赛不考核启动时间。
2.3 主循环的状态机写法
主循环不建议写成「读按键 → 发 LoRa → 读 ADC」的直线流程，因为 LoRa 发送是阻塞的，发一帧期间按键全丢。这份代码用的是轻量状态机：按键扫描每 10ms 跑一次，ADC 每 50ms 采一次，LoRa 发送由按键事件触发、放在独立分支里。这样即使射频发送耗时，按键也不会漏检。具体节奏靠一个软件计时变量控制，不用中断也能跑得稳，赛场上少用一个中断就少一个排查点。
3. 矩阵按键：扫描时序与消抖的真实写法
矩阵按键是省赛里最容易被低估的模块。看起来就是行列扫描，但赛场上的翻车点集中在两处：一是扫描间隔太短导致相邻按键串扰，二是消抖逻辑写成了「延时等待」把整个主循环拖死。这份代码用的是「定时扫描 + 状态机消抖」，不阻塞主循环，也不依赖外部中断，是赛场上比较稳的写法。
3.1 行列扫描的基本原理与端口配置
4x4 矩阵按键的本质是 4 根行线 + 4 根列线，行线设成输出、列线设成输入带上拉。扫描时逐行拉低，读列线电平：哪一列被拉低，就说明那一行那一列的按键被按下。端口配置的关键是列线必须开内部上拉，否则悬空读出来是随机值，这就是很多人「按键乱跳」的根源。
void Key_Matrix_Init(void) { /* 行线：推挽输出，默认输出高 */ GPIO_InitTypeDef gpio = {0}; gpio.Mode = GPIO_MODE_OUTPUT_PP; gpio.Pull = GPIO_NOPULL; gpio.Speed = GPIO_SPEED_FREQ_LOW; /* 行线端口配置，具体端口按 board.h 宏来 */ HAL_GPIO_Init(KEY_ROW_PORT, &gpio); KEY_ROW_ALL_HIGH(); /* 列线：输入 + 上拉，悬空时读到高电平 */ gpio.Mode = GPIO_MODE_INPUT; gpio.Pull = GPIO_PULLUP; HAL_GPIO_Init(KEY_COL_PORT, &gpio); }逻辑说明：行线默认输出高，扫描时把当前行拉低、其余行保持高，这样只有当前行的按键可能导通到列线；列线上拉保证没按键时读到高，按下时被行线的低电平拉低。参数说明：上拉电阻用芯片内部即可，常见 30～50kΩ，不需要外接；如果赛场板子列线已经有外部上拉，内部上拉可以关掉，避免并联后阻值偏小导致低电平不够低。
3.2 定时扫描与状态机消抖
消抖不写成 delay，而是用「连续两次采样一致才认」的状态机。扫描函数每 10ms 被主循环调用一次，内部维护每个按键的上一状态：
/* 每 10ms 调用一次，返回按下的键值，无按键返回 0xFF */ uint8_t Key_Scan(void) { static uint8_t last_key = 0xFF; static uint8_t stable_cnt = 0; uint8_t cur_key = Key_ReadRaw(); /* 原始行列扫描，返回键值或 0xFF */ if (cur_key == last_key) { if (stable_cnt < 3) stable_cnt++; /* 连续 3 次一致才认稳定 */ } else { stable_cnt = 0; last_key = cur_key; } if (stable_cnt == 3 && cur_key != 0xFF) { stable_cnt = 0; /* 触发一次后清零，防连发 */ return cur_key; } return 0xFF; }逻辑说明：连续 3 次采样一致（约 30ms）才认定按键有效，机械抖动通常 5～20ms，30ms 窗口能覆盖大部分廉价轻触键；触发后把计数清零，避免按住不放时连续上报。参数说明：扫描周期 10ms 是折中值，太快会增加 CPU 占用且抖动窗口不够，太慢（比如 50ms）会让快速点按漏检；稳定次数 3 对应 30ms，如果赛场按键偏硬可以降到 2（20ms），偏软可以升到 4。
3.3 键值映射与长按短按的取舍
原始扫描返回的是行列索引，业务层需要的是「键 1～键 16」。映射表放在 key_matrix.c 里用常量数组，别用 switch 硬编码，改键位只动数组。长按短按这份代码没做，赛题如果要求长按功能，建议在状态机里加一个按住计时，超过 800ms 上报长按事件，短按在松开时上报——注意短按要在「松开」时判定，按下就上报会导致长按也先触发一次短按，这是另一个常见翻车点。
4. LoRa 通信：帧格式、收发握手与超时处理
LoRa 这块是省赛区分度最高的部分。很多人能发出去但收不回来，或者收发都通但偶发丢帧，问题基本出在三个地方：帧没有帧头帧尾导致粘包、发送后没有等待发送完成就切接收、接收没有超时导致主循环卡死。这份代码的 LoRa 驱动把这三件事都处理了，值得逐段看。
4.1 帧格式设计与粘包规避
LoRa 模块透传模式下，接收端拿到的是一串字节流，没有天然的消息边界。如果直接发业务数据，连续两帧会粘在一起，解析必错。常见做法是加帧头 + 长度 + 校验：
/* 帧格式: [0xAA][0x55][LEN][CMD][DATA...][CRC8] */ uint8_t LoRa_BuildFrame(uint8_t cmd, const uint8_t *data, uint8_t len, uint8_t *out) { uint8_t idx = 0; out[idx++] = 0xAA; /* 帧头1 */ out[idx++] = 0x55; /* 帧头2，双字节降低误同步概率 */ out[idx++] = len + 2; /* 长度 = CMD + DATA + CRC */ out[idx++] = cmd; for (uint8_t i = 0; i < len; i++) out[idx++] = data[i]; out[idx++] = CRC8_Calc(out, idx); /* 对帧头到 DATA 做校验 */ return idx; }逻辑说明：双字节帧头 0xAA55 比单字节帧头误同步概率低一个量级；长度字段让接收端知道该收多少字节；CRC8 覆盖帧头到数据段，接收端校验不过直接丢帧，不会把错数据送进业务层。参数说明：LEN 字段包含 CMD 和 CRC 两个字节，接收端解析时注意别把 LEN 本身算进去；CRC8 多项式用常见的 0x07 即可，收发两端必须一致，这是最容易两边各写一套导致永远校验失败的地方。
4.2 发送等待与模式切换
LoRa 模块发送是异步的，调用发送接口后必须等模块的发送完成标志，不能立刻切回接收模式，否则这一帧会被截断。这份代码在发送后轮询等待，带超时保护：
uint8_t LoRa_SendFrame(const uint8_t *frame, uint8_t len) { uint32_t timeout = 0; LoRa_SetMode_TX(); LoRa_WriteBuf(frame, len); LoRa_StartTx(); /* 等待发送完成，超时 500ms 防止卡死 */ while (!LoRa_IsTxDone()) { if (++timeout > 500) { LoRa_SetMode_RX(); /* 超时也要切回接收，别让模块停在 TX */ return 1; /* 返回失败，业务层决定是否重发 */ } Board_Delay_ms(1); } LoRa_SetMode_RX(); return 0; }逻辑说明：发送前切 TX 模式、写完缓冲再启动发送，顺序反了会发出空帧；等待完成用轮询加超时，超时后强制切回 RX，否则模块停在发送态，后续永远收不到数据——这是「发一次之后再也收不到」的典型原因。参数说明：500ms 超时对省赛的帧长足够，LoRa 在低扩频因子下几十字节的空中时间通常不到 100ms；如果赛场要求低速率长距离，空中时间会拉长，超时值要按实际扩频因子估算后放大。
4.3 接收解析与超时保护
接收端不能死等，要用「有数据才读、读完校验、校验不过丢弃」的流程，并且整个接收流程要有超时。解析时先找帧头，找到后按长度字段收齐，再校验 CRC，任何一步失败就重置解析状态机。这套流程写成状态机后，即使收到半帧或者噪声，也能自动恢复，不会把解析指针卡死。赛场上如果出现「偶尔能收、偶尔收不到」，先查接收超时是不是设得太短，再查两端 CRC 多项式是否一致。
5. 电位器 ADC 取值：采样、滤波与量程换算
电位器取值看着简单，但赛题往往要求「稳定显示」或者「按区间判定」，直接单次采样会跳得没法看。这份代码用的是多次采样取平均 + 中值滤波的组合，兼顾响应速度和稳定性，是赛场上比较实用的折中。
5.1 ADC 采样配置与参考电压
采样前先确认参考电压和分辨率。常见做法是用内部参考或者板载基准，12 位分辨率下满量程 4095。配置时注意采样时间要够，电位器输出阻抗偏高，采样时间太短会导致读数偏低且不稳：
uint16_t ADC_ReadPot(void) { uint32_t sum = 0; /* 连续采 8 次累加，单次采样时间按通道阻抗调大 */ for (uint8_t i = 0; i < 8; i++) { HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 10); sum += HAL_ADC_GetValue(&hadc1); HAL_ADC_Stop(&hadc1); } return (uint16_t)(sum / 8); /* 8 次平均，压低随机噪声 */ }逻辑说明：多次平均能压掉随机噪声，但对脉冲干扰无效，所以后面还要加中值；每次采样单独启停是为了避免连续转换模式下通道切换的残留。参数说明：采样次数 8 是响应速度和稳定性的折中，赛题要求快速响应可以降到 4，要求显示稳定可以升到 16；采样时间按电位器阻值调，常见 10kΩ 电位器用中等采样时间即可，阻值越大采样时间越长。
5.2 中值滤波与滑动窗口
平均值对偶发尖峰无能为力，加一层中值滤波：维护一个长度 5 的滑动窗口，每次取中位数输出。这样单个异常采样会被直接剔除，输出曲线平滑但不滞后太多。窗口长度别开太大，5 或 7 足够，开太大响应会明显变慢，赛题如果要求「转动即变」会判响应不及时。
5.3 量程换算与区间判定
原始 ADC 值换算成电压或百分比时，注意整数运算的截断误差。常见做法是先乘后除，避免先除丢精度：
/* 12 位 ADC，参考 3.3V，换算成毫伏 */ uint16_t ADC_ToMillivolt(uint16_t raw) { return (uint16_t)((uint32_t)raw * 3300 / 4095); }逻辑说明：先乘 3300 再除 4095，用 32 位中间变量防止溢出，这样精度损失最小；如果先除再乘，raw 较小时误差会被放大。参数说明：3300 是参考电压毫伏值，按实际基准改；4095 是 12 位满量程，如果是 10 位分辨率改成 1023。区间判定时建议加一点回差，比如阈值 50% 判定，上升沿用 52%、下降沿用 48%，避免在阈值附近来回跳变导致状态反复切换。
6. 避坑与排查：五个赛场高频翻车点
6.1 按键乱跳或串键
现象：按一个键，相邻键也被触发，或者没按键时随机上报。原因：列线没开上拉导致悬空读到随机电平，或者扫描间隔太短、上一行的电平还没稳定就开始扫下一行。解决：确认列线内部上拉已开，扫描每行拉低后加几微秒稳定延时再读列线，扫描周期不低于 10ms。
6.2 LoRa 首包必丢
现象：上电后第一帧总是收不到，后面正常。原因：模块上电稳定时间不够，初始化后立刻发送，内部晶振还没稳。解决：初始化后加 200～300ms 延时再允许发送，或者首帧发送前先做一次空读状态寄存器确认模块就绪。
6.3 发一次之后再也收不到
现象：发送功能正常，但发完一帧后接收端一直没数据。原因：发送后没等发送完成标志就切模式，或者超时后没强制切回接收态，模块停在 TX。解决：发送流程必须等 TxDone 或超时后强制切 RX，两条路径都要切回接收，不能只在成功分支切。
6.4 ADC 读数偏低且不稳
现象：电位器拧到最大，读数到不了满量程，且数值抖动大。原因：采样时间太短，高阻源还没给采样电容充够电；或者参考电压配置和实际基准不一致。解决：加长采样时间，确认参考电压配置，采样次数加到 8 次以上取平均。
6.5 帧校验永远失败
现象：收发都通，但接收端 CRC 校验一直不过。原因：两端 CRC 多项式或初值不一致，或者发送端 CRC 覆盖范围（是否含帧头）和接收端理解不同。解决：把 CRC 计算函数抽成公共文件两端共用，覆盖范围在注释里写死，别各写各的。
7. 把三个外设串成一个可验证的联调流程
代码能编译通过只是第一步，赛场上真正要的是「三个外设同时工作不互相干扰」。我一般会按一个固定顺序联调，每一步都有明确的验证信号，避免三个模块一起上导致问题定位不了。
第一步，只跑矩阵按键，串口打印键值。验证标准是快速连按 20 次不漏检、不串键，按住不放只上报一次。这一步不过，后面都别谈。
第二步，只跑 ADC，串口打印原始值和毫伏值。验证标准是拧到两端能到接近 0 和接近满量程，中间转动时数值单调变化、无明显跳变。如果两端到不了，先查采样时间和参考电压，别急着改滤波。
第三步，只跑 LoRa，两块板子对发。验证标准是连续发 100 帧，接收端计数和发送端一致，CRC 失败数为 0。这一步建议把发送间隔设成 100ms，太快会掩盖超时处理的问题。
第四步，三个一起跑，重点看按键触发 LoRa 发送时 ADC 采样有没有被拖慢。如果发现按键响应变迟钝，说明 LoRa 发送的阻塞时间侵占了主循环，常见做法是把发送拆成「置标志 + 主循环里发」，或者把 ADC 采样放到发送之前。
联调时有个习惯我一直保留：每个模块的调试打印都带一个前缀，比如[KEY]、[ADC]、[LORA]，串口一屏混着输出时能一眼分清是谁在说话。这个习惯在赛场上救过我好几次——有次 LoRa 偶发丢帧，就是靠前缀发现丢帧总是紧跟在一次 ADC 采样之后，最后定位到是采样期间关了全局中断影响了射频时序。从那以后我每次联调都强制走一遍「单模块 → 双模块 → 全模块」的顺序，不跳步。希望这套拆法帮到你，拿到代码先按这个流程跑一遍，比直接读代码快得多。
本文还有配套的精品资源，点击获取
