ESP32: add support to light sleep #1789

bettio · 2025-08-08T13:20:28Z

Allow putting ESP32 to light sleep, and wake it up using a GPIO or a timer.

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

pguyot · 2025-08-08T16:22:45Z

src/platforms/esp32/components/avm_sys/platform_nifs.c

 }
 #endif

+static term nif_esp_gpio_wakeup_enable(Context *ctx, int argc, term argv[])


I would call this gpio:wakeup_enable/2 to match with the esp-idf function name.

this means we are leaking more ESP32 specific stuff into GPIO module. I think they can be made somehow generic, but I'm not sure how.

src/platforms/esp32/components/avm_sys/platform_nifs.c

bettio · 2025-08-10T10:30:14Z

There is something that I'd like to here the opinion about:

Should we use the avm_pubsub for pushing power manager events when returning from sleep?
Such as different 3rd party drivers might need to check if any IRQ pin has been raised during sleep, or any other process might need to know that everything was suspend for a certain amount of time.
So we have either 2 options: leave the caller handle this when returning from sleep, or standardizing some kind of mechanism for informing drivers and anything else that there was a power management related event.

pguyot · 2025-08-10T12:26:11Z

There is something that I'd like to here the opinion about:

Should we use the avm_pubsub for pushing power manager events when returning from sleep? Such as different 3rd party drivers might need to check if any IRQ pin has been raised during sleep, or any other process might need to know that everything was suspend for a certain amount of time. So we have either 2 options: leave the caller handle this when returning from sleep, or standardizing some kind of mechanism for informing drivers and anything else that there was a power management related event.

We could use monitor/2 to get the event.

BEAM documentation reads:

The monitor functionality is expected to be extended. That is, other Types and Items are expected to be supported in a future release.

UncleGrumpy · 2025-08-11T16:55:15Z

We could use monitor/2 to get the event.

This is an interesting suggestion, and might be useful to expose an API for pushing other “monitored” events, like acquiring or loosing a network connection.

I think some standardized notification system would be good, but it should be opt in, so extra resources are not consumed if they are not used.

bigint: misc fixes Those bugs were unlikely causing a crash, but still code wasn't correct. As an additional change: add `size_align_up_pow2` and similar utilities to `utils.h` since they are also required in intn.h as well. 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

Previous names, such as intn_2_digits_to_int64 were pretty cryptic. Signed-off-by: Davide Bettio <davide@uninstall.it>

Names with `mn` prefix were less readable. Signed-off-by: Davide Bettio <davide@uninstall.it>

Also remove INTN_ABS_OUT_LEN and INTN_NEG_OUT_LEN macros, since intn doesn't use anymore 2-complement. Signed-off-by: Davide Bettio <davide@uninstall.it>

…or-platforms-with-3-operands JIT: optimize shift right for platforms with 3 operands Continuation of atomvm#1838 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

Use a cache to remember tail calls that were already implemented and replace further implementations of the same tail call with a jump to the previous implementation. Coverage shows that all cases are covered in libs/estdlib/src and libs/jit/src: OP_RETURN: 50 misses, 1735 hits (97%) OP_JUMP/OP_CALL_LAST/OP_CALL_ONLY: 656 misses, 389 hits (37%) OP_CALL_LAST: 220 misses, 206 hits (48%) OP_FUNC_INFO: 58 misses, 1619 hits (97%) Signed-off-by: Paul Guyot <pguyot@kallisys.net>

Signed-off-by: Paul Guyot <pguyot@kallisys.net>

