Gemenskapslösning

Google Coral PCIe på ZimaOS för Frigate: Gasket-drivrutinen, integrering av 1.4.1 och USB-TPU:ns begränsningar

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.

Den här källan har en stark officiell verifieringskedja. Användaren kunde inte installera Googles Coral PCIe-drivrutin med apt eller dpkg eftersom ZimaOS levererar maskinvarudrivrutiner som en del av systemavbildningen. Zima-Jerry byggde därför ett särskilt kärn-/uppdateringspaket som innehöll gasket-drivrutinen, användaren installerade det och Coral Edge TPU började fungera.

IceWhale bekräftade sedan att gasket-drivrutinen var integrerad i den officiella ZimaOS 1.4.1-versionen. Aktuella användare bör därför inte ladda ner den gamla test-RAUCB:n eller försöka installera Debians Coral-paket på ZimaOS-värden.

De ursprungliga Debian-drivrutinsinstruktionerna passade inte ZimaOS

Googles Linux-konfiguration för Coral PCIe förutsätter traditionellt en generell distribution där paket och kärnmoduler kan installeras efter att operativsystemet har distribuerats. ZimaOS fungerar annorlunda: Zima-Jerry sade uttryckligen att maskinvarudrivrutiner är förbyggda i systemet och normalt inte kan läggas till senare med kommandon från pakethanteraren.

IceWhale byggde en särskild testavbildning med gasket-drivrutinen

Zima-Jerry tog fram ett särskilt ZimaOS-uppdateringspaket för kernel 6.12 med gasket-drivrutinen och bad användaren installera det med RAUC. Han varnade också för att det var en betaversion och att den alternativa systemplatsen kunde användas om testet misslyckades.

Den test-RAUCB:n skapades för validering i maj 2025. Den bör inte behandlas som ett aktuellt installationspaket.

Källanvändaren bekräftade att Coral PCIe-TPU:n fungerade

ZimaOS-terminalen visar en Global Unichip Coral Edge TPU PCIe-enhet som upptäckts av lspci
Den ursprungliga inläggsskaparen bekräftade att PCIe Coral-enheten visades efter testversionen med gasket-drivrutinen.

Detta är en användarverifierad framgång, inte bara en föreslagen drivrutinspatch.

Officiella ZimaOS 1.4.1 integrerade gasket-drivrutinen

Efter att 1.4.1 släpptes frågade användaren om en uppgradering skulle ta bort den fungerande drivrutinen. Zima-Jerry svarade att version 1.4.1 redan hade integrerat gasket-drivrutinen och att användaren kunde uppgradera utan problem.

Det är den hållbara slutsatsen från källan.

Installera inte om den gamla testdrivrutinen på aktuella ZimaOS

Aktuella ZimaOS-versioner bygger på den senare kärn- och systemdrivrutinslinjen, inte på den anpassade testavbildningen från maj 2025. Kontrollera först om PCIe-TPU:n upptäcks:

lspci -nn
ls /dev/apex_*

Om enheten saknas i en aktuell version ska du samla in det exakta PCI-ID:t och ZimaOS-versionen i stället för att lägga det gamla betapaketet ovanpå systemet.

Frigate behöver fortfarande åtkomst till TPU-enheten

Stöd för värddrivrutinen är bara det första lagret. Frigate-containern måste också få tillgång till rätt Edge TPU-enhet, vanligtvis en Apex-enhetsnod för PCIe Coral, och Frigates detektorkonfiguration måste matcha hårdvaran.

Använd den aktuella vägledningen om Coral PCIe-maskinvara tillsammans med den Frigate-version du faktiskt kör.

USB Coral använder en separat drivrutins- och enhetssökväg

Samma forumtråd utvidgades senare med förfrågningar om USB Coral. USB-enheter kan först visas som 1a6e:089a och senare som 18d1:9302 efter initiering. Denna USB-sökväg använder inte samma PCIe-gasket-/apex-flöde.

ZimaBoard 2-terminal som visar att en Google Coral USB-TPU upptäcktes med lsusb som 18d1:9302
Senare källsvar behandlade USB Coral separat; PCIe-gasket-stöd bör inte generaliseras till USB-enheter.

Tråden visar hur förfrågningar om ZimaOS-drivrutiner hanteras

I ZimaOS är en saknad kärndrivrutin normalt ett problem med integrationen i systemavbildningen, snarare än ett skäl att apt install paket till värdsystemet. Ange enhets-ID:t, den nödvändiga uppströmsdrivrutinen/-modulen och den aktuella ZimaOS-versionen till IceWhale så att drivrutinen kan valideras i systemavbildningen.

Verifiera både PCI-uppräkningen och Apex-enhetsnoden

En användbar aktuell kontroll är inte bara huruvida lspci visar Global Unichip-/Coral-enheten, men huruvida gasket-/apex-drivrutinen har skapat den förväntade enhetsnoden, exempelvis /dev/apex_0. PCI-uppräkning utan enhetsnoden kan innebära att maskinvaran är synlig medan körningsdrivrutinen inte är fullständigt bunden.

Frigate måste använda rätt detektortyp för PCIe Coral

När värdsystemet exponerar TPU:n mappar du Apex-enheten till Frigate-containern och konfigurerar detektorn enligt den aktuella Frigate-syntaxen för Edge TPU. Återanvänd inte det senare USB-exemplet enhet: usb för en PCIe Coral.

Lås inte NAS-enheten permanent till den gamla testversionen RAUCB

Källanvändaren var förståeligt nog orolig för att en vanlig uppdatering skulle kunna ta bort den nya drivrutinen. IceWhale undanröjde den oron genom att integrera gasket i den officiella versionen 1.4.1. När en testad drivrutin blir en del av den normala systemavbildningen innebär det större risk att fortsätta använda den privata betaversionen än att återgå till den stödda versionslinjen.

Vanliga frågor om Coral i ZimaOS

Fungerade testet av Coral PCIe-gasket-drivrutinen faktiskt?

Ja. Den ursprungliga skribenten bekräftade att PCIe-TPU:n upptäcktes och fungerade.

Inkluderades stöd för gasket senare i en officiell ZimaOS-version?

Ja. Zima-Jerry bekräftade uttryckligen att det integrerades i ZimaOS 1.4.1.

Bevisar det automatiskt att alla Coral USB-TPU:er fungerar?

Nej. USB Coral följer en separat USB-drivrutins-/enhetssökväg som diskuteras senare i tråden.