Xinyuan-LilyGO/TTGO_TWatch_Library

C

1,076

232 commits

updated Jan 8, 2026

See the code

README

🌟LilyGO T-Watch🌟

English | δΈ­ζ–‡

⭐ News

  1. T-Watch-S3 version is here
  2. In order to be compatible with multiple versions of T-Watch, all examples include a config.h file. For the first use, you need to define the T-Watch model you use in the config.h file
  3. In the config.h file, you can also see similar definitions, such as LILYGO_WATCH_LVGL, LILYGO_WATCH_HAS_MOTOR, this type of definition, it will be responsible for opening the defined module function, all definitions Will be available here View
  4. Most of the examples are only used as hardware function demonstrations. This library only completes some initialization work and some demonstrations. For more advanced gameplay, please see TTGO.h, to understand how to initialize, after being familiar with it, you can completely leave this library for more advanced gameplay

sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch

  • Demonstration effect of T-Watch2020-V3 from lunokjod

lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch

πŸš€ Characteristics

  1. The library already contains all the hardware drivers for T-Watch
  2. Using TFT_eSPI as the display driver, you can directly call TFT_eSPI through the construction object.
  3. Using lvgl v7.7.2 as the display graphics framework, the driver method has been implemented, you only need to call lvgl api according to your own needs.
  4. For the use of lvgl please refer to lvgl docs

