Solução da comunidade

Google Coral PCIe no ZimaOS para o Frigate: o controlador Gasket, a integração 1.4.1 e os limites do TPU USB

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.

Esta fonte apresenta uma cadeia de verificação oficial sólida. O utilizador não conseguiu instalar o controlador Coral PCIe da Google com apt ou dpkg porque o ZimaOS inclui os controladores de hardware como parte da imagem do sistema. Por isso, Zima-Jerry criou um pacote dedicado de kernel/atualização contendo o controlador gasket, o utilizador instalou-o e o Coral Edge TPU começou a funcionar.

A IceWhale confirmou então que o controlador gasket estava integrado na versão oficial 1.4.1 do ZimaOS. Por isso, os utilizadores atuais não devem transferir o antigo RAUCB de teste nem tentar instalar pacotes Coral Debian no anfitrião ZimaOS.

As instruções originais do controlador Debian não eram adequadas ao ZimaOS

A configuração Linux do Coral PCIe da Google pressupõe tradicionalmente uma distribuição de uso geral, na qual os pacotes e módulos do kernel podem ser instalados depois de o sistema operativo ser implementado. O ZimaOS é diferente: Zima-Jerry afirmou explicitamente que os controladores de hardware são pré-compilados no sistema e que normalmente não podem ser adicionados posteriormente através de comandos do gestor de pacotes.

A IceWhale criou uma imagem de teste dedicada ao controlador gasket

Zima-Jerry produziu um pacote especial de atualização do ZimaOS com kernel 6.12 e o controlador gasket, e disse ao utilizador para o instalar com RAUC. Também avisou que era uma compilação beta e que o outro bloco do sistema podia ser utilizado se o teste falhasse.

Esse RAUCB de teste foi criado para validação em maio de 2025. Não deve ser tratado como um pacote de instalação atual.

O utilizador da fonte confirmou que o TPU Coral PCIe funcionava

Terminal do ZimaOS a mostrar um dispositivo Global Unichip Coral Edge TPU PCIe detetado pelo lspci
O autor original confirmou que o dispositivo Coral PCIe apareceu após a compilação de teste do controlador gasket.

Este é um sucesso verificado pelo utilizador, não apenas uma correção de controlador proposta.

O ZimaOS oficial 1.4.1 integrou o controlador gasket

Depois do lançamento da versão 1.4.1, o utilizador perguntou se a atualização removeria o controlador funcional. Zima-Jerry respondeu que a versão 1.4.1 já tinha integrado o controlador gasket e que o utilizador podia atualizar com confiança.

Essa é a conclusão sólida da fonte.

Não reinstale o antigo controlador de teste no ZimaOS atual

As versões atuais do ZimaOS herdam a linha posterior do kernel/controlador do sistema, e não a imagem de teste personalizada de maio de 2025. Verifique primeiro se o TPU PCIe é detetado:

lspci -nn
ls /dev/apex_*

Se o dispositivo estiver em falta numa versão atual, recolha o ID PCI exato e a versão do ZimaOS, em vez de instalar o antigo pacote beta sobre o sistema.

O Frigate continua a precisar de acesso ao dispositivo TPU

O suporte do controlador no anfitrião é apenas a primeira camada. O contentor Frigate também tem de receber o dispositivo Edge TPU adequado, normalmente um nó de dispositivo Apex para o Coral PCIe, e a configuração do detetor do Frigate tem de corresponder ao hardware.

Utilize as orientações atuais sobre hardware Coral PCIe em conjunto com a versão do Frigate que utiliza efetivamente.

O Coral USB utiliza uma via separada de controlador e dispositivo

A mesma thread do fórum evoluiu posteriormente para pedidos relacionados com o Coral USB. Os dispositivos USB podem aparecer primeiro como 1a6e:089a e, mais tarde, como 18d1:9302 após a inicialização. Essa via USB não utiliza o mesmo fluxo gasket/apex da PCIe.

Terminal do ZimaBoard 2 a mostrar uma TPU Google Coral USB detetada com lsusb como 18d1:9302
As respostas posteriores da fonte trataram o Coral USB separadamente; o suporte gasket para PCIe não deve ser generalizado para dispositivos USB.

A thread demonstra como funcionam os pedidos de controladores do ZimaOS

No ZimaOS, a ausência de um controlador do kernel é normalmente um problema de integração da imagem do sistema, e não um motivo para apt install pacotes no anfitrião. Forneça à IceWhale o ID do dispositivo, o controlador/módulo upstream necessário e a versão atual do ZimaOS, para que o controlador possa ser validado na compilação do sistema.

Verifique a enumeração PCI e o nó do dispositivo Apex

Uma verificação útil atualmente não consiste apenas em saber se lspci apresenta o dispositivo Global Unichip/Coral, mas o facto de o controlador gasket/apex ter criado o nó de dispositivo esperado, como /dev/apex_0. A enumeração PCI sem o nó do dispositivo pode significar que o hardware está visível, mas que o controlador de execução ainda não está totalmente associado.

O Frigate tem de utilizar corretamente o tipo de detetor Coral PCIe

Depois de o anfitrião expor a TPU, mapeie o dispositivo Apex para o contentor Frigate e configure o detetor de acordo com a sintaxe atual do Frigate Edge TPU. Não reutilize o exemplo USB posterior dispositivo: usb para uma Coral PCIe.

Não fixe permanentemente o NAS à RAUCB de teste antiga

Era compreensível que o utilizador de origem receasse que uma atualização normal pudesse remover o novo controlador. A IceWhale resolveu essa questão ao integrar o gasket na versão oficial 1.4.1. Quando um controlador testado passa a fazer parte da compilação normal do sistema, manter-se na imagem beta privada cria mais riscos do que voltar à linha de versões suportada.

Perguntas frequentes sobre a Coral no ZimaOS

O teste do controlador gasket da Coral PCIe funcionou realmente?

Sim. O autor original confirmou que a TPU PCIe foi detetada e estava a funcionar.

O suporte para o gasket foi posteriormente incluído numa versão oficial do ZimaOS?

Sim. Zima-Jerry confirmou explicitamente que foi integrado no ZimaOS 1.4.1.

Isso prova automaticamente que todas as TPUs Coral USB funcionam?

Não. O Coral USB segue uma via separada de controlador/dispositivo USB, discutida mais adiante na thread.