Instalar FydeOS na família Radxa ROCK 5

Última atualização: 2025-11-20

Observação

Devido a uma atualização anterior de firmware da Radxa que alterou a lógica do script de inicialização da SPI-Flash, versões mais antigas de firmware podem falhar ao inicializar corretamente o FydeOS v21 e versões posteriores. Se você encontrar problemas de inicialização após uma instalação nova, recomendamos atualizar o firmware da sua SPI-Flash de acordo com a documentação oficial da Radxa (ROCK 5B / ROCK 5B+ / ROCK 5T), pois isso normalmente resolve problemas de compatibilidade.

Este guia vai orientá-lo no processo de inicialização do FydeOS / openFyde na sua família de computadores de placa única Rock 5, incluindo ROCK 5B, ROCK 5B+ e ROCK 5T. Basta seguir as instruções específicas do seu sistema operacional, e você estará pronto para usar o FydeOS / openFyde em pouco tempo.

Pela natureza da família ROCK 5, é recomendável primeiro se familiarizar com os processos básicos e as práticas recomendadas de uso, operação e experimentação com computadores de placa única como a família ROCK 5, lendo a documentação oficial e assistindo às demonstrações em vídeo disponíveis na documentação oficial.

1. Baixe o arquivo de instalação

• Se você quiser FydeOS, comece visitando a página FydeOS for SBC e baixando o arquivo de instalação específico para a família ROCK 5.

• Para openFyde, obtenha a imagem mais recente na página de lançamento.

2. Obtenha o arquivo de imagem .img

Nota

Desde FydeOS v21.0-SP1 (openFyde r138), adicionamos suporte para ROCK 5B+ e ROCK 5T e alteramos a distribuição dos arquivos de instalação:

• Para versões anteriores a FydeOS v21.0-SP1 (openFyde r138), fornecíamos diretamente imagens de instalação no formato .xz, que você pode descompactar para obter o arquivo de imagem .img.
• Para FydeOS v21.0-SP1 (openFyde r138) e versões posteriores, fornecemos arquivos de instalação no formato .run; você pode seguir as etapas abaixo para obter o arquivo de imagem .img correspondente.

1. Prepare para executar o arquivo .run

   Para FydeOS v21.0-SP1 (openFyde r138) e versões posteriores, depois de baixado, você terá um arquivo .run. Ele precisa ser executado para criar a imagem inicializável. Escolha seu sistema operacional para as próximas etapas:

   macOS / Linux / BSD

   Para usuários de macOS, Linux e BSD, usar o terminal é a maneira mais fácil de executar o arquivo .run. Abra seu terminal e navegue até o diretório de download.

   Windows

   Usuários do Windows vão utilizar o Subsistema do Windows para Linux (WSL) para executar o arquivo .run.

   1. Instale o WSL: Se você ainda não instalou o WSL, consulte o guia oficial da Microsoft para instalar o WSL.
   2. Abra o terminal do WSL: Inicie seu terminal do WSL assim que a instalação estiver concluída.
   3. Navegue até Downloads: Use o comando cd para ir até o diretório onde você baixou o arquivo .run. Normalmente, isso fica em /mnt/c/Users/YourUsername/Downloads.

2. Conceda permissão de execução ao arquivo .run

   Agora, precisamos permitir que o arquivo .run seja executado como um executável. Use o seguinte comando no seu terminal:

   chmod +x FydeOS_for_SBC_Rock5B_v21.0-SP1-io.run

   Importante: Certifique-se de substituir FydeOS_for_SBC_Rock5B_v21.0-SP1-io.run pelo nome exato do arquivo .run que você baixou.

