Instalar el software

Las SBC suelen usar una tarjeta SD como su «disco». Al mismo tiempo, algunas personas usan SSD. Esta documentación y las imágenes de disco se construyen y prueban con tarjetas SD, así que arrancar desde SSD es posible en hardware que lo soporte, pero no es una configuración que probemos ni soportemos: te guiarás por la documentación de arranque por USB/SSD de tu propia SBC/placa, y resolver cualquier problema específico de esa configuración queda por tu cuenta.

Tu configuración de hardware puede ser distinta a la que se usó para crear esta documentación, así que ajusta los pasos según corresponda.

Obtener la imagen de disco

Puedes obtener la imagen de disco de WPSD en WPSD.radio, en la siguiente URL:

https://wpsd.radio/#download-wpsd

Descarga el archivo de imagen de disco adecuado para tu SBC. En la mayoría de los casos no necesitas descomprimir el archivo descargado.

Consejo

Solo existen imágenes de disco para las SBC y los dispositivos de fabricantes que aparecen en la página de descarga; consulta Computadora de placa única para saber por qué. Si no ves tu hardware específico en la tabla, es que no se ha construido ninguna imagen para él. (lee las preguntas frecuentes)

En la página también se incluye el archivo WPSD_SHA256-SUMS.txt. Este archivo contiene las firmas criptográficas de los archivos de imagen de disco, que puedes usar para verificar que la descarga que recibiste no tiene errores ni fue alterada en el camino. Verificar la suma de comprobación (checksum) es totalmente opcional y está fuera del alcance de este documento. Consulta el artículo How to Verify MD5, SHA-1, and SHA-256 Checksum in Windows (cómo verificar sumas de comprobación MD5, SHA-1 y SHA-256 en Windows) para más información.

Grabar la imagen

Hay varias herramientas para grabar tu tarjeta SD. Algunos prefieren interfaces gráficas, como Balena Etcher y Raspberry Pi Imager. También se pueden usar herramientas clásicas del sistema operativo, como dd.

Recomendamos Balena Etcher para quienes tienen menos experiencia y emprenden este proyecto. Los radioaficionados con más experiencia pueden tener sus propias preferencias.

Con Balena Etcher

Truco

El equipo de WPSD recomienda usar Balena Etcher en lugar de otras herramientas, como Raspberry Pi Imager. Esto se debe a que las imágenes de disco de WPSD vienen preconfiguradas con muchos ajustes, y usar otras herramientas de grabación de imágenes que permiten hacer modificaciones después de grabar corre el riesgo de dañar la instalación. Bajo tu propio riesgo (Caveat Emptor).

Balena Etcher está disponible para Windows, MacOS y Linux en x86. Descarga la versión adecuada directamente desde la página de descargas de Balena Etcher e instálala.

  1. Inserta la SD: inserta la tarjeta SD en la computadora, con tu adaptador si hace falta.

  2. Abre Balena Etcher.

  3. Selecciona la imagen: con el botón «Select image» (seleccionar imagen), navega hasta el archivo de imagen de disco comprimido que descargaste y elígelo; por ejemplo, WPSD_RPi-Trixie.img.xz.

  4. Selecciona la unidad: selecciona la tarjeta SD con el botón «Select drive» (seleccionar unidad) y elige la tarjeta SD que insertaste antes en la computadora.

  5. Graba: selecciona el botón «Flash» (grabar) y deja que el programa grabe la imagen de disco en la tarjeta SD. El proceso de grabación puede tardar un rato, según la velocidad de la tarjeta SD, de la computadora y del lector de tarjetas.

  6. Balena Etcher te avisará cuando termine el proceso de grabación y verificación. Cuando termine, puedes expulsar la tarjeta SD con seguridad.

Con Raspberry Pi Imager

