ESP32+Ra-02 双板LoRa无线收发实操

2026-11-13 13:18:33 131阅读 所属项目:ESP32 开发板

TTGO LoRa32 开发板与配套天线
今天把两块 ESP32 LoRa 板子做成一对收发机:发送端每 10 秒发一个计数包,接收端把包内容和 RSSI 信号强度打到串口和 OLED 上。整个链路不依赖 Wi-Fi 和路由器,天线拧上就能跑。手里有 Ra-02/SX1278 模块的也不用换代码,同样的库、同样的初始化,只是频段和接线要按自己的模块核对。教程思路出处是 Random Nerd Tutorials 的 TTGO LoRa32 SX1276 实操,代码逐字符搬过来验证过。

LoRa 到底是什么,凭什么传得远

LoRa 是 Semtech 那套扩频射频调制技术,特点是拿低带宽换距离:只传很小的数据量,但抗干扰强、功耗低、传得远。unlicensed 频段全球通用,常见的是欧洲 868 MHz、北美 915 MHz、亚洲 433 MHz。Ra-02/SX1278 这类散装模块基本都按 433 MHz 走,TTGO LoRa32 这类一体板常见 433/868 两种版本,买之前看清丝印,别拿 868 的板子在亚洲硬跑。

它不适合的场景也要说清楚:需要高速率、需要非常频繁地发包、或者要组大网的地方,LoRa 都不是好选择。它最舒服的位置是电池供电的传感节点,几节电池扛几个月,每天发几条小数据。点对点两台设备直连,或者上 LoRaWAN 组网,都行。

硬件准备与库安装

这次用的是两块 TTGO LoRa32(SX1276 射频芯片 + 0.96 寸 OLED),和 Ra-02/SX1278 属于同一个 SX127x 家族,LoRa 库完全通用。板子长这样:

TTGO LoRa32 OLED 板正面

烧录前先确认板子在 Arduino IDE 里能被认出来。开发板列表里选 TTGO LoRa32 这一项:

Arduino IDE 中选择 TTGO LoRa 板

然后装库。两块板共用同一个 LoRa.h(sandboxes 版 LoRa 库,库管理器搜 LoRa 装 sandboxesmen 那个),另外 OLED 还要 Adafruit SSD1306 和 Adafruit GFX 两个库。装完库务必重启 IDE,不然编译时找不到头文件。

库管理器安装 LoRa 库

射频部分走 SPI,板级引脚定义是 SCK 5、MISO 19、MOSI 27、SS 18、RST 14、DIO0 26,代码里已经写死,不用改:

TTGO LoRa 板引脚图

如果你用散装 Ra-02 模块自己搭 ESP32,这几个 SPI 引脚可以按你的接线在 #define 处改,其余代码不动。频段常量 BAND 是唯一的硬性检查点:亚洲用 433E6,欧洲 866E6,北美 915E6。发和收两端必须同一个频段,一个 433 一个 868 是永远握不上手的。

发送端代码

发送端每 10 秒发一条 "hello 计数值",同时在 OLED 上刷状态。完整代码如下:

/*********
  Rui Santos
  Complete project details at https://RandomNerdTutorials.com/ttgo-lora32-sx1276-arduino-ide/
*********/

//Libraries for LoRa
#include "SPI.h"
#include "LoRa.h"

//Libraries for OLED Display
#include "Wire.h"
#include "Adafruit_GFX.h"
#include "Adafruit_SSD1306.h"

//define the pins used by the LoRa transceiver module
#define SCK 5
#define MISO 19
#define MOSI 27
#define SS 18
#define RST 14
#define DIO0 26

//433E6 for Asia
//866E6 for Europe
//915E6 for North America
#define BAND 866E6

//OLED pins
#define OLED_SDA 4
#define OLED_SCL 15 
#define OLED_RST 16
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels

//packet counter
int counter = 0;

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RST);