3. Execute o arquivo .run

   Hora de executar o arquivo .run! No seu terminal, execute:

   ./FydeOS_for_SBC_Rock5B_v21.0-SP1-io.run

   Depois de executar, um menu interativo aparecerá:

   *****************************
   * Supported boards *
   *****************************
   [1] Rock 5B
   [2] Rock 5B Plus
   [3] Rock 5T
   [4] Quit
   -----------------------------
   Enter your choice:

   Siga as instruções para selecionar o modelo ROCK 5 e o meio de inicialização desejado (eMMC, NVMe ou SATA, dependendo do seu modelo).

   O script então gerará o arquivo de imagem inicializável. Você pode ver mensagens como esta durante o processo:

   *****************************
   * board: rock5b, supported install storage: nvme *
   *****************************

   Gerar a imagem pode levar algum tempo. Quando terminar, você deverá ver uma saída semelhante a esta, indicando o caminho para o seu arquivo .img gerado:

   board: rock5b storage: NVME
   Generated image: /some/path/FydeOS_for_SBC_Rock5B_v21.0-SP1-io.img
   Installing uboot firmware on ./FydeOS_for_SBC_Rock5B_v21.0-SP1-io.img
   Installed bootloader to ./FydeOS_for_SBC_Rock5B_v21.0-SP1-io.img

   Excelente! Agora você tem um arquivo .img inicializável, pronto para gravação. Você pode executar novamente o .run se necessário.

3. Grave a imagem no seu dispositivo de armazenamento

A partir do FydeOS v17 (openFyde r114), você pode gravar a imagem baixada diretamente no dispositivo de armazenamento que será usado para inicializar o FydeOS e aproveitar todas as funcionalidades, incluindo atualizações OTA (diferentemente de antes, quando você precisava gravar a imagem primeiro em um cartão micro SD e depois realizar um processo de instalação para a unidade de armazenamento de destino final).

Para gravar arquivos em unidades de armazenamento M.2 NVMe/SATA ou em um chip eMMC, pode ser necessário hardware adicional para interface com esses dispositivos de armazenamento. Recomendamos usar uma carcaça USB para unidade M.2 NVMe/SATA ou um leitor USB para eMMC para fazer isso.

Nota

O firmware gravado na SPI-Flash da família ROCK 5 na fábrica pode estar vazio ou pode não oferecer suporte à inicialização via NVMe. Grave/atualize a SPI flash antes de instalar em NVMe, caso contrário a inicialização via NVMe falhará. Consulte a documentação oficial: ROCK 5B / ROCK 5B+ / ROCK 5T.

Recomendamos usar o balenaEtcher para gravar a imagem em um dispositivo USB. O BalenaEtcher é uma ferramenta fácil de usar, compatível com Windows, macOS e versões amplamente usadas de Linux. Ele permite que os usuários gravem arquivos de imagem em dispositivos USB ou cartões de memória em apenas três etapas simples:

Você pode baixar o pacote de instalação para o seu sistema operacional no site oficial do balenaEtcher.

Nota

Se você encontrar problemas de compatibilidade com o balenaEtcher, use um destes métodos:

• Extraia o arquivo .img do arquivo .xz e grave-o diretamente

• No Windows, use Rufus para obter os resultados mais confiáveis

Como alternativa, se você estiver confortável com o comando dd, pode gravar diretamente o arquivo .img no dispositivo de armazenamento de destino.

4. Ligue seu ROCK 5

Depois de gravar com sucesso a imagem no dispositivo de armazenamento de destino, insira-o com segurança no seu ROCK 5, conecte também seus kits KVM (teclado, mouse e vídeo) e ligue-o. Isso conclui o processo de instalação do FydeOS / openFyde. Aproveite para explorar seu novo sistema operacional!

O que fazer em caso de tela preta ou se o sistema operacional não inicializar?

Devido à singularidade dos SBCs com processadores ARM, o processo de inicialização do sistema difere significativamente dos dispositivos x86 tradicionais. Para a família ROCK 5, você precisa garantir que o firmware SPI do dispositivo permita inicializar a partir do dispositivo de armazenamento que você instalou, que normalmente é um SSD NVMe ou SATA no slot M.2. Se você encontrar dificuldades para inicializar a partir de um SSD no slot M.2, verifique também se o firmware SPI não foi modificado ou danificado. Se não tiver certeza, você pode consultar a wiki oficial para reparo.