Xinyuan-LilyGO / TTGO_TWatch_Library

Hello,

I'm trying to write some minimal implementation of libraries for MicroPython in order to support the T-WATCH S3.
I have installed MicroPython and soon I'll port my SX1276 driver to SX1262, however in order to do this I need to be able to power the whole device, and I need help about it.

I understand that you provide a library for Arduino, however other than the library itself, the T-WATCH S3 is poorly documented, there is very little information about how the device works, how to set the PMU, and things like that.

This is a list of initial questions I have:

At startup what is the AXP2101 configuration? All the LoRa modem, the display, and all the other things already powered up?
The AXP2101 i2c bus seems to be connected to pins 10 and 11 of the ESP32. I downloaded the data sheet. Please can you tell what configuration I should set in the chip in order for the T-WATCH to work? Also, if I mess with the registers, is it possible to damage the T-WATCH with wrong voltages?

Thanks

For instance from the schematic it looks like that the display receives power from ALDO2 pin of the AXP2101. So I wonder if on power-on this pin is already setup to have the tension required or not.

I made some progress. After reading the datasheet of AXP2101 I could not talk with the device via i2c because in the device datasheet a wrong slave address for the device is specified. The address is 0x34 instead. Now I can read the PMU status registers and will likely discover all the things I asked here. Thanks. If I will fail I'll try to seek your help again. Thank you.

It will be still useful if you could advice about how to avoid damaging the board during testings. I'll try do in MicroPython the same setup you did in the power initialization function in C.

For the boot sequence and peripheral power channels, they are also explained here

TTGO_TWatch_Library/src/LilyGoLib.cpp

Line 350 in 10becb4

// ! ESP32S3 VDD, Don't change

If you are writing axp2101, then this may be helpful to you
https://github.com/lewisxhe/XPowersLib/tree/master/Micropython/src

Thank you @lewisxhe, I see you are the same person writing also the AXP drivers: they are cool drivers, but for the task of just making the T-WATCH to start I'm taking a simpler approach of directly addressing the few registers I need, like this (note, this is not the final code, I'm still experimenting, but the idea is to just write the few registers needed and that's it).

from machine import Pin, SoftI2C
i2c = SoftI2C(sda=Pin(10), scl=Pin(11))

if False:
    # Set above to True if you want to list all the address
    # of reachable devices. In the t-watch S3 they should
    # be 25, 52, 81, 90. Corresponding (in random order) to
    # the haptic motor, RTC clock, accelerometer and the
    # AXP2101.
    print("i2c devices: ",i2c.scan())

slave_addr = 0x34 # AXP2101 i2c slave address.

# Read PMU STATUS 1
b = i2c.readfrom_mem(slave_addr,0x00,1)
pmu_status = b[0]
print("PMU status 1 at startup", bin(pmu_status))

v = i2c.readfrom_mem(slave_addr,0x15,1)
print("[before] vbus voltage limit set to", 3.88+v[0]*0.08)
# Set vbus voltage limit to 4.36v
# Register 0x15 is Input voltage limit control.
# A value of 6 means 4.36v as volts = 3.88 + value * 0.08
# This should be the default.
data = bytearray(1)
data[0] = 6
i2c.writeto_mem(slave_addr,0x15,data)

v = i2c.readfrom_mem(slave_addr,0x15,1)
print("[after] vbus voltage limit set to", 3.88+v[0]*0.08)

When I wrote AXP2101, I just wrote the driver, not for T-Watch. Users can customize it freely.

@lewisxhe indeed, it makes completely sense. But in my case all I need is to power-up the device, talk with the LoRa chip with a driver I'm porting from another project, and display some text as LoRa packets are received. And I want it to be very simple to understand for newcomers. Anyway your drivers are a good reference: I appreciate your work.

Thank you for your understanding. Most of LilyGo's products are maintained by me personally. I can't do more. It would be better if your MicroPython completion can be shared with us. I will place it in README so that those who need Micropython can People see it and thank you for your work

Sure @lewisxhe, my goal is to support the T-watch S3 here: https://github.com/antirez/freakwan, so everything will be public, but I'll also create a stand-alone repository showing how to power-up the device and how to display something on the screen and so forth. The funny thing is that I'm primarily a C programmer, and yet the Arduino / ESP32 C IDE is so annoying and slow that I prefer to go with Python for this stuff.

Awesome, thank you for your excellent work. If you have any questions later, you can contact me and I will try my best to help you.

@lewisxhe got some initial thing working: https://github.com/antirez/t-watch-s3-micropython

Not much, but the AXP2101 is configured properly (now it charges the battery and all), and the display works with the provided library. Next stop is likely implementing the sx126x driver for LoRa.

Okay, I will continue to pay attention

T-WATCH S3 - AXP2101 Init sequence