Forward port changes from v0.6 release branch

Merge doc fixes and a ESP32 GPIO fix from release-0.6 branch into main.

Author: bettio

CHANGELOG.md

@@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 
 - Fixed specifications of nifs from `esp_adc` module
+- ESP32: fix `gpio:init/1` on GPIO >= 32
 
 ## [0.6.5] - 2024-10-15
 

doc/src/programmers-guide.md

@@ -1369,6 +1369,10 @@ To retrieve data in RTC slow memory, use the [`esp:rtc_slow_get_binary/0`](./api
 Data = esp:rtc_slow_get_binary()
 ```
 
+```{caution}
+Calling [`esp:rtc_slow_get_binary/0`](./apidocs/erlang/eavmlib/esp.md#rtc_slow_get_binary0) without having stored a binary first using [`esp:rtc_slow_set_binary/1`](./apidocs/erlang/eavmlib/esp.md#rtc_slow_set_binary1), will raise with badarg. So make sure to wrap such a call with a try/catch or similar.
+```
+
 By default, RTC slow memory in AtomVM is limited to 4098 (4k) bytes.  This value can be modified at build time using an IDF SDK `KConfig` setting.  For  instructions about how to build AtomVM, see the AtomVM [Build Instructions](./build-instructions.md#building-for-esp32).
 
 ### Miscellaneous ESP32 APIs

src/platforms/esp32/components/avm_builtins/gpio_driver.c

@@ -660,7 +660,7 @@ static term nif_gpio_init(Context *ctx, int argc, term argv[])
     }
 
     gpio_config_t config = {};
-    config.pin_bit_mask = 1 << gpio_num;
+    config.pin_bit_mask = 1ULL << gpio_num;
     config.mode = GPIO_MODE_DISABLE;
     config.pull_up_en = GPIO_PULLUP_DISABLE;
     config.pull_down_en = GPIO_PULLDOWN_DISABLE;