Este tópico mudou de assunto ao longo do tempo. Começou como um tutorial de instalação do BTOP no CasaOS, em 2024, e tornou-se muito mais valioso em março de 2025, quando o ZimaOS 1.3.3 adicionou um painel btop integrado para monitorização do desempenho e vários utilizadores do ZimaBoard/ZimaBlade descobriram que o novo binário falhava com Instrução ilegal (core despejado).
O diagnóstico final veio da IceWhale, não de especulação da comunidade: Zima-Giorgio afirmou que a equipa não tinha tido em conta o CPU do ZimaBoard ao compilar o btop e que o problema seria corrigido no ZimaOS 1.4.0. Isto torna o caso num erro histórico de compatibilidade do CPU com um limite de versão claro.
O ZimaOS 1.3.3 introduziu o painel btop integrado
As notas de lançamento da versão 1.3.3 da IceWhale apresentaram o btop como um novo painel de monitorização do desempenho no painel do ZimaOS. O objetivo era disponibilizar informações sobre o CPU, a memória, os processos e a atividade do sistema sem exigir que os utilizadores instalassem uma infraestrutura de monitorização separada.
Consulte o limite de funcionalidades do ZimaOS 1.3.3 ao ler o tópico original.
O atalho do painel abriu um ecrã para voltar a ligar
Nos sistemas afetados, clicar no atalho abria uma porta temporária com um número elevado e mostrava apenas um aviso para voltar a ligar.
Executar o btop diretamente produziu uma instrução ilegal
A linha de diagnóstico fundamental foi:
btop
Instrução ilegal (core despejado)Essa mensagem significa que o CPU tentou executar uma instrução para a qual o binário foi compilado, mas que o hardware não suportava. Isto é muito diferente de uma cache do navegador ou de um tempo limite do WebSocket.
Vários navegadores excluíram um erro específico do navegador
Os utilizadores testaram Firefox, Chrome/Chromium, Safari, Brave, Opera, Edge, janelas normais e modos privados/anónimos. O comportamento manteve-se igual.
Esse teste negativo foi útil, porque a primeira pergunta da IceWhale durante a resolução de problemas foi se o problema poderia ser específico do navegador.
As DevTools mostraram uma falha do WebSocket depois de o backend parar
Os utilizadores afetados tinham CPUs da geração Intel Celeron N3450
Um utilizador do ZimaBoard 832 e um utilizador do ZimaBlade compararam o hardware e notaram que ambos tinham CPUs da classe Intel Celeron N3450. Perguntaram se o binário do btop tinha sido compilado para um conjunto de instruções de CPU mais recente, destinado ao ZimaCube.
Essa hipótese foi posteriormente confirmada pela IceWhale.
A IceWhale confirmou que o alvo de compilação estava errado
A 27 de março, Zima-Giorgio escreveu que o problema tinha sido localizado e seria resolvido no ZimaOS 1.4.0, porque a compilação original do btop não tinha em conta a CPU do ZimaBoard.
Esta é a conclusão mais sólida da fonte e deve substituir correções especulativas, como reinstalar navegadores ou instalar manualmente outro binário do btop no anfitrião imutável do ZimaOS.
A alteração da porta alta era intencional
CorrectRoadH, da IceWhale, afirmou que o facto de o btop abrir numa porta alta diferente de cada vez era uma funcionalidade de segurança, destinada a dificultar a reutilização direta da sessão temporária de monitorização.
Por isso, a alteração da porta não era, por si só, uma prova da falha.
Não diagnostique o btop atual apenas com base no erro da 1.3.3
A versão atual do ZimaOS está muito além da 1.3.3/1.4.0. Se o btop falhar atualmente, registe a versão atual do ZimaOS, o modelo da CPU, o erro exato no terminal e se o problema afeta o atalho do painel ou apenas a CLI.
Um Instrução ilegal numa instalação moderna ainda pode indicar compatibilidade com a CPU, mas deve ser investigado como uma nova regressão, em vez de se presumir que é o pacote antigo de 2025.
Porque surgiu o erro de WebSocket após o erro da CPU
O painel inicia uma sessão interativa semelhante a um terminal para o btop. Se o processo btop terminar imediatamente com uma instrução de CPU ilegal, o frontend perde o backend com o qual espera comunicar. As mensagens de fecho do WebSocket e de ligação recusada podem, portanto, ser efeitos secundários da falha do processo.
Esta é uma lição geral útil para a resolução de problemas: o primeiro erro da consola do navegador nem sempre é a causa principal. Compare-o com o que acontece quando o comando subjacente é executado diretamente.
A falha também do atalho do Gestor de Rede forneceu outra pista
Um utilizador afetado afirmou que os atalhos do Gestor de Recursos e do Gestor de Rede produziam o mesmo comportamento de reconexão, enquanto o terminal Web normal funcionava. Isso sugeria que a falha estava associada ao ambiente da ferramenta iniciada pelo atalho, e não a uma interrupção completa do ttyd.
A IceWhale ainda precisava da mensagem direta btop a falha e partilhou informações sobre o hardware N3450 para identificar o verdadeiro problema do alvo de compilação.
Reinstalar a mesma compilação 1.3.3 não alteraria as instruções do processador
Assim que a IceWhale confirmou que o próprio binário tinha sido compilado sem ter em conta o processador do ZimaBoard, reinstalar os navegadores, limpar a cache e reinstalar a mesma versão do sistema não poderiam corrigir o conjunto de instruções do executável.
A correção permanente exigia um binário compilado de novo, disponibilizado na versão seguinte do ZimaOS.
A compatibilidade do hardware inclui binários do espaço do utilizador, não apenas controladores do kernel
As discussões sobre compatibilidade centram-se frequentemente nos controladores da placa de rede, da GPU ou do armazenamento. Este incidente mostra que um sistema operativo x86 genérico também pode deixar de funcionar em processadores mais antigos se uma aplicação incluída for compilada com instruções que o hardware não implementa.
Para máquinas x86 de terceiros, uma Instrução ilegal a mensagem é, portanto, uma prova valiosa e deve ser incluída integralmente num relatório de suporte.
FAQ de compatibilidade do btop
O problema de origem foi causado pelo Firefox ou pelo Chrome?
Não. Os utilizadores reproduziram o problema em vários navegadores e em modos privados.
Qual foi a causa principal indicada pela IceWhale?
O binário btop tinha sido compilado sem ter em conta o conjunto de instruções do processador do ZimaBoard.
Que versão deveria corrigir o problema?
Zima-Giorgio disse que o btop corrigido chegaria no ZimaOS 1.4.0.
