This is an automated email from the ASF dual-hosted git repository. acassis pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit fc6762b5b872948b5af537cc222ce8b9432d01cc Author: dechao_gong <[email protected]> AuthorDate: Thu Oct 22 10:03:45 2026 +0800 Documentation/rtl8730e: document the ADC configuration Add the 12-bit ADC to the list of supported features of the RTL8730E-EVB board and describe the new adc configuration: which channels are registered at /dev/adc0, the pads they are bound to, and the other functions that share those pads. Signed-off-by: dechao_gong <[email protected]> Assisted-by: Claude <[email protected]> --- .../arm/rtl8730e/boards/rtl8730e_evb/index.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst index 11306b5148f..dd05e6cb155 100644 --- a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst +++ b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst @@ -47,6 +47,8 @@ Supported in this NuttX port: * General-purpose timers exposed as ``/dev/timerN`` character devices, with microsecond timeouts and a periodic expiration callback * On-chip watchdog exposed as a ``/dev/watchdog0`` character device +* 12-bit ADC exposed as a ``/dev/adc0`` character device, sampled in polling + mode through the SDK fwlib register layer * littlefs persistent storage mounted at ``/data`` (a dedicated SPI NOR flash partition), backing the Wi-Fi key-value store * Wi-Fi station and SoftAP through the ``wapi`` tool @@ -190,6 +192,26 @@ opens the device, sets a timeout, and pings it:: nsh> wdog # run the watchdog example on /dev/watchdog0 +adc +--- + +Minimal NSH with the ADC driver and the ``adc`` example (``examples/adc``) +enabled (no Wi-Fi). The board registers one converter at ``/dev/adc0`` (see +``boards/arm/rtl8730e/rtl8730e_evb/src/rtl8730e_adc.c``) listing CH2-CH5, +which each ``ANIOC_TRIGGER`` samples in list order. The chip has ten +channels; CH0-CH5 are external and bound to the fixed pads PA0-PA5 (the +pin-mux table names them ``TOUCHn_ADCn``), while the rest are internal and +have no pad. PA0 and PA1 are not bonded out on the RTL8730EAM/EAH packages, +so the table leaves CH0 and CH1 out. The pads reach the converter through +the cap-touch function (``PINMUX_FUNCTION_CAPTOUCH``, function 18), shared +with the cap-touch controller and, on PA2-PA5, the DMIC, so those functions +cannot be used on the same pad. PA3/PA4 are also I2C1 pads and PA4/PA5 are +UART1 or PWM pads: a config that registers one of those too must drop the +clashing channel from the table. The input range is 0 to 3.3 V with 12-bit +samples, reported as raw codes. Exercise it with the example:: + + nsh> adc -n 1 # sample CH2-CH5 once on /dev/adc0 + Wi-Fi =====
