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 b1209991590d52748b7a1e59be27d69768cc56a3 Author: dechao_gong <[email protected]> AuthorDate: Tue Sep 22 10:15:31 2026 +0800 Documentation/platforms/arm/rtl8730e: update board doc and add gpio config - Switch board image directive from .. image:: to .. figure:: with :scale: 50 % and a caption line, matching the format used by other Ameba board docs (rtl8721dx, rtl8721f). - Move rtl8730e_evb.png from img/ subdirectory to the same level as index.rst, consistent with other boards. - Add gpio configuration section describing the three registered pins (PB19 output /dev/gpio0, PB20 input /dev/gpio1, PB11 interrupt /dev/gpio2), usage examples and pin encoding notes. - Add GPIO to the "Supported in this NuttX port" feature list. Signed-off-by: dechao_gong <[email protected]> Assisted-by: Claude <[email protected]> --- .../arm/rtl8730e/boards/rtl8730e_evb/index.rst | 27 +++++++++++++++++++-- .../boards/rtl8730e_evb/{img => }/rtl8730e_evb.png | Bin 2 files changed, 25 insertions(+), 2 deletions(-) diff --git a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst index d6609add034..9aa1577b3c0 100644 --- a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst +++ b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst @@ -4,9 +4,12 @@ RTL8730E_EVB .. tags:: chip:rtl8730e, arch:arm, vendor:realtek -.. image:: img/rtl8730e_evb.png +.. figure:: rtl8730e_evb.png + :scale: 50 % :align: center - :alt: PKE8730EAH-VD3-F32 evaluation board + :alt: Realtek RTL8730E EVB development board + + The RTL8730E EVB development board. The RTL8730E_EVB is a Realtek RTL8730E evaluation board built around the RTL8730EH (DDR2 64 MB, 16 MB NOR flash). NuttX runs on the dual-core Arm @@ -30,6 +33,8 @@ Supported in this NuttX port: * NSH shell over the LOG-UART console * SMP on both Cortex-A32 cores; tasks are dispatched across CPU0 and CPU1 by the NuttX SMP scheduler +* GPIO pins exposed as ``/dev/gpioN`` character devices (input, output and + interrupt), driven through the SDK fwlib ROM 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 @@ -52,6 +57,24 @@ nsh Networking-enabled NSH with SMP, littlefs at ``/data``, and the ``wapi`` Wi-Fi tool. The console is the LOG-UART at 1500000 8N1. +gpio +---- + +Minimal NSH with the GPIO driver and the ``gpio`` example enabled (no Wi-Fi). +The board registers three pins from its pin table (see +``boards/arm/rtl8730e/rtl8730e_evb/src/rtl8730e_gpio.c``): an output at +``/dev/gpio0``, an input at ``/dev/gpio1`` and an interrupt pin at +``/dev/gpio2``. Edit that table to match a board's wiring. Exercise them +with the example:: + + nsh> gpio -o 1 /dev/gpio0 # drive the output high + nsh> gpio /dev/gpio1 # read the input + nsh> gpio -w 1 /dev/gpio2 # wait for a falling-edge interrupt + +Pins are encoded with the ``AMEBA_PA()`` / ``AMEBA_PB()`` helpers from +``arch/arm/src/common/ameba/ameba_gpio.h`` (port A/B, pin 0-31), matching the +Ameba SDK ``PinName`` layout. + Wi-Fi ===== diff --git a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/img/rtl8730e_evb.png b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/rtl8730e_evb.png similarity index 100% rename from Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/img/rtl8730e_evb.png rename to Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/rtl8730e_evb.png
