Skip to content

Getting Started for RZ/T,N

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

Note

Hereafter, we use following terminology.

  • EVK: Refers "Evaluation Board Kit".

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.

The RZ/T2H Evaluation Board Kit (EVK) is the ideal board kit for RZ/T2H evaluation.

Following items are included in the RZ/T2H Evaluation Board Kit.

EquipmentDetails
RZ/T2H EvaluationEvaluation board itself
USB Mini B CableFor serial communication between PC and the board
USB Type C CableFor Power supply (15V)
USB Micro B CableFor on-board emulator connection

The RZ/N2H Evaluation Board Kit (EVK) is the ideal board kit for RZ/N2H evaluation.

Following items are included in the RZ/N2H Evaluation Board Kit.

EquipmentDetails
RZ/N2H EvaluationEvaluation board itself
USB Mini B CableFor serial communication between PC and the board
USB Type C CableFor Power supply (15V)
USB Micro B CableFor on-board emulator connection

Step 2: Obtain necessary environment

1. Necessary Equipment

Please prepare the following equipment for your EVK.

Equipment

Purpose

Remarks

RZ/T2H Module Board (SMARC2.1) + Common Carrier Board

(P/N: RTK9RZT2H0S00000BJ)

It is used to evaluate Linux boot.

Included with RZ/T2H Evaluation Board Kit (EVK)

USB serial cable


It is used to connect the PC and the EVK and get the console
output of Linux running on the EVK.

* Connect to Mini USB type-B port of EVK

Included with RZ/T2H Evaluation Board Kit (EVK)


USB Power Delivery (PD) AC adapter + USB C PD cable
for power supply

Used for power supply

* Connect to USB type-C port of EVK

PC





It can be used to operate the demo environment from a terminal
on a PC, rebuild HMI SDK Linux, or use it as a development device
for applications.

At least 100GB or more free space of HDD/SDD
 8GB or more RAM
* 4-core or more CPU

The OS of the PC is as follows. However, Windows PCs are for
debugging using a serial connection and cannot be used for
development such as building software.

Ubuntu 22.04 LTS, 64-bit version
 Windows 10 or 11

micro SD card




Linux and demo images provided by the HMI SDK are written and
used as a Linux boot device.

Type: SDHC
 Speed class: UHI-Class 10
* Capacity: Minimum 4GB, recommended 8GB

Linux on the RZ/T2H EVK is booted from a micro SD card by eSD
boot.



Equipment

Purpose

Remarks

RZ/N2H Module Board (SMARC2.1) + Common Carrier Board

(P/N: RTK9RZN2H0S00000BJ)

It is used to evaluate Linux boot.

Included with RZ/N2H Evaluation Board Kit (EVK)

USB serial cable


It is used to connect the PC and the EVK and get the console
output of Linux running on the EVK.

* Connect to Mini USB type-B port of EVK

Included with RZ/N2H Evaluation Board Kit (EVK)


USB Power Delivery (PD) AC adapter + USB C PD cable
for power supply

Used for power supply

* Connect to USB type-C port of EVK

PC





It can be used to operate the demo environment from a terminal
on a PC, rebuild HMI SDK Linux, or use it as a development device
for applications.

At least 100GB or more free space of HDD/SDD
 8GB or more RAM
* 4-core or more CPU

The OS of the PC is as follows. However, Windows PCs are for
debugging using a serial connection and cannot be used for
development such as building software.

Ubuntu 22.04 LTS, 64-bit version
 Windows 10 or 11

micro SD card




Linux and demo images provided by the HMI SDK are written and
used as a Linux boot device.

Type: SDHC
 Speed class: UHI-Class 10
* Capacity: Minimum 4GB, recommended 8GB

Linux on the RZ/N2H EVK is booted from a micro SD card by eSD
boot.



2. Necessary Software

