Skip to content

Commit

Permalink
boards: arduino: uno_r4: Update document about Arduino UNO R4 WiFi
Browse files Browse the repository at this point in the history
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 <[email protected]>
  • Loading branch information
soburi authored and carlescufi committed Apr 10, 2024
1 parent 1b25601 commit 747440c
Showing 1 changed file with 58 additions and 5 deletions.
63 changes: 58 additions & 5 deletions boards/arduino/uno_r4/doc/index.rst
Original file line number Diff line number Diff line change
@@ -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).

Expand All @@ -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.

Expand All @@ -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
-----------
Expand All @@ -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

0 comments on commit 747440c

Please sign in to comment.