Solução da comunidade

Guia de controladores Realtek RTL8821CE ou RTL8852BE no ZimaOS

A user labeled the card RTL8821CE, but lspci showed RTL8852BE; ZimaOS detected PCIe hardware while nmtui reported Wi-Fi Hardware: Missing.

Se uma placa Wi-Fi Realtek aparecer no lspci, mas o ZimaOS indicar «Hardware Wi-Fi: Em falta», o dispositivo PCIe está a ser detetado, mas o controlador/firmware sem fios utilizável ainda não está completamente disponível. No tópico original, o título refere RTL8821CE, mas o resultado real de lspci identifica um controlador RTL8852BE 802.11ax.

Essa distinção é importante, porque o RTL8821CE e o RTL8852BE utilizam controladores Linux upstream diferentes. A documentação atual de compatibilidade do ZimaOS ainda não apresenta nenhuma destas placas PCIe como opção Wi-Fi verificada, por isso não assuma que pode simplesmente instalar no ZimaOS um controlador do Linux Mint como se fosse um pacote Debian normal.

Identifique primeiro o chip exato

lspci -nnk | grep -A3 -Ei 'network|wireless'
dmesg | grep -Ei 'rtw|firmware|wifi|wlan' | tail -100

Utilize o ID PCI e a linha do controlador, não apenas a designação do produto na placa. O hardware do utilizador original foi identificado como RTL8852BE, embora o tópico referisse RTL8821CE.

O RTL8852BE tem um controlador Linux upstream

A atual referência do controlador Linux RTL8852BE indica que o RTL8852BE utiliza o módulo rtw89_8852be nos kernels Linux modernos.

O RTL8821CE utiliza uma família de controladores diferente

O RTL8821CE é suportado pela família rtw88, e não por rtw89. Misturar instruções relativas aos dois chipsets pode conduzir ao módulo errado e a um processo de diagnóstico de firmware inadequado.

A lista atual de compatibilidade do ZimaOS não verifica estas placas

A atual lista de adaptadores de rede compatíveis com o ZimaOS inclui o Intel AX210 e vários adaptadores Ethernet, mas não inclui placas Wi-Fi PCIe RTL8821CE ou RTL8852BE.

Não instale pacotes DKMS aleatórios no sistema anfitrião

O ZimaOS é um sistema de estilo appliance. Um pacote de controlador que funcione no Ubuntu ou no Linux Mint pode depender de cabeçalhos, DKMS, do estado do gestor de pacotes ou de caminhos de sistema com permissões de escrita que o ZimaOS não disponibiliza da mesma forma.

Verifique se o módulo existe

modinfo rtw89_8852be 2>/dev/null
modinfo rtw88_8821ce 2>/dev/null

Se o módulo exato estiver em falta, comunique o ID PCI e o nome do controlador à IceWhale, em vez de forçar uma compilação externa não relacionada.

Utilize um adaptador verificado num servidor de produção

Se precisar de Wi-Fi agora, utilize um adaptador atualmente verificado, como o Intel AX210, em vez de depender de uma placa PCIe Realtek não verificada.

O guia de resolução de problemas de hardware ajuda a estruturar um relatório de compatibilidade.

Verifique os erros de firmware separadamente do módulo do controlador

Um módulo pode existir e, ainda assim, falhar porque o blob de firmware Realtek necessário está em falta. No dmesg, distinga «módulo não encontrado» de «falha ao carregar o firmware», pois estes casos exigem correções diferentes por parte da IceWhale.

Utilize o ID PCI num pedido de controlador

Para a placa RTL8852BE 1T1R apresentada, o ID PCI é mais importante do que a referência da peça sobresselente HP. Os pedidos de controladores devem incluir os IDs do fabricante/dispositivo, para que a IceWhale possa ativar a opção correta do kernel e o pacote de firmware adequado.

Prefira Ethernet numa NAS sempre ligada

Mesmo quando o Wi-Fi funciona, a Ethernet com fios é normalmente mais previsível num servidor de armazenamento, pois evita roaming, interferências de radiofrequência e o comportamento da gestão de energia sem fios. Utilize Wi-Fi quando a instalação de cabos não for prática, e não como caminho predefinido para tráfego NAS intenso.

FAQ

A placa original é mesmo RTL8821CE?

O título do fórum indica RTL8821CE, mas o resultado de lspci publicado identifica RTL8852BE.

Porque funciona no Linux Mint?

O Mint pode incluir o módulo do kernel e o firmware necessários, enquanto a compilação do ZimaOS pode não incluir ou ativar a mesma combinação.

Posso instalar o controlador Wi-Fi com apt?

Não trate o ZimaOS como um anfitrião Ubuntu normal. Prefira um adaptador verificado ou solicite a integração do controlador.

O que devo enviar à IceWhale?

O ID PCI exato, lspci -nnk, o resultado relevante de dmesg, a versão do ZimaOS e a indicação de que outra distribuição Linux funciona ou não.