Please install following software on Linux PC.

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

    Image file is:

    • core-image-minimal-rzt2h-dev.rootfs.wic.gz

    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.

    Image file is:

    • core-image-minimal-rzn2h-dev.rootfs.wic.gz

    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

    Image file is:

    • core-image-minimal-rzt2h-dev.rootfs.wic.gz

    Note

    Additionally, the file below is also required:

    • core-image-minimal-rzt2h-dev.rootfs.wic.bmap

    Image file is:

    • core-image-minimal-rzn2h-dev.rootfs.wic.gz

    Note

    Additionally, the file below is also required:

    • core-image-minimal-rzn2h-dev.rootfs.wic.bmap

Step 5: Reference Board Setting

1. Setup EVK's peripheral

Please setup following below diagram.

2. EVK's DIP switch

EVK's DIP switch (SW14) and jumper(CN77 and CN78) reference.

  • jumper

    • SD Card(CN77)

    • eMMC(CN78)

  • SW14

    • SCIF Download Mode

      SW14-1SW14-2SW14-3SW14-4SW14-5SW14-6SW14-7SW14-8
      OFFONOFFOFFOFFONONOFF

    • xSPI Boot Mode

      SW14-1SW14-2SW14-3SW14-4SW14-5SW14-6SW14-7SW14-8
      ONONONOFFOFFOFFONOFF

    • eMMC Boot Mode

      SW14-1SW14-2SW14-3SW14-4SW14-5SW14-6SW14-7SW14-8
      ONONOFFOFFOFFONONOFF

    • eSD Boot Mode

      SW14-1SW14-2SW14-3SW14-4SW14-5SW14-6SW14-7SW14-8
      OFFOFFONOFFOFFOFFONOFF

EVK's DIP switch (DSW3) and jumper(JP23) reference.

  • jumper

    • eMMC(JP23)

  • DSW3

    • SCIF Download Mode

      DSW3-1DSW3-2DSW3-3DSW3-4DSW3-5DSW3-6DSW3-7DSW3-8
      OFFONOFFOFFOFFOFFONOFF

    • xSPI Boot Mode

      DSW3-1DSW3-2DSW3-3DSW3-4DSW3-5DSW3-6DSW3-7DSW3-8
      ONONONOFFOFFOFFONOFF

    • eMMC Boot Mode

      DSW3-1DSW3-2DSW3-3DSW3-4DSW3-5DSW3-6DSW3-7DSW3-8
      ONONOFFOFFOFFONONOFF

    • eSD Boot Mode

      DSW3-1DSW3-2DSW3-3DSW3-4DSW3-5DSW3-6DSW3-7DSW3-8
      OFFOFFONOFFOFFOFFONOFF

3. Prepare for Flashing Boot Loader into EVK

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

  1. To set the board to SCIF Download mode, set the SW14 as below.

    SW14-1SW14-2SW14-3SW14-4SW14-5SW14-6SW14-7SW14-8
    OFFONOFFOFFOFFONONOFF

  2. Turn ON the power switch (SW16) to supply the power.

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

  4. 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:

    VariableValue
    Baud rate115200 bps
    Data8 bit
    Paritynone
    Stop1 bit
    Flow controlnone

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

    VariableValue
    New-lineCR or AUTO

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

  1. To set the board to SCIF Download mode, set the DSW3 as below.

    DSW3-1DSW3-2DSW3-3DSW3-4DSW3-5DSW3-6DSW3-7DSW3-8
    OFFONOFFOFFOFFOFFONOFF

  2. Turn ON the power switch (SW1) to supply the power.

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

  4. 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:

    VariableValue
    Baud rate115200 bps
    Data8 bit
    Paritynone
    Stop1 bit
    Flow controlnone

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

    VariableValue
    New-lineCR or AUTO

  6. After finishing all settings, when the reset button 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. The messages below are shown on the terminal.

 SCI Download mode (Normal SCI boot)

Send an image of Flash Writer using the terminal software after the message please send ! is shown.

