> 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-iiot-rz-g2l-som-quick-start-guide.md). # HummingBoard IIOT & RZ/G2L SOM Quick Start Guide ![IIOT Sideways.png](/files/xXCiRcsV8AifPdDtNjGG) ## Introduction The following quick start guide provides background information about the HummingBoard IIOT. 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** | | ----------- | --------- | ------------ | --------------- | | 29 Sep 2024 | Yazan | 1.0 | Initial release | ## Hardware Setup #### Product specifications | **Model** |



#### HUMMINGBOARD RZ/G2L IIOT SBC

| | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SOM Model |

Renesas RZ/G2L Solo / Dual core Arm Cortex A55
Up to 1.2GHz (With Arm M33)

| | Memory & Storage |

Up to 2GB DDR4
Up to 128GB eMMC
MicroSD

| | Network |

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

| | Connectivity |

3 x USB3.0 ( Host)
M.2 B-Key LTE modem (eSIM, NanoSim)
M.2 M-Key
Additional addon cards are supported\*
SIM card slot

| | Media |

MIPI-DSI
The Evaluation kit comes with 7” touch display MIPI-DSI
MIPI-CSI 4 lanes

| | I/O |

2 x USB2.0
2 x CAN-FD
2x RS232 or 2x RS485, or RS232 + RS485 (SW Configuration)
1 x I/O Digital Input
1 x I/O Digital output
1 x Reset button
1 x ON/OFF button
1 x Configurable push button
1 x RGB LED

| | Misc |

TPM2.0
GPIO
RTC
EEPROM

| | OS Support | Linux | | Environment |

Commercial: 0°C to 70°C
Industrial: -40°C to 85°C

| | Dimensions |

PCBA: 88 x 135 mm
Enclosure :

| | Power |

7V – 28V wide range
PoE sink support 802.3af Class 0
Reverse polarity support

