Getting Started¶
This page explains how to start-up Ubuntu or Debian on RZ MPU evaluation board kit.
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¶
Please prepare the following equipment.
PC used for creating a bootable microSD card
- At least 50GB or more free space of HDD/SDD
- 8GB or more RAM
- 4-core or more CPU
- Ubuntu (64-bit) 22.04 LTS or 24.04 LTS
sudo
permission and internet connection are required.
microSD card for Ubuntu/Debian bootable image
- Type: SDHC, SDXC
- Capacity: Minimum 32GB
Step 3: Obtain Ubuntu and Debian for RZ MPU Linux¶
Click the button below to get Renesas software for Ubuntu or Debian.
Step 4: Create a bootable microSD card¶
To create a bootable microSD card for Ubuntu, see RZ/G2L Ubuntu Bootable Tool.
To create a bootable microSD card for Debian, see RZ/G2L Debian Bootable Tool.
Step 5: Write flash writer and bootloaders¶
The following tools are used in the instructions below. Please install them to your PC in advance.
1. Setup EVK's peripheral¶
To write flash writer and bootloaders, you need to connect your PC to the EVK with a USB serial cable.
2. Set boot mode to SCIF download mode¶
Turn off the power of EVK, then set the SW11 as follows.
3. Configure terminal software¶
Configure the setting of serial communication on terminal software as follows:
Variable | Value |
---|---|
Baud rate | 115200 bps |
Data | 8 bits |
Parity | none |
Stop | 1 bit |
Flow control | none |
4. Prepare flash writer and bootloaders¶
The flash writer and the bootloaders are stored in the package. Unzip the package and pick up flash write and bootloaders.
Flash writer
Flash_Writer_SCIF_RZG2L_SMARC_PMIC_DDR4_2GB_1PCS.mot
Bootloaders
bl2_bp_spi-smarc-rzg2l_pmic.srec
fip-smarc-rzg2l_pmic.srec
5. Download flash writer to RAM¶
Turn on the power of the EVK by pressing SW9. The messages below are shown on the terminal.
SCIF Download mode
(C) Renesas Electronics Corp.
-- Load Program to System RAM ---------------
please send !
Send an image of Flash Writer
using terminal software after the message please send ! is shown.
Open the File menu, then select Send file... to open Send file dialog.
Select the Flash Writer
image in the dialog, and press Open button.
Press Ctrl+A+S, then select ascii for upload mode.
Select the Flash Writer
image file.
Press any key when upload is completed.
After successfully downloading the image, the Flash Writer
starts automatically and shows a message like below on the terminal.
6. Write the bootloaders¶
6-1. Change baud rate of serial port¶
Before writing the loader files, change the flash writer transfer rate from default (115200
bps) to high speed (921600
bps) with SUP
command.
After the SUP
command, change the serial communication protocol speed from 115200
bps to 921600
bps on the terminal software.
6-2. Write bl2 file¶
Execute XLS2
command 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. Set the following addresses respectively.
- Address to load to RAM:
H'11E00
- Address to save to ROM:
H'00000
For example:
>XLS2
===== Qspi writing of RZ/G2 Board Command =============
Load Program to Spiflash
Writes to any of SPI address.
Dialog : AT25QL128A
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)
Send the data of bl2_bp-spi-smarc-rzg2*.srec
from terminal software in the same way as the Flash Writer
after the message please send ! is shown.
Note
In the case that the following message is shown, enter Y.
After writing the data is completed, the following messages like below are shown on the terminal.
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'0000CA38
===========================================================
>
6-3. Write fip file¶
Execute XLS2
command to write fip file.
Set the following addresses respectively for the fip file.
- Address to load to RAM:
H'00000
- Address to save to ROM:
H'1D200
For example:
>XLS2
===== Qspi writing of RZ/G2 Board Command =============
Load Program to Spiflash
Writes to any of SPI address.
Dialog : AT25QL128A
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)
Send the data of fip-smarc-rzg2*.srec
from terminal software in the same way as the Flash Writer
after the message please send ! is shown.
Note
In the case that the following message is shown, enter Y.
After writing the data is completed, the following messages like below are shown on the terminal.
SPI Data Clear(H'FF) Check :H'00010000-000DFFFF Erasing..............Erase Completed
SAVE SPI-FLASH.......
======= Qspi Save Information =================
SpiFlashMemory Stat Address : H'0001D200
SpiFlashMemory End Address : H'000DD9EF
===========================================================
>
6-4. Restore baud rate of serial port¶
After writing two loader files is completed, restore the serial communication protocol speed to 115200
bps on the terminal software.
Then, turn off the power of the board by pressing the SW9.
Step 6: Run Ubuntu / Debian on RZ EVK¶
1. Setup EVK's peripheral¶
Before you start Ubuntu / Debian on RZ EVK, you need to set up the EVK.
2. Setup EVK's DIP switch¶
3. Setup u-boot¶
Turn on the power of the EVK by pressing SW9, and press Enter key within a few seconds to interrupt the boot process. If it succeeds, you will see the following messages:
NOTICE: BL2: v2.9(release):v2.5/rzg2l-1.00-3892-gcc1869562
NOTICE: BL2: Built : 20:49:37, Jun 22 2025
NOTICE: BL2: Booting BL31
NOTICE: BL31: v2.9(release):v2.5/rzg2l-1.00-3892-gcc1869562
NOTICE: BL31: Built : 20:49:38, Jun 22 2025
U-Boot 2021.10-g5141064c15 (Jun 22 2025 - 20:48:27 +0700)
CPU: Renesas Electronics CPU rev 1.0
Model: smarc-rzg2l
DRAM: 1.9 GiB
WDT: watchdog@0000000012800800
WDT: Started with servicing (60s timeout)
MMC: sd@11c00000: 0, sd@11c10000: 1
Loading Environment from MMC... OK
In: serial@1004b800
Out: serial@1004b800
Err: serial@1004b800
U-boot WDT started!
Net:
Error: ethernet@11c20000 address not set.
No ethernet found.
Hit any key to stop autoboot: 0
=>
=>
Configure U-Boot environment variables to boot from a microSD card as follows:
U-Boot will load "efi/boot/bootaa64.efi" from EFI partition (default: partition 1) of the microSD card. If the EFI partition resides on a different partition, such as partition 2, please modify "1:1" to "1:2".
U-Boot will load "efi/boot/bootaa64.efi" from EFI partition (default: partition 2) of the microSD card. If the EFI partition resides on a different partition, such as partition 1, please modify "1:2" to "1:1".
Note
The RZ/G2L EVK does not have a MAC address, so you need to set an appropriate MAC address when you use ethernet. You can set the address on U-boot as follows:
For eth0,
For eth1,
To restore default environment variables in u-boot, run the following command:
Press the RESET button (SW10) to start Ubuntu / Debian.
3. Configure network¶
When you turn on the power of the EVK or press the RESET button, you will see GNU GRUB menu. Select Linux-renesas-6.1 in the menu, and press Enter.
When you run Ubuntu / Debian for the first time on the environment, configure network so that you can install packages with apt
.
Edit "/etc/netplan/50-cloud-init.yaml" as follows:
Then, execute the following command to apply the settings.
4. Run Ubuntu / Debian on EVK¶
Turn on the power of the EVK or press the RESET button. Select Linux-renesas-6.1 in the GNU GRUB menu, and press Enter to run Ubuntu / Debian on the EVK.