You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by ac...@apache.org on 2026/10/22 22:07:05 UTC
(nuttx) 02/02: Documentation/rtl8730e: document the ADC configuration
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 <de...@realsil.com.cn>
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 <de...@realsil.com.cn>
Assisted-by: Claude <no...@anthropic.com>
---
.../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
=====