Frigate con Hailo-8L en la Raspberry Pi 5: no aparece /dev/hailo0

🔵 Fuente oficial · leída en octubre de 2026

Montaste el Hailo-8L en la Pi 5 para Frigate, pero ls -l /dev/hailo0 dice que no existe y el contenedor no arranca o no usa el detector.

Por Kike · revisada en octubre de 2026 · Nivel: Intermedio · Cómo verificamos

Por qué pasa (diagnóstico)

• Sin el driver del kernel (hailo_pci) y su firmware cargados, /dev/hailo0 no se crea. Mira lsmod | grep hailo y dmesg | grep -i hailo: si todo va bien, el log termina con «Added board …, /dev/hailo0».
• En Raspberry Pi OS Bookworm el kernel trae un driver Hailo antiguo que, según la doc de Frigate, es incompatible con Frigate y hay que desactivarlo antes de instalar el correcto. En Trixie el driver ya no viene en el kernel (se instala con DKMS) y ese conflicto no aplica.
• Si dmesg no menciona Hailo en absoluto, revisa el montaje: cable plano de PCIe bien asentado y placa bien alimentada. Para elegir detector: serie Voz e IA local.

Solución paso a paso

1. Comprueba tu versión: cat /etc/os-release.
2. Solo en Bookworm: si lsmod | grep hailo muestra hailo_pci, descárgalo con sudo modprobe -r hailo_pci, localiza el módulo con modinfo -n hailo_pci y renómbralo como indica la doc de Frigate; luego sudo depmod -a y reinicia.
3. Instala el driver con el script user_installation.sh que enlaza la doc de Frigate (compila el driver, instala el firmware y las reglas udev) y reinicia.
4. Verifica: ls -l /dev/hailo0, cat /sys/module/hailo_pci/version y ls -l /lib/firmware/hailo/hailo8_fw.bin.
5. Pasa el dispositivo al contenedor en docker-compose.yml: devices: - /dev/hailo0.
6. Si sale el error «max_desc_page_size given 16384 is bigger than hw max desc page size 4096», crea /etc/modprobe.d/hailo_pci.conf con options hailo_pci force_desc_page_size=4096 y reinicia.
7. Con el AI Kit, Raspberry Pi recomienda activar PCIe Gen 3 (dtparam=pciex1_gen=3 en /boot/firmware/config.txt o con raspi-config); en el AI HAT+ se aplica solo. Mejora la velocidad, pero no es lo que hace aparecer /dev/hailo0.

✅ Si ha funcionado verás: ls -l /dev/hailo0 lista el dispositivo y dmesg | grep -i hailo termina con «Firmware was loaded successfully» y «Added board …, /dev/hailo0». hailortcli fw-control identify muestra «Device Architecture: HAILO8L» (o HAILO8).

Requisitos

• Raspberry Pi 5
• AI Kit o AI HAT+ (Hailo-8L o Hailo-8)
• Raspberry Pi OS 64 bits
• Docker
• Frigate

Compatibilidad

• Raspberry Pi 5
• Raspberry Pi OS Bookworm y Trixie (64 bits)
• Hailo-8L / Hailo-8 (no AI HAT+ 2 / Hailo-10H)

Verificación

Pasos tomados de la documentación de instalación de Frigate y de la guía de IA de Raspberry Pi.

Fuentes

• Frigate — Instalación (sección Hailo-8) (en inglés)
• Raspberry Pi — AI software (Hailo en la Pi 5) (en inglés)

Guías relacionadas

• Ollama no usa la GPU
• ¿Mi tarjeta gráfica sirve para Ollama?
• Ollama tarda mucho en la primera respuesta: mantener el modelo cargado
• Frigate: elegir detector (Coral, Hailo o CPU) para visión local
• Usar Ollama (LLM local) como agente de conversación en Home Assistant
• Ollama no responde desde otro ordenador de la red

Más guías de IA local.