🌟LilyGO T-Wristband and T-Glass🌟

News

T-Wristband and T-Glass have the same hardware, but the viewing area is different due to the casing.
LilyGO T-Wristband and T-Glass depends on lvgl v8.4.x version. Currently lvgl has released lvgl v9.0 version. When compilation error occurs, please check whether lvgl belongs to v8.4.x
The visual size of T-Wristband and T-Glass is different from the actual screen size. All examples are based on the lvgl graphics framework. Other image frameworks such as TFT_eSPI are not available here.

1️⃣Support Product

Product(PinMap)	SOC	Flash	PSRAM	Resolution	Visible Area
T-Glass	ESP32-S3 FN4R2	4MB	2MB(QSPI)	294x126	126x126
T-Wristband	ESP32-S3 FN4R2	4MB	2MB(QSPI)	294x126	126x250

Current consumption	Working current	sleep current	sleep mode
T-Glass	(240MHz) WiFi On 90~230+ mA	about 300uA	touch button wakeup
T-Wristband	(240MHz) WiFi On 90~230+ mA	about 300uA	touch button wakeup

2️⃣Examples

examples/
├── Glass
│   ├── Glass6DoF
│   ├── GlassBatteryVoltage
│   ├── GlassDeepSleep
│   ├── GlassFactory
│   ├── GlassHelloWorld
│   ├── GlassRtcAlarm
│   ├── GlassRtcDateTime
│   ├── GlassTouchButton
│   ├── GlassTouchButtonEvent
│   └── GlassVoiceActivityDetection
└── Wristband
    ├── Wristband6DoF
    ├── WristbandBatteryVoltage
    ├── WristbandDeepSleep
    ├── WristbandDisplayRotation
    ├── WristbandDisplayVisualWindow1
    ├── WristbandFactory
    ├── WristbandHelloWorld
    ├── WristbandLightSleep
    ├── WristbandRtcAlarm
    ├── WristbandRtcDateTime
    ├── WristbandTouchButton
    └── WristbandTouchButtonEvent

3️⃣ PlatformIO Quick Start (Recommended)

Install Visual Studio Code and Python
Search for the PlatformIO plugin in the VisualStudioCode extension and install it.
After the installation is complete, you need to restart VisualStudioCode
After restarting VisualStudioCode, select File in the upper left corner of VisualStudioCode -> Open Folder -> select the LilyGO T-Wristband and T-Glass directory
Wait for the installation of third-party dependent libraries to complete
Click on the platformio.ini file, and in the platformio column
Uncomment one of the lines src_dir = xxxx to make sure only one line works
Click the (✔) symbol in the lower left corner to compile
Connect the board to the computer USB
Click (→) to upload firmware
Click (plug symbol) to monitor serial output
If it cannot be written, or the USB device keeps flashing, please check the FAQ below

4️⃣ Install from Arduino Library Manager (recommended)

Install Arduino IDE
Install Arduino ESP32 V 2.0.5 or above and below V3.0, Library based on the Stable version, Please make sure the link in Boards Manager is
```
https://espressif.github.io/arduino-esp32/package_esp32_index.json
```
Sketch -> Include Library -> Manage Libraries
Library Search -> LilyGO T-Wristband and T-Glass -> Install -> Install ALL
Library Search -> lvgl -> v8.4.0 -> Install
Library Search -> SensorLib -> v0.1.8 -> Install
File -> Examples -> LilyGO T-Wristband and T-Glass -> Select the corresponding example

Tools -> , Make your selection according to the table below

Arduino IDE Setting	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
Events Run On	Core1
Flash Mode	QIO 80MHZ
Flash Size	4MB(32Mb)
Arduino Runs On	Core1
USB Firmware MSC On Boot	Disable
Partition Scheme	Default 4M with spiffs(1.2M APP/1.5MB SPIFFS)
PSRAM	QSPI PSRAM
Upload Mode	UART0/Hardware CDC
Upload Speed	921600
USB Mode	CDC and JTAG

