From 747440c46e5670da6254ecfcc0c117d3b52c4f78 Mon Sep 17 00:00:00 2001 From: TOKITA Hiroshi Date: Wed, 3 Apr 2024 19:58:45 +0900 Subject: [PATCH] boards: arduino: uno_r4: Update document about Arduino UNO R4 WiFi Update documents about adding Arduino UNO R4 WiFi. Adding a description that a debug adapter is required when flashing and debugging. Signed-off-by: TOKITA Hiroshi --- boards/arduino/uno_r4/doc/index.rst | 63 ++++++++++++++++++++++++++--- 1 file changed, 58 insertions(+), 5 deletions(-) diff --git a/boards/arduino/uno_r4/doc/index.rst b/boards/arduino/uno_r4/doc/index.rst index e94c4c7890..1b2b28385b 100644 --- a/boards/arduino/uno_r4/doc/index.rst +++ b/boards/arduino/uno_r4/doc/index.rst @@ -1,21 +1,58 @@ .. _arduino_uno_r4: -Arduino UNO R4 Minima -##################### +Arduino UNO R4 +############## Overview ******** -The Arduino UNO R4 Minima is a development board featuring the Renesas RA4M1 SoC +The Arduino UNO R4 Minima/WiFi is a development board featuring the Renesas RA4M1 SoC in the Arduino form factor and is compatible with traditional Arduino. +Hardware +******** + +- Renesas RA4MA1 Processor (ARM Cortex-M4 at 48 MHz) +- 256 KiB flash memory and 32 KiB of RAM +- One user LEDs +- One reset button +- One WiFi Transceiver (Arduino UNO R4 WiFi only) +- One 12x8 LED Matrix (Arduino UNO R4 WiFi only) +- Built-in CMSIS-DAP debug adapter (Arduino UNO R4 WiFi only) + +Supported Features +================== + +The Arduino UNO R4 Minima/Wifi board configuration supports the following +hardware features: + ++-----------+------------+------------------------------------------+ +| Interface | Controller | Driver/Component | ++===========+============+==========================================+ +| GPIO | on-chip | I/O ports | ++-----------+------------+------------------------------------------+ +| UART | on-chip | Serial ports | ++-----------+------------+------------------------------------------+ + Programming and debugging ************************* +Debug adapter +============= + +A debug adapter is required to flash and debug programs. +Arduino UNO R4 WiFi has a built-in debug adapter that +you can use for flashing and debugging. + +In the Arduino UNO R4 Minima case, You need to prepare +debug adapter separately. A 5V-compatible CMSIS-DAP adapter +adapts to this board. + + Building & Flashing =================== -You can build and flash an application in the usual way (See +You can build and flash with ``west flash`` command (See :ref:`build_an_application` and :ref:`application_run` for more details). @@ -26,10 +63,15 @@ Here is an example for building and flashing the :zephyr:code-sample:`blinky` ap :board: arduino_uno_r4_minima :goals: build flash +.. zephyr-app-commands:: + :zephyr-app: samples/basic/blinky + :board: arduino_uno_r4_wifi + :goals: build flash + Debugging ========= -Debugging also can be done in the usual way. +Debugging can be done with ``west debug`` command. The following command is debugging the :zephyr:code-sample:`blinky` application. Also, see the instructions specific to the debug server that you use. @@ -39,6 +81,12 @@ Also, see the instructions specific to the debug server that you use. :maybe-skip-config: :goals: debug +.. zephyr-app-commands:: + :zephyr-app: samples/basic/blinky + :board: arduino_uno_r4_wifi + :maybe-skip-config: + :goals: debug + Using pyOCD ----------- @@ -62,3 +110,8 @@ If you corrupt the Arduino bootloader, you can restore it with the following com wget https://raw.githubusercontent.com/arduino/ArduinoCore-renesas/main/bootloaders/UNO_R4/dfu_minima.hex pyocd flash -e sector -a 0x0 -t r7fa4m1ab dfu_minima.hex + +.. code-block:: console + + wget https://raw.githubusercontent.com/arduino/ArduinoCore-renesas/main/bootloaders/UNO_R4/dfu_wifi.hex + pyocd flash -e sector -a 0x0 -t r7fa4m1ab dfu_wifi.hex