Instalación del runtime de Hailo-10H e implementación de modelos de visión artificial

Utilice esta guía para instalar y verificar el runtime de Hailo-10H e implementar un modelo de visión artificial de AI Lab en una Raspberry Pi CM5 con un acelerador PCIe Hailo-10H. Esta página cubre el flujo de trabajo común del dispositivo, el runtime y el contenedor; los argumentos específicos de cada modelo permanecen en la tarjeta correspondiente. Hailo-10H utiliza su propio HEF, imagen, enlace de Python y biblioteca HailoRT; no se deben mezclar con artefactos de Hailo-8.

1. Instalar y verificar el runtime

En una imagen de Raspberry Pi OS compatible, instale el paquete host de Hailo-10H y reinicie antes del primer uso:

bash

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

Después de reconectarse, verifique el hardware:

bash

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

Resultado esperado: el dispositivo PCIe se identifica como Hailo-10H y existe /dev/hailo0. Si no es así, resuelva los problemas de controlador, PCIe o alimentación antes de ejecutar un contenedor de modelo.

2. Descargar la imagen del modelo

Utilice la imagen exacta de Hailo-10H que se muestra en la tarjeta del modelo de AI Lab:

bash

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

3. Ejecutar el modelo

Reemplace los marcadores de posición con el comando de la tarjeta del modelo. Se deben montar tanto la biblioteca compartida versionada de HailoRT como el enlace simbólico sin versión.

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

Abra http://<BOARD_IP>:8000 cuando el servicio indique que la vista previa web está lista. Conserve los argumentos específicos del modelo que aparezcan en la tarjeta, incluidos los HEF secundarios utilizados por tuberías de dos etapas.

4. Diagnosticar fallos comunes

Síntoma	Comprobación
`/dev/hailo0` no existe	Confirme que `lspci` vea Hailo-10H, que el controlador esté cargado y reinicie después de la instalación.
`Failed to open device file`	Verifique los permisos del dispositivo, el argumento `--device` del contenedor y la configuración del host de HailoRT.
Error de Python o biblioteca compartida de HailoRT	Use la imagen de Hailo-10H y monte tanto `libhailort.so.5.1.1` como `libhailort.so`.
Error de la API de inferencia	Confirme que la etiqueta de la imagen incluya el código de aplicación fijo y que el HEF sea específico de Hailo-10H.

5. Antes de publicar un nuevo modelo

Valide la imagen y el comando en hardware físico Hailo-10H. Luego, agregue el paquete de la imagen como una entrada de downloadSources en AI Lab y cree una Wiki dedicada a Hailo-10H para que los usuarios reciban el comando correcto después de elegir la plataforma.