커뮤니티 솔루션

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 드라이버가 포함된 특수 커널 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 gasket/apex 흐름을 사용하지 않습니다.

lsusb에서 18d1:9302로 감지된 Google Coral USB TPU가 표시된 ZimaBoard 2 터미널
이후 소스 답변에서는 USB Coral을 별도로 다뤘습니다. PCIe gasket 지원을 USB 디바이스에 일반화해서는 안 됩니다.

이 스레드는 ZimaOS 드라이버 요청이 처리되는 방식을 보여 줍니다

ZimaOS에서 커널 드라이버가 없다는 것은 일반적으로 시스템 이미지 통합 문제이지, 다음을 수행할 이유가 아닙니다 apt install 호스트에 패키지를 설치합니다. 디바이스 ID, 필요한 업스트림 드라이버/모듈 및 현재 ZimaOS 버전을 IceWhale에 제공하여 시스템 빌드에서 드라이버를 검증할 수 있도록 하세요.

PCI 열거와 Apex 디바이스 노드를 모두 확인하세요

현재 유용한 확인 방법은 단지 다음 여부만 확인하는 것이 아닙니다 lspci Global Unichip/Coral 디바이스를 나열하지만, gasket/apex 드라이버가 다음과 같은 예상 디바이스 노드를 생성했는지는 /dev/apex_0. 디바이스 노드 없이 PCI 열거만 표시된다면 하드웨어는 보이지만 런타임 드라이버가 완전히 연결되지 않았다는 의미일 수 있습니다.

Frigate는 PCIe Coral 감지기 유형을 올바르게 사용해야 합니다

호스트가 TPU를 노출한 후 Apex 디바이스를 Frigate 컨테이너에 매핑하고 현재 Frigate Edge TPU 구문에 따라 감지기를 구성하세요. 이후의 USB 예제를 재사용하지 마세요 디바이스: USB PCIe Coral의 경우.

NAS를 이전 테스트 RAUCB에 영구적으로 고정하지 마세요

소스 게시자는 일반 업데이트로 새 드라이버가 제거될 수 있다는 점을 당연히 우려했습니다. IceWhale은 gasket을 공식 1.4.1에 통합하여 이 우려를 해결했습니다. 테스트된 드라이버가 일반 시스템 빌드의 일부가 되면, 비공개 베타 이미지를 계속 사용하는 것이 지원되는 릴리스 라인으로 돌아가는 것보다 위험이 커집니다.

ZimaOS의 Coral FAQ

Coral PCIe gasket 드라이버 테스트가 실제로 작동했나요?

예. 원 게시자가 PCIe TPU가 감지되어 작동한다고 확인했습니다.

gasket 지원이 나중에 공식 ZimaOS 릴리스에 포함되었나요?

예. Zima-Jerry가 ZimaOS 1.4.1에 통합되었다고 명시적으로 확인했습니다.

그렇다고 모든 Coral USB TPU가 작동한다는 것이 자동으로 입증되나요?

아니요. USB Coral은 나중에 스레드에서 설명한 별도의 USB 드라이버/디바이스 경로를 따릅니다.