void setup() {
  //initialize Serial Monitor
  Serial.begin(115200);

  //reset OLED display via software
  pinMode(OLED_RST, OUTPUT);
  digitalWrite(OLED_RST, LOW);
  delay(20);
  digitalWrite(OLED_RST, HIGH);

  //initialize OLED
  Wire.begin(OLED_SDA, OLED_SCL);
  if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3c, false, false)) { // Address 0x3C for 128x32
    Serial.println(F("SSD1306 allocation failed"));
    for(;;); // Don't proceed, loop forever
  }
  
  display.clearDisplay();
  display.setTextColor(WHITE);
  display.setTextSize(1);
  display.setCursor(0,0);
  display.print("LORA SENDER ");
  display.display();
  
  Serial.println("LoRa Sender Test");

  //SPI LoRa pins
  SPI.begin(SCK, MISO, MOSI, SS);
  //setup LoRa transceiver module
  LoRa.setPins(SS, RST, DIO0);
  
  if (!LoRa.begin(BAND)) {
    Serial.println("Starting LoRa failed!");
    while (1);
  }
  Serial.println("LoRa Initializing OK!");
  display.setCursor(0,10);
  display.print("LoRa Initializing OK!");
  display.display();
  delay(2000);
}

void loop() {
   
  Serial.print("Sending packet: ");
  Serial.println(counter);

  //Send LoRa packet to receiver
  LoRa.beginPacket();
  LoRa.print("hello ");
  LoRa.print(counter);
  LoRa.endPacket();
  
  display.clearDisplay();
  display.setCursor(0,0);
  display.println("LORA SENDER");
  display.setCursor(0,20);
  display.setTextSize(1);
  display.print("LoRa packet sent.");
  display.setCursor(0,30);
  display.print("Counter:");
  display.setCursor(50,30);
  display.print(counter);      
  display.display();

  counter++;
  
  delay(10000);
}

发送端跑起来的实物状态:

发送端板子运行状态

接收端代码

接收端用 LoRa.parsePacket() 轮询收包,读出数据后顺带取 RSSI。RSSI 是负数,越接近 0 信号越好,这个值后面排天线问题时是唯一的凭据:

/*********
  Rui Santos
  Complete project details at https://RandomNerdTutorials.com/ttgo-lora32-sx1276-arduino-ide/
*********/

//Libraries for LoRa
#include "SPI.h"
#include "LoRa.h"

//Libraries for OLED Display
#include "Wire.h"
#include "Adafruit_GFX.h"
#include "Adafruit_SSD1306.h"

//define the pins used by the LoRa transceiver module
#define SCK 5
#define MISO 19
#define MOSI 27
#define SS 18
#define RST 14
#define DIO0 26

//433E6 for Asia
//866E6 for Europe
//915E6 for North America
#define BAND 866E6

//OLED pins
#define OLED_SDA 4
#define OLED_SCL 15 
#define OLED_RST 16
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RST);

String LoRaData;

void setup() { 
  //initialize Serial Monitor
  Serial.begin(115200);
  
  //reset OLED display via software
  pinMode(OLED_RST, OUTPUT);
  digitalWrite(OLED_RST, LOW);
  delay(20);
  digitalWrite(OLED_RST, HIGH);
  
  //initialize OLED
  Wire.begin(OLED_SDA, OLED_SCL);
  if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3c, false, false)) { // Address 0x3C for 128x32
    Serial.println(F("SSD1306 allocation failed"));
    for(;;); // Don't proceed, loop forever
  }

  display.clearDisplay();
  display.setTextColor(WHITE);
  display.setTextSize(1);
  display.setCursor(0,0);
  display.print("LORA RECEIVER ");
  display.display();

  Serial.println("LoRa Receiver Test");
  
  //SPI LoRa pins
  SPI.begin(SCK, MISO, MOSI, SS);
  //setup LoRa transceiver module
  LoRa.setPins(SS, RST, DIO0);

  if (!LoRa.begin(BAND)) {
    Serial.println("Starting LoRa failed!");
    while (1);
  }
  Serial.println("LoRa Initializing OK!");
  display.setCursor(0,10);
  display.println("LoRa Initializing OK!");
  display.display();  
}

