Avnet RZBOARD V2L User manual

1
Linux Yocto User Manual
v2.1

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 2
Copyright Statement:
•The RzBoard and its related intellectual property are owned by Avnet Manufacturing Services.
•Avnet Manufacturing Services has the copyright of this document and reserves all rights. Any part of
the document should not be modified, distributed or duplicated in any approach and form without the
written permission issued by Avnet Manufacturing Services.
Disclaimer:
•Avnet Manufacturing Services does not take warranty of any kind, either expressed or implied, as to
the program source code, software and documents provided along with the products, and including,
but not limited to, warranties of fitness for a particular purpose; The entire risk as to the quality or
performance of the program is with the user of products.

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 3
Revision History
Rev.
Description
Author
Date
v1.0
Initial version
Lily
2022/9/21
v2.0
Updated Yocto Project to 3.1.14
Lily
2022/09/28
v2.1
Edits to all sections (eliminated non-scripted flash writes)
Peter
2022/10/26

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 4
Contents
Revision History ..................................................................................................................................... 3
Chapter 1 Introduction............................................................................................................................. 6
1.1 Target Board.............................................................................................................................. 6
1.2 Introduction................................................................................................................................ 6
1.3 Feature List ............................................................................................................................... 7
Chapter 2 System Boot-Up ..................................................................................................................... 8
2.1 Preparation and Programming..................................................................................................8
2.1.1 Hardware Preparation.................................................................................................... 8
2.1.2 Software Source Files Preparation................................................................................ 8
2.1.3 Software Tools Preparation............................................................................................ 9
2.1.4 Procedure to Reflash the Bootloader Firmware (eMMC)............................................10
2.1.5 Procedure to Reflash the Linux System Image (eMMC).............................................12
2.2 Booting RZBoard.....................................................................................................................14
2.2.1 Boot from eMMC..........................................................................................................14
2.2.2 Boot using QSPI flash and SD Card ...........................................................................15
2.2.3 How to Program Linux System Image into SDCard ....................................................15
2.2.4 Boot up from QSPI.......................................................................................................16
Chapter 3 Feature Configuration & Introduction ...................................................................................17
3.1 Settings in uEnv.txt..................................................................................................................17
3.2 User LED (RGB)......................................................................................................................18
3.3 Button Switches.......................................................................................................................19
3.4 Display Output.........................................................................................................................20
3.4.1 MIPI-DSI Screen..........................................................................................................20
3.4.2 MIPI To HDMI Screen ..................................................................................................20
3.5 Audio .......................................................................................................................................21
3.5.1 Check Audio Device IDs ..............................................................................................21
3.5.2 Record Audio ...............................................................................................................23
3.5.3 Play Audio File .............................................................................................................24
3.6 Video .......................................................................................................................................25
3.7 Camera....................................................................................................................................26
3.7.1 Enable the CSI-2 Module ............................................................................................26
3.7.2 Select OV5640 Camera and Set its Resolution ..........................................................27
3.7.3 Take Photo ...................................................................................................................27
3.7.4 Record Video ...............................................................................................................28
3.8 Gigabit Ethernet Interface .......................................................................................................28
3.8.1 Network Test ................................................................................................................28
3.8.2 Set Static IP .................................................................................................................28
3.8.3 Set Dynamic IP ............................................................................................................29

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 5
3.9 Storage ....................................................................................................................................30
3.9.1 SD Card .......................................................................................................................30
3.9.2 eMMC ..........................................................................................................................30
3.10 USB 2.0 Interface....................................................................................................................30
3.10.1 USB Host .....................................................................................................................30
3.10.2 USB OTG.....................................................................................................................31
3.11 Wi-Fi ........................................................................................................................................33
3.11.1 Enable Wi-Fi ................................................................................................................33
3.11.2 Connect Wi-Fi ..............................................................................................................33
3.11.3 Wi-Fi Hotspot ...............................................................................................................34
3.12 Bluetooth 5.0 ...........................................................................................................................37
3.12.1 Connect Bluetooth Device ...........................................................................................37
3.12.2 Send Files ....................................................................................................................38
3.13 UARTS ....................................................................................................................................38
3.13.1 UART 2 ........................................................................................................................38
3.14 Pi HAT 40 Pin Expansion Interface .........................................................................................39
3.14.1 GPIO ............................................................................................................................39
3.14.2 SPI ...............................................................................................................................40
3.14.3 CAN..............................................................................................................................41
3.15 DRP-AI ....................................................................................................................................42
3.16 Cortex-M33..............................................................................................................................43
3.17 Procedure to Increase eMMC Partition Size...........................................................................45
Chapter 4 Appendix...............................................................................................................................46
4.1 Hardware Documents .............................................................................................................46
4.2 Software Documents...............................................................................................................46
4.3 Linux System Image and Application Development ...............................................................46
4.3.1 Out of box System Image ............................................................................................46
4.4 Contact Information.................................................................................................................46

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 6
Chapter 1 Introduction
1.1 Target Board
RzBoard V2L is a development board developed by Avnet, based on the RZ/V2L group of 64bit
Arm-based MPUs from Renesas Electronics.
1.2 Introduction
This document provides a guide to prepare RzBoard to boot up with the Verified Linux Package for
RZ/V2L Group and introduces how to use the supported RZBoard functions.

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 7
1.3 Feature List
•Yocto version: Dunfell (3.1.14)
•U-Boot version: 2021.10
•Kernel version: 5.10.83
•Evaluation image: Yocto Image
•QSPI boot / eMMC boot
•Device-tree overlay support
•Desktop (Weston 8.0)
•1 Gigabit Ethernet (RJ45)
•2 x USB 2.0 Host + 1 x USB 2.0 OTG
•2 UART (TTL) include debug port
•External interfaces (I2C, UART, SPI, CANFD and GPIO)
•802.11ac Wi-Fi plus BLE 5.0
•MIPI-DSI display
•Audio playback and record
•MIPI-CSI Camera / USB Camera
•DRP-AI support
•H.264 hardware Enc/Dec support

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 8
Chapter 2 System Boot-Up
2.1 Preparation and Programming
2.1.1 Hardware Preparation
•USB power source with USB type-C cable
•USB to Serial adapter cable
•Ethernet cable
•Connect J19 p2-p4 (TXD,RXD,GND) to the USB to Serial cable, then connect this cable to the PC.
2.1.2 Software Source Files Preparation
The RzBoard uses the files in the Table 2 as bootloader and system images. These can be rebuily using
the procedure described in RzBoard-Linux-Yocto-Lite-Development_Guide-V*.*-EN.pdf
Files
File Name
Description
Flash
Writer
flashwriter_rzboard.mot
FlashWriter image tool, which is used to flash bootloader
images into QSPI or eMMC, can be downloaded from the Host
PC via SCIF by boot ROM
Bootloader
bl2_bp-rzboard.srec
Bootloader image in Motorola S-Record format, ARM
TFA(Trusted Firmware-A ) BL2 image
fip-rzboard.srec
Bootloader image, ARM TFA(Trusted Firmware-A ) BL31 and
u-boot combined image
System
Image
core-image-rzboard-****
**********.rootfs.wic
system image, include linux kernel, DTB and root filesystem,
Need to be written to TF card or eMMC

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 9
Table 1: Image Files
2.1.3 Software Tools Preparation
Install Tera Term terminal software
•For Windows-based write of bootloader images, command-line debug output and command entry,
the use of Tera Term terminal software is recommended
•Download and install teraterm-***.exe and configure the relevant COM port as shown below:
Install Fastboot
Download Fastboot (Windows version) tools from the Android Platform Tools official website.

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 10
2.1.4 Procedure to Reflash the Bootloader Firmware (eMMC)
.BAT File
Name
File
Size
File
Names
Boot Mode
Board Settings
flash_bootloader.bat
Download Type:
SCIF0 @115.2 kb/s
268 KB
115 KB
2.02 MB
flashwriter_RZBoard.mot
bl2_bp-RZBoard.srec
fip-RZBoard.srec
BOOT2=1: Fit fly-wire from J1 pin2 to J19 pin1
BOOT1=0: Set SW1.1 = ON
BOOT0=1: Remove SD card
(Programming bootloader images is less frequently required than updates to the Linux System Image)
Related tools, scripts and relevant information are kept up to date in the following repo:
https://github.com/Avnet/rzboard-program-tools
Simply Download latest image files, .bat and macro files using the following URL:
https://avnet.me/RZBoard_emmc
An easy scripted procedure is provided to program the following pre-built bootloader image files via the
SCIF interface (ie. USB-Serial cable) into QSPI or eMMC flash memory on RZBoard:
•flashwriter_RZBoard.mot FlashWriter image tool
Once downloaded, this is used to program the following two bootloader images into eMMC
•bl2_bp-RZBoard.srec bootloader image in Motorola S-Record format, ARM TFA
(Trusted Firmware-A ) BL2 image
•fip-RZBoard.srec which is a combination of bootloader image, ARM TFA (Trusted Firmware-A )
BL31 and u-boot combined image
Note: Complete steps 1-6 below, prior to running the provided flash_bootloader.bat file (step 7)
1) Download the latest image files, .bat and macro files from https://avnet.me/RZBoard_emmc and
extract the zipped files to a staging folder on the development computer
2) Edit Windows Ethernet network adapter settings for the development computer:
Set it’s IPv4 properties to static IP Address 192.168.1.88
3) In the staging folder, edit the config.ini file (update the COM port#, the IP Address and ensure that
this lists the matching filenames names for Bootloader image files and the Linux System image file)

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 11
4) Power-off RZBoard
5) Place RZBoard into “SCIF download boot-mode” by setting BOOT[2:0] to b101 ie.
•Set BOOT2=1 by strapping J19-pin1 to +5V (ie. connect it to J1-pin2 on the 40pin header)
•Set BOOT1=0 by strapping SW1.1 = ON
•Set BOOT0=1 by removing SD card from MicroSD slot
6) On RZBoard’s J19 Debug UART 4-pin header, connect the fly-leads from the USB-Serial cable
connected to the development computer.
7) Run flash_bootloader.bat (to launch Tera Term macro using the edited config.ini settings)
Choose the media (eMMC or QSPI Flash) to program, the macro then waits for system power up.
8) Press and hold S1 for 2 seconds to power-on RZBoard,
the macro will now proceed. Wait for this to complete (<5 min)

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 12
2.1.5 Procedure to Reflash the Linux System Image (eMMC)
.BAT File
Name
File
Size
File
Names
Boot Mode
Settings
flash_system_image.bat
Download Type:
Ethernet Fastboot @1 Gb/s
2.53 GB
*typical
core-image-RZBoard-2022
0920085823.rootfs.wic
BOOT2=0: Remove fly-wire from
J1 pin2 to J19 pin1
BOOT1=0: Set SW1.1 = ON
BOOT0=1: Remove SD card
A scripted procedure is provided to program the large Linux System Image file, into RZBoard’s
eMMC flash memory, via Gigabit Ethernet from the development computer.
Note: Complete steps 1-6 below, prior to running the provided flash_system_image.bat file:
1) Download the image files, .bat and macro files from https://avnet.me/RZBoard_emmc and
extract the zipped files to a staging folder on the development computer
2) Edit Windows Ethernet network adapter settings for the development computer:
Set it’s IPv4 properties to static IP Address 192.168.1.88
3) Edit the config.ini file (update the COM port#, the IP address and name of the System image file)
4) Power-off RZBoard
5) Place RZBoard into “eMMC (1V8) boot-mode” by setting BOOT[2:0] to b001 (as tabled above), ie.
•Set BOOT2=0 by removing fly-wire from J19-pin1 to J1-pin2 (40pin header)
•Set BOOT1=0 by strapping SW1.1 = ON
•Set BOOT0=1 by removing SD card from MicroSD slot
6) Run flash_system_image.bat (launches Tera Term macro using saved config.ini settings)

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 13
7) Power-on RZBoard. Ethernet connetion will be established and a blue window shall open in <30 sec.
8) Wait for the macro to complete (typically 15 blocks of data get sent and this completes in <5 min).
No input or operation is required during this period. After finishing, press any key to exit the BAT
script.
9) Now set RzBoard to boot from QSPI or eMMC as needed and power-cycle the board using switch S1.

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 14
2.2 Booting RZBoard
RzBoard supports Linux boot from eMMC or SD card.
Before attempting to boot Linux system image from eMMC make sure the SDCard is not in the slot.
Two different methods of booting RZBoard are described in this section:
a) Booting u-boot and the Linux System image from eMMC
b) Booting u-boot from QSPI flash, booting Linux system image from SD card
For development, booting u-boot from QSPI flash, then using NFS (network file system) located on the
development PC (via network Ethernet connection) will be detailed in a later version of this document.
2.2.1 Boot from eMMC
The least complex method, where u-boot and the Linux system image are booted from eMMC memory.
After writing bootloader and linux system images into eMMC, boot RzBoard from eMMC as follows:
•Connect Boot2 (Pin1 of J19) to GND, Dial out SD card, Set SW1 as shown below:
•Connect suitable 5V power source to RZBoard via the J10 USB type-C connector.
•Press and hold Power button S1 for 2 seconds to power-on the system.
•When the system boots-up, the serial terminal will print the following information:
Welcome to rzboard Board GNU/Linux yocto(dunfell) system.
rzboard login:
•Enter username as “root”, password as “avnet” to login.
•The Linux system interface also supports directly attached keyboard and mouse

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 15
2.2.2 Boot using QSPI flash and SD Card
Booting u-boot from QSPI flash is typically when the Linux System image is on SD card or when NFS
(network file system) is used. To boot RzBoard from QSPI flash, the two bootloader images
(bl2_bp-rzboard.srec and fip-rzboard.srec) need to have been written into it, using the scripted Flash
Writer procedure (as described earlier in this chapter)
2.2.3 How to Program Linux System Image into SDCard
Under Windows OS, Win32 Disk Imager tool is used to write Linux system image into the SDcard.
•Insert the SD card into the card reader, then connect the card reader to the USB port on the PC.
•Open Win32 Disk Imager on the PC, Select the Disk Image, then click “Write”.
•Wait for completion of the write operation…

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 16
2.2.4 Boot up from QSPI
•Connect Boot2 of J19 to GND, Insert the SDcard, Set SW1 as shown below:
•Power on the board with a 5V, 2A, Type-C interface power (to J10).
•Press Power button S1 for 2 seconds and system will power on.
•When the system boot up, the serial terminal will print the following information:
Poky (Yocto Project Reference Distro) 3.1.14 rzboard ttySC0
rzboard login:
•Enter username as “root”, password as “avnet” to login.
•Users can also use keyboard and mouse connected to RzBoard to login to Linux.

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 17
Chapter 3 Feature Configuration & Introduction
In this chapter, we mainly introduce the features of RzBoard. First of all, please refer to
RzBoard-Start-up-Guide-V*.*.pdf and boot up the system refer to the previous chapter.
Configure or use the functions according to the following guidance.
3.1 Settings in uEnv.txt
User could configure some environment variables in uEnv.txt, which can be loaded in the U-boot stage.
The uEnv.txt file has a very simple file format. The format is a single property=value statement on each
line, where value is either an integer or a string. Comments may be added, or existing config values may
be commented out and disabled, by starting a line with the # character.
The device-tree overlay function is supported from this version and the device-tree overlay file (*.dtbo) is
placed in the overlay/ directory in the FAT partition of the SDIO card or eMMC. To load the device-tree
overlay file (*.dtbo), you need to set "fdt_extra_overlays" and "enable_overlay_" prefix variable in uEnv.txt.
You can also add other configurations defined in u-boot to the uEnv.txt file.
The specific description is as follows:
Note: fdtfile must be set to a device tree binary blob, which is the basis for applying dtbo file.
fdtfile should be set, other configurations are optional.

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 18
Here is the default setting in uEnv.txt:
fdtfile=rzboard.dtb
enable_overlay_disp=hdmi
#fdt_extra_overlays=1.dtbo 2.dtbo 3.dtbo
#ethaddr=aa:bb:cc:aa:bb:cc
Modify uEnv.txt methods:
We can find uEnv.txt in /boot, then use nano or vi command to edit the uEnv.txt.
root@rzboard:~# cd /boot
root@rzboard:/boot# ls
Image cm33 overlays readme.txt rzboard.dtb uEnv.txt
root@rzboard:/boot# vi uEnv.txt
We can edit the uEnv.txt as needed and save it.
# Refer to readme.txt for more information on setting up U-Boot Env
fdtfile=rzboard.dtb
enable_overlay_disp=hdmi
#fdt_extra_overlays=1.dtbo 2.dtbo 3.dtbo
#ethaddr=aa:bb:cc:aa:bb:cc
After the modification, execute sync and reboot command to make it effect.
3.2 User LED (RGB)
RzBoard has a tri-color RGB LED indicator available for user-defined functions.
It flashes blue to indicate heartbeat by default, but this LED can be controlled using follow commands:
LED output blue:
root@rzboard:~# echo default-on > /sys/class/leds/led_blue/trigger
root@rzboard:~# echo 0 > /sys/class/leds/led_blue/brightness
root@rzboard:~# echo heartbeat > /sys/class/leds/led_blue/trigger
LED output red:
root@rzboard:~# echo 0 > /sys/class/leds/led_blue/brightness
root@rzboard:~# echo 1 > /sys/class/leds/led_red/brightness
root@rzboard:~# echo 0 > /sys/class/leds/led_red/brightness

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 19
LED output green:
root@rzboard:~# echo 0 > /sys/class/leds/led_blue/brightness
root@rzboard:~# echo 1 > /sys/class/leds/led_green/brightness
root@rzboard:~# echo 0 > /sys/class/leds/led_green/brightness
3.3 Button Switches
There are two push-button switches on RzBoard, S1 is the power button and S2 is the user button.
We can use following procedure to test these button switches.
Test PWR button S1
When system is on, press PWR button S1 for 3 seconds, the system will shut down.
Press the PWR button S1 again for 3 seconds and the system will reboot.
Test USER button S2
root@rzboard:~# evtest
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event0: keys
Select the device event number [0-0]: 0
Input driver version is 1.0.1
Input device ID: bus 0x19 vendor 0x1 product 0x1 version 0x100
Input device name: "keys"
Supported events:
Event type 0 (EV_SYN)
Event type 1 (EV_KEY)
Event code 2 (KEY_1)
Properties:
Testing ... (interrupt to exit)
Event: time 1600620566.1600620566, type 1 (EV_KEY), code 2 (KEY_1), value 1
Event: time 1600620566.1600620566, -------------- SYN_REPORT ------------
Event: time 1600620566.1600620566, type 1 (EV_KEY), code 2 (KEY_1), value 0
Event: time 1600620566.1600620566, -------------- SYN_REPORT ------------
Event: time 1600620570.1600620570, type 1 (EV_KEY), code 2 (KEY_1), value 1
Event: time 1600620570.1600620570, -------------- SYN_REPORT ------------
Event: time 1600620570.1600620570, type 1 (EV_KEY), code 2 (KEY_1), value 0
Event: time 1600620570.1600620570, -------------- SYN_REPORT ------------
Event: time 1600620606.1600620606, type 1 (EV_KEY), code 2 (KEY_1), value 1

