- This page introduces the hardware parameters related to
LilyGo T3 S3 LR1121
- This version does not have BMS, please use a lithium-ion battery with battery protection function
- Please be sure to connect the antenna before transmitting, otherwise it is easy to damage the RF module
- The T3-S3 V1.2 and T3-S3 V1.3 use the same pins; the only difference is the charging circuit.
| Product | SOC | Flash | PSRAM |
|---|---|---|---|
| T3-S3 | ESP32-S3FH4R2 | 4MB(Quad-SPI) | 2MB(Quad-SPI) |
- Install Visual Studio Code and Python
- Search for the
PlatformIOplugin in theVisual Studio Codeextension and install it. - After the installation is complete, you need to restart
Visual Studio Code - After restarting
Visual Studio Code, selectFilein the upper left corner ofVisual Studio Code->Open Folder-> select theLilyGo-LoRa-Seriesdirectory - Wait for the installation of third-party dependent libraries to complete
- Click on the
platformio.inifile, and in theplatformiocolumn - Select the board name you want to use in
default_envsand uncomment it. - Uncomment one of the lines
src_dir = xxxxto make sure only one line works , Please note the example comments, indicating what works and what does not. - Click the (✔) symbol in the lower left corner to compile
- Connect the board to the computer USB-C , Micro-USB is used for module firmware upgrade
- Click (→) to upload firmware
- Click (plug symbol) to monitor serial output
- If it cannot be written, or the USB device keeps flashing, please check the FAQ below
-
Install Arduino IDE
-
Install Arduino ESP32
-
Copy all folders in the
libdirectory to theSketchbook locationdirectory. How to find the location of your own libraries, please see here- Windows:
C:\Users\{username}\Documents\Arduino - macOS:
/Users/{username}/Documents/Arduino - Linux:
/home/{username}/Arduino
- Windows:
-
Open the corresponding example
- Open the downloaded
LilyGo-LoRa-Series - Open
examples - Select the sample file and open the file ending with
ino
- Open the downloaded
-
On Arduino Select the corresponding board in the IDE tool project and click on the corresponding option in the list below to select
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* Radio-LR1121 Upload Mode UART0/Hardware CDC Upload Speed 921600 USB Mode CDC and JTAG Programmer Esptool - Board revision Select according to actual model
-
Upload sketch
| Name | GPIO NUM | Free |
|---|---|---|
| (QWIIC) Uart1 TX | 43(External QWIIC Socket) | ✅️ |
| (QWIIC) Uart1 RX | 44(External QWIIC Socket) | ✅️ |
| QWIIC Socket IO10* | 10(External QWIIC Socket) | ✅️ |
| QWIIC Socket IO21* | 21(External QWIIC Socket) | ✅️ |
| SDA | 18 | ❌ |
| SCL | 17 | ❌ |
| OLED(SSD1306) SDA | Share with I2C bus | ❌ |
| OLED(SSD1306) SCL | Share with I2C bus | ❌ |
| SD CS | 13 | ❌ |
| SD MOSI | 11 | ❌ |
| SD MISO | 2 | ❌ |
| SD SCK | 14 | ❌ |
| LoRa(LR1121) SCK | 5 | ❌ |
| LoRa(LR1121) MISO | 3 | ❌ |
| LoRa(LR1121) MOSI | 6 | ❌ |
| LoRa(LR1121) RESET | 8 | ❌ |
| LoRa(LR1121) DIO9 | 36 | ❌ |
| LoRa(LR1121) BUSY | 34 | ❌ |
| LoRa(LR1121) CS | 7 | ❌ |
| Button1 (BOOT) | 0 | ❌ |
| Battery ADC | 1 | ❌ |
| On Board LED | 37 | ❌ |
- You can use GPIO10,21 by removing the two resistors in the figure below. Otherwise, the GPIO is connected to DIO8,DIO7 of Radio by default.
- SDA(18) and SCL(17) are not brought out and cannot be accessed. They can only be used as other GPIOs through QWIIC or header pins. During initialization, use explicit initialization
Wire.begin(sda,scl);Any unused GPIO can be used as SDA and SCL.
| T3 V1.2 | T3 V1.3 |
|---|---|
![]() |
![]() |
| Devices | 7-Bit Address | Share Bus |
|---|---|---|
| OLED Display SSD1306 | 0x3C | ✅️ |
| Features | Details |
|---|---|
| 🔗USB-C Input Voltage | 5V |
| 🔗Solar Input Voltage(T3 V1.3 Only) | 4.5~5.6V |
| ⚡Charge Current | 500mA |
| 🔋Battery Voltage | 3.7V |
| 🔋Battery Socket Cables | PH2.0mm |
| 🔗QWIIC Socket Cables | JST1.0 |
| VBUS Pin | 5V |
| VBAT Pin | 4.2V |
Important
T3 V1.3 The maximum solar input voltage can only be 5.6V. If the voltage exceeds this, the Zener diode will discharge and cause the diode to heat up.T3 V1.3
VBUS pin and USB-C port share the same circuit. Please ensure that you do not connect different voltages to the USB-C and VBUS pins, and that power is supplied from only one point.
VBAT pin and battery connector are on the same circuit. Please ensure that you do not connect different voltages to the battery connector and VBAT pin, and ensure that power is supplied from only one point.
If you need to use an external BMS to power the motherboard, the best approach is to connect it via the VBAT port. Note that the voltage connected should be the external BMS's battery voltage (maximum 4.2V). Because the onboard charging management cannot be disconnected, please ensure that the USB-C port is not connected simultaneously while the external BMS is charging; otherwise, both the onboard charging management and the external BMS will charge the battery at the same time.
| Channel | Peripherals |
|---|---|
| BOOT | Boot mode button, customizable |
| RST | Reset button |
- CHG LED
| LED State | Details |
|---|---|
| On | Battery charging |
| Off | Battery Full |
| Blink | Battery not connected |
- User LED
- The LED is connected to ESP32 GPIO37, and the LED is turned on or off by writing a high or low level
| Features | Details |
|---|---|
| RF Module | LR1121 |
| Frequency range | 400-520MHz/830-945MHz/2400-2500MHz |
| Transfer rate(LoRa Sub1G) | 0.018 K ~ 62.5 Kbps |
| Transfer rate(FSK Sub1G) | 0.6 K ~ 300 Kbps |
| Transfer rate(LoRa 2.4G) | 0.476 K~101.5 Kbps |
| Modulation | LoRa,FSK,LR-HFSS |
- LR1121 Sub-1G When the power setting is lower than 14, the power is abnormal. Please see here
- The following figure shows how to switch the onboard WIFI antenna to IPEX
| T3 V1.2 | T3 V1.3 |
|---|---|
![]() |
![]() |
- For instructions on how to configure LoRa antenna control, please refer to the example
- LR1121 The 2.4G antenna interface is located on the LoRa module and cannot be changed.
- LoRa 2.4G and Sub1G antennas are independent and cannot be shared.
- The following figure shows how to switch the onboard LoRa-Sub1G SMA antenna to IPEX






