Forward port changes from v0.6 release branch

Merge fixes (such as esp_adc NIF declarations and UART doc) from release-0.6
branch into main.

Author: bettio

CHANGELOG.md

@@ -10,6 +10,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added a limited implementation of the OTP `ets` interface
 - Added `code:all_loaded/0` and `code:all_available/0`
 
+## [0.6.6] - Unreleased
+
+### Fixed
+
+- Fixed specifications of nifs from `esp_adc` module
+
 ## [0.6.5] - 2024-10-15
 
 ### Added

doc/src/programmers-guide.md

@@ -1795,34 +1795,37 @@ Information about the ESP32 UART interface can be found in the IDF SDK [UART Doc
 
 The AtomVM UART implementation uses the AtomVM Port mechanism and must be initialized using the [`uart:open/2`](./apidocs/erlang/eavmlib/uart.md#open2) function.
 
-The first parameter indicates the ESP32 UART hardware interface.  Legal values are:
+The first parameter indicates the ESP32 UART hardware interface.  Valid values are:
 
 ```erlang
 "UART0" | "UART1" | "UART2"
 ```
 
-The selection of the hardware interface dictates the default RX and TX pins on the ESP32:
-
-| Port | RX pin | TX pin |
-|-------------|--------|-------|
-| `UART0` | GPIO_3 | GPIO_1 |
-| `UART1` | GPIO_9 | GPIO_10 |
-| `UART2` | GPIO_16 | GPIO_17 |
-
 The second parameter is a properties list, containing the following elements:
 
 | Key | Value Type | Required | Default Value | Description |
 |-----|------------|----------|---------------|-------------|
+| `rx` | `integer()` | no | -1 (`UART_PIN_NO_CHANGE`) | RX GPIO Pin |
+| `tx` | `integer()` | no | -1 (`UART_PIN_NO_CHANGE`) | TX GPIO Pin |
 | `speed` | `integer()` | no | 115200 | UART baud rate (bits/sec) |
 | `data_bits` | `5 \| 6 \| 7 \| 8` | no | 8 | UART data bits |
 | `stop_bits` | `1 \| 2` | no | 1 | UART stop bits |
 | `flow_control` | `hardware \| software \| none` | no | `none` | Flow control |
 | `parity` | `even \| odd \| none` | no | `none` | UART parity check |
 
+
+These are the usual RX and TX pins for the various UARTs on the ESP32 (as always check your board specs):
+
+| Port | RX pin | TX pin |
+|-------------|--------|-------|
+| `UART0` | GPIO_3 | GPIO_1 |
+| `UART1` | GPIO_9 | GPIO_10 |
+| `UART2` | GPIO_16 | GPIO_17 |
+
 For example,
 
 ```erlang
-UART = uart:open("UART0", [{speed, 9600}])
+UART = uart:open("UART0", [{rx, 3}, {tx, 1}, {speed, 9600}])
 ```
 
 Once the port is opened, you can use the returned `UART` instance to read and write bytes to the attached device.

libs/eavmlib/src/esp_adc.erl

@@ -117,7 +117,7 @@
 %%-----------------------------------------------------------------------------
 -spec init() -> {ok, ADCUnit :: adc_rsrc()} | {error, Reason :: term()}.
 init() ->
-    throw(nif_error).
+    erlang:nif_error(undefined).
 
 %%-----------------------------------------------------------------------------
 %% @param   UnitResource returned from init/0
@@ -134,7 +134,7 @@ init() ->
 %%-----------------------------------------------------------------------------
 -spec deinit(UnitResource :: adc_rsrc()) -> ok | {error, Reason :: term()}.
 deinit(_UnitResource) ->
-    throw(nif_error).
+    erlang:nif_error(undefined).
 
 %%-----------------------------------------------------------------------------
 %% @param   Pin         Pin to configure as ADC
@@ -185,7 +185,7 @@ acquire(Pin, UnitHandle) ->
     Attenuation :: attenuation()
 ) -> {ok, Channel :: adc_rsrc()} | {error, Reason :: term()}.
 acquire(_Pin, _UnitHandle, _BitWidth, _Attenuation) ->
-    throw(nif_error).
+    erlang:nif_error(undefined).
 
 %%-----------------------------------------------------------------------------
 %% @param   ChannelResource of the pin returned from acquire/4
@@ -204,7 +204,7 @@ acquire(_Pin, _UnitHandle, _BitWidth, _Attenuation) ->
 %%-----------------------------------------------------------------------------
 -spec release_channel(ChannelResource :: adc_rsrc()) -> ok | {error, Reason :: term()}.
 release_channel(_ChannelResource) ->
-    throw(nif_error).
+    erlang:nif_error(undefined).
 
 %%-----------------------------------------------------------------------------
 %% @param   ChannelResource of the pin returned from acquire/4
@@ -256,7 +256,7 @@ sample(ChannelResource, UnitResource) ->
     ChannelResource :: adc_rsrc(), UnitResource :: adc_rsrc(), ReadOptions :: read_options()
 ) -> {ok, Result :: reading()} | {error, Reason :: term()}.
 sample(_ChannelResource, _UnitResource, _ReadOptions) ->
-    throw(nif_error).
+    erlang:nif_error(undefined).
 
 %%-----------------------------------------------------------------------------
 %% @returns {ok, Pid}