English | 中文

• Currently T-Watch-Lib is only compatible with T-Watch S3 version, esp32 version is planned to support

1. Install Visual Studio Code and Python
2. Search for the PlatformIO plugin in the VisualStudioCode extension and install it.
3. After the installation is complete, you need to restart VisualStudioCode
4. After restarting VisualStudioCode, select File in the upper left corner of VisualStudioCode -> Open Folder -> select the TTGO_TWatch_Library directory
5. Wait for the installation of third-party dependent libraries to complete
6. Click on the platformio.ini file, and in the platformio column, cancel the sample line that needs to be used, please make sure that only one line is valid
7. Click the (✔) symbol in the lower left corner to compile
8. Connect the board to the computer USB
9. Click (→) to upload firmware
10. Click (plug symbol) to monitor serial output

1. Install Arduino IDE
2. Install Arduino ESP32 2.0.9 ,Tools -> Board -> Boards Manager
   • Please use 2.0.9. The new version has changed too much and has not yet been adapted.
3. Install TTGO_TWatch_Library
   1. Download a zipfile from github using the "Download ZIP" button and install it using the IDE ("Sketch" -> "Include Library" -> "Add .ZIP Library...")
   2. Clone this git repository into your sketchbook/libraries folder. For more info, see https://www.arduino.cc/en/Guide/Libraries
4. Install T-Watch-Deps
   • Copy all directories in T-Watch-Deps to <C:\Users\UserName\Documents\Arduino\libraries> , if there is no libraries directory, please create it.
   • Please note that instead of copying the T-Watch-Deps directory, copy the folders in the T-Watch-Deps directory to
   • Please note that currently only <TFT_eSPI> has been preconfigured , after upgrading <TFT_eSPI>, you need to re-move <extras/Setup212_LilyGo_T_Watch_S3.h> to <TFT_eSPI/User_Setups> directory, and in TFT_eSPI/User_Setup_Select.h add #include <User_Setups/Setup212_LilyGo_T_Watch_S3.h>
5. Open ArduinoIDE -> Tools
   • Board -> ESP32S3 Dev Module
   • USB CDC On Boot -> Enable ## Note that you need to change Enable to Disable when USB is not connected, so USB CDC will not prevent the board from starting
   • CPU Frequency -> 240MHz
   • USB DFU On Boot -> Disable
   • Flash Mode -> QIO 80MHz
   • Flash Size -> 16MB(128Mb)
   • USB Firmware MSC On Boot -> Disable
   • PSRAM -> OPI PSRAM
   • Partition Scheme -> 16M Flash(3MB APP/9.9MB FATFS)
   • USB Mode -> Hardware CDC and JIAG
   • Upload Mode -> UART0/Hardware CDC
   • Upload Speed -> 921600
6. Insert USB into the PC and click Upload <If the upload fails, View the FAQ below>

• display directory examples are all from TFT_eSPI internal examples
• lvgl directory examples are all from lvgl internal examples
• radio directory examples are all from RadioLib internal examples
• peripheral directory examples are all from XPowersLib & SensorsLib internal examples

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

1. Unable to upload to watch
   1. Make sure that the T-Watch is turned on, you can check it according to the following method, open the computer device manager, check the port, plug the USB port into the computer, and if the new COM device is displayed, it has been turned on, if it is not displayed, press the crown Press the button on the button for one second, and then the device port will pop up, click upload at this time
2. The USB port keeps flashing in the computer

• This is a phenomenon caused by the abnormal operation of the program, or the selection of the wrong configuration, and the continuous restart of the esp32. At this time, the problem of not being able to upload can only be solved by manually entering the download mode of the watch Please follow the steps below
  1. Remove the back cover
  2. Insert Micro-USB
  3. Open Windows Device Manager
  4. Press and hold the crown of the watch until the USB device does not appear in the Windows COM port
  5. Press the button in the picture below and keep pressing
  6. Press the crown button for one second
  7. Now the COM port is fixed
  8. Select Port in Arduino IDE
  9. Click Upload

3. Where to query the pin definition?

   1. Look here

4. The screen is not displayed after uploading the sketch?

   1. Please check the fourth line of Arduino IDE Quick Start

5. Power Domain

   Power Domain	Role
   ALDO1	RTC backup battery (3.1-3.3v)
   ALDO2	Backlight
   ALDO3	3V3 for FT6336 and st7889
   ALDO4	SX1262
   BLDO2	DRV2605 Enable pin
   DC1	ESP32 3V3
   VRTC	Nothing

6. Battery

   1. Lilygo T-Watch fits 502530 size (5x25x30mm) batteries of any chemistry supported by the AXP2101.

7. esp_vad.h: No such file or directory

   • Please use 2.0.9. The new version has changed too much and has not yet been adapted.