|
| 1 | +# LILYGO T-TWR Plus |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | +The T-TWR Plus v2.0 is a digital radio, designed and produced by LILYGO, following suggestions from the OpenRTX team. |
| 6 | +This device is based on an ESP32S3 microcontroller, paired with an SA868S baseband. To enable M17 and other digital |
| 7 | +protocols, the SA868S module has to be flashed with [sa8x8-fw](https://github.com/OpenRTX/sa8x8-fw), a Free Software firmware that gives |
| 8 | +OpenRTX full control over the underlying AT1846s radio-on-a-chip. |
| 9 | + |
| 10 | +## Hardware Revisions |
| 11 | + |
| 12 | +### Version 2.0 |
| 13 | + |
| 14 | +This version is compatible with OpenRTX, however does not feature connections between the speaker and the MCU, as well as between |
| 15 | +the microphone and the MCU, therefore it cannot operate digital voice protocols such as M17 voice without an external peripheral. |
| 16 | + |
| 17 | +Furthermore this version requires an external programmer to flash the SA868S baseband, the programmer can be built from a [cheap UART dongle](https://a.aliexpress.com/_EwDJlmT), two [1N5817 Schottky diodes](https://a.aliexpress.com/_EIiUAzH), and an [SH1.0 Header](https://www.amazon.it/dp/B01N6S8S21?ref_=cm_sw_r_apin_dp_0KZW8ZN1A1DGZ78AFKYZ). Instructions to build the programmer can be found on [sa8x8-fw GitHub repo](https://github.com/OpenRTX/sa8x8-fw). |
| 18 | + |
| 19 | +### Version 2.1 |
| 20 | + |
| 21 | +This version is not released yet and should come with a few improvements: |
| 22 | + |
| 23 | +- The baseband can be programmed from ESP32, not requiring users to build their own programming dongle |
| 24 | +- Paths from ESP32 to speaker and mic have been implemented, allowing an unmodified device to operate M17 Voice communications |
| 25 | + |
| 26 | +## Device models |
| 27 | + |
| 28 | +- VHF (134-174MHz) |
| 29 | +- UHF (400-480MHz) |
| 30 | +- VHF OpenEdition (134-174MHz) |
| 31 | +- UHF OpenEdition (400-480MHz) |
| 32 | + |
| 33 | +OpenEdition devices come with an unprogrammed SA868S, even though you can also reprogram non-OpenEdition modules, these SKU can show the manufacturer the size of the community interest towards this device. |
| 34 | + |
| 35 | +## Specifications |
| 36 | + |
| 37 | +* MCU: ESP32-S3-WROOM-1-N16R8 |
| 38 | +* Baseband: SA868S |
| 39 | +* Display: 128x64 B/W OLED (SH1106) |
| 40 | +* GPS: L76K GNSS |
| 41 | +* RGB LED: WS2812C |
| 42 | + |
| 43 | +## Flashing |
| 44 | + |
| 45 | +OpenRTX distributes releases for the T-TWR target in [UF2 format](https://github.com/microsoft/uf2). |
| 46 | +If your device does not come with a uf2 compatible bootloader, put your radio into espressif bootloader mode (powering up while holding BOOT key), |
| 47 | +connect it to your pc, and install [tinyuf2](https://github.com/adafruit/tinyuf2) with the following commands: |
| 48 | + |
| 49 | +``` |
| 50 | +mkdir tinyuf2; cd tinyuf2 |
| 51 | +wget https://github.com/adafruit/tinyuf2/releases/download/0.16.0/tinyuf2-lilygo_ttgo_t_twr_plus-0.16.0.zip |
| 52 | +unzip tinyuf2-lilygo_ttgo_t_twr_plus-0.16.0.zip |
| 53 | +esptool.py --chip auto write_flash 0x0 combined.bin |
| 54 | +``` |
| 55 | + |
| 56 | +If you power cycle your radio you should see a screen similar to this: |
| 57 | + |
| 58 | + |
| 59 | + |
| 60 | +If you connect your radio to a computer (Linux, Windows or macOS), you should see it appear as a USB block device. Drag the `openrtx_ttwrplus.uf2` file onto the device to flash the radio. Power off the radio by holding PWR (Volume +) button for 10 seconds and press the PWR button again to boot OpenRTX. |
| 61 | +Once the radio has been flashed at least once you can access again the tinyuf2 bootloader by pressing the BOOT (Volume -) button **right after** powering up the radio. |
| 62 | + |
| 63 | +## References |
| 64 | + |
| 65 | +- [T-TWR Plus Schematics](https://github.com/Xinyuan-LilyGO/T-TWR/blob/master/schematic/T-TWR-Plus_Rev2.0.pdf) |
0 commit comments