meshtastic/docs/hardware/devices/lora/index.mdx
2024-03-24 15:35:09 -07:00

285 lines
7.3 KiB
Plaintext

---
id: lora
title: LILYGO® TTGO Lora Devices
sidebar_label: LILYGO® Lora
sidebar_position: 4
---
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
Further information on the LILYGO® LoRa devices can be found on LILYGO®'s [GitHub page](https://github.com/Xinyuan-LilyGO/LilyGo-LoRa-Series).
<Tabs
groupId="t-lora"
queryString="t-lora"
defaultValue="v1"
values={[
{label: 'Lora V1', value: 'v1'},
{label: 'Lora V1.3', value: 'v1.3'},
{label: 'Lora V2.0', value: 'v2.0'},
{label: 'Lora V2.1-1.6', value:'v2.1'},
{label: 'Lora V2.1-1.8', value:'v2.1-1.8'},
{label: 'Lora T3S3-V1.0', value:'S3-v1'}
]}>
<TabItem value="v1">
## Lora v1
:::warning
Not recommended with a battery! These boards contain the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
:::
:::caution
This board is still in production but for various reasons not recommended for new purchases or for unattended installations. Firmware support is phased out. If in doubt, choose the Lora V2.1-1.6 or Lora T3S3 board.
:::
- **MCU**
- ESP32 (WiFi & Bluetooth)
- **LoRa Transceiver**
- Semtech SX1276
- **Frequency options**
- 915 MHz
- 868 MHz
- **Connectors**
- Micro USB
- Antenna: U.FL antenna connector
### Features
- Built in 0.96 inch OLED display
### Resources
- Firmware file: `firmware-tlora-v1-X.X.X.xxxxxxx.bin`
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-ttgo-lora32-v1-0-wireless-module-esp32-lora-915mhz-oled-0-96-inch-display-wifi-bluetooth-esp-32-antenna-ch9102-q184?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/32996759721.html)
![LILYGO® TTGO Lora V1](/img/hardware/lora-v1.webp)
</TabItem>
<TabItem value="v1.3">
## Lora v1.3
:::warning
Not recommended with a battery! These boards contain the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
:::
:::caution
This board is still in production but for various reasons not recommended for new purchases or for unattended installations. Firmware support is phased out. If in doubt, choose the Lora V2.1-1.6 or Lora T3S3 board.
:::
- **MCU**
- ESP32 (WiFi & Bluetooth)
- **LoRa Transceiver**
- Semtech SX127x
- **Frequency options**
- 915 MHz
- 868 MHz
- **Connectors**
- Micro USB
- Antenna: U.FL antenna connector
### Features
- Built in 0.96 inch OLED display
### Resources
- Firmware file: `firmware-tlora_v1_3-X.X.X.xxxxxxx.bin`
- Purchase Links:
- International
- [AliExpress](https://www.aliexpress.com/item/4000628100802.html)
![LILYGO® TTGO Lora V1.3](/img/hardware/lora-v1.3.webp)
![LILYGO® TTGO Lora V1.3 pin map](/img/hardware/lora-v1.3_pinmap.webp)
</TabItem>
<TabItem value="v2.0">
## Lora V2.0
:::warning
Not recommended with a battery! These boards contain the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged.
:::
:::caution
This board is still in production but for various reasons not recommended for new purchases or for unattended installations. Firmware support is phased out. If in doubt, choose the Lora V2.1-1.6 or Lora T3S3 board.
:::
- **MCU**
- ESP32 (WiFi & Bluetooth)
- **LoRa Transceiver**
- Semtech SX127x
- **Frequency options**
- 433 MHz
- 868 MHz
- 915 MHz
- **Connectors**
- Micro USB
- Antenna: U.FL antenna connector
### Features
- Built in 0.96 inch OLED display
- Power and Reset switches
- microSD connector
- No GPS
### Resources
- Firmware file: `firmware-tlora-v2-X.X.X.xxxxxxx.bin`
- Purchase Links:
- International
- [AliExpress](https://www.aliexpress.com/item/32846302183.html)
![LILYGO® TTGO Lora V2](/img/hardware/lora-v2.0.webp)
</TabItem>
<TabItem value="v2.1">
## Lora v2.1-1.6
:::caution
Early versions of these boards contained the wrong component in the LiPo battery charging circuit allowing the battery to be overcharged. Boards purchased after 2021, unless the version is T3_v1.6 20180606, should not have this issue.
:::
- **MCU**
- ESP32 (WiFi & Bluetooth)
- **LoRa Transceiver**
- Semtech SX127x
- **Frequency options**
- 433 MHz
- 868 MHz
- 915 MHz
- **Connectors**
- Micro USB
- Antenna: SMA antenna connector
### Variations of identifying marks
- FCC ID: 2ASYE-T3-V1-6-1
- "T3_v1.6.1 20210104" on the board
- "T3_v1.6 20180606" on the board
- "Model T3 V1.6.1" on the FCC sticker
### Features
- Built in 0.96 inch OLED display
- Power and Reset switches
- microSD connector
- No GPS
### Resources
- Firmware file: `firmware-tlora-v2-1-1.6-X.X.X.xxxxxxx.bin`
- Purchase Links:
- US
- [Rokland](https://store.rokland.com/products/lilygo-ttgo-lora32-v2-1_1-6-version-915mhz-esp32-lora-oled-0-96-inch-sd-card-bluetooth-wifi-wireless-module-esp-32-sma-q211?ref=8Bb2mUO5i-jKwt)
- International
- [AliExpress](https://www.aliexpress.com/item/32915894264.html)
- [Lilygo](https://www.lilygo.cc/products/lora3)
![TTGO Lora V2.1-1.6](/img/hardware/lora-v2.1-1.6.webp)
</TabItem>
<TabItem value="v2.1-1.8">
## Lora v2.1-1.8
- **MCU**
- ESP32 (WiFi & Bluetooth)
- **LoRa Transceiver**
- Semtech SX1280 (Region LORA_24 worldwide use)
- **Frequency options**
- 2.4 GHz
- **Connectors**
- USB-C
- Antenna: SMA antenna connector
### Features
- Built in 0.96 inch OLED display
- Power and Reset switches
- microSD connector
- No GPS
### Resources
- Firmware file: `firmware-tlora-v2-1-1.8-X.X.X.xxxxxxx.bin`
![TTGO Lora V2.1-1.8](/img/hardware/lora-v2.1-1.8.webp)
</TabItem>
<TabItem value="S3-v1">
## Lora T3S3 v1.0
- **MCU**
- ESP32-S3 (WiFi & Bluetooth)
- **LoRa Transceiver**
- Semtech SX1262
- Semtech 1276
- Semtech SX1280 with PA (Region LORA_24 worldwide use)
- **Frequency options**
- 868 MHz
- 915 MHz
- 2.4 GHz
- **Connectors**
- USB-C
- Antenna: SMA antenna connector
### Features
- Built in 0.96 inch OLED display
- Power and Reset switches, Boot / User Button
- microSD connector
- No GPS
### Flashing the T3S3
:::warning
Do not proceed unless an antenna is connected to avoid possible damage to the device's radio.
:::
The following process will manually place the device into the Espressif Firmware Download mode:
1. Switch off the device.
2. Connect the USB-C data cable to the device. A blue LED will illuminate while display stays black.
3. Press and hold the BOOT button to the right of the display.
4. Switch the device on.
5. After 2-3 seconds, release the BOOT button.
With the device now in the Espressif Firmware Download mode, you can proceed with flashing using one of the supported flashing methods. It's generally recommended to use the [Web Flasher](https://flasher.meshtastic.org/). You can select "Tlora T3s3 V1" from the device drop-down.
:::note
If after successfully flashing the device and the screen remains black, you may need to use the [CLI Script](https://meshtastic.org/docs/getting-started/flashing-firmware/esp32/cli-script) to flash Meshtastic.
:::
### Resources
- Firmware file: `firmware-tlora-t3s3-v1.xxxxxxx.bin`
- Purchase Links:
- US
- [Amazon](https://www.amazon.com/LILYGO-ESP32-S3-Development-Wireless-Display/dp/B0BW5W9QXZ)
- International
- [AliExpress](https://www.aliexpress.com/item/1005004627139838.html)
- [Lilygo](https://www.lilygo.cc/products/t3s3-v1-0)
- [Tindie](https://www.tindie.com/products/lilygo/lilygo-t3-s3-v10-esp32-s3-lora-sx1280-24g/)
![TTGO Lora T3S3 V1](/img/hardware/lora-t3s3.webp)
</TabItem>
</Tabs>