Instala FydeOS en la familia Radxa ROCK 5

Última actualización: 2025-11-20

Ten en cuenta

Debido a una actualización anterior del firmware de Radxa que cambió la lógica del script de arranque de SPI-Flash, las versiones anteriores del firmware pueden no arrancar correctamente FydeOS v21 y las versiones posteriores. Si encuentras problemas de arranque después de una instalación nueva, recomendamos actualizar el firmware de tu SPI-Flash de acuerdo con la documentación oficial de Radxa (ROCK 5B / ROCK 5B+ / ROCK 5T), ya que esto suele resolver los problemas de compatibilidad.

Esta guía te llevará por el proceso de arranque de FydeOS / openFyde en tus computadoras de placa única de la familia Rock 5, incluidas ROCK 5B, ROCK 5B+ y ROCK 5T. Solo sigue las instrucciones adaptadas a tu sistema operativo y tendrás FydeOS / openFyde en funcionamiento en muy poco tiempo.

Dada la naturaleza de la familia ROCK 5, se recomienda primero familiarizarte con los procesos básicos y las buenas prácticas de uso, operación y experimentación con computadoras de placa única como la familia ROCK 5, leyendo su documentación oficial y viendo las demostraciones en video disponibles en su documentación oficial.

1. Descarga el archivo de instalación

• Si quieres FydeOS, empieza por visitar la página FydeOS for SBC y descargar el archivo de instalación específico para la familia ROCK 5.

• Para openFyde, obtén la imagen más reciente desde la página de versiones.

2. Obtén el archivo de imagen de .img

Nota

Desde FydeOS v21.0-SP1 (openFyde r138), hemos agregado compatibilidad con ROCK 5B+ y ROCK 5T, y hemos cambiado la distribución de los archivos de instalación:

• Para las versiones anteriores a FydeOS v21.0-SP1 (openFyde r138), proporcionábamos directamente imágenes de instalación en formato .xz, que puedes descomprimir para obtener el archivo de imagen .img.
• Para FydeOS v21.0-SP1 (openFyde r138) y versiones posteriores, proporcionamos archivos de instalación en formato .run, y puedes seguir los pasos siguientes para obtener el archivo de imagen .img correspondiente.

1. Preparar para ejecutar el archivo .run

   Para FydeOS v21.0-SP1 (openFyde r138) y versiones posteriores, una vez descargado, tendrás un archivo .run. Este debe ejecutarse para crear la imagen de arranque. Elige tu sistema operativo para los pasos siguientes:

   macOS / Linux / BSD

   Para usuarios de macOS, Linux y BSD, usar la terminal es la forma más sencilla de ejecutar el archivo .run. Abre tu terminal y navega al directorio de descargas.

   Windows

   Los usuarios de Windows utilizarán el Subsistema de Windows para Linux (WSL) para ejecutar el archivo .run.

   1. Instala WSL: Si aún no has instalado WSL, consulta la guía oficial de Microsoft para instalar WSL.
   2. Abre la terminal de WSL: Inicia tu terminal de WSL cuando la instalación haya terminado.
   3. Ve a Descargas: Usa el comando cd para ir al directorio donde descargaste el archivo .run. Normalmente estará en /mnt/c/Users/YourUsername/Downloads.

2. Concede permiso de ejecución al archivo .run

   Ahora necesitamos permitir que el archivo .run se ejecute como ejecutable. Usa el siguiente comando en tu terminal:

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

   Importante: Asegúrate de reemplazar FydeOS_for_SBC_Rock5B_v21.0-SP1-io.run con el nombre exacto de tu archivo .run descargado.

3. Ejecuta el archivo .run

   ¡Es hora de ejecutar el archivo .run! En tu terminal, ejecuta:

   ./FydeOS_for_SBC_Rock5B_v21.0-SP1-io.run

   Después de ejecutarlo, aparecerá un menú interactivo:

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

   Sigue las indicaciones para seleccionar tu modelo ROCK 5 y el medio de arranque deseado (eMMC, NVMe o SATA, según tu modelo).

   Luego, el script generará el archivo de imagen de arranque. Es posible que durante el proceso veas mensajes como este:

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

   Generar la imagen puede llevar algo de tiempo. Cuando termine, deberías ver una salida similar a esta, que indica la ruta de tu archivo .img generado:

   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! Ahora tienes un archivo .img de arranque, listo para grabarse. Puedes volver a ejecutar el .run si es necesario.

3. Graba la imagen en tu dispositivo de almacenamiento

A partir de FydeOS v17 (openFyde r114), puedes grabar la imagen descargada directamente en el dispositivo de almacenamiento que usarás para arrancar FydeOS y disfrutar de todas las funciones, incluidas las actualizaciones OTA, ya que antes debías grabar la imagen primero en una tarjeta micro SD y luego realizar un proceso de instalación al dispositivo de almacenamiento de destino final).

Para escribir archivos en unidades de almacenamiento M.2 NVMe/Sata o en un chip eMMC, puede que necesites hardware adicional para conectar estos dispositivos de almacenamiento. Recomendamos usar una carcasa USB para unidad M.2 NVMe/Sata o un lector USB de eMMC para hacerlo.

Nota

El firmware escrito en la SPI-Flash de la familia ROCK 5 en fábrica puede estar vacío o no ser compatible con el arranque desde NVMe. Flashea o actualiza la SPI flash antes de instalar en NVMe, de lo contrario el arranque desde NVMe fallará. Consulta la documentación oficial: ROCK 5B / ROCK 5B+ / ROCK 5T.

Recomendamos usar balenaEtcher para grabar la imagen en un dispositivo USB. BalenaEtcher es una herramienta fácil de usar compatible con Windows, macOS y las versiones principales de Linux. Permite escribir rápidamente archivos de imagen en dispositivos USB o tarjetas de memoria flash en solo tres pasos sencillos:

Puedes descargar el paquete de instalación para tu sistema operativo desde el sitio web oficial de balenaEtcher.

Nota

Si encuentras problemas de compatibilidad con balenaEtcher, usa uno de estos métodos:

• Extrae el archivo .img del archivo .xz y grábalo directamente

• En Windows, usa Rufus en su lugar para obtener los resultados más fiables

Como alternativa, si te sientes cómodo con el comando dd, puedes escribir directamente el archivo .img en el dispositivo de almacenamiento de destino.

4. Enciende tu ROCK 5

Después de escribir correctamente la imagen en el dispositivo de almacenamiento de destino, insértalo con cuidado en tu ROCK 5, conecta también tu kit KVM (teclado, ratón y video) y enciéndelo. Con esto se completa el proceso de instalación de FydeOS / openFyde. ¡Disfruta explorando tu nuevo sistema operativo!

¿Qué hacer si aparece una pantalla negra o el sistema operativo no arranca?

Debido a la singularidad de los SBC con procesador ARM, el proceso de arranque del sistema difiere significativamente del de los dispositivos x86 tradicionales. Para la familia ROCK 5, debes asegurarte de que el firmware SPI del dispositivo permita arrancar desde el dispositivo de almacenamiento que has instalado, que normalmente es un SSD NVMe o Sata en la ranura M.2. Si tienes dificultades para arrancar desde un SSD dentro de la ranura M.2, asegúrate también de que tu firmware SPI no haya sido modificado ni dañado. Si no estás seguro, puedes consultar la wiki oficial para repararlo.