Hailo アクセラレータとランタイムの確認

AI Lab コンテナを実行する前に Hailo デバイスを確認します。これにより、ハードウェアやドライバの障害をモデルやアプリケーションの問題から切り離せます。

1. 電源と PCIe 認識の確認

bash

vcgencmd get_throttled
lspci -nn | grep -i hailo

最初のコマンドは通常 throttled=0x0 を返します。2 番目のコマンドは搭載されている 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 のアクセラレータセクションも参照してください。