Raspberry Pi Imager está disponible para Windows, MacOS y Ubuntu en x86. Descarga la versión adecuada directamente desde la página de descargas de Raspberry Pi e instálala.

  1. Inserta la SD: inserta la tarjeta SD en la computadora, con tu adaptador si hace falta.

  2. Abre Raspberry Pi Imager.

  3. Raspberry Pi Device: se abrirá una ventana donde puedes seleccionar el dispositivo que vas a grabar. Arriba, elige No Filter (sin filtro).

  4. Choose OS: se abrirá una ventana donde puedes seleccionar el sistema operativo que vas a grabar. No elijas ninguno de los Raspberry Pi OS; desplázate casi hasta el final y elige «Use custom» (usar personalizado). La herramienta te mostrará una ventana de selección de archivos donde puedes navegar hasta la imagen que descargaste y elegirla; por ejemplo, WPSD_RPi-Trixie.img.xz.

  5. Choose Storage: si insertaste bien tu tarjeta SD, debería aparecer en la ventana.

  6. Advanced Options: pon especial atención en NO crear un usuario, o bien en usar el usuario pi-star. La imagen de disco viene preconfigurada esperando que exista la cuenta pi-star: muchos scripts y servicios de WPSD se ejecutan como ese usuario específico o se autentican con él. Si el paso de creación de usuario de Raspberry Pi Imager crea en su lugar un nombre de usuario distinto, pi-star no existirá en el primer arranque y esos scripts/servicios fallarán, lo que daña WPSD.

    1. Presiona Shift + Control + X para abrir la pantalla de personalización del sistema operativo (OS Customization).

    2. No establezcas un nombre de usuario ni una contraseña. Si no puedes desmarcar esta opción, desmarca Enable SSH en la pestaña Services. Tendrás SSH disponible de todos modos.

      Advertencia

      El usuario y la contraseña pi-star ya vienen en la imagen de disco y muchos programas de WPSD los necesitan para funcionar bien. (Puedes cambiar la contraseña del usuario «pi-star» desde la página de configuración de WPSD después del primer arranque.)

    3. Configure wireless LAN: escribe con cuidado el SSID y la contraseña de tu WiFi local. Selecciona el país de la LAN inalámbrica que corresponda; por ejemplo, «US».

    4. Set locale settings: ponlo con los valores correctos para tu uso local.

    5. Desplázate hasta el botón «Save» (guardar) y volverás a la pantalla original.

  7. Selecciona Next o Write y una ventana emergente te preguntará si quieres aplicar los ajustes personalizados. Selecciona Yes y luego Yes otra vez para empezar a grabar. El programa tardará unos minutos en grabar y verificar la imagen. Cuando termine, puedes expulsar la tarjeta SD con seguridad.

Puedes insertar la tarjeta SD en tu SBC y continuar con Arranque inicial.

Debian / Ubuntu / MacOS

Usar estas herramientas es más avanzado, y estas instrucciones suponen que te sientes cómodo trabajando en la línea de comandos.

Puedes usar el comando dd del proyecto coreutils para grabar el archivo de imagen de disco en la tarjeta SD. Primero tienes que descomprimir el archivo .xz, cuya salida puedes canalizar (pipe) a dd si lo prefieres.

  1. Abre una ventana de terminal y cámbiate al directorio donde descargaste el archivo de imagen de disco comprimido. Normalmente estará en ~/Downloads.

  2. Descomprime el archivo con unxz, reemplazando $IMAGE por el archivo que descargaste.

    $ unxz WPSD_$IMAGE.img.xz

  3. Inserta la tarjeta SD en la computadora y usa lsblk para identificar qué dispositivo es la tarjeta SD correcta.

    $ lsblk

  4. Graba el archivo de imagen de disco en la tarjeta SD con dd. Es posible que necesites ser root para hacerlo o usar sudo. Usando /dev/sda como ejemplo de tu tarjeta SD:

    $ dd bs=4M if=WPSD_$IMAGE.img of=/dev/sda

  5. Cuando termine el proceso de grabación de la imagen de disco, retira la tarjeta SD de la computadora.