T3-S3 快速开始
依赖库
| 库名 | 版本 | 来源 |
|---|---|---|
| RadioLib | 最新 | GitHub |
| U8g2 | 最新 | Arduino 库管理器 |
Arduino
PlatformIO（推荐）
- 安装 VS Code 和 PlatformIO IDE 扩展
- 克隆仓库：bash
git clone https://github.com/Xinyuan-LilyGO/LilyGo-LoRa-Series.git - 打开项目，在
platformio.ini中选择与你的 LoRa 模块型号对应的环境 - 点击 ✓ 编译，连接 USB-C，点击 → 上传
Arduino IDE
开发板设置
| 设置项 | 值 |
|---|---|
| 开发板 | LilyGo T3-S3 |
| Board Revision | 按 LoRa 模块选择（SX1262 / SX1276 / SX1280 等） |
| Upload Speed | 921600 |
| USB Mode | Hardware CDC and JTAG |
| USB CDC On Boot | Enabled |
| CPU Frequency | 240 MHz (WiFi) |
| Flash Mode | QIO 80 MHz |
| Flash Size | 4MB (32Mb) |
| Partition Scheme | Default 4MB with spiffs |
| PSRAM | QSPI PSRAM |
步骤
- 安装 Arduino IDE 并添加 ESP32 开发板支持：
https://espressif.github.io/arduino-esp32/package_esp32_index.json - 在开发板管理器中搜索 esp32（Espressif Systems）并安装
- 克隆 LilyGo-LoRa-Series 仓库并打开示例工程
- 选择 LilyGo T3-S3 并将 Board Revision 设置为与模块匹配的值
- 点击「上传」
注意事项
- LoRa 型号：SX1262 / SX1276 / SX1278（Sub-GHz）或 SX1280（2.4 GHz）——在 Board Revision 或
utilities.h中设置正确型号 - PSRAM：QSPI PSRAM，Arduino IDE 中选择 QSPI PSRAM
- Meshtastic：本板支持 Meshtastic，可通过 Meshtastic 网页烧录工具或 CLI 刷入固件
- GPIO10/GPIO21：SX1276/78 型号中这两个引脚连接至 DIO3/DIO4，如需释放可去除对应电阻
外设示例
LoRa（SX1262）
cpp
#include <RadioLib.h>
// T3-S3 SX1262: CS=7, IRQ=33, RST=8, BUSY=34
SX1262 radio = new Module(7, 33, 8, 34);
void setup() {
Serial.begin(115200);
int state = radio.begin(915.0);
if (state != RADIOLIB_ERR_NONE) {
Serial.print("LoRa 初始化失败: "); Serial.println(state);
while (true);
}
radio.setOutputPower(22);
Serial.println("SX1262 就绪");
}
void loop() {
int state = radio.transmit("Hello T3-S3");
if (state == RADIOLIB_ERR_NONE) Serial.println("发送成功");
delay(2000);
}OLED 显示屏（SSD1306）
cpp
#include <U8g2lib.h>
#include <Wire.h>
// SSD1306 128×64 I2C，SDA=18，SCL=17
U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, U8X8_PIN_NONE);
void setup() {
Wire.begin(18, 17);
u8g2.begin();
}
void loop() {
u8g2.clearBuffer();
u8g2.setFont(u8g2_font_ncenB08_tr);
u8g2.drawStr(0, 20, "T3-S3 Ready");
u8g2.sendBuffer();
delay(1000);
}常见问题
Q：上传失败，找不到端口？ A：确认 USB CDC On Boot 已设置为 Enabled。若之前已禁用，按住 BOOT 再按 RST 进入下载模式。
Q：如何确认我的 LoRa 模块型号？ A：查看 RF 模块上的丝印，或参考订单信息。SX1280 支持 2.4 GHz，SX1262/76/78 支持 Sub-GHz 频段。