Community-Lösung

Google Coral PCIe unter ZimaOS für Frigate: der Gasket-Treiber, die Integration von 1.4.1 und die USB-TPU-Grenze

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.

Diese Quelle verfügt über eine belastbare offizielle Bestätigungskette. Der Nutzer konnte den PCIe-Treiber von Googles Coral nicht mit apt oder dpkg weil ZimaOS Hardwaretreiber als Bestandteil des System-Images ausliefert. Zima-Jerry erstellte daher ein dediziertes Kernel-/Update-Paket mit dem Gasket-Treiber, der Nutzer installierte es, und das Coral-Edge-TPU begann zu funktionieren.

IceWhale bestätigte anschließend, dass der Gasket-Treiber in die offizielle ZimaOS-Version 1.4.1 integriert wurde. Aktuelle Nutzer sollten daher weder das alte Test-RAUCB herunterladen noch Debian-Coral-Pakete auf dem ZimaOS-Host installieren.

Die ursprünglichen Debian-Treiberanweisungen passten nicht zu ZimaOS

Googles Linux-Anleitung für Coral über PCIe setzt traditionell eine Allzweck-Distribution voraus, auf der Pakete und Kernelmodule nach der Bereitstellung des Betriebssystems installiert werden können. ZimaOS ist anders: Zima-Jerry erklärte ausdrücklich, dass Hardwaretreiber bereits in das System integriert sind und normalerweise später nicht mit Befehlen des Paketmanagers hinzugefügt werden können.

IceWhale erstellte ein dediziertes Test-Image mit Gasket-Treiber

Zima-Jerry erstellte ein spezielles ZimaOS-Update-Bundle für Kernel 6.12 mit dem Gasket-Treiber und wies den Nutzer an, es mit RAUC zu installieren. Er warnte außerdem, dass es sich um einen Beta-Build handelte und bei einem Fehlschlag der alternative System-Slot verwendet werden konnte.

Dieses Test-RAUCB wurde im Mai 2025 zur Validierung erstellt. Es sollte nicht als aktuelles Installationspaket behandelt werden.

Der Nutzer der ursprünglichen Anfrage bestätigte, dass das Coral-PCIe-TPU funktionierte

ZimaOS-Terminal mit einem von lspci erkannten Global-Unichip-Coral-Edge-TPU-PCIe-Gerät
Der ursprüngliche Verfasser bestätigte, dass das Coral-Gerät über PCIe nach dem Test-Build mit dem Gasket-Treiber angezeigt wurde.

Dies ist ein vom Nutzer bestätigter Erfolg und nicht lediglich ein vorgeschlagener Treiber-Patch.

Offizielles ZimaOS 1.4.1 integrierte den Gasket-Treiber

Nachdem 1.4.1 veröffentlicht worden war, fragte der Nutzer, ob das Upgrade den funktionierenden Treiber entfernen würde. Zima-Jerry antwortete, dass Version 1.4.1 den Gasket-Treiber bereits integriert habe und der Nutzer bedenkenlos aktualisieren könne.

Das ist die belastbare Schlussfolgerung aus der Quelle.

Den alten Testtreiber nicht auf einem aktuellen ZimaOS neu installieren

Aktuelle ZimaOS-Versionen verwenden die spätere Kernel-/Systemtreiber-Linie und nicht das benutzerdefinierte Test-Image vom Mai 2025. Prüfen Sie zunächst, ob das PCIe-TPU erkannt wird:

lspci -nn
ls /dev/apex_*

Wenn das Gerät in einer aktuellen Version fehlt, erfassen Sie stattdessen die genaue PCI-ID und die ZimaOS-Version, anstatt das alte Beta-Bundle über das System zu installieren.

Frigate benötigt weiterhin Zugriff auf das TPU-Gerät

Die Unterstützung durch den Host-Treiber ist nur die erste Ebene. Der Frigate-Container muss außerdem Zugriff auf das entsprechende Edge-TPU-Gerät erhalten, üblicherweise auf einen Apex-Geräteknoten für Coral über PCIe, und die Detektorkonfiguration von Frigate muss zur Hardware passen.

Verwenden Sie die aktuellen Hinweise zur Coral-PCIe-Hardware zusammen mit der von Ihnen tatsächlich verwendeten Frigate-Version.

USB-Coral verwendet einen separaten Treiber- und Gerätepfad

Derselbe Forenthread weitete sich später auf Anfragen zu USB-Coral aus. USB-Geräte können zunächst erscheinen als 1a6e:089a und später als 18d1:9302 nach der Initialisierung. Dieser USB-Pfad verwendet nicht denselben PCIe-Gasket-/Apex-Ablauf.

ZimaBoard-2-Terminal mit einem erkannten Google-Coral-USB-TPU, das von lsusb als 18d1:9302 angezeigt wird
Spätere Antworten der Quelle behandelten USB-Coral separat; die PCIe-Gasket-Unterstützung sollte nicht auf USB-Geräte verallgemeinert werden.

Der Thread zeigt, wie Treiberanfragen für ZimaOS funktionieren

Unter ZimaOS ist ein fehlender Kernel-Treiber normalerweise ein Problem bei der Integration in das System-Image und kein Grund, apt install Pakete in den Host. Stellen Sie IceWhale die Geräte-ID, den erforderlichen Upstream-Treiber bzw. das erforderliche Modul und die aktuelle ZimaOS-Version bereit, damit der Treiber im System-Build validiert werden kann.

Sowohl die PCI-Aufzählung als auch den Apex-Geräteknoten überprüfen

Eine nützliche aktuelle Prüfung besteht nicht nur darin, ob lspci führt das Global-Unichip-/Coral-Gerät auf; ob der Gasket-/Apex-Treiber jedoch den erwarteten Geräteknoten wie /dev/apex_0. Eine PCI-Aufzählung ohne Gerätedatei kann bedeuten, dass die Hardware sichtbar ist, während der Laufzeittreiber noch nicht vollständig gebunden ist.

Frigate muss den PCIe-Coral-Detektortyp korrekt verwenden

Nachdem der Host das TPU bereitstellt, ordnen Sie das Apex-Gerät dem Frigate-Container zu und konfigurieren Sie den Detektor gemäß der aktuellen Frigate-Syntax für Edge TPU. Verwenden Sie nicht das spätere USB-Beispiel erneut. device: usb für ein PCIe-Coral.

Das NAS nicht dauerhaft auf dem alten Test-RAUCB festlegen

Der Nutzer war verständlicherweise besorgt, dass ein normales Update den neuen Treiber entfernen könnte. IceWhale zerstreute diese Bedenken, indem Gasket in die offizielle Version 1.4.1 integrierte. Sobald ein getesteter Treiber Bestandteil des normalen System-Builds wird, birgt das Verbleiben beim privaten Beta-Image mehr Risiken als die Rückkehr zum unterstützten Release-Zweig.

Coral-FAQ für ZimaOS

Hat der Test des Coral-PCIe-Gasket-Treibers tatsächlich funktioniert?

Ja. Der ursprüngliche Verfasser bestätigte, dass das PCIe-TPU erkannt wurde und funktionierte.

Wurde die Gasket-Unterstützung später in eine offizielle ZimaOS-Version aufgenommen?

Ja. Zima-Jerry bestätigte ausdrücklich, dass es in ZimaOS 1.4.1 integriert wurde.

Beweist das automatisch, dass jedes Coral-USB-TPU funktioniert?

Nein. USB-Coral folgt einem separaten USB-Treiber-/Gerätepfad, der später im Thread besprochen wird.