Skip to content

Update documentation with info about light sleep#2088

Merged
bettio merged 1 commit intoatomvm:mainfrom
bettio:doc-update-esp32-sleep
Feb 8, 2026
Merged

Update documentation with info about light sleep#2088
bettio merged 1 commit intoatomvm:mainfrom
bettio:doc-update-esp32-sleep

Conversation

@bettio
Copy link
Collaborator

@bettio bettio commented Feb 5, 2026

After #1789 (and the subsequent forward port from release-0.6), light sleep has been introduced in main.
Update newer documentation accordingly.

These changes are made under both the "Apache 2.0" and the "GNU Lesser General
Public License 2.1 or later" license terms (dual license).

SPDX-License-Identifier: Apache-2.0 OR LGPL-2.1-or-later

Copy link
Collaborator

@UncleGrumpy UncleGrumpy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I hadn’t noticed before, but since there are no build configuration options for sleep, this section seems better suited for the Programmers Guide. What do you think?

The higher the speed, the faster the PSRAM will be, at the cost of higher power usage, but not all PSRAM chips support higher speeds.

#### Sleep mode - Deep sleep
#### Sleep mode - Deep sleep and Light sleep
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It doesn’t seem as if there are any build configuration settings required for the sleep modes… this whole section seems more appropriate for the Programmers guide than the Build Instructions. I had not caught on to this befnow.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did a more extensive reorganization.

@bettio bettio force-pushed the doc-update-esp32-sleep branch from 45187f9 to dd12033 Compare February 6, 2026 10:26
After atomvm#1789 (and the subsequent forward port from release-0.6), light
sleep has been merged in main.
Update newer documentation accordingly.

Signed-off-by: Davide Bettio <davide@uninstall.it>
@bettio bettio force-pushed the doc-update-esp32-sleep branch from dd12033 to f9c767e Compare February 6, 2026 10:28
Copy link
Collaborator

@UncleGrumpy UncleGrumpy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is much better organized. Just one out of date link to Espressifs docs.

* `error` (unknown other reason)

The values matches the semantics of [`esp_sleep_get_wakeup_cause`](https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32/api-reference/system/sleep_modes.html#_CPPv426esp_sleep_get_wakeup_causev).
The values match the semantics of [`esp_sleep_get_wakeup_cause`](https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32/api-reference/system/sleep_modes.html#_CPPv426esp_sleep_get_wakeup_causev).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should update the link to a currently supported IDF docs version. 4.4 > 5.5

@UncleGrumpy
Copy link
Collaborator

Since we always stay up to date with the latest ESP-IDF, we might consider linking to “latest” in the IDF docs, so we aren’t constantly chasing down dead/old links in our docs.

@bettio bettio added this to the v0.7.0 milestone Feb 6, 2026
@bettio
Copy link
Collaborator Author

bettio commented Feb 8, 2026

Since we always stay up to date with the latest ESP-IDF, we might consider linking to “latest” in the IDF docs, so we aren’t constantly chasing down dead/old links in our docs.

Sounds right, I will run a find & replace on the entire codebase.

@bettio bettio merged commit aa7ac0f into atomvm:main Feb 8, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants