STM32驱动LoRa SX1280与E28-2G4M模块实战指南

简介这份资源面向使用STM32F4系列主控驱动亿佰特E28-2G4MSX1280射频芯片LoRa模块的嵌入式开发者尤其适合正在做无线通信项目、苦于官方与网络示例零散难成体系的工程师与学习者。作者结合SX1280官方demo与网络思路整理弥补了E28模块可用示例稀少的缺口引脚连接在readme中有详细说明程序实现了中断中按键发送与接收并将接收数据经串口输出显示便于直接移植验证。压缩包共643个文件约32.65MB以149个h头文件、127个c源文件为核心配合113个d依赖文件、113个o目标文件、112个crf编译中间文件以及uvprojx工程、hex固件、map映射、sct分散加载等工程配置完整保留了Keil编译与调试链路。目前已有1145人学习下载读者可据此快速搭建LoRa收发实验环境理解SX1280中断收发流程与串口调试方法并参考工程结构排查编译与引脚配置问题。1. LoRa SX1280 与 E28-2G4M 的 STM32 驱动从模块到能跑通的完整路径手里拿到一个 E28-2G4M 模块2.4G 频段、SX1280 射频芯片再配一块 STM32 开发板想让它俩真正通信起来这件事听起来简单实际动手时你会发现资料零散、寄存器手册厚、例程跑不通。LoRa SX1280 和常见的 SX1278 在寄存器层面差异不小E28-2G4M 又是模块厂在 SX1280 基础上做的封装引脚定义、供电要求、天线匹配都有自己的脾气。这篇笔记面向的是已经拿到模块和 STM32 板子、想自己写驱动或改造现有工程的嵌入式开发者从 SPI 时序、寄存器配置、收发流程到调试排错把一条能复现的路径讲清楚。读完你应该能判断这个方案值不值得投入以及怎么少走弯路。2. 先搞清 SX1280 和 E28-2G4M 的硬件底子2.1 SX1280 在 2.4G 频段做了什么SX1280 是 Semtech 在 2.4GHz 频段上的一颗 LoRa 收发器和 Sub-1G 的 SX127x 系列最大的区别在于它把 LoRa 调制解调器、FSK 调制解调器、测距引擎都集成到了一颗芯片里支持 LoRa 模式下的扩频因子 SF5 到 SF12带宽 203kHz 到 1625kHz还支持 GFSK 和 FLRC 模式。2.4G 频段的好处是天线小、全球通用代价是穿透力和绕射能力比 433M/868M 弱适合短距离、高数据率或者需要较小天线的场景。SX1280 和 MCU 之间通过 SPI 通信寄存器分两类一类是配置寄存器通过写命令字加地址的方式访问另一类是命令寄存器直接写命令字节触发动作比如设置睡眠、进入接收、启动测距。芯片内部有 256 字节的 FIFO收发数据都经过这个 FIFO。中断方面SX1280 提供 DIO1、DIO2、DIO3 三根中断线可以映射不同的中断源比如 TxDone、RxDone、Timeout、CRC 错误等。2.2 E28-2G4M 模块把哪些东西固定了E28-2G4M 是模块厂基于 SX1280 做的模组通常集成了射频匹配网络、晶振、天线接口。拿到模块后你能改的是和 MCU 连接的引脚定义、供电电压、以及通过 SPI 配置 SX1280 内部寄存器。模块本身一般引出这些引脚VCC、GND、MISO、MOSI、SCK、NSS、BUSY、NRESET、DIO1。有些版本还会引出 DIO2、DIO3 和 RXEN/TXEN 之类的射频开关控制脚。这里有个容易翻车的点E28-2G4M 的供电范围通常是 1.8V 到 3.6V但射频发射瞬间电流可能冲到 100mA 以上如果直接用 STM32 的 3.3V LDO 给它供电而 LDO 余量不够就会出现发射时复位或者通信距离骤降。我一般会在模块 VCC 脚旁边并一个 100uF 钽电容加一个 0.1uF 陶瓷电容先把这个坑填上。2.3 STM32 侧需要准备什么外设STM32 这边需要至少一个 SPI 接口、几个普通 GPIO 做 NSS、NRESET、BUSY 和 DIO1 中断输入。SPI 模式要设成 Mode 0CPOL0CPHA0时钟频率不要一上来就拉满SX1280 的 SPI 最高支持 18MHz但实际调试时先用 1MHz 到 4MHz 跑通再往上提。NSS 可以用硬件片选也可以软件控制我习惯用软件控制方便在两次传输之间插入精确延时。BUSY 引脚很关键SX1280 在执行某些命令时需要时间BUSY 拉高表示芯片正忙此时不能发 SPI 命令。很多例程跑不通就是因为忽略了 BUSY 判断命令发出去芯片没响应读回来全是 0 或者 0xFF。3. 用 STM32 HAL 库把 SPI 和 GPIO 骨架搭起来3.1 CubeMX 里的最小配置在 CubeMX 里选好你的 STM32 型号开一个 SPI 外设参数按下面设参数值说明ModeFull-Duplex Master主机全双工Data Size8 Bits8 位数据CPOLLow空闲低电平CPHA1 Edge第一个边沿采样Prescaler根据主频分到 1-4MHz先低速跑通First BitMSB高位先出NSSSoftware软件控制片选GPIO 这边NRESET 配成推挽输出初始高电平BUSY 配成输入不需要上拉DIO1 配成外部中断下降沿触发或者上升沿触发具体看中断映射配置。3.2 底层读写函数SX1280 的 SPI 时序是拉低 NSS发送命令字节然后发送地址或数据最后拉高 NSS。读寄存器时命令字节的最高位表示读还是写0x00 是写0x01 是读。下面是我常用的两个底层函数// 写命令到 SX1280cmd 是命令字节data 是数据缓冲区len 是长度 void sx1280_write_command(uint8_t cmd, uint8_t *data, uint16_t len) { uint8_t i; SX1280_NSS_LOW(); HAL_SPI_Transmit(hspi1, cmd, 1, 100); for (i 0; i len; i) { HAL_SPI_Transmit(hspi1, data[i], 1, 100); } SX1280_NSS_HIGH(); } // 读寄存器addr 是寄存器地址data 是接收缓冲区len 是长度 void sx1280_read_register(uint16_t addr, uint8_t *data, uint16_t len) { uint8_t cmd[3]; cmd[0] 0x01; // 读命令 cmd[1] (addr 8) 0xFF; // 地址高字节 cmd[2] addr 0xFF; // 地址低字节 SX1280_NSS_LOW(); HAL_SPI_Transmit(hspi1, cmd, 3, 100); HAL_SPI_Receive(hspi1, data, len, 100); SX1280_NSS_HIGH(); } // 写寄存器 void sx1280_write_register(uint16_t addr, uint8_t *data, uint16_t len) { uint8_t cmd[3]; cmd[0] 0x00; // 写命令 cmd[1] (addr 8) 0xFF; cmd[2] addr 0xFF; SX1280_NSS_LOW(); HAL_SPI_Transmit(hspi1, cmd, 3, 100); HAL_SPI_Transmit(hspi1, data, len, 100); SX1280_NSS_HIGH(); }这三个函数里NSS 的拉低拉高必须包住整个传输过程中间不能被打断。HAL_SPI_Transmit 的超时参数我给了 100ms实际 1MHz 时钟下几个字节几毫秒就完事给大一点是防止调试时卡死。读寄存器时先发 3 字节命令头再接收数据注意 HAL_SPI_Receive 和 HAL_SPI_TransmitReceive 的区别这里只收不发用 Receive 就行。3.3 复位和 BUSY 等待上电后第一件事是复位 SX1280NRESET 拉低至少 100us 再拉高然后等 BUSY 变低。BUSY 等待要加超时不然芯片没焊好或者供电不对程序就死在这里// 等待 BUSY 引脚变低超时返回 0 uint8_t sx1280_wait_busy(void) { uint32_t timeout 100000; while (HAL_GPIO_ReadPin(SX1280_BUSY_GPIO_Port, SX1280_BUSY_Pin) GPIO_PIN_SET) { if (--timeout 0) { return 0; // 超时 } } return 1; } // 硬件复位 void sx1280_reset(void) { HAL_GPIO_WritePin(SX1280_NRESET_GPIO_Port, SX1280_NRESET_Pin, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(SX1280_NRESET_GPIO_Port, SX1280_NRESET_Pin, GPIO_PIN_SET); HAL_Delay(10); sx1280_wait_busy(); }复位后建议读一下芯片版本号或者做一次寄存器回读测试确认 SPI 通路是通的。比如往某个测试寄存器写一个值再读回来对不上就说明 SPI 时序或者引脚有问题。4. 配置 LoRa 参数并跑通一次收发4.1 设置频点、扩频因子和带宽SX1280 在 LoRa 模式下需要配置射频频率、扩频因子、带宽、编码率、前导码长度、报头类型。频率计算公式是RF_freq (freq_hz * 2^18) / 32e6。比如要设 2400MHz算出来是 0x18000000 附近的值分三个字节写入。// 设置 LoRa 频率freq_hz 单位 Hz void sx1280_set_frequency(uint32_t freq_hz) { uint8_t buf[3]; uint32_t freq_reg (uint32_t)((uint64_t)freq_hz * (1 18) / 32000000); buf[0] (freq_reg 16) 0xFF; buf[1] (freq_reg 8) 0xFF; buf[2] freq_reg 0xFF; sx1280_write_command(0x86, buf, 3); // 0x86 是 SetRfFrequency 命令 } // 设置调制参数sf 是扩频因子bw 是带宽代码cr 是编码率 void sx1280_set_modulation_params(uint8_t sf, uint8_t bw, uint8_t cr) { uint8_t buf[3]; buf[0] sf; // SF5-SF12 buf[1] bw; // 带宽代码比如 0x04 对应 203kHz buf[2] cr; // 编码率比如 0x01 对应 4/5 sx1280_write_command(0x8B, buf, 3); // SetModulationParams }带宽代码需要查手册常用的几个0x04 是 203kHz0x05 是 406kHz0x06 是 812kHz0x07 是 1625kHz。扩频因子越大灵敏度越高但速率越低。2.4G 频段干扰相对多SF 别设太小我一般从 SF9 或 SF10 开始试。4.2 进入发送和接收状态配置完参数后把数据写入 FIFO然后触发发送。发送完成后 DIO1 会拉高在中断里读状态或者轮询。接收类似先进入接收模式等 DIO1 中断再读 FIFO。// 发送数据 void sx1280_transmit(uint8_t *data, uint8_t len) { uint8_t buf[2]; // 设置 FIFO 基地址 buf[0] 0x00; sx1280_write_command(0x8E, buf, 1); // SetBufferBaseAddress // 写数据到 FIFO sx1280_write_command(0x80, data, len); // WriteBuffer // 设置包参数前导码长度和报头类型 buf[0] 12; // 前导码长度 buf[1] 0x00; // 可变长度包显式报头 sx1280_write_command(0x8C, buf, 2); // SetPacketParams // 触发发送 buf[0] 0x00; // 超时时间0 表示不超时 sx1280_write_command(0x83, buf, 1); // SetTx }发送前要确保 BUSY 是低的写完 FIFO 后芯片会自动处理。DIO1 中断映射需要提前配置把 TxDone 和 RxDone 映射到 DIO1 引脚。中断处理里先读状态寄存器判断是发送完成还是接收完成然后清中断标志。4.3 中断映射和状态读取SX1280 的中断配置通过 SetDioIrqParams 命令完成需要指定哪些中断源映射到 DIO1、DIO2、DIO3。我一般把 TxDone、RxDone、Timeout、CrcErr 都映射到 DIO1然后在中断里读状态寄存器区分。// 配置 DIO1 中断 void sx1280_set_dio_irq(void) { uint8_t buf[8]; uint16_t irq_mask 0x0000; irq_mask | (1 0); // TxDone irq_mask | (1 1); // RxDone irq_mask | (1 2); // Timeout irq_mask | (1 6); // CrcErr buf[0] (irq_mask 8) 0xFF; buf[1] irq_mask 0xFF; buf[2] (irq_mask 8) 0xFF; // DIO1 映射 buf[3] irq_mask 0xFF; buf[4] 0x00; // DIO2 不映射 buf[5] 0x00; buf[6] 0x00; // DIO3 不映射 buf[7] 0x00; sx1280_write_command(0x8A, buf, 8); // SetDioIrqParams }中断服务函数里先读状态寄存器 0x0A 和 0x0B判断具体是哪个事件然后写 0x0A 和 0x0B 清标志。注意清标志要在处理完数据之后做不然可能丢中断。5. 调试 SX1280 时最容易踩的五个坑5.1 现象SPI 读回来全是 0xFF 或 0x00原因通常是 NSS 时序不对或者 SPI 模式设错。SX1280 要求 CPOL0、CPHA0如果设成 Mode 3 就读不到正确数据。另一个可能是 BUSY 没等芯片正忙时发命令被忽略。解决方法是先用示波器看 SCK、MOSI、NSS 三根线的波形确认 NSS 拉低期间正好有 8 个时钟脉冲然后检查 BUSY 等待逻辑在每次 SPI 传输前都加 wait_busy。5.2 现象能读到版本号但发不出数据这种情况一般是射频参数没配对或者天线没接。先确认频率设置正确2.4G 频段别设成 433M 的寄存器值。然后检查 SetPacketParams 里的前导码长度和报头类型前导码太短可能导致接收方检测不到。天线方面E28-2G4M 如果没有接天线就发射驻波比会很差芯片可能保护性降功率甚至损坏调试时务必接上匹配天线或者 50 欧姆假负载。5.3 现象通信距离只有几米2.4G 频段本身距离就短但如果只有几米先查供电。发射瞬间电流不足会导致功率上不去用万用表量模块 VCC 脚在发射时的电压跌落如果掉到 3.0V 以下就要加电容或者换 LDO。其次查扩频因子和带宽SF 设太小、带宽设太大都会降低灵敏度。我一般把 SF 设到 10 或 11带宽设 406kHz 或 203kHz先保证能通再逐步优化。5.4 现象中断进不去或者进去一次就卡死DIO1 中断配置要注意SX1280 的中断是电平方式还是脉冲方式取决于寄存器配置。如果中断进去后没清标志就会一直触发。解决方法是中断里先读状态寄存器处理完数据后写 1 清对应标志位。另外STM32 的外部中断要设成下降沿或上升沿别设成双边沿不然会触发两次。5.5 现象发送正常但接收方收不到先确认收发双方频率、扩频因子、带宽、编码率、前导码长度完全一致这些参数差一个就通不了。然后检查接收方的 Rx 超时设置如果超时太短可能数据还没收完就退出了。还有一点容易忽略SX1280 的 FIFO 指针在收发切换时需要复位如果连续收发每次都要重新设置 BufferBaseAddress。6. 把驱动封装成可复用的组件6.1 分层设计硬件层、驱动层、应用层跑通单次收发之后下一步是把代码整理成可复用的结构。我一般分三层硬件层负责 SPI 读写和 GPIO 控制驱动层实现 SX1280 的初始化、参数配置、收发函数应用层处理业务逻辑。这样换 MCU 或者换模块时只需要改硬件层。// 驱动层接口示例 typedef struct { void (*reset)(void); uint8_t (*wait_busy)(void); void (*write_command)(uint8_t cmd, uint8_t *data, uint16_t len); void (*read_register)(uint16_t addr, uint8_t *data, uint16_t len); void (*write_register)(uint16_t addr, uint8_t *data, uint16_t len); } sx1280_hal_t; typedef struct { sx1280_hal_t hal; uint32_t freq_hz; uint8_t sf; uint8_t bw; uint8_t cr; } sx1280_dev_t; // 初始化 uint8_t sx1280_init(sx1280_dev_t *dev); // 发送 uint8_t sx1280_send(sx1280_dev_t *dev, uint8_t *data, uint8_t len); // 接收 uint8_t sx1280_receive(sx1280_dev_t *dev, uint8_t *data, uint8_t *len, uint32_t timeout_ms);这种结构的好处是如果你以后要换到 SX126x 或者别的射频芯片应用层代码基本不用动只换驱动层实现就行。6.2 参数持久化和低功耗处理实际产品里频率、扩频因子这些参数可能需要根据现场情况调整我一般把它们存在 STM32 的 Flash 或者外部 EEPROM 里上电时读出来配置。低功耗方面SX1280 支持 Sleep 模式电流可以降到 1uA 以下如果设备是电池供电不收发的时候让它进 Sleep需要时再唤醒。// 进入睡眠模式 void sx1280_sleep(void) { uint8_t buf[1]; buf[0] 0x00; // 冷启动模式 sx1280_write_command(0x84, buf, 1); // SetSleep } // 唤醒 void sx1280_wakeup(void) { // 拉低 NSS 一段时间再拉高或者发一个空命令 SX1280_NSS_LOW(); HAL_Delay(1); SX1280_NSS_HIGH(); sx1280_wait_busy(); }唤醒后需要重新配置参数因为 Sleep 模式下寄存器会丢失。如果不想每次重配可以用 Warm Start 模式但功耗会高一点。6.3 用状态机管理收发流程如果应用场景是半双工收发建议用状态机管理避免在中断里做太多事情。状态机可以分 Idle、Tx、Rx、Timeout 几个状态主循环里轮询状态切换中断只负责置标志位。typedef enum { STATE_IDLE, STATE_TX, STATE_RX, STATE_TIMEOUT } sx1280_state_t; sx1280_state_t g_state STATE_IDLE; void sx1280_process(void) { switch (g_state) { case STATE_IDLE: // 有数据要发就切到 TX if (has_data_to_send()) { sx1280_transmit(tx_buf, tx_len); g_state STATE_TX; } else { sx1280_start_receive(); g_state STATE_RX; } break; case STATE_TX: if (tx_done_flag) { tx_done_flag 0; g_state STATE_IDLE; } break; case STATE_RX: if (rx_done_flag) { rx_done_flag 0; process_received_data(); g_state STATE_IDLE; } else if (rx_timeout_flag) { rx_timeout_flag 0; g_state STATE_TIMEOUT; } break; case STATE_TIMEOUT: g_state STATE_IDLE; break; } }这种写法比在中断里直接处理数据要稳中断响应时间短不会因为处理数据导致丢包。状态机跑在主循环里配合 SysTick 做超时计数逻辑清晰也好调试。6.4 验证驱动稳定性的几个测试驱动写完后别急着上业务先做几组测试连续发送 1000 包看丢包率拉远距离看 RSSI 和 SNR 变化在不同供电电压下测试发射功率是否稳定长时间运行看有没有内存泄漏或者状态卡死。我一般会写一个简单的测试固件每 100ms 发一包递增序号的数据接收端记录丢包和序号跳变跑一晚上看结果。提示测试时把收发双方的天线都接好别为了省事用杜邦线代替天线2.4G 频段对天线匹配很敏感杜邦线当天线驻波比极差可能烧芯片。这套东西从拿到模块到稳定跑通我花了大概一周的业余时间其中大部分时间是在查寄存器手册和用示波器看波形。如果你手头有逻辑分析仪调试 SPI 会快很多。SX1280 的寄存器手册一定要对着看别全靠猜很多问题手册里都写了只是藏得深。希望帮到你。本文还有配套的精品资源点击获取