Introduction
The following guide will provide different HummingBoard RZ /G2LCfamily boot options.
| Table of Contents |
|---|
This guide uses build artifacts from the SolidRun BSP repository. You need to clone this repo and build the artifacts first.
The RZ /G2LC HummingBoards have two basic boot modes: SD boot and eMMC boot. The boot process starts with loading the bootloaders to the memory from the SD or eMMC. This article will explain how to boot HummingBoard in different modes and flash bootloaders to the eMMC.
This guide compatible with all the RZ family. For using with a specific device you need to change the path of the image to the correct one (replace all the xxxx).
Boot from SD card
Prepare the SD card. Connect the SD card to your PC and flash the image on it.
| Code Block |
|---|
$ sudo dd if=images/rzg2lcrzxxxx_solidrun_buildroot-sd-xxxxxxx.img of=/dev/sdX bs=1M |
...
| Info |
|---|
Note: the SD card is assumed to be connected to /dev/sdX device and unmounted. Don’t forget to change X to the actual device letter. |
Set the S3 DIP switch to “Boot from uSD. “
Connect the USB cable and open the serial terminal. If you have trouble with this step, refer to the serial connection article.
Plug the SD card into the HummingBoard and connect the power supply.
After that step, the board will boot automatically.
Boot from USB
It’s possible to place the rootfs and boot partitions on the USB drive. This allows us to boot the Linux and get access to the eMMC.
Prepare the SD card. Connect the SD card to your PC and flash the bootloader image.
| Code Block |
|---|
$ sudo dd if=images/rzg2lcrzxxxx_solidrun-sd-bootloader-xxxxxxx.img of=/dev/sdX bs=1M |
Prepare a USB drive with the boot partition and the rootfs partition.
| Code Block |
|---|
$ sudo dd if=images/rzg2lcrzxxxx_solidrun_buildroot-sd-xxxxxxx.img of=/dev/sdX bs=1M |
| Info |
|---|
Note: the USB drive is assumed to be connected to /dev/sdX device and unmounted. Don’t forget to change X to the actual device letter. |
Set the S3 DIP switch to “Boot from uSD. “
Connect the USB cable and open the serial terminal. If you have trouble with this step, refer to the serial connection article.
Plug the SD card and USB drive into the HummingBoard, and connect the power supply.
...
Set the bootargs for the USB boot:
| Code Block |
|---|
# setenv bootargs "rw rootwait earlycon root=/dev/sda2" |
Load kernel and fdt file from the USB drive:
| Code Block |
|---|
# usb start # load usb 0:1 $kernel_addr_r boot/Image # load usb 0:1 $fdt_addr_r boot/rzg2lcrzxxx-hummingboard.dtb |
| Info |
|---|
Note: make sure to choose the correct dtb file according to your device. |
If you need an eMMC access from Linux:
| Code Block |
|---|
# setenv sdio_select emmc |
Boot the Linux kernel:
| Code Block |
|---|
# booti $kernel_addr_r - $fdt_addr_r |
After that step, the board will boot using the rootfs placed on the second USB drive partition.
Boot using TFTP
U-Boot allows to load the kernel, ramdisk, and fdt over TFTP. In this example, we will use ramdisk for the rootfs.
Prepare the SD card. Connect the SD card to your PC and flash the bootloader image.
| Code Block |
|---|
$ sudo dd if=images/rzg2lcrzxxxx_solidrun-sd-bootloader-xxxxxxx.img of=/dev/sdX bs=1M |
Set the S3 DIP switch to “Boot from uSD. “
Prepare the TFTP server. Place the following files from the build directory on the server:
images/tmp/Image
images/tmp/rzg2lcrzxxxx-hummingboard.dtb
images/tmp/initrd.img
Connect the USB cable and open the serial terminal. If you have trouble with this step, refer to the serial connection article.
Plug the SD card, USB drive, and Ethernet cable into the HummingBoard, and connect the power supply.
...
Set the TFTP server address:
| Code Block |
|---|
# setenv serverip <the.server.ip.addr> |
| Info |
|---|
the server ip address is the ip of the device that you created the server on. |
Get the IP address:
| Code Block |
|---|
# dhcp |
Set the boot args and load boot artifacts:
| Code Block |
|---|
# setenv bootargs "earlycon" # tftpboot $kernel_addr_r Image # tftpboot $fdt_addr_r rzg2lcrzxxx-hummingboard.dtb # tftpboot $ramdisk_addr_r initrd.img |
If you need an eMMC access from Linux:
| Code Block |
|---|
# setenv sdio_select emmc |
Set the S3 DIP switch to "Boot from emmc".
Boot the Linux kernel:
| Code Block |
|---|
# booti $kernel_addr_r $ramdisk_addr_r $fdt_addr_r |
...
| Info |
|---|
Note: since the rootfs is in the RAM, all changes in the filesystem will be lost after reboot. |
Flashing bootloaders and rootfs from Linux
This paragraph assumes you boot Linux using rootfs placed on the USB. And you selected SDIO switch to the eMMC in the u-boot environment before jumping to Linux.
| Code Block |
|---|
# setenv sdio_select emmc |
Also, you need to copy bootloader files to the rootfs in the USB:
bl2_bp-rzg2lcrzxxx-solidrun.bin
fip-rzg2lcrzxxxx-solidrun.bin
rzg2lcrzxxx_solidrun_buildroot-sd-xxxxxxx.img
Disable eMMC boot partition write protection:
| Code Block |
|---|
$ echo 0 > /sys/block/mmcblk0boot0/force_ro |
Flash the bootloaders:
| Code Block |
|---|
$ dd if=bl2_bp-rzg2lcrzxxx-solidrun.bin of=/dev/mmcblk0boot0 bs=512 seek=1 $ dd if=fip-rzg2lcrzxxx-solidrun.bin of=/dev/mmcblk0boot0 bs=512 seek=256 |
Enable boot partition:
| Code Block |
|---|
# mmc bootbus set single_backward x1 x8 /dev/mmcblk0 # mmc bootpart enable 1 0 /dev/mmcblk0 |
Flash the bootfs and rootfs:
| Code Block |
|---|
$ dd if=rzg2lcrzxxxx_solidrun_buildroot-sd-a6f9227xxxxx.img of=/dev/mmcblk0 bs=4M |
After this step, you can reboot, and the board will start booting from eMMC.
Flashing bootloaders over serial
An RZ/G2LC CPU has a serial downloader mode. With this mode, it’s possible to flash the bootloader to SOM’s eMMC using flash-writer bare-metal software.
Prepare the board:
Connect serial cable
Connect power supply
Go On your PC terminal go to the flash-writer script dir:
| Code Block |
|---|
$ cd build_scripts/flash-writer/ |
...
Flash the bootloaders:
| Code Block |
|---|
$ sudo ./flash_writer_tool.sh config.ini fw $ sudo ./flash_writer_tool.sh config.ini bl2 $ sudo ./flash_writer_tool.sh config.ini fip $ sudo ./flash_writer_tool.sh config.ini emmc_config |
| Info |
|---|
Note: The fw command uploads the flash-writer bare-metal software to the RAM. You can change the order or skip some of the commands if you need, but the fw command should always come first since it uploads the necessary software for the other commands. |
Set the S3 DIP switch to eMMC boot and press reset.
Pre-programmed SOMs
Pre-programmed SOMs (bootloader/custom_image on eMMC) can be ordered from Solid-Run for high volume (programming will be done during the production test process).
It is possible to order SOMs from Solidrun with preprogrammed General/Custom bootloader on eMMC and then you can load the Linux & FS over USB-Disk / Ethernet (TFTP/DHCP) and then program the custom image from Linux…