验证 Hailo 加速器与运行时

在运行 AI Lab 容器之前验证 Hailo 设备，以便将硬件或驱动故障与模型及应用问题区分开来。

1. 检查电源与 PCIe 发现

bash
vcgencmd get_throttled
lspci -nn | grep -i hailo

第一条命令通常应报告 throttled=0x0。第二条命令必须识别出已安装的 Hailo 处理器。如果 PCIe 未检测到设备，请在此处停止排查；重新安装 Python 软件包无法解决 PCIe 枚举缺失的问题。

2. 检查驱动与设备节点

bash
lsmod | grep -E 'hailo1x_pci|hailo_pci'
ls -l /dev/hailo0

Hailo-8 通常使用 hailo_pci 驱动名称，而 Hailo-10H 软件可能使用 hailo1x_pci。具体名称取决于所使用的软件栈。字符设备 /dev/hailo0 必须存在，才能传递给 Docker。

3. 检查 HailoRT 与固件通信

bash
hailortcli --version
sudo hailortcli fw-control identify

identify 命令应报告板卡和设备架构信息，且不出现驱动操作错误。请将输出与内核版本一起记录下来：

bash
uname -r
modinfo hailo_pci 2>/dev/null | grep -E 'version|vermagic' || true
modinfo hailo1x_pci 2>/dev/null | grep -E 'version|vermagic' || true

4. 按顺序诊断故障

结果下一步操作
lspci 中没有 Hailo 条目检查电源、模块安装、M.2/PCIe 兼容性以及产品特定的 PCIe 设置。
PCIe 设备存在但没有 /dev/hailo0检查已加载的驱动并执行 `sudo dmesg -T
设备节点存在但 identify 命令失败检查权限、固件以及 HailoRT/驱动兼容性。
identify 命令成功继续使用对应的 Hailo-8 或 Hailo-10H 部署工具和模型卡片。

对于搭载 Hailo-8 的产品，请同时参阅 Seeed 的 R21xx 系统配置指南 以及具体产品 Wiki 中的加速器部分。