diff --git a/docs/en/t3_s3_lr1121/t3_s3_lr1121_hw.md b/docs/en/t3_s3_lr1121/t3_s3_lr1121_hw.md index b053269..62732a1 100644 --- a/docs/en/t3_s3_lr1121/t3_s3_lr1121_hw.md +++ b/docs/en/t3_s3_lr1121/t3_s3_lr1121_hw.md @@ -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) diff --git a/docs/en/t3_s3_lr1121_pa/images/LORA-IPEX.png b/docs/en/t3_s3_lr1121_pa/images/LORA-IPEX.png new file mode 100644 index 0000000..922ee12 Binary files /dev/null and b/docs/en/t3_s3_lr1121_pa/images/LORA-IPEX.png differ diff --git a/docs/en/t3_s3_lr1121_pa/images/LR1121.png b/docs/en/t3_s3_lr1121_pa/images/LR1121.png new file mode 100644 index 0000000..324db65 Binary files /dev/null and b/docs/en/t3_s3_lr1121_pa/images/LR1121.png differ diff --git a/docs/en/t3_s3_lr1121_pa/t3_s3_lr1121_pa_hw.md b/docs/en/t3_s3_lr1121_pa/t3_s3_lr1121_pa_hw.md new file mode 100644 index 0000000..518bf1d --- /dev/null +++ b/docs/en/t3_s3_lr1121_pa/t3_s3_lr1121_pa_hw.md @@ -0,0 +1,201 @@ +
+ LilyGo logo +
+ +

🌟LilyGo T3 S3 LR1121 PA Version🌟

+ +## 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) diff --git a/docs/en/t3_s3_sx1262/images/T3-S3-QWIIC.png b/docs/en/t3_s3_sx1262/images/T3-S3-QWIIC.png deleted file mode 100644 index 938c86e..0000000 Binary files a/docs/en/t3_s3_sx1262/images/T3-S3-QWIIC.png and /dev/null differ diff --git a/docs/en/t3_s3_sx1262/t3_s3_sx1262_hw.md b/docs/en/t3_s3_sx1262/t3_s3_sx1262_hw.md index 8391713..54c1416 100644 --- a/docs/en/t3_s3_sx1262/t3_s3_sx1262_hw.md +++ b/docs/en/t3_s3_sx1262/t3_s3_sx1262_hw.md @@ -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 diff --git a/docs/en/t3_s3_sx1276/t3_s3_sx1276_hw.md b/docs/en/t3_s3_sx1276/t3_s3_sx1276_hw.md index 0be4b67..c0a638c 100644 --- a/docs/en/t3_s3_sx1276/t3_s3_sx1276_hw.md +++ b/docs/en/t3_s3_sx1276/t3_s3_sx1276_hw.md @@ -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 diff --git a/docs/en/t3_s3_sx1278/t3_s3_sx1278_hw.md b/docs/en/t3_s3_sx1278/t3_s3_sx1278_hw.md index f8897dd..ba3738a 100644 --- a/docs/en/t3_s3_sx1278/t3_s3_sx1278_hw.md +++ b/docs/en/t3_s3_sx1278/t3_s3_sx1278_hw.md @@ -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 diff --git a/docs/en/t3_s3_sx1280/t3_s3_sx1280_hw.md b/docs/en/t3_s3_sx1280/t3_s3_sx1280_hw.md index cfa433b..4f48249 100644 --- a/docs/en/t3_s3_sx1280/t3_s3_sx1280_hw.md +++ b/docs/en/t3_s3_sx1280/t3_s3_sx1280_hw.md @@ -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 diff --git a/docs/en/t3_s3_sx1280pa/t3_s3_sx1280pa.md b/docs/en/t3_s3_sx1280pa/t3_s3_sx1280pa.md index 30801e6..713ce8a 100644 --- a/docs/en/t3_s3_sx1280pa/t3_s3_sx1280pa.md +++ b/docs/en/t3_s3_sx1280pa/t3_s3_sx1280pa.md @@ -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 diff --git a/docs/en/t_beam_1w/t_beam_1w_hw.md b/docs/en/t_beam_1w/t_beam_1w_hw.md index 51a0fcf..f4a6f16 100644 --- a/docs/en/t_beam_1w/t_beam_1w_hw.md +++ b/docs/en/t_beam_1w/t_beam_1w_hw.md @@ -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 diff --git a/docs/en/t3_s3_lr1121/images/T3-S3-QWIIC.png b/docs/static/T3S3-QWIIC-V1.2.png similarity index 100% rename from docs/en/t3_s3_lr1121/images/T3-S3-QWIIC.png rename to docs/static/T3S3-QWIIC-V1.2.png diff --git a/docs/en/t3_s3_lr1121/images/T3S3-V13-QWIIC.png b/docs/static/T3S3-QWIIC-V1.3.png similarity index 100% rename from docs/en/t3_s3_lr1121/images/T3S3-V13-QWIIC.png rename to docs/static/T3S3-QWIIC-V1.3.png diff --git a/docs/en/t3_s3_lr1121/images/WIFI-IPEX.png b/docs/static/T3S3-WIFI-IPEX-V1.2.png similarity index 100% rename from docs/en/t3_s3_lr1121/images/WIFI-IPEX.png rename to docs/static/T3S3-WIFI-IPEX-V1.2.png diff --git a/docs/static/T3S3-WIFI-IPEX-V1.3.png b/docs/static/T3S3-WIFI-IPEX-V1.3.png new file mode 100644 index 0000000..c36a640 Binary files /dev/null and b/docs/static/T3S3-WIFI-IPEX-V1.3.png differ