HummingBoard & Hailo 15 SOM Quick Start Guide
Introduction
The following quick start guide provides background information about the SolidRun Hailo 15 SOM.
The guide will give a technical overview of the product. By the end of it, you should be able to boot an operating system and run a demo application.
Revision and Notes
Date | Owner | Revision | Notes |
---|---|---|---|
May 12, 2024 | Mikhail Anikin | 1.0 | Initial release |
Aug 12, 2024 | Mikhail Anikin | 1.1 | Update flashing process |
Nov 6, 2024 | Mikhail Anikin | 1.2 | Add IIoT support |
Dec 16, 2024 | Mikhail Anikin | 1.3 | Update flashing process |
Dec 22, 2024 | Mikhail Anikin | 1.4 | Introducing SW update |
Table of Contents |
|
Hardware Setup
Product specifications
| Hailo 15 SOM with HummingBoard |
---|---|
I/Os | 1 x MIPI-CSI on SOM |
Networking | 1 x Ethernet RJ45 10/100/1000 |
Processor | Hailo 15 Quad-core Arm Cortex A53 1.3GHz 2 x Cortex M4, 200MHz |
Memory & Storage | up to 8GB DDR4 RAM |
Development and Debug interfaces | Micro USB |
Power | 7V – 36V |
Expansion card I/Os | mikroBUS header |
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 |
For more detailed information about Hailo 15 SOM, please visit the hardware user manual:
Visual Features Overview
Please see below the features overview of the connector side of the HummingBoard Pro & Hailo 15
Software Setup
Cable setup and prerequisites
Here is what you will need to power up and use the board:
Linux or Windows PC
HummingBoard with Hailo 15 SOM
12V Power adapter (HummingBoard has wide range input of 7V-36V, it is recommended to use 12V power adapter).
The micro USB to USB for the console (the HummingBoard has an onboard FTDI chip).
IP router or IP switch
Boot select and boot options
You should select the boot source before powering up the board for the first time.
Hailo 15 with HummingBoard has two boot options: serial boot (for recovery) and eMMC boot (the main option). To select a boot option, the DIP switch needs to be modified.
For more information, see HummingBoard Hailo 15 Boot Select
Generating Yocto image
The prebuilt artifacts are available here.
Navigate to the meta layer repo for the build instructions: meta-solidrun-arm-hailo.
Understanding boot artifacts
The following artifacts are generated by yocto build:
Artifact | Purpose | Target location |
---|---|---|
hailo15_scu_bl.bin | SCU Bootloader | QSPI Flash |
hailo15_scu_fw.bin | SCU Firmware | QSPI Flash |
scu_bl_cfg_a.bin, scu_bl_cfg_b.bin | SCU Configuration | QSPI Flash |
customer_certificate.bin | Customer key certificate | QSPI Flash |
u-boot.dtb.signed | U-Boot device tree | QSPI Flash |
u-boot-initial-env | U-Boot environment | QSPI Flash |
u-boot-spl.bin | U-Boot SPL | QSPI Flash |
u-boot-tfa.itb | TF-A and U-Boot | eMMC Boot partition |
fitImage | Linux kernel and device tree | eMMC Boot partition |
core-image-minimal-hailo15-solidrun.ext4 | RootFS | eMMC Root partition |
core-image-minimal-hailo15-solidrun.wic | Full eMMC image that contains both partitions. It can be flashed with bmap-tools using the .bmap file | eMMC |
hailo15_uart_recovery_fw.bin | Recovery firmware for reflashing QSPI |
|
Booting the board:
The board is pre-flashed with a basic yocto image and AI demos.
Serial connection
Please insert the micro USB into your device. Then, you can refer to Serial Connection to install the necessary serial connection software in Linux/Windows.Network connection
The prebuilt image has a preset network configuration with a static IP10.0.0.1
. Connect your PC to the board with a 1GbE RJ45 patch cord and set the static IP of your PC interface to10.0.0.2
.Optional: Camera connection
To evaluate the demo application, connect the MIPI-CSI camera to the Hailo 15 SOM MIPI-CSI interface before starting the boot.Power the board
Plug in a power supply, and the board will start booting. You will see the boot log in the serial terminal:
Poky (Yocto Project Reference Distro) 4.0.2 hailo15 ttyS1
hailo15 login:
Use the following default credentials:
Login: root
Password: root
Running the demo applications
Using GStreamer
Gstreamer is a CLI application that allows you to send, receive, and convert video streams.
Install gstreamer
For Ubuntu/Debian distros:
sudo apt install gstreamer1.0-plugins-ugly gstreamer1.0-plugins-bad gstreamer1.0-libav
For Fedora/RHEL distros:
sudo dnf install gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-bad-free-gtk
For Windows:
Download the Installer: Go to the GStreamer official website and download the appropriate installer for your Windows version.
Run the Installer: Execute the downloaded file. During installation, select "Complete Installation" to install all basic plugins.
Set Environment Variables: To use GStreamer from the command line, add GStreamer to your system's PATH as described here.
For Windows, you might need to configure the Firewall to allow the stream. Make sure that 10.0.0.2
is a private network.
Run the gstreamer pipeline to start receiving a stream.
On your pc In a bash terminal or Windows cmd run:
gst-launch-1.0 -v udpsrc port=5000 address=0.0.0.0 ! application/x-rtp,encoding-name=H264 ! queue ! rtph264depay ! queue ! h264parse ! avdec_h264 ! queue ! videoconvert ! fpsdisplaysink video-sink=autovideosink text-overlay=false sync=false
Run the demo application on the Hailo15 EVK:
Using VLC
Another option is to receive a stream using VLC media player.\
Install VLC
For Ubuntu/Debian distros:
For Fedora/RHEL distros:
For Windows:
Download the Installer: Go to the VLC official website and download the appropriate installer for your Windows version.
Run the Installer: Execute the downloaded file. During installation, select "Complete Installation" to install all basic plugins.
For Windows, you might need to configure the Firewall to allow the stream. Make sure that 10.0.0.2
is a private network.
Create a stream configuration file
stream.sdp
with the following content:
Open the
stream.sdp
in the vlc using theMedia -> Open File
tab.Run the demo application on the target:
Firmware update process
Updating firmware with SWUpdate (recommended)
A part of the yocto build is a software update package (.swu). This image contains a full rootfs image, bootloaders, and qSPI content and will automatically flash all the artifacts in places.
Run an HTTP server on port 80 in the directory with the update image (.swu)
Reset the board. In the u-boot menu, select
SWUpdate
The board will boot, load the update image from IP 10.0.0.2, port 80 and update all the firmware components.
Manual firmware reflashing
Flashing QSPI flash
Reflashing QSPI is only possible under Linux.
Download the flashing tool and install it into your system.
Set the DIP switch to the Serial download mode.
Close the serial terminal on your PC.
Reset the board.
Upload the uart flashing firmware into the SOM:
Reflash QSPI content:
Sending u-boot over uart
Hailo FW expects a firmware version match between proprietary firmware, SPL, u-boot, and kernel. After qSPI firmware was reflashed with uart boot mode, u-boot with the same fw version should be loaded. SPL uses the UART Y-Modem mode to load the u-boot-tfa.itb
file over the serial connection.
Set the DIP switch to the qSPI boot with Y-modem u-boot load.
Reset the board. You will see the board booted to SPL and expects u-boot to be sent with Y-modem:
U-Boot SPL 2022.01 (Feb 04 2024 - 18:42:25 +0000)
Loading Environment from SPIFlash... OK
U-Boot SPL boot source uart
CCCCCCCCCC
The SPL waits for the Y-modem transfer to upload the u-boot into the RAM. The latest minicom already has a built-in Y-modem transfer function. With minicom, press Ctrl+A, then S, select ymodem
, and then choose file u-boot-tfa.itb
. Note: the transfer can take a few minutes. As soon as the u-boot is completely transferred, you will see the same u-boot entries as usual Proceed to the restoring eMMC with ramdisk.
Restoring eMMC content.
The u-boot menu has a special entry that allows you to load a ramdisk from an HTTP server and boot to it.
Run an HTTP server on port 80 in the directory with the image
In the u-boot menu, select
Boot to flashing ramdisk
The Board will grub a ramdisk from the HTTP server on IP 10.0.0.2, port 80, and boot to it.
Once the board is booted to the ramdisk, flash eMMC:
Reboot the board and restore the DIP switch to the qSPI boot.
List Of Supported OS
Related Articles
Related pages
SolidRun Ltd.