1. 硬件准备与接线指南第一次接触LoRa通信时我也被各种引脚连接搞得头晕眼花。但实际接线就像拼乐高积木只要按图索骥就能搞定。这里我以最常用的STM32F103C8T6蓝色小板和Ra-01SC模组为例手把手教你搭建硬件环境。必备设备清单Ra-01SC模组 ×2建议买带IPEX天线接口的版本STM32F103C8T6开发板 ×2某宝20元左右USB转TTL模块 ×2推荐CH340芯片版本杜邦线若干建议用不同颜色区分信号线安卓数据线 ×2给开发板供电用核心接线要点电源部分必须接对模组的3.3V和GND要分别接开发板的3.3V和GND。我有次把3.3V错接到5V上模组当场冒烟报废。SPI接口要对应PA4接NSS、PA5接SCK、PA6接MISO、PA7接MOSI。这组引脚在STM32的SPI1接口上不能随意更换。控制引脚别漏接PB1接RESET用于硬件复位PB11接DIO1用来触发中断。特别提醒DIO4在部分场景下也需要连接比如CAD模式。实际接线时有个小技巧先用万用表蜂鸣档检查通断。有次我因为杜邦线内部断裂调试了一整天都没发现是硬件问题。2. 开发环境搭建很多新手卡在环境配置这一步我推荐用Keil MDKSTM32CubeMX的组合方案。去年给大学生做培训时这套方案让零基础学员最快30分钟就能编译出第一个工程。具体操作步骤安装STM32CubeMX后选择STM32F103C8系列芯片开启SPI1接口Full-Duplex Master模式配置PB1和PB11为GPIO_Output生成代码时记得勾选Generate peripheral initialization as a pair of .c/.h有个坑要注意Ra-01SC的驱动库默认使用HAL库如果你习惯用标准库需要手动修改底层驱动。我整理过一份移植指南关键点在于重写这几个函数void SPI_Write(uint8_t addr, uint8_t data) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, addr, 1, 1000); HAL_SPI_Transmit(hspi1, data, 1, 1000); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); }3. LoRa参数配置详解RadioSetRxConfig这个函数看着参数很多其实可以分成三类理解。去年做智慧农业项目时我通过实测总结出这些经验值通信可靠性配置组bandwidth带宽城市环境用125kHz郊区可用250kHzdatarate扩频因子SF7~SF12数值越小速度越快但距离越短coderate编码率建议4/5在4/8时传输效率会下降40%功耗优化配置组preambleLen前导码默认12即可电池供电设备可减到8rxContinuous持续接收电池设备建议设为0用定时唤醒特殊场景配置FreqHopOn跳频工厂等强干扰环境建议开启iqInvertedIQ反转只有和SX1278通信时才需要设为1实测案例在500米距离的楼宇间传输用以下配置最稳定RadioSetRxConfig(MODEM_LORA, 0, 9, 1, 0, 12, 0, 0, 0, 1, 0, 0, 0, 0);4. 收发模式切换的坑点官方例程里没强调的模式切换顺序是我踩过最深的坑。有次项目验收时设备莫名死机最后发现是没正确处理状态切换。必须遵循的操作序列发送完成 → 调用Standby() → 等待10ms → 切接收模式接收超时 → 直接切发送模式会丢包 → 应先复位射频开关关键代码示例void SendToReceiveSwitch() { Radio.Standby(); // 必须的过渡状态 HAL_Delay(10); // 实测至少需要8ms稳定时间 Radio.SetRxConfig(...); Radio.Rx(0); // 0表示持续接收 }调试时建议在每个状态切换点加LED指示。我用红灯表示发送中蓝灯表示接收中绿灯表示待机这样一眼就能看出卡在哪个环节。5. 实战温度数据互传现在我们来做个完整案例两个节点每隔10秒互传温度数据。这个例子包含了参数配置、状态切换、数据处理的全流程。发送端核心逻辑void SendTask() { float temp ReadTemperature(); uint8_t buf[4]; memcpy(buf, temp, sizeof(float)); Radio.SetTxConfig(MODEM_LORA, 14, 0, 0, 9, 1, 12, 0, 1, 0, 0, 0, 3000); Radio.Send(buf, 4); } void OnTxDone() { printf(发送成功\r\n); SendToReceiveSwitch(); // 切换到接收模式 }接收端数据处理void OnRxDone(uint8_t *payload, uint16_t size, int16_t rssi, int8_t snr) { if(size 4) { float temp; memcpy(temp, payload, 4); printf(收到温度:%.1f, RSSI:%d, SNR:%d\r\n, temp, rssi, snr); } Radio.Rx(0); // 继续接收 }实测中发现在数据前加1字节的帧头能显著提高抗干扰能力。比如用0xAA开头接收端校验帧头后再解析数据。6. 常见问题排查指南根据三年来的技术支持经验我整理了这些典型问题的解决方法症状1能发不能收检查DIO1接线是否松动确认Radio.SetRxConfig的参数与发送端完全一致用频谱仪查看是否有信号发出没有的话检查PA_BOOST配置症状2通信距离突然变短检查天线阻抗匹配最好用网分仪测查看电源电压是否低于3.0V检查周围是否有同频段设备干扰症状3数据包CRC错误降低数据传输速率把SF调大在project_config.h中增加前导码长度在代码中启用RSSI检测过滤弱信号有个很隐蔽的坑某些厂家的模组需要修改RF开关控制时序。如果遇到发送后立即收不到的情况可以尝试在Radio.Standby()后加50ms延时。
从零构建：基于STM32的Ra-01SC模组LoRa通信实战
发布时间：2026/5/17 10:56:05
1. 硬件准备与接线指南第一次接触LoRa通信时我也被各种引脚连接搞得头晕眼花。但实际接线就像拼乐高积木只要按图索骥就能搞定。这里我以最常用的STM32F103C8T6蓝色小板和Ra-01SC模组为例手把手教你搭建硬件环境。必备设备清单Ra-01SC模组 ×2建议买带IPEX天线接口的版本STM32F103C8T6开发板 ×2某宝20元左右USB转TTL模块 ×2推荐CH340芯片版本杜邦线若干建议用不同颜色区分信号线安卓数据线 ×2给开发板供电用核心接线要点电源部分必须接对模组的3.3V和GND要分别接开发板的3.3V和GND。我有次把3.3V错接到5V上模组当场冒烟报废。SPI接口要对应PA4接NSS、PA5接SCK、PA6接MISO、PA7接MOSI。这组引脚在STM32的SPI1接口上不能随意更换。控制引脚别漏接PB1接RESET用于硬件复位PB11接DIO1用来触发中断。特别提醒DIO4在部分场景下也需要连接比如CAD模式。实际接线时有个小技巧先用万用表蜂鸣档检查通断。有次我因为杜邦线内部断裂调试了一整天都没发现是硬件问题。2. 开发环境搭建很多新手卡在环境配置这一步我推荐用Keil MDKSTM32CubeMX的组合方案。去年给大学生做培训时这套方案让零基础学员最快30分钟就能编译出第一个工程。具体操作步骤安装STM32CubeMX后选择STM32F103C8系列芯片开启SPI1接口Full-Duplex Master模式配置PB1和PB11为GPIO_Output生成代码时记得勾选Generate peripheral initialization as a pair of .c/.h有个坑要注意Ra-01SC的驱动库默认使用HAL库如果你习惯用标准库需要手动修改底层驱动。我整理过一份移植指南关键点在于重写这几个函数void SPI_Write(uint8_t addr, uint8_t data) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, addr, 1, 1000); HAL_SPI_Transmit(hspi1, data, 1, 1000); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); }3. LoRa参数配置详解RadioSetRxConfig这个函数看着参数很多其实可以分成三类理解。去年做智慧农业项目时我通过实测总结出这些经验值通信可靠性配置组bandwidth带宽城市环境用125kHz郊区可用250kHzdatarate扩频因子SF7~SF12数值越小速度越快但距离越短coderate编码率建议4/5在4/8时传输效率会下降40%功耗优化配置组preambleLen前导码默认12即可电池供电设备可减到8rxContinuous持续接收电池设备建议设为0用定时唤醒特殊场景配置FreqHopOn跳频工厂等强干扰环境建议开启iqInvertedIQ反转只有和SX1278通信时才需要设为1实测案例在500米距离的楼宇间传输用以下配置最稳定RadioSetRxConfig(MODEM_LORA, 0, 9, 1, 0, 12, 0, 0, 0, 1, 0, 0, 0, 0);4. 收发模式切换的坑点官方例程里没强调的模式切换顺序是我踩过最深的坑。有次项目验收时设备莫名死机最后发现是没正确处理状态切换。必须遵循的操作序列发送完成 → 调用Standby() → 等待10ms → 切接收模式接收超时 → 直接切发送模式会丢包 → 应先复位射频开关关键代码示例void SendToReceiveSwitch() { Radio.Standby(); // 必须的过渡状态 HAL_Delay(10); // 实测至少需要8ms稳定时间 Radio.SetRxConfig(...); Radio.Rx(0); // 0表示持续接收 }调试时建议在每个状态切换点加LED指示。我用红灯表示发送中蓝灯表示接收中绿灯表示待机这样一眼就能看出卡在哪个环节。5. 实战温度数据互传现在我们来做个完整案例两个节点每隔10秒互传温度数据。这个例子包含了参数配置、状态切换、数据处理的全流程。发送端核心逻辑void SendTask() { float temp ReadTemperature(); uint8_t buf[4]; memcpy(buf, temp, sizeof(float)); Radio.SetTxConfig(MODEM_LORA, 14, 0, 0, 9, 1, 12, 0, 1, 0, 0, 0, 3000); Radio.Send(buf, 4); } void OnTxDone() { printf(发送成功\r\n); SendToReceiveSwitch(); // 切换到接收模式 }接收端数据处理void OnRxDone(uint8_t *payload, uint16_t size, int16_t rssi, int8_t snr) { if(size 4) { float temp; memcpy(temp, payload, 4); printf(收到温度:%.1f, RSSI:%d, SNR:%d\r\n, temp, rssi, snr); } Radio.Rx(0); // 继续接收 }实测中发现在数据前加1字节的帧头能显著提高抗干扰能力。比如用0xAA开头接收端校验帧头后再解析数据。6. 常见问题排查指南根据三年来的技术支持经验我整理了这些典型问题的解决方法症状1能发不能收检查DIO1接线是否松动确认Radio.SetRxConfig的参数与发送端完全一致用频谱仪查看是否有信号发出没有的话检查PA_BOOST配置症状2通信距离突然变短检查天线阻抗匹配最好用网分仪测查看电源电压是否低于3.0V检查周围是否有同频段设备干扰症状3数据包CRC错误降低数据传输速率把SF调大在project_config.h中增加前导码长度在代码中启用RSSI检测过滤弱信号有个很隐蔽的坑某些厂家的模组需要修改RF开关控制时序。如果遇到发送后立即收不到的情况可以尝试在Radio.Standby()后加50ms延时。
