Hailo-10H-runtime-installatie en CV-modelimplementatie

Via deze handleiding installeer en controleer je de Hailo-10H-runtime en implementeer je een AI Lab CV-model op een Raspberry Pi CM5 met een PCIe Hailo-10H-accelerator. Deze pagina beschrijft de algemene workflow voor device, runtime en container; modelspecifieke argumenten staan op de betreffende modelkaart. De Hailo-10H gebruikt zijn eigen HEF, image, Python-binding en HailoRT-bibliotheek; niets hiervan mag worden gecombineerd met Hailo-8-artefacten.

1. Runtime installeren en controleren

Installeer op een ondersteunde Raspberry Pi OS-image het Hailo-10H-hostpakket en herstart vóór het eerste gebruik:

bash

sudo apt update
sudo apt install hailo-h10-all -y
sudo reboot

Controleer na opnieuw verbinden de hardware:

bash

lspci -nn | grep -i hailo
lsmod | grep hailo
hailortcli --version
ls -l /dev/hailo0
sudo hailortcli fw-control identify

Verwacht resultaat: het PCIe-apparaat wordt herkend als Hailo-10H en /dev/hailo0 bestaat. Is dit niet het geval, los dan driver-, PCIe- of voedingsproblemen op voordat je een modelcontainer start.

2. Model-image ophalen

Gebruik de exacte Hailo-10H-image die op de AI Lab-modelkaart staat:

bash

sudo docker pull ghcr.io/seeed-projects/recomputer-hailo10h-cv/<model>:latest

3. Model uitvoeren

Vervang de placeholders door de opdracht van de modelkaart. Zowel de geversioneerde HailoRT-shared library als de ongeversioneerde symlink moeten worden gemount.

bash

sudo docker run --rm \
  --name cm5-hailo10h-<model> \
  --privileged \
  --net=host \
  -e PYTHONUNBUFFERED=1 \
  --device /dev/hailo0:/dev/hailo0 \
  -v /usr/lib/libhailort.so.5.1.1:/usr/lib/libhailort.so.5.1.1:ro \
  -v /usr/lib/libhailort.so:/usr/lib/libhailort.so:ro \
  ghcr.io/seeed-projects/recomputer-hailo10h-cv/<model>:latest \
  python web_detection.py --model_path model/<model>.hef --video_path video/test.mp4

Open http://<BOARD_IP>:8000 zodra de service meldt dat het webvoorbeeld gereed is. Behoud alle modelspecifieke argumenten van de kaart, inclusief eventuele secundaire HEF's die in tweetraps-pipelines worden gebruikt.

4. Veelvoorkomende problemen oplossen

Symptoom	Controle
`/dev/hailo0` bestaat niet	Controleer of `lspci` de Hailo-10H ziet, of de driver is geladen en herstart na installatie.
`Failed to open device file`	Controleer de apparaatrechten, het `--device`-argument van de container en de HailoRT-hostconfiguratie.
HailoRT Python- of shared-library-fout	Gebruik de Hailo-10H-image en mount zowel `libhailort.so.5.1.1` als `libhailort.so`.
Fout in de inference-API	Controleer of de image-tag de vastgelegde applicatiecode bevat en of de HEF specifiek voor Hailo-10H is.

5. Voordat je een nieuw model publiceert

Valideer de image en de opdracht op fysieke Hailo-10H-hardware. Voeg daarna het image-pakket als downloadSources-vermelding toe in AI Lab en maak een speciale Hailo-10H-wiki aan, zodat gebruikers na het kiezen van het platform de juiste opdracht ontvangen.