RzBoard-Linux-Yocto-User-Manual-v2.1
https://www.avnet.me/rzboard 20
Event: time 1600620606.1600620606, -------------- SYN_REPORT ------------
Event: time 1600620606.1600620606, type 1 (EV_KEY), code 2 (KEY_1), value 0
Event: time 1600620606.1600620606, -------------- SYN_REPORT ------------
Event: time 1600620609.1600620609, type 1 (EV_KEY), code 2 (KEY_1), value 1
Event: time 1600620609.1600620609, -------------- SYN_REPORT ------------
Use “Ctrl+C” to exit this test.
3.4 Display Output
RzBoard supports MIPI-DSI and HDMI screen.
Users can connect the screen to the board before boot up the system according to the following table.
When the system boot up, the screen will print the related startup message and login UI. Users can
connect keyboard to login the RzBoard file system.
Screen Type
Screen Resolution
Interface
MIPI-DSI
720*1280
J5 (MIPI-DSI)
MIPI to HDMI
Adjust to the screen size
J13 (microHDMI)
3.4.1 MIPI-DSI Screen
If you choose MIPI-DSI display and it’s model# is PH720128T003, you should edit uEnv.txt as follows:
#enable_overlay_disp=mipi
fdt_extra_overlays=rzboard-mipi-ph720128t003.dtbo
If you choose MIPI-DSI display and it’s model# is PH720128T005, you should edit uEnv.txt as follows:
enable_overlay_disp=mipi
#fdt_extra_overlays=1.dtbo 2.dtbo 3.dtbo
MIPI-DSI supports adjustment of the LCD backlight brightness. The backlight brightness has a range from
0 to 9, where 9 is highest brightness, 0 is the lowest.
Execute the following instructions on the serial terminal to implement the backlight test:
root@rzboard:~# echo 7 > /sys/class/backlight/backlight/brightness
3.4.2 MIPI To HDMI Screen
RzBoard also supports MIPI to HDMI screen, Choose MIPI to HDMI screen, the enable_overlay_disp
value should be:
enable_overlay_disp=hdmi