Solução da comunidade

Realtek RTL8821CE ou RTL8852BE no ZimaOS: guia de controladores

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 «Wi-Fi Hardware: Missing», o dispositivo PCIe está a ser detetado, mas o suporte necessário de controlador/firmware sem fios não está completo. Na discussão original, o título menciona RTL8821CE, mas o resultado real de lspci identifica um controlador RTL8852BE 802.11ax.

Esta distinção é importante porque o RTL8821CE e o RTL8852BE utilizam controladores Linux upstream diferentes. A documentação de compatibilidade atual do ZimaOS continua sem indicar nenhuma destas placas PCIe como opção Wi-Fi validada, por isso, não parta do princípio de que é possível instalar um controlador do Linux Mint no ZimaOS como se fosse um pacote Debian normal.

Identifique primeiro o chipset exato

lspci -nnk | grep -A3 -Ei 'network|sem fios'
dmesg | grep -Ei 'rtw|firmware|Wi-Fi|wlan' | tail -100

Utilize o ID PCI e a linha do controlador, não apenas o nome do produto na placa. O hardware do utilizador na publicação foi identificado como RTL8852BE, embora a discussão mencionasse RTL8821CE.

O RTL8852BE tem um controlador Linux upstream

A atual referência do controlador Linux para o 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 pela rtw89. Misturar instruções para os dois chipsets pode levar ao módulo errado e a uma abordagem incorreta para resolver problemas de firmware.

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

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

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

O ZimaOS é um sistema do tipo appliance. Um pacote de controladores 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.

Verificar 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.

Use um adaptador verificado num servidor de produção

Se precisar de Wi-Fi já, use 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 separadamente os erros de firmware e do módulo do controlador

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

Use o ID PCI num pedido de controlador

No caso da placa RTL8852BE 1T1R publicada, 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 e do dispositivo para que a IceWhale possa ativar a opção correta do kernel e o pacote de firmware.

Prefira Ethernet para um NAS sempre ligado

Mesmo quando o Wi-Fi funciona, a Ethernet com fios costuma ser mais previsível num servidor de armazenamento, pois evita o roaming, a interferência de radiofrequência e o comportamento da gestão de energia sem fios. Use Wi-Fi quando passar cabos não for prático, em vez de o usar como ligação predefinida para tráfego NAS intenso.

FAQ

A placa de origem é mesmo RTL8821CE?

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

Porque é que o Linux Mint funciona?

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

Posso instalar o controlador Wi-Fi com o apt?

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

O que devo enviar à IceWhale?

ID PCI exato, resultado de lspci -nnk, saída relevante de dmesg, versão do ZimaOS e se outra distribuição Linux funciona.