boards/renesas/rzg2lc_smarc/doc/index.rst
.. zephyr:board:: rzg2lc_smarc
Overview
The Renesas RZ/G2LC SMARC Evaluation Board Kit (RZ/G2LC-EVKIT) consists of a SMARC v2.1 module board and a carrier board.
Device: RZ/G2LC R9A07G044C22GBG
SMARC v2.1 Module Board Functions
5P35023 <https://www.renesas.com/en/products/clocks-timing/clock-generation/programmable-clocks/5p35023-versaclock-3s-programmable-clock-generator>_ implementedRAA215300 <https://www.renesas.com/en/products/power-management/multi-channel-power-management-ics-pmics/raa215300-high-performance-9-channel-pmic-supporting-ddr-memory-built-charger-and-rtc>_ implementedCarrier Board Functions
Hardware
The Renesas RZ/G2LC MPU documentation can be found at RZ/G2LC Group Website_
.. figure:: rzg2lc_block_diagram.webp :width: 600px :align: center :alt: RZ/G2LC group feature
RZ/G2LC block diagram (Credit: Renesas Electronics Corporation)
.. zephyr:board-supported-hw::
Programming and Debugging
Applications for the rzg2lc_smarc board can be built in the usual way as
documented in :ref:build_an_application.
The UART port for Cortex-M33 System Core can be accessed by connecting Pmod USBUART <https://store.digilentinc.com/pmod-usbuart-usb-to-uart-interface/>_
to the upper side of PMOD 1.
It is possible to load and execute a Zephyr application binary on
this board on the Cortex-M33 System Core from
the internal SRAM, using JLink debugger (:ref:jlink-debug-host-tools).
Here is an example for building and debugging with the :zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: rzg2lc_smarc/r9a07g044c22gbg/cm33 :goals: build debug
RZ/G2LC-EVKIT is designed to start different systems on different cores. It uses Yocto as the build system to build Linux system and boot loaders to run Zephyr on Cortex-M33 with u-boot. The minimal steps are described below.
Follow "2.2 Building Images" of SMARC EVK of RZ/G2L, RZ/G2LC, RZ/G2UL Linux Start-up Guide_ to prepare the build environment.
At step (4), follow step "2. Download Multi-OS Package" and "3. Add the layer for Multi-OS Package"
of "3.2 OpenAMP related stuff Integration for RZ/G2L, RZ/G2LC and RZ/G2UL" of Release Note for RZ/G Multi-OS Package V2.0.2_
to add the layer for Multi-OS Package.
.. code-block:: console
$ cd ~/rzg_vlp_<pkg ver> $ unzip <Multi-OS Dir>/r01an5869ej0202-rzg-multi-os-pkg.zip $ tar zxvf r01an5869ej0202-rzg-multi-os-pkg/meta-rz-features_multi-os_v2.0.2.tar.gz $ bitbake-layers add-layer ../meta-rz-features/meta-rz-multi-os/meta-rzg2l
Start the build:
.. code-block:: console
$ MACHINE=smarc-rzg2lc bitbake core-image-minimal
The below necessary artifacts will be located in the build/tmp/deploy/images
+---------------+------------------------------------------------------+ | Artifacts | File name | +===============+======================================================+ | Boot loader | bl2_bp-smarc-rzg2lc.srec | | | | | | fip-smarc-rzg2lc.srec | +---------------+------------------------------------------------------+ | Flash Writer | Flash_Writer_SCIF_RZG2LC_SMARC_DDR4_1GB_1PCS.mot | +---------------+------------------------------------------------------+
Follow "4.2 Startup Procedure" of SMARC EVK of RZ/G2L, RZ/G2LC, RZ/G2UL Linux Start-up Guide_ for power supply and board setting
at SCIF download (SW11[1:4] = OFF, ON, OFF, ON) and (SW1[1:2] = ON, OFF)
Follow "4.3 Download Flash Writer to RAM" of SMARC EVK of RZ/G2L, RZ/G2LC, RZ/G2UL Linux Start-up Guide_ to download Flash Writer to RAM
Follow "4.4 Write the Bootloader" of SMARC EVK of RZ/G2L, RZ/G2LC, RZ/G2UL Linux Start-up Guide_ to write the boot loader
to the target board by using Flash Writer.
Follow "4.5 Change Back to Normal Boot Mode" with switch setting (SW11[1:4] = OFF, OFF, OFF, ON) and (SW1[1:2] = ON, OFF)
Follow "3. Preparing the SD Card" of SMARC EVK of RZ/G2L, RZ/G2LC, RZ/G2UL Linux Start-up Guide_ to write files to the microSD Card
Copy zephyr.bin file to microSD card
Follow "4.4.2 CM33 Sample Program Invocation with u-boot" from the beginning to step 4 of Release Note for RZ/G Multi-OS Package V2.0.2_
Execute the commands stated below on the console to start zephyr application with CM33 core. Here, ''N'' stands for the partition number in which you stored zephyr.bin file.
.. code-block:: console
Hit any key to stop autoboot: 2
=> dcache off
=> mmc dev 1
=> fatload mmc 1:N 0x00010000 zephyr.bin
=> fatload mmc 1:N 0x40010000 zephyr.bin
=> cm33 start_normal 0x00010000 0x40010000
=> dcache on
References
.. target-notes::
.. _RZ/G2LC Group Website: https://www.renesas.com/en/products/microcontrollers-microprocessors/rz-mpus/rzg2lc-general-purpose-mcus-dual-core-arm-cortex-a55-12ghz-cpus-and-single-core-arm-cortex-m33-200mhz-cpu
.. _RZG2LC-EVKIT Website: https://www.renesas.com/en/products/microcontrollers-microprocessors/rz-mpus/rzg2lc-evkit-evaluation-board-kit-rzg2lc-mpu
.. _SMARC EVK of RZ/G2L, RZ/G2LC, RZ/G2UL Linux Start-up Guide: https://www.renesas.com/en/document/gde/smarc-evk-rzg2l-rzg2lc-rzg2ul-linux-start-guide-rev105
.. _Release Note for RZ/G Multi-OS Package V2.0.2: https://www.renesas.com/us/en/document/rln/release-note-rzg-multi-os-package-v202