Improve intn function names Function names such as intn_addmn` were quite unreadable, let's just remove `mn` suffix. 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

Document `intn` Continuation of atomvm#1929 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

Documentation wasn't correct, they were already accepting non-normalized integers: - intn_to_string() - intn_to_integer_bytes() - intn_required_unsigned_integer_bytes() Changed to support integers not in normal form: - intn_to_double Signed-off-by: Davide Bettio <davide@uninstall.it>

Remove valgrind-suppressions.sup.license. Signed-off-by: Davide Bettio <davide@uninstall.it>

Aarch64: add tests for better coverage 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

Support unnormalized intn Fix documentation about functions accepting big integers in not-normalized form, and extend intn_to_double to accept them. 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

Remove unused file Remove valgrind-suppressions.sup.license. 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

…-reduce-binary-size JIT: factorize tail calls to reduce binary size Continuation of atomvm#1900 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

Add a new `term_reuse_binary` to reuse a refc binary, taking advantage of private_append compiler optimization. Add handling of out of memory errors in term_alloc_refc_binary by raising out of memory error instead of aborting. Update `and_/3` signature in JIT backends to handle and with a new register, and performed few optimizations accordingly by removing unnecessary copy. Signed-off-by: Paul Guyot <pguyot@kallisys.net>

Implement support for private_append 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

This function name is going to be used from term.h. Also since it is a static helper, put verb first. Signed-off-by: Davide Bettio <davide@uninstall.it>

Replace duplicated code with new functions in term.h. Signed-off-by: Davide Bettio <davide@uninstall.it>

Use `term_initialize_bigint` instead of `term_intn_data` + `intn_copy` Signed-off-by: Davide Bettio <davide@uninstall.it>

`term_create_uninitialized_intn` -> `term_create_uninitialized_bigint` `term_intn_to_term_size` -> `term_bigint_size_requirements` Also add doxygen documentation. Signed-off-by: Davide Bettio <davide@uninstall.it>

Rename it to BOXED_BIGINT_HEAP_SIZE, and clarify that it must be always used, in order to have the suitable size for allocating space for the bigint term with its boxed header. Signed-off-by: Davide Bettio <davide@uninstall.it>

Use better names than bn1, bn2 (such as big1, big2), etc... Signed-off-by: Davide Bettio <davide@uninstall.it>

Move before all arithmetic and bitwise functions bitwise helpers. Signed-off-by: Davide Bettio <davide@uninstall.it>

Update it in order to build Range.ex. Signed-off-by: Davide Bettio <davide@uninstall.it>

Elixir: Range: fix compile error with Elixir 1.8 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

IO.warn is not available, and the 1.19 internal function consolidate changed a tiny bit. Signed-off-by: Peter M <petermm@gmail.com>

Fix Protocol.ex warnings IO.warn is not available, and the 1.19 internal function consolidate changed a tiny bit. 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

Just update v5.5.1 -> v5.5.2. No other updates are available. Update also esp32-mkimage.yaml and esp32-simtest.yaml. Signed-off-by: Davide Bettio <davide@uninstall.it>

CI: esp32-build: update latest esp-idf Just update v5.5.1 -> v5.5.2. No other updates are available. 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

Switch from CMAKE_BINARY_DIR found when configuring with cmake to determining the paths at runtime. This allows configuring and building with the espressif/esp-idf docker image, and later running the escript in the host environment with OTP (and optionally Elixir and/or Gleam) installed. Signed-off-by: Winford <winford@object.stream>

Determine paths for ESP32 mkimage.sh at runtime 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

Signed-off-by: schnittchen <schnittchen@das-labor.org>

Fix error log 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

CI was having some odd failures, just update it. Signed-off-by: Davide Bettio <davide@uninstall.it>

Update node and nvm script. Signed-off-by: Davide Bettio <davide@uninstall.it>

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

Start disabling them on MCU targets. Signed-off-by: Davide Bettio <davide@uninstall.it>

Start phasing out old OTP versions Start disabling them on MCU targets. 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

AVM_PRINT_PROCESS_CRASH_DUMPS was introduced with bcfdcc6 (PR atomvm#1799), but the option hasn't been exposed / set on embedded targets (such as esp32, stm32 and rp2). The reason is that esp32 CMakeLists.txt doesn't include the root CMakeLists.txt, and the libAtomVM one doesn't have that option defined (it is defined on the root CMakeLists.txt), so that option didn't have a default value. Signed-off-by: Davide Bettio <davide@uninstall.it>

Signed-off-by: Peter M <petermm@gmail.com>

…dded-plat Enable/Make AVM_PRINT_PROCESS_CRASH_DUMPS work on embedded platforms 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

CI: Fix freebsd nxdomain failure 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

petermm · 2026-01-11T16:19:09Z

lgtm, there is also some docs over here:

"Usage of light sleep is untested, and no support for controlling light sleep is currently implemented. Reach out if you do any experiments and measurements."

AtomVM/doc/src/build-instructions.md

Line 384 in 6330d9f

#### Sleep mode - Light sleep

that needs updating

Add missing `/erlang`. Signed-off-by: Davide Bettio <davide@uninstall.it>

Doc: distributed-erlang.md: fix example file path 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

Support to OTP version < 26 is not compiled by default. Signed-off-by: Davide Bettio <davide@uninstall.it>

emscripten: phase out old OTP version (< 26) 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

Supercedes: atomvm#2063 CI: Only test release-v5.4 and 5.5.2 for ESP32P4, due to their support for both P4 revisions. Changelog fixes and additions. Other minor fixes related to CI. Signed-off-by: Peter M <petermm@gmail.com>

Signed-off-by: Peter M <petermm@gmail.com>

Fix ESP32-P4 builds and deep_sleep_hold Supercedes: atomvm#2063 CI: Only test release-v5.4 and 5.5.2 for ESP32P4, due to their support for both P4 revisions. Changelog fixes and additions. Other minor fixes related to CI. (simulator has gotten task_wdt support but, it's currently broken P4) 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

Allow putting ESP32 to light sleep, and wake it up using a GPIO or a timer. Signed-off-by: Davide Bettio <davide@uninstall.it>

src/libAtomVM/jit.c

+    if (n <= 64) {
+        union maybe_unsigned_int64 value;
+        bool status = bitstring_extract_integer(
+            ((term) bin_ptr) | TERM_PRIMARY_BOXED, offset, n, bs_flags, &value);


src/libAtomVM/jit.c

+    bool status;
+    switch (n) {
+        case 16:
+            status = bitstring_extract_f16(((term) bin_ptr) | TERM_PRIMARY_BOXED, offset, n, bs_flags, &value);


src/libAtomVM/jit.c

+            status = bitstring_extract_f16(((term) bin_ptr) | TERM_PRIMARY_BOXED, offset, n, bs_flags, &value);
+            break;
+        case 32:
+            status = bitstring_extract_f32(((term) bin_ptr) | TERM_PRIMARY_BOXED, offset, n, bs_flags, &value);


src/libAtomVM/jit.c

+            status = bitstring_extract_f32(((term) bin_ptr) | TERM_PRIMARY_BOXED, offset, n, bs_flags, &value);
+            break;
+        case 64:
+            status = bitstring_extract_f64(((term) bin_ptr) | TERM_PRIMARY_BOXED, offset, n, bs_flags, &value);


bettio force-pushed the add-support-to-esp32-light-sleep branch from 778ca20 to 0cb4308 Compare August 8, 2025 14:39

pguyot reviewed Aug 8, 2025

View reviewed changes

bettio force-pushed the add-support-to-esp32-light-sleep branch from 0cb4308 to 4d62044 Compare August 10, 2025 15:01

bettio and others added 24 commits October 25, 2025 16:48

intn: rename (u)int64 utils

8392ab4

Previous names, such as intn_2_digits_to_int64 were pretty cryptic. Signed-off-by: Davide Bettio <davide@uninstall.it>

intn: remove redundant mn suffix: e.g.: addmn -> add

38cdd9b

Names with `mn` prefix were less readable. Signed-off-by: Davide Bettio <davide@uninstall.it>

intn: add doxygen documentation

f416458

Also remove INTN_ABS_OUT_LEN and INTN_NEG_OUT_LEN macros, since intn doesn't use anymore 2-complement. Signed-off-by: Davide Bettio <davide@uninstall.it>

Aarch64: add tests for better coverage

e8d2bcb

Signed-off-by: Paul Guyot <pguyot@kallisys.net>

Remove license file for deleted file

3ae8c65

Remove valgrind-suppressions.sup.license. Signed-off-by: Davide Bettio <davide@uninstall.it>

bif.c: rename term_to_bigint to conv_term_to_bigint

1725da5

This function name is going to be used from term.h. Also since it is a static helper, put verb first. Signed-off-by: Davide Bettio <davide@uninstall.it>

Add term_to_bigint and term_is_bigint

83fe7b1

Replace duplicated code with new functions in term.h. Signed-off-by: Davide Bettio <davide@uninstall.it>

Add new term_initialize_bigint function

9808df3

Use `term_initialize_bigint` instead of `term_intn_data` + `intn_copy` Signed-off-by: Davide Bettio <davide@uninstall.it>

Rename term_create_uninitialized_intn and term_intn_to_term_size

ba2c1a4

`term_create_uninitialized_intn` -> `term_create_uninitialized_bigint` `term_intn_to_term_size` -> `term_bigint_size_requirements` Also add doxygen documentation. Signed-off-by: Davide Bettio <davide@uninstall.it>

term: rename and clarify BOXED_INTN_SIZE macro

10ce113

Rename it to BOXED_BIGINT_HEAP_SIZE, and clarify that it must be always used, in order to have the suitable size for allocating space for the bigint term with its boxed header. Signed-off-by: Davide Bettio <davide@uninstall.it>

bif.c: use understandable names

6ce3ea8

Use better names than bn1, bn2 (such as big1, big2), etc... Signed-off-by: Davide Bettio <davide@uninstall.it>

bif.c: move bigint helpers

7946e89

Move before all arithmetic and bitwise functions bitwise helpers. Signed-off-by: Davide Bettio <davide@uninstall.it>

bettio and others added 19 commits December 27, 2025 19:10

CI: Elixir 1.8 is the minimum tested version

8a65751

Update it in order to build Range.ex. Signed-off-by: Davide Bettio <davide@uninstall.it>

Fix Protocol.ex warnings

fa54a3f

IO.warn is not available, and the 1.19 internal function consolidate changed a tiny bit. Signed-off-by: Peter M <petermm@gmail.com>

CI: esp32-build: update latest esp-idf

f914621

Just update v5.5.1 -> v5.5.2. No other updates are available. Update also esp32-mkimage.yaml and esp32-simtest.yaml. Signed-off-by: Davide Bettio <davide@uninstall.it>

fix typo in ESP32 dac_driver.c

46d1eb9

Signed-off-by: schnittchen <schnittchen@das-labor.org>

Merge pull request atomvm#2053 from schnittchen/fix-error-log

4d0953b

Fix error log 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

Update rp2040js to v1.1.1

de9bcba

CI was having some odd failures, just update it. Signed-off-by: Davide Bettio <davide@uninstall.it>

CI: pico-build: update node to 24

27ec563

Update node and nvm script. Signed-off-by: Davide Bettio <davide@uninstall.it>

Merge pull request atomvm#2054 from bettio/update-rp2040js-to-v1.1.1

3d6e706

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

Start phasing out old OTP versions

68968c9

Start disabling them on MCU targets. Signed-off-by: Davide Bettio <davide@uninstall.it>

CI: Fix freebsd nxdomain failure

66a6648

Signed-off-by: Peter M <petermm@gmail.com>

bettio and others added 8 commits January 12, 2026 00:51

Doc: distributed-erlang.md: fix example file path

9da8bf9

Add missing `/erlang`. Signed-off-by: Davide Bettio <davide@uninstall.it>

emscripten: phase out old OTP version (< 26)

816d388

Support to OTP version < 26 is not compiled by default. Signed-off-by: Davide Bettio <davide@uninstall.it>

Fix ESP32 deep_sleep hold

49c410b

Supercedes: atomvm#2063 CI: Only test release-v5.4 and 5.5.2 for ESP32P4, due to their support for both P4 revisions. Changelog fixes and additions. Other minor fixes related to CI. Signed-off-by: Peter M <petermm@gmail.com>

ESP32-P4: built variants for revisions and wifi daughterboard

06c0d21

Signed-off-by: Peter M <petermm@gmail.com>

ESP32: add support to light sleep

a07cef1

Allow putting ESP32 to light sleep, and wake it up using a GPIO or a timer. Signed-off-by: Davide Bettio <davide@uninstall.it>

bettio force-pushed the add-support-to-esp32-light-sleep branch from 4d62044 to a07cef1 Compare January 22, 2026 14:06

github-advanced-security bot found potential problems Jan 22, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

ESP32: add support to light sleep #1789

ESP32: add support to light sleep #1789

Uh oh!

bettio commented Aug 8, 2025 •

edited

Loading

Uh oh!

pguyot Aug 8, 2025

Uh oh!

bettio Aug 10, 2025

Uh oh!

Uh oh!

bettio commented Aug 10, 2025 •

edited

Loading

Uh oh!

pguyot commented Aug 10, 2025 •

edited

Loading

Uh oh!

UncleGrumpy commented Aug 11, 2025

Uh oh!

petermm commented Jan 11, 2026

Uh oh!

Check failure

Check failure

Check failure

Check failure

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

ESP32: add support to light sleep #1789

Are you sure you want to change the base?

ESP32: add support to light sleep #1789

Uh oh!

Conversation

bettio commented Aug 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pguyot Aug 8, 2025

Choose a reason for hiding this comment

Uh oh!

bettio Aug 10, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

bettio commented Aug 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pguyot commented Aug 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

UncleGrumpy commented Aug 11, 2025

Uh oh!

petermm commented Jan 11, 2026

Uh oh!

Check failure

Check failure

Check failure

Check failure

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

bettio commented Aug 8, 2025 •

edited

Loading

bettio commented Aug 10, 2025 •

edited

Loading

pguyot commented Aug 10, 2025 •

edited

Loading