LILYGO T3S3

版本迭代:

购买链接

目录

• 描述
• 预览
• 模块
• 快速开始
• 引脚总览
• 相关测试
• 常见问题
• 项目
• 资料
• 依赖库

描述

T3S3 (LILYGO T3-S3 V1.2) 是一款集成 ESP32-S3 主控与多频段 LoRa 通信能力的紧凑型开发板。该开发板可选配 SX1262/1276（433/868/915MHz）或 SX1280（2.4GHz）LoRa 模块，支持远距离低功耗通信。板载 0.96 英寸 128x64 OLED 显示屏（SSD1306）及 MicroSD（TF）卡槽，提供数据可视化与存储功能。

通过 Type-C USB 实现供电与程序烧录，并扩展了丰富的接口资源，包括 ADC（GPIO15/16）、UART（U0RTS/U0CTS）、PSP 总线（GPIO33-37）等。同时保留 BOOT/RST 按键与标注清晰的 GPIO 引脚，适用于物联网传感网络、环境监测等低功耗场景开发。

预览

实物图

引脚图

模块

MCU

• 芯片：ESP32-S3FH4R2
• PSRAM：2MB (Quad-SPI)
• FLASH：4MB (Quad-SPI)
• 其他说明：更多资料请访问乐鑫官方ESP32-S3数据手册

屏幕

• 尺寸：0.96英寸 OLED
• 分辨率：128x64px
• 屏幕类型：OLED
• 驱动芯片：SSD1306
• 总线通信协议：I2C

LoRa

• 芯片：SX1262 / SX1276 / SX1280（可选）
• 频率：SX1262/SX1276: 433/868/915MHz，SX1280: 2.4GHz

存储

• 类型：MicroSD (TF) 卡
• 接口：SPI

概述

快速开始

示例支持

./examples/
├── ArduinoLoRa                              # Only support SX1276/SX1278 radio module (仅支持 SX1276/SX1278 无线电模块)
│   ├── LoRaReceiver
│   └── LoRaSender
├── Display                                  # Only supports TBeam TFT Shield
│   ├── Free_Font_Demo
│   ├── TBeam_TFT_Shield
│   ├── TFT_Char_times
│   └── UTFT_demo
├── GPS                                      # T-Beam GPS demo examples
│   ├── TinyGPS_Example
│   ├── TinyGPS_FullExample
│   ├── TinyGPS_KitchenSink
│   ├── UBlox_BasicNMEARead                  # Only support Ublox GNSS Module           
│   ├── UBlox_NMEAParsing                    # Only support Ublox GNSS Module           
│   ├── UBlox_OutputRate                     # Only support Ublox GNSS Module      
│   └── UBlox_Recovery                       # Only support Ublox GNSS Module      
├── LoRaWAN                                  # LoRaWAN examples
│   ├── LMIC_Library_OTTA
│   └── RadioLib_OTAA
├── OLED
│   ├── SH1106FontUsage
│   ├── SH1106GraphicsTest
│   ├── SH1106IconMenu
│   ├── SH1106PrintUTF8
│   ├── SSD1306SimpleDemo
│   └── SSD1306UiDemo
├── PMU                                      # T-Beam & T-Beam S3 PMU demo examples
├── RadioLibExamples                         # RadioLib examples,Support SX1276/78/62/80...
│   ├── Receive_Interrupt
│   └── Transmit_Interrupt
├── Sensor                                   # Sensor examples,only support t-beams3-supreme
│   ├── BME280_AdvancedsettingsExample
│   ├── BME280_TestExample
│   ├── BME280_UnifiedExample
│   ├── PCF8563_AlarmByUnits
│   ├── PCF8563_SimpleTime
│   ├── PCF8563_TimeLib
│   ├── PCF8563_TimeSynchronization
│   ├── QMC6310_CalibrateExample
│   ├── QMC6310_CompassExample
│   ├── QMC6310_GetDataExample
│   ├── QMC6310_GetPolarExample
│   ├── QMI8658_BlockExample
│   ├── QMI8658_GetDataExample
│   ├── QMI8658_InterruptBlockExample
│   ├── QMI8658_InterruptExample
│   ├── QMI8658_LockingMechanismExample
│   ├── QMI8658_MadgwickAHRS
│   ├── QMI8658_PedometerExample
│   ├── QMI8658_ReadFromFifoExample
│   └── QMI8658_WakeOnMotion
|── T3S3Factory                              # T3 S3 factory test examples
└── Factory                                  # T-Beam & T-Beam S3 and BPF factory test examples

