ESP8266与RPi 3B+的LoRa-02(SX1278)通信故障排查

核心配置不匹配问题 #

• 同步字（Sync Word）不一致：ESP8266使用的Arduino LoRa库默认同步字为0x34，但你的树莓派代码中设置的是0x12，这会导致双方无法识别彼此的数据包。请将两边同步字统一：
  • ESP8266代码中添加LoRa.setSyncWord(0x12);（或把树莓派的modem.eth.syncWord改为0x34）
• AGC配置冲突：ESP8266代码中LoRa.setGain(0)是禁用自动增益控制（AGC），而树莓派代码开启了AGC（modem.eth.AGC = 1）。AGC对SX1278接收灵敏度至关重要，建议两边统一开启：
  • ESP8266代码替换为LoRa.enableAgc();（若库支持），或设置LoRa.setGain(6);

硬件与SPI基础配置检查 #

• 确认树莓派SPI已启用：通过raspi-config进入「Interfacing Options」→「SPI」开启接口，重启树莓派后生效。
• 接线与供电检查：
  • 确保LoRa模块使用稳定的3.3V供电，若树莓派3.3V引脚电流不足，需外接3.3V电源模块。
  • 检查DIO0、RESET、SPI引脚接线是否牢固，特别是DIO0引脚（中断触发），接触不良会导致接收中断失效。
• SPI通信验证：在树莓派代码中添加读取SX1278版本寄存器的逻辑，确认SPI链路正常：

  // 在LoRa_begin后添加
  uint8_t version = LoRa_readReg(&modem, 0x42);
  printf("SX1278 Version: 0x%02X\n", version);
  

  若输出为0x12则SPI正常，否则排查接线或SPI配置。

树莓派库与代码优化 #

• 更换成熟库：当前使用的库稳定性存疑（两台树莓派ping pong也失败），建议替换为更可靠的C/C++库，比如基于wiringPi的SX1278底层驱动，或Semtech官方SX127x驱动的树莓派移植版本。
• 简化接收逻辑：暂时去掉回调函数，改用轮询方式检测数据包，排除中断配置问题：

  // 替换原while循环
  while (1) {
    int packetSize = LoRa_parsePacket(&modem);
    if (packetSize > 0) {
      printf("Received packet size: %d\n", packetSize);
      char buf[256];
      int len = LoRa_readPacket(&modem, (uint8_t*)buf, sizeof(buf));
      buf[len] = '\0';
      printf("Data: %s\n", buf);
    }
    usleep(100000);
  }
  

• 中断引脚冲突检查：确认GPIO17（DIO0）未被其他程序占用，可通过gpio readall命令查看引脚状态。

额外测试建议 #

• 提高ESP8266发射功率：添加LoRa.setTxPower(20, PA_OUTPUT_PA_BOOST_PIN);增强信号强度，排除弱信号导致的接收失败。
• 校准频率：若存在频偏，可尝试微调频率（比如±1000Hz），确认是否因晶体精度问题导致无法接收。

内容的提问来源于stack exchange，提问作者Amir