Implement support for light-/deep-sleep

[jessebraham]

We should provide APIs for entering light-/deep-sleep.

Chips which have been prioritized by the maintainers have associated tracking issues linked beside them. Community members are encouraged to attempt adding support for other chips as well.

• ESP32
• ESP32-C2
• ESP32-C3
• ESP32-C6 Light-/deep-sleep support for ESP32-C6 #1028
• ESP32-H2 Light-/deep-sleep support for ESP32-H2 #1029
• ESP32-S2
• ESP32-S3

[bjoernQ]

For inspiration

• https://github.com/bjoernQ/esp32c3-sleep-experiment
• https://matrix.to/#/!LdaNPfUfvefOLewEIM:matrix.org/$MGQY24t_Zo-eufQ6vFjUX99MLHOb7W41f9F44BwBHX8?via=matrix.org&via=tchncs.de&via=mozilla.org

[jessebraham]

Support for light-/deep-sleep for ESP32 added in #574. I will begin work on supporting additional chips in the coming weeks.

[bugadani]

I'd like to add as a todo item that the HAL should probably not expose the RtcSleepConfig type(s) directly. Instead, the HAL should expose something akin to esp-idf's "sleep flags". The reason is, that currently it is possible to create subtly broken sleep configurations: the user is free to set whatever combination they want, and the driver has no way of verifying the sleep configuration. Wakeup sources may also need to take care of setting up correct values, which should be easier handled when applying sleep flags.

[Ben-PH]

I'd like to contribute to this. Have an important use-case for C3, and a nice-to-have use case with S3 for light-sleep.

I have no idea how to go about doing this. I'll read through the links, but embedded and EE stuff is a bit crazy to me.

This will be my first time contributing to this project, and couldn't find a contributing file/instruction documentation. How should I go about contributing? fork-draft PR-iterate?

@jessebraham should we coordinate on this one?

[Ben-PH]

I've made #712

at this point, it's just a note-taking exercise, but if all goes well, will shortly start implementing the different sleeps for c3.

[jessebraham]

ESP32-C3 support added in #795

[bugadani]

I'm working on C6 now. It's a bit annoying as function names are different, but the flow seems to be similar enough. May take some time but I'll hope to get it working in a week or two.