| | Enclosure | Optional extruded aluminum (IP32) enclosure | | | [Buy Now](https://shop.solid-run.com/?s=%22HummingBoard+iiot%22\&post_type=product&_ga=2.156269240.2016484779.1641802897-2012112798.1622706355) | {% hint style="info" %} 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](/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. ![image-20250115-103930.png](/files/rmASTQxEn7XQNH6wAwGE) #### Visual features overview Please see below the features overview of the connector side of the HummingBoard IIOT & RZ/G2L SOM. ![HummingBoard RZ\_G2L IIOT SBC Layout .png](/files/7sDGNxXP8pwMwjdYRoLR) Print side connector overview of the HummingBoard IIOT & RZ/G2L SOM. ![image-20240929-120103.png](/files/kPTd6aI9sseDrYcepBsI) ![image-20241215-105449.png](/files/jjtd0Kigjz9hjL8QRfbj) **Power Input Polarity \[J1]:** * **Connector Type**: Green two-terminal connector \[J1]. * **Voltage Range**: 7V to 32V. * **Polarity**: * **+ (Positive)**: Left terminal (as marked in the image). * **- (Negative)**: Right terminal (as marked in the image). {% hint style="info" %} Plug for connector **J1** : 2 Position Terminal Block Plug, Female Sockets 0.138" (3.50mm). {% endhint %} **J5004** {2x RS485, 2x CAN-FD, 2x RS232, DIG\_IN, DIG\_OUT} ![image-20241013-104136.png](/files/YvSWAsTLiFqwQRilLiBy) ![image-20241121-134703.png](/files/g8abeBT2tysNV9qjh7YL) {% hint style="info" %} Plug for connector **J5004** : 20 Position Terminal Block Plug, Female Sockets 0.138" (3.50mm) like [this](https://www.digikey.com/en/products/detail/phoenix-contact/1738885/3606115). {% endhint %} ## Software Setup #### Cable setup and prerequisites Here is what you will need to power up and use the board: * Linux or Windows PC * HummingBoard IIOT with SOM * 12V Power adapter (HummingBoard IIOT has wide range input of 7V-28V), alternatively you can use a PoE injector to power on the device. * Type-C to USB for console, the HummingBoard IIOT has an onboard FTDI chip. * IP router or IP switch ## Boot Select ![image-20240901-112851.png](/files/7SOOs903pskPsDwPgFeo) Before powering up the board for the first time it is recommended to select the boot media using onboard DIP switch **S5**: | **Switch** |

1
(MD0)

|

2
(MD1)

|

3
(MD2)

|

4
(SD0\_DEV\_SEL)

|

5
(VDD\_1.8V)

|

6
(VDD\_3.3V)

| | --------------------- | ---------------------------------- | ---------------------------------- | ---------------------------------- | -------------------------------------------- | ---------------------------------------- | ---------------------------------------- | | **uSD** | OFF | OFF | OFF | OFF | OFF | **ON** | | **eMMC** | **ON** | OFF | OFF | **ON** | OFF | **ON** | | **Serial Dowanloder** | **ON** | OFF | **ON** | OFF | OFF | **ON** | {% hint style="info" %} **MDx** = BOOT\_MODEx, **VDD\_BOOT** = 1.8V **or** 3.3V (Select S5\[5] **or** S5\[6]) .\ **Note** that **MD1** and **MD0** have been swapped between PCB version 1.1 and PCB version 1.0. {% endhint %} ## Booting from SD card ## Boot Select Here is the correct DIP switch position for SD boot: ![image-20240929-162042.png](/files/nKgrgByBD9LxuA9PLLrn) {% hint style="info" %} Note: The black rectangle represents the switch position. {% endhint %} Once you set the switches, you can apply the following for booting from an SD card. 1. **Downloading the Debian image** Download the Debian image 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](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 rzg2l-solidrun-sd-debian-f22483f.img.xz | dd of=/dev/sdX bs=4k conv=fdatasync ``` * For more information, please visit [Flashing an SD Card](/other-articles/flashing-an-sd-card.md) . {% hint style="info" %} Note: Plug a micro SD into your Linux PC, the following assumes that the micro SD is added as /dev/sdX and all it’s partitions are unmounted. {% endhint %} 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. **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. Once you installed the necessary serial connection software, you should be able to see the following: ![](/files/HCnKay5yrv1chZCVZO4X) * In order to be able to log in , please insert “**root**” as a username and password as follows: ![](/files/DqQFIJyjGw9ycMja4cL8) ## 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 [i.MX8M 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. 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 hciconfig -a ``` 2. Choose a device, and turn it on: ``` hciconfig hci0 up ``` 3. Set up the Bluetooth name: ``` hciconfig hci0 name 'SolidRun_Ble' ``` 4. Make your Bluetooth detectable by other devices: ``` hciconfig hci0 piscan ``` 5. If you want to connect to other devices: * Start by scanning for other Bluetooth devices: ``` hcitool scan ``` * Choose a MAC address and connect : ``` rfcomm connect 0 $MAC 10 & ``` * You can check the communication between the devices by writing : ``` l2ping -c 4 $MAC ``` #### 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. * For some cellular modules to be connected, please refer to [Cellular Modules](/nxp/imx6/sbc-platform/imx6-other-articles/cellular-modules.md) . #### SPI For testing you serial peripheral interface - SPI, please see this documentation [SPI from Linux with spidev](/nxp/imx8/sbc-platform/imx8m-other-articles/spi-from-linux-with-spidev.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. Make a directory for the output of the Weston GUI. ``` $ mkdir /your/directory/location ``` 3. Give permissions to this directory. ``` $ chmod 0700 /your/directory/location ``` 4. Set the XDG\_RUNTIME\_DIR env param to your directory. ``` $ export XDG_RUNTIME_DIR=/your/directory/location ``` 5. Run Weston. ``` $ weston ``` 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. ## TLV EEPROM Support RZ/G2L SoMs are being programmed with identifying information such as the product name, MAC Address and SKUs to allow for programmatic identification of hardware. ## 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 * ## Documentation | | File | Modified | | - | ---- | -------- | No files shared here yet. * Drag and drop to upload or \[browse for files] Upload file File description [Buy a Sample Now](https://shop.solid-run.com/?s=%22HummingBoard+Pulse%22\&post\\_type=product&\\_ga=2.156269240.2016484779.1641802897-2012112798.1622706355) ### Related Articles --- # 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-iiot-rz-g2l-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.