Se uma placa Realtek RTL8188CE estiver invisível no ZimaOS, determine primeiro se o dispositivo PCIe é detetado e se o kernel inclui o módulo rtl8192ce antes de tentar compilar um controlador antigo do GitHub. O RTL8188CE é suportado pelo controlador upstream do Linux rtl8192ce, mas isso não prova que o módulo ou o firmware estejam incluídos em todas as compilações do ZimaOS.
A discussão da comunidade de 2025 terminou com a IceWhale a dizer que tentaria integrar o suporte, não com uma solução verificada por um utilizador. A documentação atual de compatibilidade do ZimaOS lista adaptadores testados, como o Intel AX210, mas não lista o RTL8188CE; por isso, esta placa deve continuar a ser tratada como um caso de compatibilidade a verificar, e não como hardware garantidamente plug-and-play.
Passo 1: Verificar se o PCIe deteta a placa Wi-Fi
Execute:
lspci -nn | grep -i -E 'network|wireless'Se o RTL8188CE não aparecer de todo, o problema está abaixo do NetworkManager. Volte a encaixar a placa, verifique a ranhura e, se possível, teste a placa noutro sistema.
Passo 2: Verificar o controlador Linux esperado
O Linux upstream identifica rtl8192ce como o controlador PCIe para hardware RTL8192CE e RTL8188CE. A documentação de controladores sem fios do Linux documenta essa correspondência.
Verifique se o kernel do ZimaOS tem o módulo:
modinfo rtl8192ce
lsmod | grep rtl8192ceSe modinfo indica que o módulo não foi encontrado, uma árvore de código-fonte antiga de terceiros dificilmente será a solução mais simples num sistema operativo de appliance.
Passo 3: Inspecionar as mensagens do kernel
Execute:
dmesg | grep -i -E 'rtl|firmware|wifi|wlan'Isto permite distinguir entre “controlador em falta”, “controlador carregado, mas falha do firmware” e “dispositivo inicializado, mas o NetworkManager não criou uma interface utilizável”.
Passo 4: Verificar se o NetworkManager deteta a rede Wi-Fi
Se o controlador carregar corretamente, verifique:
ip link
nmtuiSe existir uma interface sem fios, mas não aparecerem SSIDs, o problema passou da deteção PCIe/controlador para o firmware, a regulamentação, o rádio ou o comportamento do NetworkManager.
Porque o antigo controlador do GitHub não é a melhor primeira solução
A discussão de origem referenciava um controlador RTL8188CE mantido pela comunidade, cujo suporte documentado ao kernel está desatualizado em relação aos kernels modernos. O próprio kernel Linux já inclui suporte para RTL8188CE através de rtl8192ce. Substituir módulos de rede sem fios integrados no kernel por uma versão externa mais antiga pode criar incompatibilidades de versões e o módulo pode perder-se na atualização seguinte do ZimaOS.
Como o ZimaOS utiliza um sistema ao estilo de um dispositivo dedicado, evite tratá-lo como o Ubuntu e executar um longo procedimento de instalação de pacotes/compilação, a menos que a IceWhale documente especificamente esse procedimento para a sua versão.
Utilize um adaptador conhecido como compatível quando a fiabilidade for importante
A atual lista de adaptadores de rede do ZimaOS inclui o Intel AX210 entre os adaptadores testados. O guia do AX210 Wi-Fi 6E separado fornece um fluxo de trabalho de referência compatível.
Se o Wi-Fi for essencial para um servidor e o módulo RTL8188CE estiver ausente na sua versão, substituir o hardware por uma opção conhecida como compatível é frequentemente mais seguro do que manter um módulo do kernel externo.
Como comunicar eficazmente a ausência do controlador
Inclua a versão do ZimaOS, uname -r, lspci -nn resultado, modinfo rtl8192ce resultado e o
respetivo dmesg linhas. Isto permite ao suporte determinar se o hardware está em falta, se o módulo foi omitido ou se a inicialização do firmware falhou.
O guia de resolução de problemas do ZimaOS fornece um quadro de escalonamento mais abrangente.
Perguntas frequentes
Que controlador do Linux utiliza o RTL8188CE?
A documentação upstream da rede sem fios do Linux associa os dispositivos PCIe RTL8188CE ao rtl8192ce controlador.
Isso significa que o RTL8188CE funciona garantidamente no ZimaOS?
Não. O suporte do kernel upstream não garante que uma determinada versão do ZimaOS inclua o módulo, o firmware ou uma integração testada para esse adaptador.
Devo compilar o controlador rtl8188ce do GitHub?
Não como primeiro passo. Verifique primeiro o módulo integrado no kernel. Um controlador externo pode deixar de funcionar após atualizações do kernel e é mais difícil de manter no ZimaOS.
Porque é que a placa não aparece no nmtui?
Se não existir nenhuma interface sem fios, o controlador pode não ter sido carregado ou o dispositivo pode não ter sido detetado. Diagnostique o suporte para PCIe e para o kernel antes de alterar as definições do NetworkManager.
