Documentation: Add XIAO RA4M1 Board

Added documentation for Seeed Studio XIAO RA4M1
Board.

Signed-off-by: Rodrigo Sim <rcsim10@gmail.com>
This commit is contained in:
Rodrigo Sim
2025-03-23 19:24:38 -03:00
committed by Xiang Xiao
parent f3a4011a20
commit 02937bd939
2 changed files with 151 additions and 0 deletions
@@ -0,0 +1,151 @@
=======================
Seeed Studio XIAO RA4M1
=======================
The `Seeed Studio XIAO RA4M1 <https://wiki.seeedstudio.com/getting_started_xiao_ra4m1/>`_ is a general purpose board supplied by
Seeed Studio and it is compatible with the Renesas RA4M1 ecosystem, sharing the same MCU as Arduino R4 Minima
(R7FA4M1AB3CFM).
.. figure:: xiao-ra4m1.jpg
:align: center
Features
========
* Renesas RA4M1, ARM® Dual Cortex-M4 @ 48MHz
* 32kB SRAM, 256KkB Flash, 8KB EEPROM
* Security: AES128/256
* USB Type-C interface
* 19 Pins:14x Analog,19x Digital, 2x IIC, 2x UART, 2x SPI
* 1 user LED, 1 power LED1 RGB LED (WS2812)
* 1 RESET button, 1 BOOT button
Serial Console
==============
By default, a serial console appears on pins 6 (TX GPIO) and pin 7
(RX GPIO). This console runs a 115200-8N1.
User LED
========
The USER LED, the yellow LED on the XIAO RA4M1, is connected to P011
according to the schematic diagram.
Buttons
=======
The RESET and BOOT buttons can be used to enter "Renesas RA USB Boot" mode by
reboot the board with BOOT shorted to GND and press the reset button twice (double click).
The board will enumerate as "Renesas RA USB Boot".
Pin Mapping
===========
Pads numbered anticlockwise from USB connector.
===== ========== ==========
Pad Signal Notes
===== ========== ==========
0 P014 D0/A0
1 P000 D1/A1
2 P001 D2/A2
3 P002 D3/A3
4 P006 D4/SDA
5 P100 D5/SCL
6 P301 D6/Default TX for UART0 serial console
7 P301 D7/Default RX for UART0 serial console
8 P111 D8/SCK
9 P110 D9/MISO
10 P109 D10/MOSI
11 3V3 Power output to peripherals
12 Ground
13 VIN +5V Supply to board
===== ========== ==========
Power Supply
============
The working voltage of the MCU is 3.3V. Voltage input connected to
general I/O pins may cause chip damage if its higher than 3.3V.
Installation
============
1. Configure and build NuttX:
.. code-block:: console
$ git clone https://github.com/apache/nuttx.git nuttx
$ git clone https://github.com/apache/nuttx-apps.git apps
$ cd nuttx
$ make distclean
$ ./tools/configure.sh xiao-ra4m1:nsh
$ make V=1
2. Connect the Seeed Studio XIAO RA4M1, and enter "Renesas RA USB Boot" mode,
then, flash the ``nuttx.hex`` file using ``rfp-cli``:
(https://www.renesas.com/en/software-tool/renesas-flash-programmer-programming-gui)
Example command:
.. code-block:: bash
rfp-cli -device ra -port /dev/ttyACM0 -p ./build/nuttx.hex
3. To access the console, TX and RX pins must be connected to the
device such as USB-serial converter.
Configurations
==============
nsh
---
Basic NuttShell configuration (console enabled in UART0, at 115200 bps).
combo
-----
This configuration enabled NuttShell via Serial and enabled led and gpio
examples:
Testing leds:
.. code-block:: console
$nsh> leds
leds_main: Starting the led_daemon
leds_main: led_daemon started
led_daemon (pid# 5): Running
led_daemon: Opening /dev/userleds
led_daemon: Supported LEDs 0x01
led_daemon: LED set 0x01
$nsh> led_daemon: LED set 0x00
led_daemon: LED set 0x01
led_daemon: LED set 0x00
led_daemon: LED set 0x01
led_daemon: LED set 0x00
led_daemon: LED set 0x01
Testing gpios:
======== ====== ==========
PIN/GPIO Mode Device
======== ====== ==========
D0/P014 Input /dev/gpio0
D1/P000 Output /dev/gpio1
======== ====== ==========
.. code-block:: console
$nsh> gpio /dev/gpio0
Driver: /dev/gpio0
Input pin: Value=0
$nsh> gpio /dev/gpio0
Driver: /dev/gpio0
Input pin: Value=1
Binary file not shown.

After

Width:  |  Height:  |  Size: 318 KiB