PlatformIO

1. 安装 Visual Studio Code。
2. 在扩展中搜索并安装 "PlatformIO IDE"。
3. 从 GitHub 下载 T3S3 项目代码。
4. 在 VS Code 中打开项目文件夹，编辑 platformio.ini 文件选择所需环境。
5. 连接设备，编译并烧录程序。

Arduino

1. 安装 Arduino IDE

2. 安装 Arduino ESP32

3. 将 lib 目录中的所有文件夹复制到 Sketchbook location 目录中。如何查找库文件位置，请参阅此处

   • Windows: C:\Users\{用户名}\Documents\Arduino
   • macOS: /Users/{用户名}/Documents/Arduino
   • Linux: /home/{用户名}/Arduino

4. 打开相应示例

   • 打开已下载的 LilyGo-LoRa-Series 文件夹
   • 打开 examples 文件夹
   • 选择示例文件并打开后缀为 ino 的文件

5. 在 Arduino IDE 工具菜单中选择对应开发板型号，点击下方列表中的对应选项进行选择

   | Name | Value |
   | ------------------------------------ | ---------------------------------------------------- |
   | Board | LilyGo T3-S3 |
   | Port | Your port |
   | USB CDC On Boot | Enable |
   | CPU Frequency | 240MHZ(WiFi) |
   | Core Debug Level | None |
   | USB DFU On Boot | Disable |
   | Erase All Flash Before Sketch Upload | Disable |
   | Events Run On | Core1 |
   | Arduino Runs On | Core1 |
   | USB Firmware MSC On Boot | Disable |
   | Partition Scheme | Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS) |
   | PSRAM | QSPI PSRAM |
   | Board Revision* | XXXXXX |
   | Upload Mode | UART0/Hardware CDC |
   | Upload Speed | 921600 |
   | USB Mode | CDC and JTAG |
   | Programmer | Esptool |

   • Board revision Select according to actual model

6. 上传程序

开发平台

1. Arduino IDE
2. Platform IO
3. ESP-IDF
4. Micropython

引脚总览

SX1262

1276

您可以通过移除图中所示的两个电阻来使用 GPIO10 和 GPIO21。否则，该 GPIO 默认会连接到无线电设备的 DIO3 和 DIO4 。

1278

您可以通过移除下图中的两个电阻来使用 GPIO10 和 GPIO21。否则，该 GPIO 默认会连接到无线电设备的 DIO3 和 DIO4 端口。

1280

相关测试

测试数据待补充

常见问题

• Q. 如何选择 LoRa 模块版本？
  A. SX1262/SX1276 适用于 Sub-1GHz 频段，通信距离更远；SX1280 适用于 2.4GHz 频段，数据速率更高。

• Q. OLED 屏幕不显示？
  A. 检查屏幕排线连接，确认 I2C 地址配置正确（SSD1306 通常为 0x3C）。

• Q. SD 卡无法识别？
  A. 确保 SD 卡格式正确（FAT32），检查卡片是否插好，尝试不同的 SD 卡。

• Q. 程序烧录失败？
  A. 按住 BOOT 按键再点击 RESET 进入下载模式，确保驱动安装正确。

项目

• T3S3 原理图

资料

• 原理图
• SX1262 数据手册
• SSD1306 数据手册
• ESP32-S3 数据手册

依赖库

• RadioLib - LoRa 通信库
• U8g2 - OLED 显示库
• Arduino_GFX - 图形显示库
• SD - SD 卡库