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 |
|---|---|---|---|
| Yazan | 1.0 | Initial release |
Table of Contents | |||
Hardware Setup
Product specifications
Model | HummingBoard IIOT |
|---|---|
SOM Model | NXP i.MX8M Plus Dual / Quad core Arm Cortex A53 up to 1.8GHz (with Arm M7 GPP) |
Memory & Storage | Up to 4GB LPDDR4 |
Network | 2 x Ethernet RJ45 10/100/1000 |
Connectivity | 1 x USB3.0 (OTG) |
Media | LVDS |
I/O | 1 x Reset button |
Misc | TPM2.0 |
OS Support | Linux |
Environment | Commercial: 0°C to 70°C |
Dimensions | PCBA: 140 x 90mm |
Power | 7V – 28V wide range |
Enclosure | Optional extruded aluminum (IP32) enclosure |
Supported with i.MX8M-PLUS SOM. For more detailed information about our SOM-i.MX8M series please visit this user manual : i.MX8M Plus SOM Hardware User Manual .
Block Diagram
The following figure describes the i.MX8M Pro Block Diagram.
Visual features overview
Please see below the features overview of the connector side of the HummingBoard IIOT.
Print side connector overview of the HummingBoard IIOT.
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
Before powering up the board for the first time it is recommended to select the boot media using onboard DIP switch S5:
Switch | 1 | 2 | 3 | 4 | 5 | 6 |
|---|---|---|---|---|---|---|
uSD | ON | ON | OFF | OFF | ON | OFF |
eMMC | OFF | ON | OFF | OFF | ON | OFF |
USB OTG | ON | OFF | OFF | OFF | ON | OFF |
Internal Fuses | OFF | OFF | OFF | OFF | ON | OFF |
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.
Booting from SD card
Boot Select
Here is the correct DIP switch position for SD boot:
Note: The black rectangle represents the switch position.
Once you set the switches, you can apply the following for booting from an SD card.
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/IMX8/imx8mp_build/build_date_20240806-rev_449b768/imx8mp-sdhc-debian-449b768.img.xz
For more Debian releases, please visit Debian Release for i.MX8.
Writing the image to the SD card
Use the following commands for writing the image to an SD card:
xz -dc imx8mp-sdhc-debian-449b768.img.xz | sudo dd of=/dev/sdX bs=4k conv=fdatasync status=progress
For more information, please visit Flashing an SD Card .
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.
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.
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 and password as follows:
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 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 .
WiFi
You can connect to WiFi using any application, such as : connmanctl or wpa_spplicant.
An example for connecting to WiFi using wpa_supplicant:
To bring a WiFi interface up, run the following :
ifconfig wlan0 up
To discover your wireless network interface name, see Network Interfaces.
Install the wpa_supplicant package:
apt-get install wpasupplicant
Edit network interfaces file :
At the bottom of the file, add the following lines to allow wlan as a network connection:
cat <<EOF > /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
Create a configuration file with the relevant ssid:
cat <<EOF > /etc/wpa_supplicant/wpa_supplicant.conf
ctrl_interface=/run/wpa_supplicant
update_config=1
network={
ssid="MYSSID"
psk="passphrase"
}
EOF
Check your personal ssids by running : ‘iw dev wlan0 scan’
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 or wpa_supplicant.
Bluetooth
For showing all Bluetooth devices, run the following:
apt-get install bluez hciconfig -a
Choose a device, and turn it on:
hciconfig hci0 up
Set up the Bluetooth name:
hciconfig hci0 name 'SolidRun_Ble'
Make your Bluetooth detectable by other devices:
hciconfig hci0 piscan
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 .
SPI
For testing you serial peripheral interface - SPI, please see this documentation SPI from Linux with spidev.
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:
Install the Weston package.
$ sudo apt install weston
Make a directory for the output of the Weston GUI.
$ mkdir /your/directory/location
Give permissions to this directory.
$ chmod 0700 /your/directory/location
Set the XDG_RUNTIME_DIR env param to your directory.
$ export XDG_RUNTIME_DIR=/your/directory/location
Run Weston.
$ weston
For working with GNOME GUI on top of Xorg:
Install Xorg.
$ sudo apt install xorg
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.
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.
Basler Camera
For getting started with the Camera Module on your board, please see this documentation Basler Camera Quick Start Guide.
TLV EEPROM Support
Starting from April 01. 2022, the EEPROMs on Carriers, i.MX8M Plus SoMs are being programmed with identifying information such as the product name and SKUs to allow for programmatic identification of hardware. Check our iMXMP EEPROM documentation for additional information.
