Solución de la comunidad

Google Coral PCIe en ZimaOS para Frigate: el controlador Gasket, la integración 1.4.1 y el límite del TPU USB

A May 2025 thread where IceWhale built a dedicated ZimaOS beta with the Google Coral gasket driver for a Mini PCIe Edge TPU. The original poster confirmed it worked, and Zima-Jerry later confirmed the gasket driver was integrated into official ZimaOS 1.4.1. Later replies opened a separate USB Coral support discussion.

Esta fuente cuenta con una sólida cadena de verificación oficial. El usuario no pudo instalar el controlador PCIe de Coral de Google con apt o dpkg porque ZimaOS incluye los controladores de hardware como parte de la imagen del sistema. Por ello, Zima-Jerry creó un paquete específico de kernel/actualización que contenía el controlador gasket, el usuario lo instaló y el Coral Edge TPU comenzó a funcionar.

IceWhale confirmó posteriormente que el controlador gasket estaba integrado en la versión oficial de ZimaOS 1.4.1. Por tanto, los usuarios actuales no deben descargar el antiguo RAUCB de prueba ni intentar instalar paquetes Debian de Coral en el host de ZimaOS.

Las instrucciones originales del controlador Debian no eran adecuadas para ZimaOS

La configuración de Coral PCIe de Google para Linux tradicionalmente presupone una distribución de propósito general en la que se pueden instalar paquetes y módulos del kernel después de implementar el sistema operativo. ZimaOS es diferente: Zima-Jerry indicó explícitamente que los controladores de hardware vienen precompilados en el sistema y normalmente no se pueden añadir después mediante comandos del gestor de paquetes.

IceWhale creó una imagen de prueba específica con el controlador gasket

Zima-Jerry creó un paquete especial de actualización de ZimaOS con kernel 6.12 que incluía el controlador gasket y le indicó al usuario que lo instalara con RAUC. También advirtió que era una compilación beta y que se podía utilizar la ranura de sistema alternativa si la prueba fallaba.

Ese RAUCB de prueba se creó para su validación en mayo de 2025. No debe tratarse como un paquete de instalación actual.

El usuario de la fuente confirmó que el TPU Coral PCIe funcionaba

Terminal de ZimaOS que muestra un dispositivo Global Unichip Coral Edge TPU PCIe detectado por lspci
El autor original confirmó que el dispositivo Coral PCIe apareció después de instalar la compilación de prueba con el controlador gasket.

Se trata de un éxito verificado por el usuario, no simplemente de un parche de controlador propuesto.

ZimaOS 1.4.1 oficial integró el controlador gasket

Después de que se publicara la versión 1.4.1, el usuario preguntó si la actualización eliminaría el controlador funcional. Zima-Jerry respondió que la versión 1.4.1 ya había integrado el controlador gasket y que el usuario podía actualizar con confianza.

Esa es la conclusión sólida de la fuente.

No reinstales el antiguo controlador de prueba en el ZimaOS actual

Las versiones actuales de ZimaOS heredan la línea posterior del kernel y los controladores del sistema, no la imagen de prueba personalizada de mayo de 2025. Primero comprueba si se detecta el TPU PCIe:

lspci -nn
ls /dev/apex_*

Si el dispositivo no aparece en una versión actual, recopila el ID PCI exacto y la versión de ZimaOS en lugar de instalar sobre el sistema el antiguo paquete beta.

Frigate aún necesita acceso al dispositivo TPU

La compatibilidad con el controlador del host es solo la primera capa. El contenedor de Frigate también debe recibir el dispositivo Edge TPU correspondiente, normalmente un nodo de dispositivo Apex para Coral PCIe, y la configuración del detector de Frigate debe coincidir con el hardware.

Usa la guía actual sobre hardware Coral PCIe junto con la versión de Frigate que realmente ejecutes.

Coral USB utiliza una ruta independiente de controlador y dispositivo

El mismo hilo del foro se amplió posteriormente con solicitudes sobre Coral USB. Los dispositivos USB pueden aparecer primero como 1a6e:089a y posteriormente como 18d1:9302 después de la inicialización. Esa ruta USB no utiliza el mismo flujo gasket/apex de PCIe.

Terminal de ZimaBoard 2 que muestra una TPU Google Coral USB detectada con lsusb como 18d1:9302
Las respuestas posteriores de la fuente trataron Coral USB por separado; la compatibilidad con gasket para PCIe no debe generalizarse a los dispositivos USB.

El hilo demuestra cómo funcionan las solicitudes de controladores de ZimaOS

En ZimaOS, la ausencia de un controlador del kernel normalmente es un problema de integración de la imagen del sistema, no un motivo para apt install paquetes en el host. Proporciona a IceWhale el ID del dispositivo, el controlador/módulo ascendente requerido y la versión actual de ZimaOS para que el controlador pueda validarse en la compilación del sistema.

Verifica tanto la enumeración PCI como el nodo de dispositivo Apex

Una comprobación actual útil no consiste únicamente en verificar si lspci muestra el dispositivo Global Unichip/Coral, pero si el controlador gasket/apex ha creado el nodo de dispositivo esperado, como /dev/apex_0. La enumeración PCI sin el nodo de dispositivo puede significar que el hardware es visible, pero que el controlador en tiempo de ejecución no está completamente asociado.

Frigate debe usar correctamente el tipo de detector Coral PCIe

Después de que el host exponga la TPU, asigna el dispositivo Apex al contenedor de Frigate y configura el detector según la sintaxis actual de Frigate Edge TPU. No reutilices el ejemplo USB posterior dispositivo: usb para una Coral PCIe.

No fijes el NAS para siempre a la RAUCB de prueba antigua

El usuario original estaba comprensiblemente preocupado de que una actualización normal pudiera eliminar el nuevo controlador. IceWhale resolvió esa preocupación integrando gasket en la versión oficial 1.4.1. Una vez que un controlador probado pasa a formar parte de la compilación normal del sistema, permanecer en la imagen beta privada implica más riesgos que volver a la línea de versiones compatibles.

Preguntas frecuentes sobre Coral en ZimaOS

¿La prueba del controlador gasket para Coral PCIe funcionó realmente?

Sí. El autor original confirmó que la TPU PCIe se detectó y funcionaba.

¿Se incluyó posteriormente la compatibilidad con gasket en una versión oficial de ZimaOS?

Sí. Zima-Jerry confirmó explícitamente que se integró en ZimaOS 1.4.1.

¿Eso demuestra automáticamente que todas las TPU Coral USB funcionan?

No. Coral USB sigue una ruta independiente de controlador/dispositivo USB que se analiza más adelante en el hilo.