The options in bold are required, others are selected according to actual conditions.

Select Port
Click upload , Wait for compilation and writing to complete
If it cannot be written, or the USB device keeps flashing, please check the FAQ below

5️⃣ Arduino IDE Manual installation (not recommended)

Install Arduino IDE
Install Arduino ESP32 V 2.0.5 or above and below V3.0, Library based on the Stable version, Please make sure the link in Boards Manager is
```
https://espressif.github.io/arduino-esp32/package_esp32_index.json
```
Download LilyGO T-Wristband and T-Glass , move to Arduino library folder (e.g. C:\Users\YourName\Documents\Arduino\libraries)
Copy all folders in libdeps folder to Arduino library folder (e.g. C:\Users\YourName\Documents\Arduino\libraries)

Tools -> , Make your selection according to the table below

Arduino IDE Setting	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
Events Run On	Core1
Flash Mode	QIO 80MHZ
Flash Size	4MB(32Mb)
Arduino Runs On	Core1
USB Firmware MSC On Boot	Disable
Partition Scheme	Default 4M with spiffs(1.2M APP/1.5MB SPIFFS)
PSRAM	QSPI PSRAM
Upload Mode	UART0/Hardware CDC
Upload Speed	921600
USB Mode	CDC and JTAG

The options in bold are required, others are selected according to actual conditions.

File -> Examples -> LilyGO T-Wristband and T-Glass -> Select the corresponding example
Select Port
Click upload , Wait for compilation and writing to complete
If it cannot be written, or the USB device keeps flashing, please check the FAQ below

6️⃣ ESP32 basic examples

BLE Examples
WiFi Examples
SPIFFS Examples
FFat Examples
For more examples of esp32 chip functions, please refer to arduino-esp32-libraries

7️⃣ FAQ

The board uses USB as the JTAG upload port. When printing serial port information on USB_CDC_ON_BOOT configuration needs to be turned on. If the port cannot be found when uploading the program or the USB has been used for other functions, the port does not appear. Please enter the upload mode manually.
1. Connect the board via the USB cable
2. Press and hold the BOOT button , While still pressing the BOOT button, press RST button
3. Release the RST button
4. Release the BOOT button
5. Upload sketch
If the above is invalid, burn the binary file to check whether the hardware is normal
If you use external power supply instead of USB-C, please turn off the USB_CDC_ON_BOOT option. This is because the board will wait for USB access when it starts.
- For Arduino IDE users, it can be turned off in the options , Please note that turning off USB_CDC_ON_BOOT will turn off Serial redirection to USB-C. At this time, you will not see any Serial message output when opening the port from USB-C, but output from GPIO43 and GPIO44.
```
Tools -> USB CDC On Boot -> Disable
```
- For Platformio users, you can add the following compilation flags in the ini file
```
build_flags =
    ; Enable -DARDUINO_USB_CDC_ON_BOOT will start printing and wait for terminal access during startup
    ; -DARDUINO_USB_CDC_ON_BOOT=1

    ; Enable -UARDUINO_USB_CDC_ON_BOOT will turn off printing and will not block when using the battery
    -UARDUINO_USB_CDC_ON_BOOT
```

The JD9613 display RAM is only 1/2 the screen size and does not support rotation.Directions 0 and 1 can adjust the vertical direction, horizontal 1 and 3 are the same direction.

// Set the screen orientation to portrait , 0 and 2 are two opposite vertical directions
 amoled.setRotation(0);
 amoled.setRotation(2);

// Set the screen orientation to horizontal. 1 and 3 are all in the same direction and cannot be changed.
 amoled.setRotation(1);
 amoled.setRotation(3);

8️⃣ Resource

Product(PinMap)	schematic
T-Glass	schematic
T-Wristband	schematic

T-Glass & T-Wristband datasheet

8️⃣ Depends on required libraries

0015/LilyGO-T-Wristband-and-T-Glass