コミュニティソリューション

Frigate向けZimaOSのGoogle Coral PCIe:Gasketドライバー、1.4.1統合、USB TPUの境界

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.

この情報源には、公式による強力な検証の連鎖があります。ユーザーはGoogleのCoral PCIeドライバーを次のコマンドでインストールできませんでした。 apt または dpkg ZimaOSはハードウェアドライバーをシステムイメージの一部として提供しているためです。そのためZima-Jerryはgasketドライバーを含む専用のカーネル/アップデートパッケージを作成し、ユーザーがそれをインストールした結果、Coral Edge TPUが動作するようになりました。

その後IceWhaleは、gasketドライバーが公式ZimaOS 1.4.1リリースに統合されたことを確認しました。したがって、現在のユーザーは古いテスト用RAUCBをダウンロードしたり、ZimaOSホストにDebian用Coralパッケージをインストールしたりすべきではありません。

元のDebianドライバー手順はZimaOSには適合しなかった

GoogleのLinux向けCoral PCIeセットアップは、従来、OSの展開後にパッケージやカーネルモジュールをインストールできる汎用ディストリビューションを前提としていました。ZimaOSは異なります。Zima-Jerryは、ハードウェアドライバーがシステムにあらかじめビルドされており、通常はパッケージマネージャーのコマンドで後から追加できないと明言しました。

IceWhaleが専用のgasketドライバーテストイメージを作成

Zima-Jerryはgasketドライバーを含むkernel-6.12対応の特別なZimaOSアップデートバンドルを作成し、RAUCでインストールするようユーザーに指示しました。また、ベータビルドであり、テストに失敗した場合は別のシステムスロットを使用できるとも警告しました。

このテスト用RAUCBは2025年5月の検証用に作成されたものです。現在のインストールパッケージとして扱うべきではありません。

情報提供元のユーザーがCoral PCIe TPUの動作を確認

lspciで検出されたGlobal Unichip Coral Edge TPU PCIeデバイスを表示するZimaOSターミナル
元の投稿者は、gasketドライバーのテストビルド後にPCIe Coralデバイスが表示されたことを確認しました。

これは単に提案されたドライバーパッチではなく、ユーザーによって検証された成功例です。

公式ZimaOS 1.4.1にgasketドライバーを統合

1.4.1のリリース後、ユーザーはアップグレードすると動作中のドライバーが削除されるか尋ねました。Zima-Jerryは、バージョン1.4.1にはすでにgasketドライバーが統合されており、安心してアップグレードできると回答しました。

これが、確実な情報源から導かれる結論です。

現在のZimaOSに古いテストドライバーを再インストールしないでください

現在のZimaOSリリースは、2025年5月のカスタムテストイメージではなく、後のカーネル/システムドライバー系列を引き継いでいます。まず、PCIe TPUが検出されているか確認してください。

lspci -nn
ls /dev/apex_*

現在のリリースでデバイスが見つからない場合は、古いベータバンドルをシステムに重ねるのではなく、正確なPCI IDとZimaOSのバージョンを収集してください。

FrigateはTPUデバイスへのアクセスも必要

ホストドライバーのサポートは最初の段階にすぎません。Frigateコンテナには適切なEdge TPUデバイスも渡す必要があります。PCIe Coralでは通常、Apexデバイスノードが該当し、Frigateの検出器設定もハードウェアに合わせる必要があります。

実際に使用しているFrigateのリリースと併せて、現在のCoral PCIeハードウェアガイダンスを使用してください。

USB Coralは別のドライバーおよびデバイス経路です

同じフォーラムスレッドでは、後にUSB Coralの要望へと話が広がりました。USBデバイスは最初に次のように表示されることがあります 1a6e:089a その後、 18d1:9302 初期化後。USB経路では、同じPCIeガスケット/apexフローは使用しません。

lsusbで18d1:9302として検出されたGoogle Coral USB TPUを表示するZimaBoard 2のターミナル
後半のソースの返信ではUSB Coralが別途扱われています。PCIeガスケットのサポートをUSBデバイスに一般化しないでください。

このスレッドはZimaOSでのドライバー要望の進め方を示しています

ZimaOSでは、カーネルドライバーがない場合、通常は「〜する」理由ではなく、システムイメージへの統合に関する問題です apt install ホストにパッケージを組み込みます。デバイスID、必要なアップストリームドライバー/モジュール、現在のZimaOSバージョンをIceWhaleに提供し、システムビルドでドライバーを検証できるようにします。

PCI列挙とApexデバイスノードの両方を確認する

現在の確認では、単に〜かどうかだけでなく、 lspci はGlobal Unichip/Coralデバイスを一覧表示しますが、ガスケット/apexドライバーが、次のような想定されたデバイスノードを作成したかどうかは、 /dev/apex_0。デバイスノードがない状態でPCI列挙される場合、ハードウェアは認識されていても、ランタイムドライバーが完全にはバインドされていない可能性があります。

FrigateではPCIe Coralの検出器タイプを正しく使用する必要があります

ホストがTPUを公開したら、ApexデバイスをFrigateコンテナに割り当て、現在のFrigate Edge TPU構文に従って検出器を設定します。後述のUSB例を再利用しないでください デバイス:USB PCIe Coral用。

NASを古いテスト用RAUCBに永久に固定しないでください

ソースのユーザーが、通常のアップデートで新しいドライバーが削除されるのではないかと心配したのは当然です。IceWhaleは、ガスケットを公式の1.4.1に統合することでその懸念を解消しました。テスト済みのドライバーが通常のシステムビルドの一部になった後は、プライベートベータのイメージを使い続けるほうが、サポート対象のリリース系列に戻すよりもリスクが高くなります。

ZimaOSのCoralに関するFAQ

CoralのPCIeガスケットドライバーのテストは実際に動作しましたか?

はい。元の投稿者は、PCIe TPUが検出され、動作していることを確認しました。

ガスケットのサポートは、後に公式のZimaOSリリースへ組み込まれましたか?

はい。Zima-Jerryは、ZimaOS 1.4.1に明示的に統合されたことを確認しました。

いいえ。それだけで、すべてのCoral USB TPUが動作することが証明されるわけではありません。

いいえ。USB Coralは、スレッド後半で説明されている別のUSBドライバー/デバイス経路に従います。