Communityoplossing

Google Coral PCIe op ZimaOS voor Frigate: het Gasket-stuurprogramma, de 1.4.1-integratie en de USB-TPU-grens

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.

Deze bron heeft een sterke officiële verificatieketen. De gebruiker kon de PCIe-driver van Google's Coral niet installeren met apt of dpkg omdat ZimaOS hardwaredrivers als onderdeel van de systeemimage levert. Daarom bouwde Zima-Jerry een speciaal kernel-/updatepakket met de gasket-driver, installeerde de gebruiker dit en begon de Coral Edge TPU te werken.

IceWhale bevestigde vervolgens dat de gasket-driver was geïntegreerd in de officiële ZimaOS 1.4.1-release. Huidige gebruikers moeten daarom de oude test-RAUCB niet downloaden en geen Debian Coral-pakketten op de ZimaOS-host proberen te installeren.

De oorspronkelijke Debian-driverinstructies waren niet geschikt voor ZimaOS

De Linux Coral PCIe-installatie van Google gaat traditioneel uit van een distributie voor algemeen gebruik, waarop pakketten en kernelmodules na de implementatie van het besturingssysteem kunnen worden geïnstalleerd. ZimaOS is anders: Zima-Jerry zei expliciet dat hardwaredrivers vooraf in het systeem zijn ingebouwd en normaal gesproken niet later met pakketbeheeropdrachten kunnen worden toegevoegd.

IceWhale bouwde een speciale testimage voor de gasket-driver

Zima-Jerry maakte een speciale ZimaOS-updatebundel voor kernel 6.12 met de gasket-driver en vertelde de gebruiker deze met RAUC te installeren. Hij waarschuwde ook dat het om een bètaversie ging en dat het alternatieve systeemslot kon worden gebruikt als de test mislukte.

Die test-RAUCB is in mei 2025 gemaakt voor validatie. Deze moet niet worden beschouwd als een actueel installatiepakket.

De oorspronkelijke gebruiker bevestigde dat de Coral PCIe-TPU werkte

ZimaOS-terminal waarop een Global Unichip Coral Edge TPU PCIe-apparaat wordt weergegeven dat door lspci is gedetecteerd
De oorspronkelijke poster bevestigde dat het PCIe Coral-apparaat zichtbaar werd na de testbuild met de gasket-driver.

Dit is door de gebruiker geverifieerd succes, niet slechts een voorgestelde driverpatch.

Officieel ZimaOS 1.4.1 integreerde de gasket-driver

Nadat 1.4.1 was uitgebracht, vroeg de gebruiker of upgraden de werkende driver zou verwijderen. Zima-Jerry antwoordde dat versie 1.4.1 de gasket-driver al had geïntegreerd en dat de gebruiker met vertrouwen kon upgraden.

Dat is de blijvende conclusie van de bron.

Installeer de oude testdriver niet opnieuw op het huidige ZimaOS

Huidige ZimaOS-releases gebruiken de latere kernel- en systeemdriverlijn in plaats van de aangepaste testimage van mei 2025. Controleer eerst of de PCIe-TPU wordt gedetecteerd:

lspci -nn
ls /dev/apex_*

Als het apparaat in een huidige release ontbreekt, verzamel dan de exacte PCI-ID en ZimaOS-versie in plaats van de oude bètabundel boven op het systeem te installeren.

Frigate heeft nog steeds toegang tot het TPU-apparaat nodig

Ondersteuning door de hostdriver is slechts de eerste laag. De Frigate-container moet ook toegang krijgen tot het juiste Edge TPU-apparaat, doorgaans een Apex-apparaatknooppunt voor PCIe Coral, en de detectorconfiguratie van Frigate moet overeenkomen met de hardware.

Gebruik de actuele Coral-informatie voor PCIe-hardware samen met de Frigate-release die je daadwerkelijk gebruikt.

USB Coral gebruikt een afzonderlijk stuurprogramma- en apparaatpad

Dezelfde forumdiscussie breidde zich later uit naar verzoeken om USB Coral. USB-apparaten kunnen eerst verschijnen als 1a6e:089a en later als 18d1:9302 na initialisatie. Dat USB-pad gebruikt niet dezelfde PCIe-gasket-/apex-flow.

ZimaBoard 2-terminal waarop een Google Coral USB TPU met lsusb wordt gedetecteerd als 18d1:9302
Latere reacties uit de bron gingen afzonderlijk over USB Coral; PCIe-gasketondersteuning mag niet worden veralgemeend naar USB-apparaten.

De discussie laat zien hoe verzoeken om ZimaOS-drivers werken

Op ZimaOS is een ontbrekende kernel-driver normaal gesproken een probleem met de integratie in de systeemimage, en geen reden om apt install pakketten in de host. Geef IceWhale de apparaat-ID, de vereiste upstream-driver/module en de huidige ZimaOS-versie, zodat de driver in de systeembuild kan worden gevalideerd.

Controleer zowel PCI-enumeratie als het Apex-apparaatknooppunt

Een nuttige huidige controle is niet alleen of lspci geeft het Global Unichip-/Coral-apparaat weer, maar of de gasket-/apex-driver het verwachte apparaatknooppunt, zoals /dev/apex_0. PCI-enumeratie zonder het apparaatknooppunt kan betekenen dat de hardware zichtbaar is, terwijl de runtime-driver nog niet volledig is gekoppeld.

Frigate moet het juiste PCIe Coral-detectortype gebruiken

Nadat de host de TPU beschikbaar heeft gemaakt, koppel je het Apex-apparaat aan de Frigate-container en configureer je de detector volgens de huidige Frigate-syntaxis voor Edge TPU. Gebruik het latere USB-voorbeeld niet opnieuw apparaat: usb voor een PCIe Coral.

Pin de NAS niet voor altijd vast aan de oude testversie RAUCB

De oorspronkelijke gebruiker maakte zich begrijpelijkerwijs zorgen dat een normale update de nieuwe driver zou verwijderen. IceWhale nam die zorg weg door gasket te integreren in de officiële versie 1.4.1. Zodra een geteste driver onderdeel wordt van de normale systeemopbouw, brengt het blijven gebruiken van de private bèta-image meer risico met zich mee dan teruggaan naar de ondersteunde releaselijn.

Veelgestelde vragen over Coral op ZimaOS

Werkte de test van de Coral PCIe gasket-driver daadwerkelijk?

Ja. De oorspronkelijke poster bevestigde dat de PCIe TPU werd gedetecteerd en werkte.

Is ondersteuning voor de gasket later opgenomen in een officiële ZimaOS-release?

Ja. Zima-Jerry bevestigde expliciet dat dit in ZimaOS 1.4.1 is geïntegreerd.

Bewijst dat automatisch dat elke Coral USB TPU werkt?

Nee. USB Coral volgt een afzonderlijk USB-stuurprogramma-/apparaatpad dat later in de discussie wordt besproken.