HummingBoard Ripple & RZ/G2L SOM Quick Start Guide
Introduction
The following quick start guide provides background information about the HummingBoard Ripple RZ/G2L.
The guide will give a technical overview about the product and by the end of it you should be able to boot an operating system and begin testing your application.
Revision and Notes
Date | Owner | Revision | Notes |
---|---|---|---|
Aug 21, 2023 | Yazan Shhady | 1.0 | Initial release |
Nov 13, 2023 | Shahar Fridman | 1.1 | Update for the first boot and for the features |
Table of Contents |
Hardware Setup
Product specifications
| HUMMINGBOARD Ripple RZ/G2L |
---|---|
I/Os | 2 x USB 2.0 |
Networking | 1 x Ethernet RJ45 10/100/1000 |
Processor | Renesas RZ/G2L Dual core Arm Cortex A55 up to 1.2GHz + Cortex M33 |
Memory & Storage | Up to 2GB DDR4 RAM |
Display | HDMI (ADI bridge MIPI-DSI to HDMI) |
Misc. | 1 x Reset button |
Development and Debug interfaces | Micro USB |
Power | 7V – 36V |
Expansion card I/Os | mikroBUS header |
Temperature | Commercial: 0°C to 70°C |
Dimensions | PCBA: 100 x 70mm |
Enclosure | Extruded aluminium |
|
Supported with RZ/G2L SOM. For more detailed information about our SOM RZ/G2L series please visit this user manual : RZ/G2L SOM Hardware User Manual .
Block Diagram
The following figure describes the RZ/G2L Block Diagram.
Visual features overview
Please see below the features overview of the connector side of the HummingBoard Ripple & RZ/G2L SOM.
Print side connector overview of the HummingBoard Ripple & RZ/G2L SOM.
Software Setup
Cable setup and prerequisites
Here is what you will need to power up and use the board:
Linux or Windows PC
HummingBoard Ripple with RZ/G2L SOM (HummingBoard Ripple & RZ/G2L SOM)
12V Power adapter (HummingBoard Ripple has wide range input of 7V-36V, it is recommended to use 12V power adapter).
Micro USB to USB for console, the HummingBoard Ripple has an onboard FTDI chip.
IP router or IP switch
USB Disk and SD Card
Boot Select
Before powering up the board for the first time it is recommended to select the boot media. In order to configure the boot media, please refer to HummingBoard RZ/G2L Boot Select .
eMMC and SD connect to the same SDIO signals via MUX so we can’t have access to the SD & eMMC at the same time, select eMMC/SD by setting switch S3{6} → on : eMMC , off : SD
Generating Yocto, Buildroot and Debian image
Yocto
Clone the repository from the “List of supported OS” link and move your terminal to this directory.
Download the layers by this command
$ repo init -u https://github.com/SolidRun/meta-solidrun-arm-rzg2lc.git -b dunfell -m meta-solidrun-arm-rzg2lc.xml $ repo sync
In this stage you can modify your image configs as you want, you can find more info about it the the repository.
For graphics support you need to explore in the readme file in the github and follow the instructions of this utility.
Set the environment of the image that going to be build by this command
$ TEMPLATECONF=$PWD/meta-solidrun-arm-rzg2lc/docs/template/conf/rzg2lc-solidrun source poky/oe-init-build-env build
Build your own Yocto image by this command
$ MACHINE=rzg2l-hummingboard bitbake <target>
NOTE: Choose your relevant target, for example:
-core-image-bsp: cli image.
-core-image-weston: graphical image.
-core-image-qt: graphical image including qt.
Buildroot/Debian
Clone the repository from the “List of supported OS” link and move your terminal to this directory.
In this stage you can modify your image configs as you want, you can find more info about it the the repository.
Build your own image by this command
$ MACHINE=rzg2l-hummingboard Distro=<Buildroot/Debian> ./runme.sh
Booting from SD card
The following shows how to set the switches on the boot source selector:
Please Note:
The black rectangle represents the switch position.
Once you set the switches, you can apply the following for booting from SD card:
Downloading the image
Download the image (for example Debian) by running the following command on your Linux/Windows PC:wget https://solid-run-images.sos-de-fra-1.exo.io/RZ/Debian/build_date_20240529-git_rev_f22483f/rzg2l-solidrun-sd-debian-f22483f.img.xz
For more Debian releases, please visit Debian Releases for RZ/G2L.
Writing the image to the SD card
Use the following commands for writing the image to an SD card:xz -dc rzg2l-solidrun-sd-debian-f22483f.img.xz | dd of=/dev/sdX bs=4k conv=fdatasync
For more information, please visit Flashing an SD Card .
Note: Plug a micro SD into your Linux PC, the following assumes that the USB-Disk / Micro-SD is added as /dev/sdX and all it’s partitions are unmounted.
Note: You can use the following command for writing to the SD in case you generated your own image:
$ sudo dd if=/your/image/path of=/dev/sdX bs=4k conv=fdatasync
SD card insertion
Please Insert the SD card into your device.Power connection
Connect your power adaptor to the DC jack, and then connect the adaptor to mains supply.Power On
Hold on the On/Off Power button - SW1 (as shown in the figure below)SW1 - On/Off ButtonNote: The system should turn on by default when the power is connected (without pressing the button).
Serial Connection
Please insert the micro USB into your device, then you can refer to Serial Connection for installing necessary serial connection software in Linux/Windows.
Once you installed the necessary serial connection software, you should be able to see the following:
In order to be able to log in , please insert “root” as a username as follows:
Final stages
The following stages need to be done in order to finalise the imaging:
Run
fdisk /dev/mmcblk0
if using SD or eMMC.Recreate the rootfs partition (mostly the second partition) by deleting it and then creating a new partition that starts at the next sector after the first one and extends to the end of the drive (or less depending on your needs).
Write the new partition, when prompt about ‘Do you want to remove the signature?’ then answer with Yes.
Run
resize2fs /dev/mmcblk0p2
if using SD Card or eMMC.In this stage the root partition should be big enough to start populating it; but first update the RTC clock.
Connect the RJ45 to your network with internet access (and DHCP server); and then run
dhclient
.Update the RTC clock by running
ntpdate pool.ntp.org
and thenhwclock -w
.Run apt-update commands below and then populate the root filesystem as you wish.
$ apt-get update && apt-get upgrade -y
Here is an example of the same process in the rzg2lc device until the 3rd step (include):
After those steps you should end the process in this way (step 4 to the end):
In the end you should see with “lsblk” that the partition size is in the required size.
More Features
List Of Supported OS