Quick Start Guides¶

RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images.zip

To boot Android, it’s required to flash Android bootloader and flash Android images.

Device connection information:

Start up the device by pressing and hold the Power button (POWER) for 2 seconds.

The standard configuration is shown in the following figure.

Figure. Bottom side view of the SMARC RZ/G3L main board

Figure. Top side view of the SMARC RZ/G3L main board

Flashing AOSP image¶

Flashing bootloader¶

It’s needed to update the firmware (*). Especially, it’s mandatory to use U-Boot which support “fastboot” command.

(*)bootloader binaries:

• bl2_bp_smarc_rzg3l_emmc.bin
• bl2_bp_smarc_rzg3l_emmc.srec
• bl2_bp_smarc_rzg3l_esd.bin
• bl2_bp_smarc_rzg3l_esd.srec
• fip_smarc_rzg3l.bin
• fip_smarc_rzg3l.srec

Use provided *.mot (Flash Writer) firmware below for flashing eMMC bootloader:

• Flash_Writer_SCIF_RZG3L_SMARC_LPDDR4.mot

Use provided *.ttl (TeraTerm Language) macros below for flashing eMMC bootloader:

• emmc_flash_rzg3l.ttl

Use provided script below for flashing eSD bootloader:

• flash_eSD_smarc_rzg3l.sh

• For RZ/G3L prebuilt images

unzip RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images.zip

• Confirm the content of RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images

tree -L 1 RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images

• Content of the RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images

  RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images
  ├── L-497(Rev1.1)_RZ-MPU-Video-Codecパッケージ_利用許諾契約書_RZG3L-AOSP-17.pdf
  ├── L-498(Rev1.1)_Video-Codec-Package-for-RZ-MPU_Software-License-Agreement_RZG3L-AOSP-17.pdf
  ├── notice-files
  ├── prebuilt-images
  ├── README.txt
  └── sbom
  

• Confirm the content of prebuilt-images

  tree RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images/prebuilt-images
  

