ESP8266 node.sleep() hang

Expected behavior

esp8266 does not hang

Actual behavior

esp8266 hangs (does not return from sleep no matter the level changes on the trigger pin)

Test code

Provide a Minimal, Complete, and Verifiable example which will reproduce the problem.

-- Physically grounding D7 with INT_LOW specified hangs ESP with node.sleep
gpio.mode(7,0); print("start",gpio.read(7),"\n")
cfg={}
cfg.wake_pin=7
cfg.int_type=node.INT_LOW
cfg.resume_cb=function() print("resume",gpio.read(7),wifi.sta.getip()) end
cfg.preserve_mode=true
node.sleep(cfg)

Terminal

test 1: ok: high to low

gpio.mode(7,0); print("start",gpio.read(7),"\n") start 1 cfg={} cfg.wake_pin=7 cfg.int_type=node.INT_LOW cfg.resume_cb=function() print("resume",gpio.read(7),wifi.sta.getip()) end cfg.preserve_mode=true node.sleep(cfg) resume 0 nil

test 2: ok: low to high

gpio.mode(7,0); print("start",gpio.read(7),"\n") start 0 cfg={} cfg.wake_pin=7 cfg.int_type=node.INT_HIGH cfg.resume_cb=function() print("resume",gpio.read(7),wifi.sta.getip()) end cfg.preserve_mode=true node.sleep(cfg) resume 1 nil

test 3: hangs: high to high (no change), but use INT_HIGH so level should trigger immediately, fails with hang

print("now start with the trigger level already set") now start with the trigger level already set gpio.mode(7,0); print("start",gpio.read(7),"\n") start 1 cfg={} cfg.wake_pin=7 cfg.int_type=node.INT_HIGH cfg.resume_cb=function() print("resume",gpio.read(7),wifi.sta.getip()) end cfg.preserve_mode=true node.sleep(cfg) Soft restart by user command Soft restart by user command r$

test 4: hangs: D7 is low and start node.sleep with INT_LOW hangs just like test 3. Furthermore no amount of high and low cycling on D7 returns the ESP from sleep. Hard reset required as with test 3.

test 5: hangs: any edge trigger, hangs INT_UP, INT_DOWN and INT_BOTH hang the ESP

Other things tried

1. a really old build with release DTS: 202002231746 with the same result.
2. minimum module builds for new and old. just modules: file,gpio,net,node,tmr,uart,wifi.
3. Pins D1, D2, D5, D6 tested with current build
4. Same result in all cases

NodeMCU startup banner

NodeMCU 3.0.0.0 built with Docker provided by frightanic.com branch: release commit: 36cb f9f017d356319a6369e299765eedff191154 release: 3.0.0-release_20211229 +25 release DTS: 202402250804 SSL: false build type: float LFS: 0x40000 bytes total capacity modules: adc,bit,cron,dht,file,gpio,i2c,net,node,ow,pwm,rtcmem,rtctime,sntp,spi,struct,tmr,uart,wifi build 2024-09-12 18:10 powered by Lua 5.1.4 on SDK 3.0.1-dev(fce080e) cannot open init.lua:

user_config.h snippet

// GPIO_INTERRUPT_ENABLE needs to be defined if your application uses the // gpio.trig() or related GPIO interrupt service routine code. Likewise the // GPIO interrupt hook is required for a few modules such as rotary. If you // don't require this functionality, then commenting out these options // will remove any associated runtime overhead.

#define GPIO_INTERRUPT_ENABLE #define GPIO_INTERRUPT_HOOK_ENABLE

// If your application uses the light sleep functions and you wish the // firmware to manage timer rescheduling over sleeps (the CPU clock is // suspended so timers get out of sync) then enable the following options

#define TIMER_SUSPEND_ENABLE #define PMSLEEP_ENABLE

Hardware

Describe which ESP8266/ESP32 device you use and document any special hardware setup required to reproduce the problem. ESP8266: D1 Mini, 12E, 12F with 10k pullup on D7 with push button switch to ground D7=high and INT_LOW works when D7 pulled down D7=low and INT_HIGH works when D7 pulled high D7=low and INT_LOW hangs ESP and requires hard reset INT_UP, INT_DOWN and INT_BOTH hang the ESP

Hard to imagine this is a bug, but nothing in the docs https://nodemcu.readthedocs.io/en/dev/modules/node/#nodesleep indicates additional hardware or software setup required

Perhaps this just requires an update to the documentation with the missing element(s).

Build Environment

1. Docker Desktop 4.33.1 (161083)
2. Git-2.46.0-64-bit
3. Windows 11