
今天把两块 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 库完全通用。板子长这样:

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

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

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

如果你用散装 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:

烧录与排错实录
两块板各自选好端口分别烧录,串口监视器统一开 115200。初始化成功会看到 LoRa Initializing OK!,发送端持续打印 Sending packet: 0、1、2...,接收端打印 Received packet hello 1 with RSSI -70 这种格式。
烧录链路上最容易卡的三处,按顺序排查:
- Starting LoRa failed! —— 射频芯片没起来。先查 BAND 是不是和板子硬件版本匹配,再查 SS/RST/DIO0 三个引脚定义是否和你手里的板子一致。Ra-02 散装模块的话,NSS 接哪个 GPIO 就定义哪个。
- SSD1306 allocation failed —— OLED 初始化失败。多数是地址问题,0x3C 不行换 0x3D;还可能是 OLED_RST 没接对,软件复位那段
digitalWrite不能省。 - 能初始化但收不到包 —— 两个板子 BAND 不同步是首因;其次看天线。原装弹簧天线看着不起眼,不拧或者接触不良会把 RSSI 干到 -120 以下,有人实测只隔 10 米就丢包,把天线重新拧紧后立刻恢复正常。散装 Ra-02 记得先把天线焊上再上电,裸板上电烧射频前端是这一族模块最贵的坑。
验证通过后,你可以把发送端换成温湿度读数,接收端加个 SD 卡或者往服务器转发,一条 LoRa 数据链路就算搭完了。距离期望值:空旷环境带正常天线,双板点对点跑几公里不稀奇,楼内穿墙则要靠 RSSI 实测说话,别拿理论值当验收标准。











RSSI 这个值确实好用,我拿两块板隔着两栋楼测,-95 左右还能稳收,低于 -115 就开始丢包了。
提醒一句 Ra-02 真的要先焊天线再上电,我去年裸板通电烧了一块前端,血泪教训。
亚洲用 433E6 这个点太关键了,我第一次跑就是 868 板子配 433 模块,调了一晚上才发现频段不对。
Starting LoRa failed! 这个报错我遇到的是 DIO0 接错脚,改完定义就通了,和文章里说的对得上。
点对点几公里的说法没夸张,我在郊外实测过三公里,城里穿墙就别指望了,得看 RSSI 慢慢挪位置。