void loop() {

  //try to parse packet
  int packetSize = LoRa.parsePacket();
  if (packetSize) {
    //received a packet
    Serial.print("Received packet ");

    //read packet
    while (LoRa.available()) {
      LoRaData = LoRa.readString();
      Serial.print(LoRaData);
    }

    //print RSSI of packet
    int rssi = LoRa.packetRssi();
    Serial.print(" with RSSI ");    
    Serial.println(rssi);

   // Dsiplay information
   display.clearDisplay();
   display.setCursor(0,0);
   display.print("LORA RECEIVER");
   display.setCursor(0,20);
   display.print("Received packet:");
   display.setCursor(0,30);
   display.print(LoRaData);
   display.setCursor(0,40);
   display.print("RSSI:");
   display.setCursor(30,40);
   display.print(rssi);
   display.display();   
  }
}

接收端运行实物,OLED 上能看到包内容和 RSSI:

接收端 OLED 显示包内容与 RSSI

烧录与排错实录

两块板各自选好端口分别烧录,串口监视器统一开 115200。初始化成功会看到 LoRa Initializing OK!,发送端持续打印 Sending packet: 0、1、2...,接收端打印 Received packet hello 1 with RSSI -70 这种格式。

烧录链路上最容易卡的三处,按顺序排查:

  1. Starting LoRa failed! —— 射频芯片没起来。先查 BAND 是不是和板子硬件版本匹配,再查 SS/RST/DIO0 三个引脚定义是否和你手里的板子一致。Ra-02 散装模块的话,NSS 接哪个 GPIO 就定义哪个。
  2. SSD1306 allocation failed —— OLED 初始化失败。多数是地址问题,0x3C 不行换 0x3D;还可能是 OLED_RST 没接对,软件复位那段 digitalWrite 不能省。
  3. 能初始化但收不到包 —— 两个板子 BAND 不同步是首因;其次看天线。原装弹簧天线看着不起眼,不拧或者接触不良会把 RSSI 干到 -120 以下,有人实测只隔 10 米就丢包,把天线重新拧紧后立刻恢复正常。散装 Ra-02 记得先把天线焊上再上电,裸板上电烧射频前端是这一族模块最贵的坑。

验证通过后,你可以把发送端换成温湿度读数,接收端加个 SD 卡或者往服务器转发,一条 LoRa 数据链路就算搭完了。距离期望值:空旷环境带正常天线,双板点对点跑几公里不稀奇,楼内穿墙则要靠 RSSI 实测说话,别拿理论值当验收标准。


作者:固件烧录仔
链接:https://www.aiddithome.com/p/113d82987cdea2.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
5条评论
老张装机
1楼 · 2026-11-13 13:19:03

RSSI 这个值确实好用,我拿两块板隔着两栋楼测,-95 左右还能稳收,低于 -115 就开始丢包了。

锡点
2楼 · 2026-11-13 13:19:03

提醒一句 Ra-02 真的要先焊天线再上电,我去年裸板通电烧了一块前端,血泪教训。

第三次终于亮了
3楼 · 2026-11-13 13:19:03

亚洲用 433E6 这个点太关键了,我第一次跑就是 868 板子配 433 模块,调了一晚上才发现频段不对。

拆开看看再说
4楼 · 2026-11-13 13:19:03

Starting LoRa failed! 这个报错我遇到的是 DIO0 接错脚,改完定义就通了,和文章里说的对得上。

隔壁工位的好奇宝
5楼 · 2026-11-13 13:19:03

点对点几公里的说法没夸张,我在郊外实测过三公里,城里穿墙就别指望了,得看 RSSI 慢慢挪位置。