Table of Contents
Advertisement
Quick Links
SMARC EVK of RZ/Five
Linux Start-up Guide
Introduction
This document provides a guide to prepare RZ/Five reference boards to boot up with the Verified Linux Package.
This guide provides the following information:
Building procedure
•
Preparation for use
•
•
Boot loader and U-Boot
•
How to run this Linux package on the target board
How to create a software development kit (SDK)
•
Target Reference Board
RZ/Five reference board
RZ/Five Evaluation board Kit (smarc-rzfive) (*1)
•
RZ/Five SMARC Module Board (P/N: RTK9743F01C01000BE)
o
RZ SMARC Series Carrier Board (P/N: RTK97X4XXXB00000BE)
o
(*1)
"RZ/Five Evaluation board Kit" includes the RZ/Five SMARC Module Board and the RZ SMARC Series
Carrier Board.
The "Evaluation board Kit for RZ/Five MPU" will be called "RZ/Five Evaluation Kit" in the next section.
Target Software
•
RZ/Five Verified Linux Package version 3.0.5 or later. (hereinafter referred to as "VLP/F")
R01US0618EJ0101 Rev.1.01
Oct. 31, 2023
R01US0618EJ0101
Rev.1.01
Oct. 31, 2023
Page 1 of 41
Advertisement
Table of Contents
Related Manuals for Renesas RZ/Five
Summary of Contents for Renesas RZ/Five
- Page 1 R01US0618EJ0101 Rev.1.01 Linux Start-up Guide Oct. 31, 2023 Introduction This document provides a guide to prepare RZ/Five reference boards to boot up with the Verified Linux Package. This guide provides the following information: Building procedure • Preparation for use •...
-
Page 2: Table Of Contents
SMARC EVK of RZ/Five Linux Start-up Guide Contents Environment Requirement ..................... 4 Build Instructions ......................6 Notes ............................9 Preparing the SD Card ....................12 Write files to the microSD card (used wic image)..............12 Write files to the microSD card (not used wic image) ............14 3.2.1... - Page 3 SMARC EVK of RZ/Five Linux Start-up Guide Website and Support ......................42 R01US0618EJ0101 Rev.1.01 Page 3 of 41 Oct. 31, 2023...
-
Page 4: Environment Requirement
A Windows PC can be used as the serial terminal interface with software such as TeraTerm. Figure 1 Recommend environment Note: The board shown in Figure 1 is RZ/V2L, but RZ/Five has the same structure. R01US0618EJ0101 Rev.1.01 Page 4 of 41... - Page 5 SMARC EVK of RZ/Five Linux Start-up Guide Table 1. Equipment and Software for Developing Environments of RZ/Five Linux Platform Equipment Description Linux Host PC Used as build/debug environment 100GB free space on HDD or SSD is necessary Ubuntu 20.04 LTS 64 bit OS must be used.
-
Page 6: Build Instructions
$ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" Copy all files obtained from Renesas into your Linux Host PC prior to the steps below. The directory which you put the files in is described as <package download directory>... - Page 7 VLP/F was verified. If you are just evaluating VLP/F and RZ/Five series, open source software packages are not mandatory to use. Usually, all the software can be built without using these files if your build machine is connected to the Internet.
- Page 8 Table 2. Supported images of VLP/F Image name Purpose core-image-minimal Minimal set of components core-image-bsp Minimal set of components plus audio support and some useful tools Table 3. Image files for RZ/Five RZ/Five Linux kernel Image-smarc-rzfive.bin Device tree file Image-r9a07g043f01-smarc.dtb root filesystem <image...
-
Page 9: Notes
SMARC EVK of RZ/Five Linux Start-up Guide 2.2 Notes GPLv3 packages In this release, the GPLv3 packages are disabled as default in build/conf/local.conf: INCOMPATIBLE_LICENSE = "GPLv3 GPLv3+" If you want to use GPLv3, just hide this line: #INCOMPATIBLE_LICENSE = "GPLv3 GPLv3+"... - Page 10 The name “WIC” is derived from OpenEmbedded Image Creator (oeic). It includes image that system can boot it in hardware device. From VLP/G v3.0.5, WIC is supported and below guidelines are shown how to use it to boot Renesas RZ/Five devices. •...
- Page 11 SMARC EVK of RZ/Five Linux Start-up Guide Software bill of materials (SBoM) Software package data exchange (SPDX) is an open standard for SBoM that identifies and catalogs components, licenses, copyrights, security references, and other metadata relating to software. From VLP/G v3.0.5, creating SPDX is supported and below guidelines are shown how to use it: Enable creating SPDX in local.conf (default is disabled) by uncommenting out below line:...
-
Page 12: Preparing The Sd Card
SMARC EVK of RZ/Five Linux Start-up Guide Preparing the SD Card You can prepare the microSD card by the following 2 methods. Please select one of them and follow the steps. - 3.1 Write files to the microSD card (used wic image) - 3.2 Write files to the microSD card (not used wic image) - Page 13 SMARC EVK of RZ/Five Linux Start-up Guide Table 5. File and directory in the micro SD card Type/Number Contents Filesystem Primary #1 FAT32 Flash_Writer_SCIF_RZFIVE_SMARC.mot fit-smarc-rzfive.srec spl-smarc-rzfive.srec Primary #2 Ext4(*1) ├── bin ├── boot ├─Image └─r9a07g043f01-smarc.dtb ├── dev ├── etc ├── home ├──...
-
Page 14: Write Files To The Microsd Card (Not Used Wic Image)
SMARC EVK of RZ/Five Linux Start-up Guide 3.2 Write files to the microSD card (not used wic image) 3.2.1 Create a microSD card for boot Linux To boot from SD card, over 4GB capacity of blank SD card is needed. You can use Linux Host PC to expand the kernel and the rootfs using USB card reader or other equipment. - Page 15 SMARC EVK of RZ/Five Linux Start-up Guide (5) Change the partition table microSD card needs two partitions as listed in Table 6 . Table 6. Partitions of microSD card Type/Number Contents Size Filesystem Primary #1 500MB (minimum 128MB) FAT32 Linux kernel...
- Page 16 SMARC EVK of RZ/Five Linux Start-up Guide Disk identifier: 0x6b6aac6e Device Boot Start Sectors Size Id Type /dev/sdb1 2048 1026047 1024000 500M 83 Linux /dev/sdb2 1026048 62333951 61307904 29.2G 83 Linux Filesystem/RAID signature on partition 1 will be wiped. Command (m for help):...
- Page 17 SMARC EVK of RZ/Five Linux Start-up Guide (6) Format and mount the partitions If the partitions were automatically mounted after the step (4), please unmount them according to the step (3). Then format the partitions using the command below: $ sudo mkfs.vfat -v -c -F 32 /dev/sdb1 mkfs.fat 4.1 (2017-01-24)
-
Page 18: Write Files To The Microsd Card
510968 1% /media/user/A299-E6A6 /dev/sdb2 30041556 45080 28447396 1% /media/user/rootfs When you use RZ/Five Evaluation board Kit, copy kernel and device tree file to the first partition like as below. $ cp $WORK/build/tmp/deploy/images/smarc-rzfive/<Linux kernel> /media/user/A299-E6A6 $ cp $WORK/build/tmp/deploy/images/smarc-rzfive/<Devise tree> /media/user/A299-E6A6 When you use RZ/Five Evaluation board Kit, expand rootfs to the second partition like as below. -
Page 19: Reference Board Setting
SMARC EVK of RZ/Five Linux Start-up Guide Reference Board Setting 4.1 Preparation of Hardware and Software The following environment of Hardware and Software is used in the evaluation. Hardware preparation (Users should purchase the following equipment.): USB Type-C cable compatible with USB PD. (e.g. AK-A8485011 (manufactured by Anker)) •... -
Page 20: How To Set Boot Mode And Input Voltage
4.1.1 How to set boot mode and input voltage Please set the SW11 settings as follows. Pin no1 to no3 of the SW11 is used to control boot mode of RZ/Five. • • Pin no4 of the SW11 is used to control the input voltage from power charger to 5V or 9V. Please use a 5V setting as initial setting. -
Page 21: How To Set Sw1
Please set the SW1 settings to follows. The SW1-1 is used to select the JTAG debug mode or not. • JTAG is not used to in the procedure for booting up RZ/Five Group Board Support Package, so please set SW1-1 to normal operation mode. •... -
Page 22: Power Supply
SMARC EVK of RZ/Five Linux Start-up Guide Startup Procedure 4.1.4 Power supply Connect USB-PD Power Charger to USB Type-C Connector (CN6). LED1(VBUS Power ON) and LED3 (Module PWR On) lights up. 1. Connect USB Type- C cable to CN6 2. LED1(VBUS PWR On) -
Page 23: Building Files To Write
SMARC EVK of RZ/Five Linux Start-up Guide 4.1.5 Building files to write The evaluation boards use the files in the Table 8 as the boot loaders. The boot loaders files are generated by the build instruction in the section 2. Please refer to the Table 3. Please copy these files to a PC which runs serial terminal software. - Page 24 SMARC EVK of RZ/Five Linux Start-up Guide To set the board to SCIF Download mode, set the SW11 as below: Table 9. SW11 R01US0618EJ0101 Rev.1.01 Page 24 of 41 Oct. 31, 2023...
- Page 25 SMARC EVK of RZ/Five Linux Start-up Guide After finished all settings, when pressed the reset button SW10, the messages below are displayed on the terminal. 4. Press the Blue button (RESET) Figure 6. Press the RESET button R01US0618EJ0101 Rev.1.01 Page 25 of 41...
-
Page 26: Download Flash Writer To Ram
SMARC EVK of RZ/Five Linux Start-up Guide 4.2 Download Flash Writer to RAM Turn on the power of the board by pressing SW9. The messages below are shown on the terminal. SCIF Download mode (C) Renesas Electronics Corp. -- Load Program to SystemRAM --------------- please send ! Send an image of Flash Writer (Flash_Writer_SCIF_RZFIVE_SMARC.mot) using terminal software after the message... - Page 27 The image will be sent to the board via serial connection. After successfully downloading the binary, Flash Writer starts automatically and shows a message like below on the terminal. Flash writer for RZ/Five Series V1.02 Nov.15,2021 Product Code : RZ/Five >...
-
Page 28: Write The Bootloader
Flash ROM with information where the data should be loaded on the address of the main memory. For example, this part describes how to write boot loader files in the case of RZ/Five Evaluation Board Kit PMIC version.: >XLS2... - Page 29 SMARC EVK of RZ/Five Linux Start-up Guide Send the data of “fit-smarc-rzfive.srec” from terminal software after the message “please send !” is shown. After successfully download the binary, messages like below are shown on the terminal. SPI Data Clear(H'FF) Check :H'00000000-0000FFFF Erasing..Erase Completed SAVE SPI-FLASH..
-
Page 30: Change Back To Normal Boot Mode
SMARC EVK of RZ/Five Linux Start-up Guide 4.4 Change Back to Normal Boot Mode To set the board to SPI Boot mode, set the SW11 as below: Table 11. SW11 Note:- Set the SW1 on SoM module to eMMC mode. - Page 31 In case booting from microSD card on SMARC carrier board, set environment variables using the commands below. The commands below are for the RZ/Five board. Please replace the file names in “bootcmd” according to the Release Note when you use other boards.
-
Page 32: Booting And Running Linux
SMARC EVK of RZ/Five Linux Start-up Guide Booting and Running Linux Set microSD card to slot on carry board. Figure 7.Set microSD card to SMARC-EVK Now the board can bootup normally. Please turn off and on the power again to boot up the board. -
Page 33: Shutdown The Board
SMARC EVK of RZ/Five Linux Start-up Guide Booting using the fdt blob at 0x48000000 Loading Device Tree to 0000000057ff7000, end 0000000057fff91a ... OK Starting kernel ... 0.000000] Booting Linux on physical CPU 0x0000000000 [0x412fd050] 0.000000] Linux version 5.10.83-cip1-yocto-standard (oe-user@oe-host) (aarc oky (Yocto Project Reference Distro) 3.1.17 smarc-rzfive ttySC0... -
Page 34: Building The Sdk
SMARC EVK of RZ/Five Linux Start-up Guide Building the SDK To build Software Development Kit (SDK), run the commands below after the steps (1) – (5) of the section 2 are finished. The SDK allows you to build custom applications outside of the Yocto environment, even on a completely different PC. -
Page 35: Application Building And Running
Linux Start-up Guide Application Building and Running This chapter explains how to make and run an application for RZ/Five with this package. 7.1 Make an application Here is an example of how to make an application running on VLP. The following steps will generate the “Hello World”... - Page 36 SMARC EVK of RZ/Five Linux Start-up Guide # /usr/share/linux-helloworld/linux-helloworld How to extract SDK Step 1. Make a work directory for the application on the Linux host PC. $ mkdir ~/linux-helloworld $ cd ~/linux-helloworld Step 2. Make the following three files (an application file, Makefile, and configure file) in the directory for the application.
-
Page 37: Run A Sample Application
Notes: 1. “sdb2” (above in red) may depend on using system. 2. is an optional directory name to store the application. 7.2 Run a sample application Power on the RZ/Five Evaluation Board Kit and start the system. After booting, run the sample application with the following command. BSP: RZFIVE/RZFIVE-SMARC-EVK/<package version>... -
Page 38: Appendix
Flash Writer is built automatically when building BSP by bitbake command. Please refer to the Release Note of the RZ/Five BSP to obtain a binary file of Flash Writer. If you need latest one, please get source code from the GitHub repository and build it according to the following instructions. -
Page 39: How To Replace The Smarc Module Board
SMARC EVK of RZ/Five Linux Start-up Guide 8.2 How to replace the SMARC Module Board Please be careful when replacing the board as follows. Remove the four screws. Note: The screw thread is a special shape, so be careful not to crush the screw thread. -
Page 40: Device Drivers
The following drivers are supported: For detail information on how to use, please refer to these documents in the BSP manual set. File Description RTK0EF0045Z9006AZJ-v3.0.x.zip BSP Manual Set for RZ/Five. Note) “x” is the version of the file. Please refer to the latest one. Table 12. Support device drivers Device Driver... -
Page 41: Revision History
SMARC EVK of RZ/Five Linux Start-up Guide Revision History Description Rev. Date Page Summary 1.00 Jun. 30, 2023 First edition issued. R01US0618EJ0101 Rev.1.01 Page 41 of 41 Oct. 31, 2023... - Page 42 SMARC EVK of RZ/Five Linux Start-up Guide Website and Support Renesas Electronics Website http://www.renesas.com/ Inquiries http://www.renesas.com/contact/ All trademarks and registered trademarks are the property of their respective owners. R01US0618EJ0101 Rev.1.01 Page 42 of 41 Oct. 31, 2023...