Getting Started¶

This page explains how to start-up the Renesas RZ Linux BSP Plus.

Introduction¶

Getting Started explains the instruction to run the Renesas RZ Linux BSP Plus.

Common instructions are explained in this document.

Step 1: Obtain an evaluation board¶

Click the button below to get the board.

Board
Get the board for RZ MPUs.

Step 2: Obtain necessary environment¶

1. Necessary Equipment¶

Please prepare the following equipment for your EVK.

2. Necessary Software¶

Please install following software on Linux PC.

• git

Step 3: Obtain and Build Renesas RZ Linux BSP Plus source code¶

Please refer to How To Build Linux BSP Plus.

Step 4: Deploy Renesas RZ Linux BSP Plus¶

You can prepare the microSD card by the following method. Please select one of them and follow the steps.

Below steps are for wic image.

1. In case of Windows PC¶

1. Download or copy the release package into your PC
2. Unzip the release package and extract an image file

3. Write the image file to your micro SD card by using one of the following tool

   • Win32 Disk Imager
   • balenaEtcher
   RZ/G2L

   Image file is:

   • <image name>-smarc-rzg2l.rootfs.wic.gz

   Note

   Where <image name> is one of the following:

   • core-image-minimal
   • core-image-weston

   Caution

   Even if you see a message such as you need to format the disk before/after writing the image, do not format the SD card.

2. In case of Linux PC (Ubuntu)¶

1. Download or copy the release package into your PC
2. Unzip the release package and extract an image file

3. Insert the micro SD Card into your Linux PC and find the device name of the SD card

   Use lsblk command to check the device name as follows.

   • Before inserting the SD card

     lsblk
     

     NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
         (snip)
     nvme0n1     259:0    0 465.8G  0 disk
     ├─nvme0n1p1 259:1    0   512M  0 part /boot/efi
     └─nvme0n1p2 259:2    0 465.3G  0 part /
     

   • After inserting the SD card

     lsblk
     

     NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
         (snip)
     nvme0n1     259:0    0 465.8G  0 disk
     ├─nvme0n1p1 259:1    0   512M  0 part /boot/efi
     └─nvme0n1p2 259:2    0 465.3G  0 part /
     sda           8:0    1  14.5G  0 disk
     ├─sda1        8:1    1   500M  0 part /media/user/boot
     └─sda2        8:2    1   3.4G  0 part /media/user/rootfs
     

   Note

   The device name is assigned to the SD card by Linux on your Host PC. It may be named /dev/sd* (* is a letter representing the physical drive). It is /dev/sda in this sample.

4. Unmount the SD card if it is mounted

   Use umount command with mount points that are displayed when you executed lsblk command. For example:

   umount /media/user/boot
   umount /media/user/rootfs
   

5. Write the image to the SD card

   Use bmaptool command with device name of SD card is displayed when you executed lsblk command. For example:

   sudo bmaptool copy <wic image>.wic.gz /dev/sda
   

   RZ/G2L

   Image file is:

   • <image name>-smarc-rzg2l.rootfs.wic.gz

   Note

   Additionally, the file below is also required:

   • <image name>-smarc-rzg2l.rootfs.wic.bmap

   Note

   Where <image name> is one of the following:

   • core-image-minimal
   • core-image-weston

Step 5: Reference Board Setting¶

1. Setup EVK's peripheral¶

Please setup following below diagram.

2. EVK's DIP switch¶

3. Prepare for Flashing Boot Loader into EVK¶

Connect the board to the programing PC by using the USB serial cable.

1. Bring up TeraTerm and select the File > New Connection to set the connection on the software.

   

2. Select the Setup > Serial port to set the settings about serial communication protocol on TeraTerm.

   Set the settings for the serial communication in TeraTerm as below:

   Variable	Value
   Baud rate	115200 bps
   Data	8 bit
   Parity	none
   Stop	1 bit
   Flow control	none

   

3. Select the Setup > Terminal to set the new-line code.

   Variable	Value
   New-line	CR or AUTO

   

4. To set the board to SCIF Download mode, set the SW11 as below.

   

   SW11-1	SW11-2	SW11-3	SW11-4
   OFF	ON	OFF	ON

5. After finishing all settings, when the reset button SW10 is pressed, the message below will be displayed on the terminal.

   

   

4. Download Flash Writer to RAM¶

Flash Writer is a small program that is downloaded into internal RAM inside the target device to assist in programming the boot loader into Flash memory.

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 using the terminal software after the message please send ! is shown.

Below is a sample procedure with TeraTerm.

1. Open a Send file dialog by selecting File > Send file menu.

   

   

2. Select the image to be send and click Open button.

   

3. The image will be sent to the board via serial connection.

   

4. After successfully downloading the binary, Flash Writer starts automatically and shows a message like below on the terminal.

   Flash writer for RZ/G2 Series V1.02 Nov.15,2021
    Product Code : RZ/G2L
   >
   

5. Write the Bootloader¶

For the boot operation, two boot loader files need to be programming into the target board.

The corresponding bootloader files and specified address information depend on each target board.

Before writing the loader files, change the Flash Writer transfer rate from default (115200 bps) to high speed (921600 bps) with SUP (speed up) command of Flash Writer.

>SUP
Scif speed UP
Please change to 921.6Kbps baud rate setting of the terminal.

After issuing the SUP command, change the serial communication protocol speed from 115200 bps to 921600 bps as well, and push the enter key.

Next, use the XLS2 command of Flash Writer to write boot loader binary files.

This command receives binary data from the serial port and writes the data to a specified address of the Flash ROM with information where the data should be loaded on the address of the main memory.

>XLS2
===== Qspi writing of RZ/G2 Board Command =============
Load Program to Spiflash
Writes to any of SPI address.
 Micron : MT25QU512
Program Top Address & Qspi Save Address
===== Please Input Program Top Address ============
  Please Input : H'11E00

===== Please Input Qspi Save Address ===
  Please Input : H'00000
Work RAM(H'50000000-H'53FFFFFF) Clear....
please send ! ('.' & CR stop load)

SPI Data Clear(H'FF) Check :H'00000000-0000FFFF Erasing..Erase Completed
SAVE SPI-FLASH.......
======= Qspi  Save Information  =================
 SpiFlashMemory Stat Address : H'00000000
 SpiFlashMemory End Address  : H'00009A80
===========================================================

SPI Data Clear(H'FF) Check : H'00000000-0000FFFF,Clear OK?(y/n)

>XLS2
===== Qspi writing of RZ/G2 Board Command =============
Load Program to Spiflash
Writes to any of SPI address.
 Micron : MT25QU512
Program Top Address & Qspi Save Address
===== Please Input Program Top Address ============
  Please Input : H'00000

===== Please Input Qspi Save Address ===
  Please Input : H'1D200
Work RAM(H'50000000-H'53FFFFFF) Clear....
please send ! ('.' & CR stop load)

SPI Data Clear(H'FF) Check :H'00000000-0000FFFF Erasing..Erase Completed
SAVE SPI-FLASH.......
======= Qspi  Save Information  =================
 SpiFlashMemory Stat Address : H'0001D200
 SpiFlashMemory End Address  : H'000CC73F
===========================================================

SPI Data Clear(H'FF) Check : H'00000000-0000FFFF,Clear OK?(y/n)

Step 6: Run RZ Linux BSP Plus¶

1. Setup EVK's DIP switch to Normal Boot¶

In this case use QSPI boot and SD card.

2. Turn on EVK and start Linux BSP Plus¶