⌚️ T-Watch-S3 Zephyr Board Module

Caution

Under active development. Do not use for production/consumer devices.

Warning

By using this module, you accept all responsibility for any damage to property or person. In particular, battery management is not deeply validated. I highly recommend removing the battery from your device entirely.

Zephyr board support for the LilyGo T-Watch S3.

Current Status

The following features are currently supported and superficially tested using the test project:

• usb uart (hello_world.c)
• LCD display (display.c)
• display backlight (diplay.c)
• touch panel (touch.c)
• basic haptics (haptics.c)
• accelerometer (imu.c)
• PMIC power to haptics & LCD (power.c)

The following features are not yet supported/tested:

• battery management

Caution

Battery management has not been validated in depth. It is possible this may over-charge or over-discharge the battery. Catastrophic damage could occur. You accept responsibility for this by using this code.

• bluetooth
• wifi
• microphone

Note

(PDM support over I2S is supported in the esp32 hal, but not surfaced to Zephyr)

• speaker

Note

The MAX98357 driver will need to be implemented

• LoRa radio
• LoRaWAN support

Note

There is some work on enabling the LoRa Basics Modem. It may be worth waiting to do this.

• external button
• Infrared LED
• Realtime clock
• SPI Flash Storage

Getting Started

This is intended to be used as a Zephyr module.

Assuming you have west and a Zephyr toolchain installed, you can make use of the t-watch-s3 board by adding the following to a west.yml file in a new project:

manifest:
  remotes:
    - name: vvvvvvvvvv-llc
      url-base: https://github.com/vvvvvvvvvv-LLC
  
  projects:
    - name: t-watch-s3
      remote: vvvvvvvvvv-llc
      repo-path: t-watch-s3
      revision: main

Note

a very good project to set up your basic project structure is the zephyr example application.

Then run west update to fetch the latest version of the module.

An easy way to confirm you can build is to copy the test directory to your project and run west build -b t_watch_s3/esp32s3/procpu inside that directory.

Building

The module contains a test project used to lightly validate functionality as it is being developed. To build the project, navigate to the test directory and run west build -b t_watch_s3/esp32s3/procpu.

You can then flash the binary using west flash [--esp-device <serial port>] and monitor the output using west espressif monitor [--port <serial port>].

Contributing

This module is still actively under development.

If you would like to contribute, please do not hesitate to open a PR or an issue. A more comprehensive contribution guide will be added in the future.

You may find the schematic useful.