• Content of the RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images/prebuilt-images

     |-- adb
     |-- bl2_bp_smarc_rzg3l_emmc.bin
     |-- bl2_bp_smarc_rzg3l_emmc.srec
     |-- bl2_bp_smarc_rzg3l_esd.bin
     |-- bl2_bp_smarc_rzg3l_esd.srec
     |-- boot.img
     |-- dtb.img
     |-- dtbo.img
     |-- fastboot
     |-- fastboot.sh
     |-- fastboot_functions.sh
     |-- fip_smarc_rzg3l.bin
     |-- fip_smarc_rzg3l.srec
     |-- init_boot.img
     |-- mke2fs
     |-- super.img
     |-- vbmeta.img
     |-- vendor_boot.img
     |-- flash_eSD_smarc_rzg3l.sh
     |-- Flash_Writer_SCIF_RZG3L_SMARC_LPDDR4.mot
     `-- emmc_flash_rzg3l.ttl
  

Please follow the steps below to flash IPL (these steps are executed on Windows PC and use TeraTerm tool for flashing) on RZ/G3L boards.

setenv platform r9a08g046
saveenv

run fastbootcmd

sudo ./fastboot.sh --serial=<serial#> --noresetenv --blonly --update_bootloaderemmc

setenv platform r9a08g046
saveenv

run fastbootcmd

sudo ./fastboot.sh --serial=<serial#> --noresetenv --blonly --update_bootloaderesd

Flashing images using fastboot¶

This step should be done after successful IPL and U-Boot flashing. (See Flashing bootloader)

Could not find "misc" partition

This warning is expected. The "misc" partition doesn't exist yet because no Android images have been flashed. It will be created automatically during the Android image flashing steps.

1) Using “fastboot usb”, please connect USB0_OTG to Ubuntu Host PC with an USB cable for fastboot.
2) Power on device and interrupt autoboot.
3) Execute below commands on target board.

Set environment values on U-boot

env default -a 
setenv serial# <serial number>  # Set board serial number to serial#: 0000XXXX (where XXXX = board number like 0011) 
editenv bootargs

Edit bootargs: video=XXXX-X:d 
“video” variable needs to set parameter related to display configuration. 
video=HDMI-A-1:e (Skip hotplug, keep connector always on)

saveenv 
reset  # Please Interrupt autoboot 
run fastbootcmd

4) Execute below commands on Ubuntu Host PC.

Format eMMC/SD card partition and write image file to target. Please use “fastboot” command that you built in step Building Android, IPL, U-Boot, and Kernel sources. (Of course, fastboot tool included in latest Android SDK is also worked.)

Method: Fastboot USB¶

• Following below commands to flash Android images:

cd <your working dir>/RTK0EF0188Z78001ZJ_v17.0.0_prebuilt-images/prebuilt-images
chmod a+x *
sudo ./fastboot -s <serial#> oem format # Expected output: "Finished. Total time: x.xxxs"
sudo ./fastboot -s <serial#> reboot bootloader # Expected output: "Finished. Total time: x.xxxs"
sudo ./fastboot.sh --serial=<serial#> --noresetenv --nobl # Expected output: "SUCCESS. Script finished successfully"

Once the boot process completes successfully, the GUI should appear on the HDMI monitor.

The console should display logs like the following:

[   50.869220] init: processing action (sys.boot_completed=1) from (/system/etc/init/hw/init.rc:1237)

Booting SMARC RZ/G3L¶

Please follow below steps to boot Android on SMARC RZ/G3L:

1. Change SW_MODE setting to eMMC boot mode.
2. Connect Micro USB 2.0 (USB0_OTG) to Ubuntu Host PC with USB cable.
3. Connect the HDMI touch panel to the Board.

   Note: HDMI monitor can also be used.

4. Connect the USB cable for HDMI touch panel to the USB 2.0 Type A (USB1B-1A_HOST).

   Note: USB mouse can also be used.

5. Connect the power cable to the board, press and hold the Power button (POWER) for 2 seconds.
   Verify that the following is displayed on the HDMI screen.

   

Enable and Run Sample Applications¶

This section explains how to enable and run the Sample Applications.

Enable Sample Applications¶

Enable demo applications with environment variable¶

• Step 1: Set the demo support environment variable:

export SUPPORT_DEMO=true

• Step 2: Re-build the Android image following the instructions in Building Android, IPL, U-Boot, and Kernel sources

Run the Application¶

This section explains how to run the Application.

Step 1: Boot Android Environment¶

1. Confirm if Android environment is booted successfully, the following screen is displayed:
   After Booting SMARC RZ/G3L, the following screen will appear after a few minutes.

   

2. Swipe up to open the home screen, When the home screen appears, swipe up to get UI of list of application.

   

Step 2: Run the Application¶

Simple Playback Sample App¶

1. Prepare media (video) via "adb push"

2. Click to Simple Playback Sample App icon to start the application

   

3. The application screen will appear. Swipe up to show all videos

   

4. Choose a video to play.

Grafika¶

1. Click to Grafika App icon to start the application

   

2. The application screen will appear the list of grafika test cases

   

3. Choose a testcase to test.

Step 3: Close the Application¶

To exit the application, tap the square icon at the bottom-right of the screen. When the screen shown below is displayed, swipe the application to the right. The CLEAR ALL button will appear on the left side of the screen. Tap this button. The application will close and return to the home screen.

Current Measurement Program¶

The Current Measurement Program for the RZ/G series supports current and voltage monitoring, graph plotting, and data logging. The program is not officially supported on the SMARC RZ/G3L, but it is expected to operate correctly because the platform uses the same current-sensing hardware as the supported platforms.

Please reference detail at: https://www.renesas.com/en/document/apn/rz-series-current-measurement-program

In this section, the Current Measurement Program is used to measure current and voltage, plot graphs, and save data while the system is operating in S2R (Suspend-to-RAM) mode. This demonstrates the power-saving benefits of S2R mode.

How to use Current Measurement Program¶

Step 1: Power off the board and connect USB cables as shown below:

Figure. SMARC RZG3L connection to Current measurement

Step 2: Set up the Current Meansurement application on the Windows PC.

a. Log in to Renesas website and download the Current Meansurement package from the link below: https://www.renesas.com/en/document/swe/rz-series-current-measurement-program

b. Extract the ZIP file twice and confirm that the extracted files match those shown below:

Figure. Current Measurement Program executable files

c. Double click on CurrentMeasurementAppFor5ch.exe to start the program. Since the SMARC RZ/G3L supports only four channels, make sure to uncheck the 0x9E I2C address.

Figure. Current Measurement Program with 0x9E I2C address unchecked

d. Click the "Start/Stop" Button to start or stop measurement.

Figure. Start or Stop measurement

Step 3: Press the POWER button to boot Android.

Figure. Current and voltage measurements during Android boot

Step 4: Wait for Android to finish booting, then open API Demos -> Graphics -> OpenGL ES -> Kube to run a graphics workload.

Figure. Voltage and current measurements while running API Demos

Step 5: Run the following commands on the board console to enter Suspend-to-RAM mode:

su
echo 0 > /sys/module/printk/parameters/console_suspend
echo deep > /sys/power/mem_sleep
echo enabled > /sys/class/tty/ttySC3/power/wakeup
echo mem > /sys/power/state

Step 6: Resume from S2R mode by pressing the SLEEP button.

Step 7: Shut down the Android device by following the instructions in Shutdown device section.

Step 8: Press the POWER button to turn off the board.

The measurement results are then displayed as shown in the figure below:

Figure. Voltage and current consumption in S2R mode

Shutdown device¶

Shutdown the device as shown:

Method 1: Shutdown via board's console¶

On board's console:

1)

reboot -p

2) Press and Hold the Power button (POWER) for 2 seconds to power off the SMARC RZ/G3L after the display shows no signal

Method 2: Shutdown via adb¶

On Ubuntu Host PC

1)

adb -s <serial#> shell svc power shutdown

2) Press and Hold the Power button (POWER) for 2 seconds to power off the SMARC RZ/G3L after the display shows no signal

Method 3: Shutdown via Android GUI¶

On Android GUI

1. From top center of the screen, swipe down. When the screen shown below is displayed, tap the power icon at the bottom center of the screen, then tap Power off.

   

2. Once the "shutting down" message disappears.

3. Press and Hold the Power button (POWER) for 2 seconds to power off the SMARC RZ/G3L.