> For the complete documentation index, see [llms.txt](https://dev.solid-run.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.solid-run.com/renesas/rz-g2l-v2l/sbc-platform/hummingboard-pro-rz-v2l-som-quick-start-guide.md). # HummingBoard Pro & RZ/V2L SOM Quick Start Guide ## Introduction The following quick start guide provides background information about the [HummingBoard Pro RZ/V2L](https://www.solid-run.com/embedded-industrial-iot/renesas-rz-family/rz-v2l-som/). 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** | | ------------ | -------------- | ------------ | ---------------------------------------------- | | 21 Aug 2023 | Yazan Shhady | 1.0 | Initial release | | Nov 12, 2023 | Shahar Fridman | 1.1 | Update for the first boot and for the features | | 11 Dec 2025 | Yazan Shhady | 1.2 | Correct DC input voltage range to 7V–18V | ## Hardware Setup #### Product specifications | | HUMMINGBOARD Pro RZ/V2L | | -------------------------------- | -------------------------------------------------------------------------------------------- | | I/Os |

2 x USB 2.0
1 x MIPI-CSI
1 x Digital audio (Riser interface fpC connector)

| | Networking |

2 x Ethernet RJ45 10/100/1000
1 x 802.11 a/b/g/n/ac WiFi and Bluetooth (2.4/5 GHz)

| | Processor | Renesas RZ/V2L Solo/Dual core Arm Cortex A55 up to 1.2GHz + Cortex M33 | | Memory & Storage |

up to 2GB DDR4 RAM
Starting from 16GB eMMC
MicroSD

| | Display | HDMI (ADI bridge MIPI-DSI to HDMI) | | Misc. |

1 x Reset button
1 x Configurable push button
3 x LED indicators
RTC

| | Development and Debug interfaces | Micro USB | | Power | 7V – 18V | | Expansion card I/Os |

mikroBUS header
Mini Pcie with SIM holder

| | Temperature |

Commercial: 0°C to 70°C

Industrial: -40°C to 85°C

| | Dimensions |

PCBA: 100 x 70mm

Enclosure 120 x 80 x 30mm

| | Enclosure | Extruded aluminium | | | [Buy Now](https://shop.solid-run.com/product/SRV2L-EVKHBPRO-R01) | {% hint style="info" %} Supported with RZ/V2L SOM. For more detailed information about our SOM RZ/V2L series please visit this user manual : [RZ/V2L SOM Hardware User Manual](/renesas/rz-g2l-v2l/com-som/rz-g2l-and-rz-v2l-som-hardware-user-manual.md) . {% endhint %} #### Block Diagram The following figure describes the RZ/G2L Block Diagram. ![](/files/xG63alqBYoifMSQKh9d0) #### Visual features overview Please see below the features overview of the connector side of the HummingBoard Pro & RZ/V2L SOM. ![](/files/j3bMrQO6LhQgWOUn6TA4) Print side connector overview of the HummingBoard Pro & RZ/V2L SOM. ![](/files/PNhXWXsAmR39JIQx0QbM) ## Software Setup #### Cable setup and prerequisites Here is what you will need to power up and use the board: * Linux or Windows PC * HummingBoard Pro with RZ/G2L SOM (HummingBoard Pro & RZ/V2L SOM) * 12V Power adapter (HummingBoard Extended has wide range input of 7V-36V, it is recommended to use 12V power adapter). * Micro USB to USB for console, the HummingBoard Extended 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/V2L Boot Select](/renesas/rz-g2l-v2l/sbc-platform/rz-g2-other-articles/hummingboard-rz-g2lc-g2ul-g2l-v2l-boot-select.md) . {% hint style="info" %} 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 {% endhint %} ## Generating Yocto, Buildroot and Debian image **Yocto** 1. Clone the repository from the “List of supported OS” link and move your terminal to this directory. 2. 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 ``` 3. In this stage you can modify your image configs as you want, you can find more info about it the the repository. 4. For graphics support you need to explore in the readme file in the github and follow the instructions of this utility. 5. 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 ``` 6. Build your own Yocto image by this command ``` $ MACHINE=rzv2l-hummingboard bitbake ``` * 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** 1. Clone the repository from the “List of supported OS” link and move your terminal to this directory. 2. In this stage you can modify your image configs as you want, you can find more info about it the the repository. 3. Build your own image by this command ``` $ MACHINE=rzv2l-hummingboard Distro= ./runme.sh ``` ## Booting from SD card The following shows how to set the switches on the boot source selector: ![](/files/QLfMDVfakVTztWaJYVcP) {% hint style="info" %} Please Note: The black rectangle represents the switch position. {% endhint %} Once you set the switches, you can apply the following for booting from SD card: 1. **Downloading the image**\ Download the image (for example Debian) by running the following command on your Linux/Windows PC: ``` https://solid-run-images.sos-de-fra-1.exo.io/RZ/Debian/build_date_20240529-git_rev_f22483f/rzv2l-solidrun-sd-debian-f22483f.img.xz ``` * For more Debian releases, please visit [Debian Releases for RZ/V2L](https://images.solid-run.com/RZ/rzg2lc_build). 2. **Writing the image to the SD card**\ Use the following commands for writing the image to an SD card: ``` xz -dc rzv2l-solidrun-sd-debian-f22483f.img.xz | dd of=/dev/sdX oflag=direct status=progress ``` * For more information, please visit [Flashing an SD Card](/other-articles/flashing-an-sd-card.md) . * **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. 3. **SD card insertion**\ Please Insert the SD card into your device. 4. Power connection\ Connect your power adaptor to the DC jack, and then connect the adaptor to mains supply. 5. **Power On**\ Hold on the **On/Off** Power button - **SW1** (as shown in the figure below)![](/files/QE9bSivBag7NEku4mDSq) * **Note:** The system should turn on by default when the power is connected (without pressing the button). 6. **Serial Connection**\ Please insert the micro USB into your device, then you can refer to [Serial Connection](/other-articles/serial-connection.md) for installing necessary serial connection software in Linux/Windows. * In order to be able to log in , please insert “root” as a username as follows:\ ![](/files/dLpHqJBDFo29nkMY6ecw) **Final stages** The following stages need to be done in order to finalise the imaging: 1. Run `fdisk /dev/mmcblk0` if using SD or eMMC. 2. 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). 3. Write the new partition, when prompt about ‘Do you want to remove the signature?’ then answer with Yes. 4. Run `resize2fs /dev/mmcblk0p2` if using SD Card or eMMC. 5. In this stage the root partition should be big enough to start populating it; but first update the RTC clock. 6. Connect the RJ45 to your network with internet access (and DHCP server); and then run `dhclient`. 7. Update the RTC clock by running `ntpdate pool.ntp.org` and then `hwclock -w`. 8. 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): ![](/files/TNnSYtvMiwQF8NCNsdKA) After those steps you should end the process in this way (step 4 to the end): ![](/files/CAnp3k0NiTyraMrm7V1k) In the end you should see with “lsblk” that the partition size is in the required size. ### **More Features** #### Internet Connect an Ethernet cable to your HummingBoard Pulse (for internet access during boot-up).\ Models HummingBoard with WiFi, can be connected via [WiFi](/nxp/imx8/sbc-platform/cubox-m-quick-start-guide.md#wifi) or wired Ethernet. * Please check you Ethernet connection. * Use the following commands in order to keep your system up-to-date: ``` apt-get update apt-get upgrade reboot ``` * For more detailed information, please refer to [RZ/G2LC Debian](https://github.com/SolidRun/documentation/blob/bsp/imx8/debian-11_sr8.md) . **WiFi** * You can connect to WiFi using any application, such as : [connmanctl](https://manpages.debian.org/testing/connman/connmanctl.1.en.html) or [wpa\_spplicant](https://wiki.archlinux.org/title/wpa_supplicant). An example for connecting to WiFi using wpa\_supplicant: 1. To bring a WiFi interface up, run the following : ``` $ ifconfig wlan0 up ``` {% hint style="info" %} To discover your wireless network interface name, see [Network Interfaces](https://wiki.archlinux.org/title/Network_configuration#network_interfaces). {% endhint %} 2. Install the wpa\_supplicant package: ``` $ apt-get install wpasupplicant ``` 3. Edit network interfaces file : At the bottom of the file, add the following lines to allow wlan as a network connection: ``` cat < /etc/network/interfaces.d/wlan0 allow-hotplug wlan0 iface wlan0 inet dhcp wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf iface default inet dhcp EOF ``` 4. Create a configuration file with the relevant ssid: ``` cat < /etc/wpa_supplicant/wpa_supplicant.conf ctrl_interface=/run/wpa_supplicant update_config=1 network={ ssid="MYSSID" psk="passphrase" } EOF ``` {% hint style="info" %} Check your personal ssids by running : ‘iw dev wlan0 scan’ {% endhint %} 5. Make sure it works: Restart your device and it should connect to the wireless network. You can check it by running the command `$ iwconfig` . If it doesn't, repeat above steps or get help from an adult. * For more information about using wpa\_supplicant , you can refer to [wpa\_supplicant](https://www.linuxbabe.com/command-line/ubuntu-server-16-04-wifi-wpa-supplicant) or [wpa\_supplicant](https://blog.nelhage.com/2008/08/using-wpa_supplicant-on-debianubuntu/). #### Bluetooth 1. For showing all Bluetooth devices, run the following: ``` $ apt-get install bluez $ bluetoothctl ``` 2. Turn the device on: ``` [bluetooth]# power on ``` 3. Make your Bluetooth detectable by other devices: ``` [bluetooth]# discoverable on ``` 4. If you want to connect to other devices: * Start by scanning for other Bluetooth devices: ``` [bluetooth]# scan on ``` * Choose a MAC address and connect : ``` [bluetooth]# pair $MAC ``` * You can check the pairing list between the devices by writing : ``` [bluetooth]# paired-devices ``` #### Cellular Modem The cellular modem is a more fully featured extension of which contains a cellular module with additional hardware interfaces and a SIM card slot. You can connect your cellular modem to the mPCIe, and insert a SIM card. * How to connect to the network:\ 1\. Install “modemmanager” package on your debian. ``` $ sudo apt install modemmanager ``` 2\. Search for your modem location: ``` $ mmcli -L ``` 3\. Connect to your modem: ``` $ mmcli --modem=/your/modem/location ``` 4\. Enable the modem: ``` $ mmcli --modem=/your/modem/location -e ``` 5\. Scan for networks: ``` $ mmcli --modem=/your/modem/location --3gpp-scan ``` 6\. connect to 3gpp network: ``` $ mmcli --modem=/your/modem/location --3gpp-register-in-operator= ``` 7\. Make sure the connection was created: ``` $ mmcli --modem=/your/modem/location ``` * For some cellular modules to be connected, please refer to [Cellular Modules](/nxp/imx6/sbc-platform/imx6-other-articles/cellular-modules.md) . **GUI On Debian** There is an option with the **Debian** image, up to the user, to work with a GUI like Weston, GNOME and etc.\ For applying this option do the following steps: First, connect your device to a screen using the working output (HDMI / uHDMI). For working with **Weston** GUI: 1. Install the Weston package. ``` sudo apt install weston ``` 2. Set the XDG\_RUNTIME\_DIR env param. ``` cat << 'EOF' > /etc/profile.d/weston.sh if test -z "$XDG_RUNTIME_DIR"; then export XDG_RUNTIME_DIR=/run/user/`id -u` if ! test -d "${XDG_RUNTIME_DIR}"; then # Make a directory for the output of the Weston GUI mkdir --parents "${XDG_RUNTIME_DIR}" chmod 0700 "${XDG_RUNTIME_DIR}" fi fi EOF ``` 3. Restart the system ``` reboot ``` 4. Start Weston (must be run from the **Dissplay Terminal**) ``` weston ``` {% hint style="info" %} Run the `weston` command from the **Dissplay Terminal** using keyboard (PHYSICAL TERMINAL not serial session or remote connection) {% endhint %} For working with **GNOME** GUI on top of Xorg: 1. Install Xorg. ``` $ sudo apt install xorg ``` 2. Install your desired gnome. ``` $ sudo apt install gnome-session ``` NOTE: ‘gnome-session’ is an example of gnome that we can work with, you can replace the ‘session' with another GNOME extention. 3. Start your GNOME GUI. ``` $ sudo systemctl start gdm ``` * For logging in you need a user on your device to log into it. You can create one before step 3 by this command (replace the ‘username’ with name that you want) : ``` $ sudo adduser username ``` * You can jump between GUIs that you install (like gnome-session) by the setting button that locates in the down right corner of the home screen. ## List Of Supported OS | **OS** | | | -------------------------------- | -------------------------------------------------------------------- | | ![](/files/ImHWJmfF4P3oYZioMt5Z) | [Debian](https://github.com/SolidRun/build_rzg2lc) | | ![](/files/PlmAE45Q3UFzqgv7QbHP) | [RZ/G2L Yocto](https://github.com/SolidRun/meta-solidrun-arm-rzg2lc) | | ![](/files/njazv9ZRULsuUuzHC3CU) | [Buildroot](https://github.com/SolidRun/build_rzg2lc) | ## Build from source * [Buy a Sample Now](https://shop.solid-run.com/product/SRG2L-EVKHR-R00/) ## Documentation | | File | Modified | | - | ---- | -------- | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://dev.solid-run.com/renesas/rz-g2l-v2l/sbc-platform/hummingboard-pro-rz-v2l-som-quick-start-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.