Configuración del runtime Hailo-8 y despliegue de modelos de visión artificial

Esta guía explica cómo verificar el runtime Hailo-8 y desplegar un modelo de visión artificial de AI Lab en una Raspberry Pi CM5 con un acelerador PCIe Hailo-8. Se cubren el dispositivo, el runtime y el flujo de trabajo con contenedores comunes. Los nombres de imagen, los nombres de HEF y los argumentos de posprocesamiento específicos de cada modelo se encuentran en la ficha correspondiente del modelo.

1. Verificar el dispositivo

Ejecuta estos comandos en la Raspberry Pi antes de iniciar un contenedor:

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-8, el controlador PCIe de Hailo está cargado y existe /dev/hailo0. La versión de HailoRT instalada en el host debe coincidir con la que esperan la imagen y el HEF.

2. Descargar la imagen del modelo

Utiliza la imagen exacta que aparece en la ficha del modelo correspondiente de AI Lab:

bash

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

3. Ejecutar el modelo

Esta es la forma estándar de contenedor para Hailo-8. Sustituye los marcadores de posición con el comando de la ficha del modelo; no uses una imagen ni un HEF para Hailo-10H.

bash

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

Cuando el servicio se inicie, abre http://<BOARD_IP>:8000 en un navegador. La ficha del modelo documenta cualquier argumento adicional, como un segundo HEF de detector para una tubería de varias etapas.

4. Diagnosticar fallos comunes

Síntoma	Comprobación
`/dev/hailo0` no existe	Revisa `lspci`, el controlador PCIe y reinicia tras instalar el controlador.
`HAILO_DRIVER_OPERATION_FAILED`	Verifica el controlador/runtime del host, la conexión PCIe y el estado de alimentación.
Error al cargar `libhailort.so`	Monta la biblioteca versionada del host y el enlace simbólico sin versión mostrado arriba.
El modelo no arranca	Comprueba que la imagen, el HEF, la versión principal de HailoRT y el comando específico del modelo estén todos orientados a Hailo-8.

5. Antes de publicar un modelo nuevo

Prueba la imagen en hardware Hailo-8 físico, registra el comando exacto en el README del modelo y en la Wiki de AI Lab, y configura la URL del paquete GHCR en downloadSources de la ficha del modelo.