boards/renesas/rzv2l_smarc/doc/index.rst
.. zephyr:board:: rzv2l_smarc
Overview
The Renesas RZ/V2L SMARC Evaluation Board Kit (RZ/V2L-EVKIT) consists of a SMARC v2.1 module board and a carrier board.
Device: RZ/V2L R9A07G054L23GBG
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
MIPI Camera Module
Hardware
The Renesas RZ/V2L MPU documentation can be found at RZ/V2L Group Website_
.. figure:: rzv2l_block_diagram.webp :width: 600px :align: center :alt: RZ/V2L group feature
RZ/V2L block diagram (Credit: Renesas Electronics Corporation)
Detailed hardware features for the board can be found at RZV2L-EVKIT Website_
Multi-OS processing
The RZ/V2L-EVKIT allows different applications to be executed in RZ/V2L SoC. With its multi-core architecture,
each core can operate independently to perform customized tasks or exchange data using the OpenAMP framework.
Please see :zephyr:code-sample:rz-openamp-linux-zephyr sample for reference.
.. zephyr:board-supported-hw::
Programming and Debugging
.. zephyr:board-supported-runners::
Applications for the rzv2l_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: rzv2l_smarc/r9a07g054l23gbg/cm33 :goals: build debug
RZ/V2L-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/V2L 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 Integration of OpenAMP related stuff'' of RZ/V2L Quick Start Guide for RZ/V Multi-OS Package_
to add the layer for Multi-OS Package.
.. code-block:: console
$ cd ~/rzv_vlp_<pkg ver> $ unzip <Multi-OS Dir>/r01an7254ej0311-rzv-multi-os-pkg.zip $ tar zxvf r01an7254ej0311-rzv-multi-os-pkg/meta-rz-features_multi-os_v3.1.1.tar.gz $ cd build $ bitbake-layers add-layer ../meta-rz-features/meta-rz-multi-os/meta-rzv2l
.. code-block:: console
$ MACHINE=smarc-rzv2l 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-rzv2l_pmic.srec | | | | | | fip-smarc-rzv2l_pmic.srec | +---------------+------------------------------------------------------+ | Flash Writer | Flash_Writer_SCIF_RZV2L_SMARC_PMIC_DDR4_2GB_1PCS.mot | +---------------+------------------------------------------------------+
Follow ''4.2 Startup Procedure'' of SMARC EVK of RZ/V2L 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/V2L Linux Start-up Guide_ to download Flash Writer to RAM
Follow ''4.4 Write the Bootloader'' of SMARC EVK of RZ/V2L 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/V2L Linux Start-up Guide_ to write files to the microSD Card
Copy zephyr.bin file to microSD card
Follow "4.3.2 CM33 Sample Program Invocation with u-boot" from the beginning to step 4 of RZ/V2L Quick Start Guide for RZ/V Multi-OS Package_
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/V2L Group Website: https://www.renesas.com/en/products/rz-v2l
.. _RZV2L-EVKIT Website: https://www.renesas.com/en/design-resources/boards-kits/rz-v2l-evkit
.. _SMARC EVK of RZ/V2L Linux Start-up Guide: https://www.renesas.com/en/document/gde/rzv2l-linux-start-guide-rev105
.. _RZ/V2L Quick Start Guide for RZ/V Multi-OS Package: https://www.renesas.com/en/document/apn/rzv2l-quick-start-guide-rzv-multi-os-package-v311