Flash Writer image file is:

  • HDR_NM(firstly send)
  • Flash_Programmer_SCIF_CR52_RZT2H_EVK.mot(secondary send)

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 in the Tera Term: Send file dialog box.

  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.

    SCI Download mode (Normal SCI boot)
-- Load Program to RAM ---------------
-- Start Boot Program on RAM ---------

Flash Programmer V1.06 (RZT2H)(CR52)

When the transfer is complete, please transfer the file of "Flash_Programmer_SCIF_CR52_RZT2N_EVK.mot" using the same procedure within 30 seconds. If not completed within 10 seconds, please restart the transfer from the "HDR NM" file.

Flash Writer image file is:

  • HDR_NM(firstly send)
  • Flash_Programmer_SCIF_CR52_RZT2H_EVK.mot(secondary send)

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 in the Tera Term: Send file dialog box.

  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.

    SCI Download mode (Normal SCI boot)
-- Load Program to RAM ---------------
-- Start Boot Program on RAM ---------

Flash Programmer V1.06 (RZT2H)(CR52)

When the transfer is complete, please transfer the file of "Flash_Programmer_SCIF_CR52_RZT2N_EVK.mot" using the same procedure within 30 seconds. If not completed within 10 seconds, please restart the transfer from the "HDR NM" file.

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.

use the XSPIW 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.

For example, this part describes how to write boot loader files:

> XSPIW 0 0 0
send file

Send the data of bl2_bp_xspi0-rzt2h-dev.srec from terminal software after the message send file is shown.

After successfully downloading the binary, messages like below are shown on the terminal.

Erased
Writen

Next, write another loader file by using XSPIW command again.

> XSPIW 0 0x060000 0
send file

Send the data of fip-rzt2h-dev.srec from terminal software after the message send file is shown.

After successfully downloading the binary, messages like below are shown on the terminal.

Erased
Writen

At last, turn off the power of the board.

For example, this part describes how to write boot loader files:

> XSPIW 0 0 0
send file

Send the data of bl2_bp_xspi0-rzn2h-dev.srec from terminal software after the message send file is shown.

After successfully downloading the binary, messages like below are shown on the terminal.

Erased
Writen

Next, write another loader file by using XSPIW command again.

> XSPIW 0 0x060000 0
send file

Send the data of fip-rzn2h-dev.srec from terminal software after the message send file is shown.

After successfully downloading the binary, messages like below are shown on the terminal.

Erased
Writen

At last, turn off the power of the board.

Step 6: Run RZ Linux BSP Plus

1. Setup EVK's DIP switch to Normal Boot

In this case use xSPI boot and SD card.

Set up jumper and DIP switch SW14 as follows.

  • CN77

  • SW14

    SW14-1SW14-2SW14-3SW14-4SW14-5SW14-6SW14-7SW14-8
    ONONONOFFOFFOFFONOFF

Note

For eMMC and/or eSD Boot, please refer to Appendix.

Set up jumper and DIP switch SW14 as follows.

  • JP23

  • DSW3

    DSW3-1DSW3-2DSW3-3DSW3-4DSW3-5DSW3-6DSW3-7DSW3-8
    ONONONOFFOFFOFFONOFF

Note

For eMMC and/or eSD Boot, please refer to Appendix.

2. Turn on EVK and start Linux BSP Plus

  1. Insert the bootable SD card created at Step 4 into the microSD card slot on board as illustrated in the figure at "1. Setup EVK's peripheral".
  2. Connect a USB cable to the connector for power supply.

  3. Press and hold power button for 1 second to turn on the EVK.

    Note

    Press and hold the button for 2 seconds when you turn off the EVK.

  1. Insert the bootable SD card created at Step 4 into the microSD card slot on board as illustrated in the figure at "1. Setup EVK's peripheral".
  2. Connect a USB cable to the connector for power supply.

  3. Press and hold power button for 1 second to turn on the EVK.

    Note

    Press and hold the button for 2 seconds when you turn off the EVK.