361 字
2 分钟
在运行 Ubuntu 24.04 的 Raspberry Pi 5 上安装 Hailo-8

1. 下载并烧录 Ubuntu#

下载 Ubuntu#

下载适用于 Raspberry Pi 的 Ubuntu 24.04。

向下滚动,找到 Preinstalled desktop image(预安装桌面镜像)。

适用于 Raspberry Pi Generic(64 位 ARM)的 Ubuntu 预安装桌面镜像下载入口

使用 Raspberry Pi Imager 或其他烧录工具,将镜像写入 microSD 卡或 SSD。

验证安装#

Terminal window
cat /etc/os-release

确认输出中的系统版本为 Ubuntu 24.04 LTS。

2. 启用 PCIe Gen3#

编辑固件配置文件:

Terminal window
sudo nano /boot/firmware/config.txt

添加以下配置:

dtparam=pciex1_gen=3

重启系统#

Terminal window
sudo reboot

验证 PCIe 速率#

Terminal window
sudo lspci -vv | grep LnkSta

检查输出中是否包含以下速率和带宽:

LnkSta: Speed 8GT/s, Width x1

3. 确认硬件状态#

检查 PCIe 设备是否已被识别:

Terminal window
lspci

示例输出(PCIe 地址可能不同):

06:00.0 Co-processor: Hailo Technologies Ltd. Hailo-8 AI Processor

4. 安装依赖#

更新系统#

Terminal window
sudo apt update
sudo apt full-upgrade -y

安装所需软件包#

Terminal window
sudo apt install -y \
build-essential \
dkms \
linux-headers-$(uname -r)

5. 下载并安装 Hailo 软件和驱动#

下载软件包#

从 Hailo Developer Zone 下载以下软件包:

  • HailoRT
  • HailoRT PCIe Driver
  • TAPPAS

Hailo Developer Zone 软件下载页面,已选择 Hailo-8/8L、HailoRT、ARM64、Linux 和 Python 3.12

以下命令用于安装 HailoRT 和 PCIe 驱动。

安装驱动#

在下载的软件包所在目录中执行:

Terminal window
sudo dpkg -i \
hailort_*.deb \
hailort-pcie-driver_*.deb

修复依赖#

Terminal window
sudo apt -f install

重启系统#

Terminal window
sudo reboot

请确保 hailort 与 hailort-pcie-driver 的版本一致。

6. 验证安装#

验证固件通信#

Terminal window
hailortcli fw-control identify

检查驱动版本#

Terminal window
modinfo hailo_pci | grep version
在运行 Ubuntu 24.04 的 Raspberry Pi 5 上安装 Hailo-8
https://blog.hanzogenji.cn/zh-cn/posts/tutorials/install-hailo-8-raspberry-pi-5-ubuntu-24-04/
作者
Hanzo Huang
发布于
2026-10-16
许可协议
CC BY-NC-SA 4.0