jlpoole/LilyGo-LoRa-Series
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Update docs

Browse source
This commit is contained in:
lewisxhe 2025-12-31 14:32:01 +08:00
commit 0e9e98f378
15 changed files with 248 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/en/t3_s3_lr1121/t3_s3_lr1121_hw.md
View file

@ -104,9 +104,9 @@
* 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.
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------- | ------------------------------------------- |
| ![T3-S3-QWIIC](./images/T3-S3-QWIIC.png) | ![T3-S3-QWIIC](./images/T3S3-V13-QWIIC.png) |
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------ | ------------------------------------------------ |
| ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.2.png) | ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.3.png) |
### 🧑🏼‍🔧 I2C Devices Address
@ -167,7 +167,9 @@
* The following figure shows how to switch the onboard WIFI antenna to IPEX
![WIFI-IPEX](./images/WIFI-IPEX.png)
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX
@ -184,7 +186,3 @@
* [T3_S3_V1.2 schematic](../../../schematic/T3_S3_V1.2.pdf)
* [T3_S3_V1.3 schematic](../../../schematic/T3_S3_V1.3.pdf)
* [LR1121 datasheet](https://www.semtech.com/products/wireless-rf/lora-connect/lr1121)
### Application
* [T-Beam Meshtastic](https://github.com/meshtastic/Meshtastic-device)

BIN
docs/en/t3_s3_lr1121_pa/images/LORA-IPEX.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 601 KiB

BIN
docs/en/t3_s3_lr1121_pa/images/LR1121.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 217 KiB

201
docs/en/t3_s3_lr1121_pa/t3_s3_lr1121_pa_hw.md Normal file
View file

@ -0,0 +1,201 @@
<div align="center" markdown="1">
<img src="../../../.github/LilyGo_logo.png" alt="LilyGo logo" width="100"/>
</div>
<h1 align = "center">🌟LilyGo T3 S3 LR1121 PA Version🌟</h1>
## Overview
* This page introduces the hardware parameters related to `LilyGo T3 S3 LR1121 PA Version`
### Notes on use
1. This version does not have BMS, please use a lithium-ion battery with battery protection function
2. Please be sure to connect the antenna before transmitting, otherwise it is easy to damage the RF module
### Product
| Product | SOC | Flash | PSRAM |
| ---------- | ------------- | ------------- | ------------- |
| [T3-S3][1] | ESP32-S3FH4R2 | 4MB(Quad-SPI) | 2MB(Quad-SPI) |
[1]: https://www.lilygo.cc/products/t3s3-v1-0?variant=42586879688885 "T3-S3"
## PlatformIO Quick Start
1. Install [Visual Studio Code](https://code.visualstudio.com/) and [Python](https://www.python.org/)
2. Search for the `PlatformIO` plugin in the `Visual Studio Code` extension and install it.
3. After the installation is complete, you need to restart `Visual Studio Code`
4. After restarting `Visual Studio Code`, select `File` in the upper left corner of `Visual Studio Code` -> `Open Folder` -> select the `LilyGo-LoRa-Series` directory
5. Wait for the installation of third-party dependent libraries to complete
6. Click on the `platformio.ini` file, and in the `platformio` column
7. Select the board name you want to use in `default_envs` and uncomment it.
8. Uncomment one of the lines `src_dir = xxxx` to make sure only one line works , Please note the example comments, indicating what works and what does not.
9. Click the (✔) symbol in the lower left corner to compile
10. Connect the board to the computer USB-C , Micro-USB is used for module firmware upgrade
11. Click (→) to upload firmware
12. Click (plug symbol) to monitor serial output
13. If it cannot be written, or the USB device keeps flashing, please check the **FAQ** below
## Arduino IDE quick start
1. Install [Arduino IDE](https://www.arduino.cc/en/software)
2. Install [Arduino ESP32](https://docs.espressif.com/projects/arduino-esp32/en/latest/)
3. Copy all folders in the `lib` directory to the `Sketchbook location` directory. How to find the location of your own libraries, [please see here](https://support.arduino.cc/hc/en-us/articles/4415103213714-Find-sketches-libraries-board-cores-and-other-files-on-your-computer)
* Windows: `C:\Users\{username}\Documents\Arduino`
* macOS: `/Users/{username}/Documents/Arduino`
* Linux: `/home/{username}/Arduino`
4. Open the corresponding example
* Open the downloaded `LilyGo-LoRa-Series`
* Open `examples`
* Select the sample file and open the file ending with `ino`
5. On Arduino ISelect the corresponding board in the DE tool project and click on the corresponding option in the list below to select
| Name | Value |
| ------------------------------------ | ----------------------------------- |
| Board | **ESP32S3 Dev Module** |
| 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 |
| Flash Mode | QIO 80Mhz |
| Flash Size | **4MB(32Mb)** |
| Arduino Runs On | Core1 |
| USB Firmware MSC On Boot | Disable |
| Partition Scheme | **16M Flash (3MB APP/9.9MB FATFS)** |
| PSRAM | **OPI PSRAM** |
| Upload Speed | 921600 |
| Programmer | **Esptool** |
6. Please uncomment the `utilities.h` file of each sketch according to your board model e.g `T3_S3_V1_2_LR1121_PA`, otherwise the compilation will report an error.
7. Upload sketch
### 📍 Pins Map
| 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.
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------ | ------------------------------------------------ |
| ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.2.png) | ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.3.png) |
### 🧑🏼‍🔧 I2C Devices Address
| Devices | 7-Bit Address | Share Bus |
| -------------------- | ------------- | --------- |
| OLED Display SSD1306 | 0x3C | ✅️ |
### ⚡ Electrical parameters
| 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 |
> \[!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
>
### Button Description
| Channel | Peripherals |
| ------- | ------------------------------ |
| BOOT | Boot mode button, customizable |
| RST | Reset button |
### LED Description
* CHG LED
| LED State | Details |
| --------- | --------------------- |
| On | Battery charging |
| Off | Battery Full |
| Blink | Battery not connected |
* User LED
1. The LED is connected to ESP32 GPIO37, and the LED is turned on or off by writing a high or low level
### RF parameters
| 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 |
> \[!IMPORTANT]
>
> ⚠️⚠️⚠️
> LR1121 version with a built-in PA, do not set the maximum power above 0dBm.
> This is because a power amplifier is added to the RF front end; setting it to 0dBm will achieve an output power of 22dBm.
> Setting it above 1dBm may damage the PA.
>
### LoRa Antenna Switch Truth Table
| Freq | Mode | DIO5_SW0 | DIO6_SW1 | DIO7_SW2 | DIO8_SW3 |
| ------- | ----- | -------- | -------- | -------- | -------- |
| 868/915 | TX | 0 | 1 | 0 | 0 |
| 868/915 | RX | 1 | 0 | 0 | 0 |
| 2.4G | TX | 0 | 0 | 1 | 0 |
| 2.4G | RX | 0 | 0 | 0 | 1 |
| SLEEP | SLEEP | 0 | 0 | 0 | 0 |
## WiFi-IPEX
* The following figure shows how to switch the onboard WIFI antenna to IPEX
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX
* The following figure shows how to switch the onboard LoRa SMA antenna to IPEX
![LORA-IPEX](./images/LORA-IPEX.png)
### LR1121 RF Block Diagram
![RF Block Diagram](./images/LR1121.png)
#### Resource
* [T3_S3_V1.2 schematic](../../../schematic/T3_S3_V1.2.pdf)
* [T3_S3_V1.3 schematic](../../../schematic/T3_S3_V1.3.pdf)
* [LR1121 datasheet](https://www.semtech.com/products/wireless-rf/lora-connect/lr1121)

BIN
docs/en/t3_s3_sx1262/images/T3-S3-QWIIC.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 372 KiB

10
docs/en/t3_s3_sx1262/t3_s3_sx1262_hw.md
View file

@ -104,9 +104,9 @@
* You can use GPIO10,21 by removing the two resistors in the figure below. Otherwise, the GPIO is connected to DIO3,DIO4 of Radio by default.
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| ![T3-S3-QWIIC](../t3_s3_lr1121/images/T3-S3-QWIIC.png) | ![T3-S3-QWIIC](../t3_s3_lr1121//images/T3S3-V13-QWIIC.png) |
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------ | ------------------------------------------------ |
| ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.2.png) | ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.3.png) |
### 🧑🏼‍🔧 I2C Devices Address
@ -164,7 +164,9 @@
* The following figure shows how to switch the onboard WIFI antenna to IPEX
![WIFI-IPEX](../t3_s3_lr1121/images/WIFI-IPEX.png)
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX

10
docs/en/t3_s3_sx1276/t3_s3_sx1276_hw.md
View file

@ -108,9 +108,9 @@
* You can use GPIO10,21 by removing the two resistors in the figure below. Otherwise, the GPIO is connected to DIO3,DIO4 of Radio by default.
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| ![T3-S3-QWIIC](../t3_s3_lr1121/images/T3-S3-QWIIC.png) | ![T3-S3-QWIIC](../t3_s3_lr1121//images/T3S3-V13-QWIIC.png) |
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------ | ------------------------------------------------ |
| ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.2.png) | ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.3.png) |
### 🧑🏼‍🔧 I2C Devices Address
@ -174,7 +174,9 @@
* The following figure shows how to switch the onboard WIFI antenna to IPEX
![WIFI-IPEX](../t3_s3_lr1121/images/WIFI-IPEX.png)
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX

10
docs/en/t3_s3_sx1278/t3_s3_sx1278_hw.md
View file

@ -108,9 +108,9 @@
* You can use GPIO10,21 by removing the two resistors in the figure below. Otherwise, the GPIO is connected to DIO3,DIO4 of Radio by default.
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| ![T3-S3-QWIIC](../t3_s3_lr1121/images/T3-S3-QWIIC.png) | ![T3-S3-QWIIC](../t3_s3_lr1121//images/T3S3-V13-QWIIC.png) |
| T3 V1.2 | T3 V1.3 |
| ------------------------------------------------ | ------------------------------------------------ |
| ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.2.png) | ![T3-S3-QWIIC](../../static/T3S3-QWIIC-V1.3.png) |
### 🧑🏼‍🔧 I2C Devices Address
@ -168,7 +168,9 @@
* The following figure shows how to switch the onboard WIFI antenna to IPEX
![WIFI-IPEX](../t3_s3_lr1121/images/WIFI-IPEX.png)
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX

4
docs/en/t3_s3_sx1280/t3_s3_sx1280_hw.md
View file

@ -159,7 +159,9 @@
* The following figure shows how to switch the onboard WIFI antenna to IPEX
![WIFI-IPEX](../t3_s3_lr1121/images/WIFI-IPEX.png)
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX

4
docs/en/t3_s3_sx1280pa/t3_s3_sx1280pa.md
View file

@ -163,7 +163,9 @@
* The following figure shows how to switch the onboard WIFI antenna to IPEX
![WIFI-IPEX](../t3_s3_lr1121/images/WIFI-IPEX.png)
| T3 V1.2 | T3 V1.3 |
| ---------------------------------------------- | ---------------------------------------------- |
| ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.2.png) | ![T3-S3](../../static/T3S3-WIFI-IPEX-V1.3.png) |
## LoRa-IPEX

34
docs/en/t_beam_1w/t_beam_1w_hw.md
View file

@ -45,23 +45,23 @@
* Select the sample file and open the file ending with `ino`
5. On Arduino ISelect the corresponding board in the DE tool project and click on the corresponding option in the list below to select
| Name | Value |
| ------------------------------------ | ----------------------------------- |
| Board | **ESP32S3 Dev Module** |
| 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 |
| Flash Mode | QIO 80Mhz |
| Flash Size | **16MB(128Mb)** |
| Arduino Runs On | Core1 |
| USB Firmware MSC On Boot | Disable |
| Partition Scheme | **16M Flash (3MB APP/9.9MB FATFS)** |
| PSRAM | **OPI PSRAM** |
| Upload Speed | 921600 |
| Programmer | **Esptool** |
| Name | Value |
| ------------------------------------ | ---------------------------------------------------- |
| Board | **ESP32S3 Dev Module** |
| 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 |
| Flash Mode | QIO 80Mhz |
| Flash Size | **16MB(128Mb)** |
| 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** |
| Upload Speed | 921600 |
| Programmer | **Esptool** |
6. Please uncomment the `utilities.h` file of each sketch according to your board model e.g `T_BEAM_1W`, otherwise the compilation will report an error.
7. Upload sketch

0
docs/en/t3_s3_lr1121/images/T3-S3-QWIIC.png → docs/static/T3S3-QWIIC-V1.2.png vendored
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 372 KiB

After

Width:  |  Height:  |  Size: 372 KiB

Before After
Before After

0
docs/en/t3_s3_lr1121/images/T3S3-V13-QWIIC.png → docs/static/T3S3-QWIIC-V1.3.png vendored
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 3.8 MiB

After

Width:  |  Height:  |  Size: 3.8 MiB

Before After
Before After

0
docs/en/t3_s3_lr1121/images/WIFI-IPEX.png → docs/static/T3S3-WIFI-IPEX-V1.2.png vendored
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 292 KiB

After

Width:  |  Height:  |  Size: 292 KiB

Before After
Before After

BIN
docs/static/T3S3-WIFI-IPEX-V1.3.png vendored Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 698 KiB