πŸ”· Install

  • Install the Arduino IDE. Note: Later instructions may not work if you use Arduino via Flatpak.
  • Download a zipfile from github using the "Download ZIP" button and install it using the IDE ("Sketch" -> "Include Library" -> "Add .ZIP Library...", OR:
  • Clone this git repository into your sketchbook/libraries folder. For more info, see https://www.arduino.cc/en/Guide/Libraries

πŸ”· Note

πŸ”· FAQ

  • The following code is reported as an error when uploading. Please change the default upload baud rate in ArduinoIDE from '20000' to '921600'.
    A fatal error occurred: Failed to write to target RAM(result was 01070000)
    
  • This error may also occur on MacOS if using a poorly compatible USB to serial driver. The driver at wch.cn is a better match. The webpage is in Chinese but the driver is digitally signed for security.

πŸ”Ά How to find the sample program

  • T-Watch & LilyPi
  • In the Arduino board select TTGO T-Watch
  • In the Arduino File -> Examples -> TTGO_TWatch_Library

πŸ”Ά Precautions

  • T-Watch-2019 & LilyPi: Since uses a special IO as the SD interface, please remove the SD card when downloading the program.

πŸ”· Resources

🚩 Version comparison

ProductT-Watch-2019T-Watch-2020-V1T-Watch-2020-V2T-Watch-2020-V3T-Block/T-Block-V1LilyPi
Core ESP32-D0WDQ6ESP32-D0WDQ6ESP32-D0WDQ6ESP32-D0WDQ6ESP32-D0WDQ6ESP32-WROVER-B
PSRAM 16MBytes16MBytes16MBytes16MBytes16MBytes16MBytes
Flash 8MBytes8MBytes4MBytes8MBytes8MBytes8MBytes
PMU AXP202AXP202AXP202AXP202AXP202❌
IMU BMA423BMA423BMA423BMA423MPU6050❌
TFT 1.54"/240X240/ST7789V1.54"/240X240/ST7789V1.54"/240X240/ST7789V1.54"/240X240/ST7789V[1][1]
TouchScreen FT6336FT6336FT6336FT6336[1][1]
Real Time Clock PCF8563PCF8563PCF8563PCF8563PCF8563PCF8563
Infrared sensor βŒβœ…βœ…βœ…βŒβŒ
Scalable βœ…βŒβœ…βŒβœ…βœ…
Microphone [1]❌❌SPM1423HM4H[1]❌
GPS [1]❌ Quectel L76K❌[1]❌
Decoder [1]MAX98357A❌MAX98357A[1]❌
Tactile [1]βœ…(IO Control)DRV2605(I2C Control)βœ…(IO Control)[1]❌
Buttonβœ…βœ…[2]βœ…[2]βœ…[2]βœ…[2]βœ…
  • [1]:Need expansion board to support
  • [2]:The buttons are AXP202 PEK programmable buttons

πŸ”Ά More interesting projects

arduino
esp32
lilygo
ttgo
twatch

Xinyuan-LilyGO/TTGO_TWatch_Library

C

1,076

232 commits

updated Jan 8, 2026

See the code

README

🌟LilyGO T-Watch🌟

English | δΈ­ζ–‡

⭐ News

  1. T-Watch-S3 version is here
  2. In order to be compatible with multiple versions of T-Watch, all examples include a config.h file. For the first use, you need to define the T-Watch model you use in the config.h file
  3. In the config.h file, you can also see similar definitions, such as LILYGO_WATCH_LVGL, LILYGO_WATCH_HAS_MOTOR, this type of definition, it will be responsible for opening the defined module function, all definitions Will be available here View
  4. Most of the examples are only used as hardware function demonstrations. This library only completes some initialization work and some demonstrations. For more advanced gameplay, please see TTGO.h, to understand how to initialize, after being familiar with it, you can completely leave this library for more advanced gameplay

sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch sharandac/My-TTGO-Watch

  • Demonstration effect of T-Watch2020-V3 from lunokjod

lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch lunokjod/watch

πŸš€ Characteristics

  1. The library already contains all the hardware drivers for T-Watch
  2. Using TFT_eSPI as the display driver, you can directly call TFT_eSPI through the construction object.
  3. Using lvgl v7.7.2 as the display graphics framework, the driver method has been implemented, you only need to call lvgl api according to your own needs.
  4. For the use of lvgl please refer to lvgl docs

πŸ”· Install

  • Install the Arduino IDE. Note: Later instructions may not work if you use Arduino via Flatpak.
  • Download a zipfile from github using the "Download ZIP" button and install it using the IDE ("Sketch" -> "Include Library" -> "Add .ZIP Library...", OR:
  • Clone this git repository into your sketchbook/libraries folder. For more info, see https://www.arduino.cc/en/Guide/Libraries

πŸ”· Note

πŸ”· FAQ

  • The following code is reported as an error when uploading. Please change the default upload baud rate in ArduinoIDE from '20000' to '921600'.
    A fatal error occurred: Failed to write to target RAM(result was 01070000)
    
  • This error may also occur on MacOS if using a poorly compatible USB to serial driver. The driver at wch.cn is a better match. The webpage is in Chinese but the driver is digitally signed for security.

πŸ”Ά How to find the sample program

  • T-Watch & LilyPi
  • In the Arduino board select TTGO T-Watch
  • In the Arduino File -> Examples -> TTGO_TWatch_Library

πŸ”Ά Precautions

  • T-Watch-2019 & LilyPi: Since uses a special IO as the SD interface, please remove the SD card when downloading the program.

πŸ”· Resources

🚩 Version comparison

ProductT-Watch-2019T-Watch-2020-V1T-Watch-2020-V2T-Watch-2020-V3T-Block/T-Block-V1LilyPi
Core ESP32-D0WDQ6ESP32-D0WDQ6ESP32-D0WDQ6ESP32-D0WDQ6ESP32-D0WDQ6ESP32-WROVER-B
PSRAM 16MBytes16MBytes16MBytes16MBytes16MBytes16MBytes
Flash 8MBytes8MBytes4MBytes8MBytes8MBytes8MBytes
PMU AXP202AXP202AXP202AXP202AXP202❌
IMU BMA423BMA423BMA423BMA423MPU6050❌
TFT 1.54"/240X240/ST7789V1.54"/240X240/ST7789V1.54"/240X240/ST7789V1.54"/240X240/ST7789V[1][1]
TouchScreen FT6336FT6336FT6336FT6336[1][1]
Real Time Clock PCF8563PCF8563PCF8563PCF8563PCF8563PCF8563
Infrared sensor βŒβœ…βœ…βœ…βŒβŒ
Scalable βœ…βŒβœ…βŒβœ…βœ…
Microphone [1]❌❌SPM1423HM4H[1]❌
GPS [1]❌ Quectel L76K❌[1]❌
Decoder [1]MAX98357A❌MAX98357A[1]❌
Tactile [1]βœ…(IO Control)DRV2605(I2C Control)βœ…(IO Control)[1]❌
Buttonβœ…βœ…[2]βœ…[2]βœ…[2]βœ…[2]βœ…
  • [1]:Need expansion board to support
  • [2]:The buttons are AXP202 PEK programmable buttons

πŸ”Ά More interesting projects

arduino
esp32
lilygo
ttgo
twatch

Project health

Overall

2.5/10

Maintained

0/10

Code review

1/10
OpenSSF Scorecard

Significant stargazers

JosΓ© Luis Cruz

81 followers Β· starred Aug 2023

Daria Sukhonina

36 followers Β· starred Jan 2025

Anthony Van de Gejuchte

49 followers Β· starred Aug 2024

Winford

25 followers Β· starred Oct 2024