meshtastic/docs/hardware/devices/lilygo/lora/index.mdx
rcarteraz fcc74c59ce
Restructure Hardware Pages (#1404)
* hide the mess! (#3)

* initial changes to folder structure

* redirect tests

* fix links

* fix links and redirects

* fix link and remove redirects for now

* fixing more broken links

* updates

* more broken links

* trunk fmt

* really forked something up

* another broken link

* really forked something up

* fixing links again

* LINKS FINALLY FIXED, added missing seeed devices

* stupid vs code

* I really hate vs code

* honestly, I despise vs code

* I want to kick vs code

* All this extra work for what

* spacing

* I really want to curse vs code

* spacing

* spacing

* Renamed folder

* had to go nuclear to fix

* trunk fmt

* add heltec vision master series

* fixing links

* test redirect

* need to rename heltec folder to allow for redirects

* needed to change raspberry-pi to raspberrypi

* oops fix links

* add chatter to index

* redirects -- I think this is comprehensive

* pesky comma

* no

* remove images

* smaller images

* indents and white spaces

* remove weird {" "}

* remove large photo

* add smaller image, use image that wasn't being used
2024-09-02 12:42:29 -07:00

288 lines
7.6 KiB
Plaintext

---
id: lora
title: LILYGO® TTGO Lora Devices
sidebar_label: LoRa32
sidebar_position: 1
---
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
To flash ESP32-S3 devices like the T3S3, you typically need to place them in Espressif's firmware download mode. Use the "1200bps reset" button in the web flasher to do this. If this method does not work for any reason, you can follow the manual process below.
:::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>