Skip to content

Commit 287354d

Browse files
committed
Add T-TWR Plus Hardware description page
Add hardware description page with instructions on how to flash tinyuf2 to the radio.
1 parent 90905b4 commit 287354d

File tree

3 files changed

+66
-0
lines changed

3 files changed

+66
-0
lines changed

_media/tinyuf2_ttwrplus.jpg

230 KB
Loading

hardware/hardware.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,3 +23,4 @@ This table provides a glance on the underlying hardware of each of the supported
2323
* [Yaesu FT2D](hardware/ft2d.md)
2424
* [Ailunce HD1](hardware/hd1.md)
2525
* [Anytone UV878](hardware/uv878.md)
26+
* [LILYGO T-TWR Plus](hardware/ttwrplus.md)

hardware/ttwrplus.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# LILYGO T-TWR Plus
2+
3+
![T-TWR Plus](../_media/ttwrplus.jpg)
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+
![T-TWR Plus tinyuf2 screen](../_media/tinyuf2_ttwrplus.jpg)
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

Comments
 (0)