From 188ca7d08a75d84c2378a9c81cc3687697f77f83 Mon Sep 17 00:00:00 2001 From: Andrew Leech Date: Wed, 29 May 2024 15:22:13 +1000 Subject: [PATCH] renesas-ra/README: Add basic details about board autogen files. The renesas-ra port board definitions contain auto-generated files which are not easy to understand for someone unfamiliar with the port. This commit adds some notes to the README to assist other developers who want to work on these. The configuration.xml file for the `ARDUINO_PORTENTA_C33` was provided by @iabdalkader. Signed-off-by: Andrew Leech --- ports/renesas-ra/README.md | 20 + .../ARDUINO_PORTENTA_C33/configuration.xml | 653 ++++++++++++++++++ 2 files changed, 673 insertions(+) create mode 100755 ports/renesas-ra/boards/ARDUINO_PORTENTA_C33/configuration.xml diff --git a/ports/renesas-ra/README.md b/ports/renesas-ra/README.md index 4b3a7696faeb..ed5a155e7f3d 100644 --- a/ports/renesas-ra/README.md +++ b/ports/renesas-ra/README.md @@ -63,6 +63,26 @@ passed as the argument to `BOARD=`; for example `RA4M1_CLICKER`, `EK_RA4M1`, The above command should produce binary images `firmware.hex` in the build-EK_RA6M2/` subdirectory (or the equivalent directory for the board specified). +## Board definition auto-generated code + +The supported board definitions contain auto-generated configuration files in +the `boards//ra_cfg` and `boards//ra_gen` folders. + +These are generated with the [RA Smart Configurator](https://www.renesas.com/us/en/software-tool/ra-smart-configurator) +tool which is used to define peripheral configuration, pinouts, interrupts etc. for each board. + +This tool can be installed either as part of the "Renesas e² studio", or separately with +the fsp driver package from https://github.com/renesas/fsp/releases eg. +* [setup_fsp_v4_4_0_rasc_v2023-04.exe](https://github.com/renesas/fsp/releases/download/v4.4.0/setup_fsp_v4_4_0_rasc_v2023-04.exe) +* [setup_fsp_v4_4_0_rasc_v2023-04.exe](https://github.com/renesas/fsp/releases/download/v4.4.0/setup_fsp_v4_4_0_rasc_v2023-04.AppImage) + +This tool can be used to create new board definitions or modify existing ones +by opening one of the `configuration.xml` files in the board folders. + +Once the `configuration.xml` file is opened in RA Smart Configurator and modified as +needed, the "Generate Project Content" button can be pressed to export new copies +of the `ra_cfg` and `ra_gen` folders. + ## Supported/Unsupported functions Please refer to the `renesas-ra` quick reference. diff --git a/ports/renesas-ra/boards/ARDUINO_PORTENTA_C33/configuration.xml b/ports/renesas-ra/boards/ARDUINO_PORTENTA_C33/configuration.xml new file mode 100755 index 000000000000..714a1c716eb2 --- /dev/null +++ b/ports/renesas-ra/boards/ARDUINO_PORTENTA_C33/configuration.xml @@ -0,0 +1,653 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Custom Board Support Files + Renesas.RA_board_custom.4.4.0.pack + + + Board support package for R7FA6M5BH2CBG + Renesas.RA_mcu_ra6m5.4.4.0.pack + + + Board support package for RA6M5 + Renesas.RA_mcu_ra6m5.4.4.0.pack + + + Board support package for RA6M5 - FSP Data + Renesas.RA_mcu_ra6m5.4.4.0.pack + + + Arm CMSIS Version 5 - Core (M) + Arm.CMSIS5.5.9.0+renesas.0.fsp.4.4.0.pack + + + Board Support Package Common Files + Renesas.RA.4.4.0.pack + + + A/D Converter + Renesas.RA.4.4.0.pack + + + Asynchronous General Purpose Timer + Renesas.RA.4.4.0.pack + + + 12-bit D/A Converter + Renesas.RA.4.4.0.pack + + + Flash Memory High Performance + Renesas.RA.4.4.0.pack + + + External Interrupt + Renesas.RA.4.4.0.pack + + + I2C Master Interface + Renesas.RA.4.4.0.pack + + + I/O Port + Renesas.RA.4.4.0.pack + + + Low Power Modes + Renesas.RA.4.4.0.pack + + + Real Time Clock + Renesas.RA.4.4.0.pack + + + SCI UART + Renesas.RA.4.4.0.pack + + + USB Basic + Renesas.RA.4.4.0.pack + + + USB Peripheral Communications Device Class + Renesas.RA.4.4.0.pack + + + USB Composite + Renesas.RA.4.4.0.pack + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +