Soluzione della community

Google Coral PCIe su ZimaOS per Frigate: il driver Gasket, l’integrazione 1.4.1 e il limite 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.

Questa fonte presenta una solida catena di verifiche ufficiali. L'utente non è riuscito a installare il driver Coral PCIe di Google con apt oppure dpkg perché ZimaOS distribuisce i driver hardware come parte dell'immagine di sistema. Zima-Jerry ha quindi creato un pacchetto dedicato del kernel e degli aggiornamenti contenente il driver gasket, l'utente lo ha installato e la Coral Edge TPU ha iniziato a funzionare.

IceWhale ha poi confermato che il driver gasket era integrato nella versione ufficiale di ZimaOS 1.4.1. Gli utenti attuali non dovrebbero quindi scaricare il vecchio RAUCB di test né cercare di installare i pacchetti Coral Debian sull'host ZimaOS.

Le istruzioni originali dei driver Debian non erano adatte a ZimaOS

La configurazione Linux Coral PCIe di Google presuppone tradizionalmente una distribuzione generica in cui i pacchetti e i moduli del kernel possono essere installati dopo la distribuzione del sistema operativo. ZimaOS è diverso: Zima-Jerry ha dichiarato esplicitamente che i driver hardware sono precompilati nel sistema e normalmente non possono essere aggiunti in seguito con comandi del gestore pacchetti.

IceWhale ha creato un'immagine di test dedicata al driver gasket

Zima-Jerry produsse un pacchetto di aggiornamento speciale di ZimaOS con kernel 6.12 e driver gasket e disse all'utente di installarlo con RAUC. Avvertì inoltre che si trattava di una build beta e che, in caso di errore del test, si sarebbe potuto usare lo slot di sistema alternativo.

Quel RAUCB di test era stato creato per la convalida nel maggio 2025. Non deve essere considerato un pacchetto di installazione attuale.

L'utente della fonte ha confermato che la TPU Coral PCIe funzionava

Terminale di ZimaOS che mostra un dispositivo Global Unichip Coral Edge TPU PCIe rilevato da lspci
L'autore originale del post confermò che il dispositivo Coral PCIe era comparso dopo la build di test del driver gasket.

Si tratta di un successo verificato dall'utente, non semplicemente di una patch del driver proposta.

ZimaOS 1.4.1 ufficiale ha integrato il driver gasket

Dopo il rilascio della versione 1.4.1, l'utente chiese se l'aggiornamento avrebbe rimosso il driver funzionante. Zima-Jerry rispose che la versione 1.4.1 aveva già integrato il driver gasket e che l'utente poteva aggiornare tranquillamente.

Questa è la conclusione solida della fonte.

Non reinstallare il vecchio driver di test sulle versioni attuali di ZimaOS

Le versioni attuali di ZimaOS ereditano la linea successiva del kernel e dei driver di sistema, non l'immagine di test personalizzata di maggio 2025. Verifica innanzitutto se la TPU PCIe è stata rilevata:

lspci -nn
ls /dev/apex_*

Se il dispositivo manca in una versione attuale, raccogli l'ID PCI esatto e la versione di ZimaOS invece di sovrapporre il vecchio pacchetto beta al sistema.

Frigate deve ancora poter accedere al dispositivo TPU

Il supporto del driver host è solo il primo livello. Anche il container Frigate deve ricevere il dispositivo Edge TPU appropriato, in genere un nodo dispositivo Apex per Coral PCIe, e la configurazione del rilevatore di Frigate deve corrispondere all'hardware.

Usa le indicazioni aggiornate di Coral sull’hardware PCIe insieme alla versione di Frigate effettivamente utilizzata.

Coral USB utilizza un percorso separato di driver e dispositivo

Lo stesso thread del forum si è poi ampliato alle richieste relative a Coral USB. I dispositivi USB possono apparire inizialmente come 1a6e:089a e successivamente come 18d1:9302 dopo l’inizializzazione. Questo percorso USB non utilizza lo stesso flusso gasket/apex PCIe.

Terminale di ZimaBoard 2 che mostra un TPU Coral USB di Google rilevato con lsusb come 18d1:9302
Le risposte successive della fonte hanno trattato separatamente Coral USB; il supporto gasket per PCIe non dovrebbe essere generalizzato ai dispositivi USB.

Il thread dimostra come funzionano le richieste di driver per ZimaOS

Su ZimaOS, l’assenza di un driver del kernel è normalmente un problema di integrazione nell’immagine del sistema, non un motivo per apt install pacchetti nell’host. Fornisci a IceWhale l’ID del dispositivo, il driver/modulo upstream richiesto e la versione attuale di ZimaOS, così che il driver possa essere convalidato nella build del sistema.

Verifica sia l’enumerazione PCI sia il nodo del dispositivo Apex

Un controllo utile e aggiornato non consiste solo nel verificare se lspci elenca il dispositivo Global Unichip/Coral, ma bisogna verificare se il driver gasket/apex ha creato il nodo del dispositivo previsto, ad esempio /dev/apex_0. L’enumerazione PCI senza il nodo del dispositivo può indicare che l’hardware è visibile, mentre il driver di runtime non è ancora completamente associato.

Frigate deve utilizzare correttamente il tipo di rilevatore Coral PCIe

Dopo che l’host espone il TPU, associa il dispositivo Apex al container Frigate e configura il rilevatore in base alla sintassi Edge TPU attuale di Frigate. Non riutilizzare il successivo esempio USB dispositivo: usb per un Coral PCIe.

Non mantenere il NAS per sempre sulla vecchia RAUCB di test

L’utente della fonte era comprensibilmente preoccupato che un normale aggiornamento potesse rimuovere il nuovo driver. IceWhale ha risolto il problema integrando gasket nella versione ufficiale 1.4.1. Una volta che un driver testato entra a far parte della normale build del sistema, rimanere sull’immagine beta privata comporta più rischi che tornare al ramo delle versioni supportate.

FAQ su Coral in ZimaOS

Il test del driver gasket per Coral PCIe ha funzionato davvero?

Sì. L’autore originale ha confermato che il TPU PCIe è stato rilevato e funziona.

Il supporto per gasket è stato incluso successivamente in una versione ufficiale di ZimaOS?

Sì. Zima-Jerry ha confermato esplicitamente che è stato integrato in ZimaOS 1.4.1.

Questo dimostra automaticamente che ogni TPU Coral USB funziona?

No. Coral USB segue un percorso separato di driver/dispositivo USB, discusso più avanti nel thread.