Raspberry Pi · UART · rescate sin red

Acceder a la terminal de una Raspberry Pi mediante una Raspberry Pi Pico y UART

Una Raspberry Pi puede controlarse desde una consola serie por UART. Como un ordenador normal no suele tener UART GPIO directo, usamos una Raspberry Pi Pico como intermediario USB-UART entre el ordenador y la Raspberry Pi.

Ordenador USB Raspberry Pi Pico con puente USB-UART UART Raspberry Pi con Linux consola
Demostración principal

Terminal por puerto serie funcionando

En el vídeo se ve el flujo real desde macOS: localizar la Pico como puerto USB serie, abrir la conexión a 115200 baudios y obtener una terminal de la Raspberry Pi por UART.

Animación de una terminal en macOS abriendo minicom contra la Raspberry Pi por el puerto serie de la Pico.
No conectes 5 V ni 3,3 V entre ambas placas para este montaje. Cada placa debe recibir alimentación por su vía habitual. Solo deben conectarse TX, RX y GND. Ambas interfaces trabajan con niveles lógicos de 3,3 V; no conectes directamente un dispositivo UART de 5 V.

1. Material necesario para el enlace UART

  • Una Raspberry Pi Pico o Pico H que hará de puente USB-UART.
  • La Raspberry Pi que ya quieres controlar por consola serie.
  • Un cable USB de datos para conectar la Pico al ordenador. Algunos cables USB solo sirven para carga.
  • Tres cables Dupont para TX, RX y GND común.
  • Un ordenador con Windows, macOS o Linux para abrir la terminal serie.

2. Convertir la Pico en un adaptador USB-UART

Esta guía usa un firmware propio ya compilado en formato UF2. Ese firmware convierte la Pico en un puente USB-UART a 115200 baudios usando GP0 como TX y GP1 como RX.

  1. Desconecta la Pico del ordenador.
  2. Mantén pulsado el botón BOOTSEL.
  3. Conecta la Pico por USB sin soltar BOOTSEL.
  4. Suelta el botón cuando aparezca una unidad USB llamada normalmente RPI-RP2.
  5. Descarga el UF2 de esta página.
  6. Copia el archivo .uf2 a la unidad RPI-RP2.
  7. Espera a que la unidad se desmonte y la Pico se reinicie automáticamente.
  8. Desconecta y vuelve a conectar la Pico si fuera necesario.
La conexión correcta es GP0 TX de la Pico hacia RXD/GPIO15 de la Raspberry Pi, GP1 RX de la Pico hacia TXD/GPIO14 de la Raspberry Pi y GND común.

Tras instalarlo, la Pico debe aparecer en el ordenador como un puerto serie USB CDC.

3. Cableado

Con el UF2 de esta guía, la Pico actúa como adaptador USB-UART usando GP0 y GP1. La regla importante es simple: TX siempre se conecta con RX y RX siempre se conecta con TX.

Foto real de una Raspberry Pi conectada por cables UART a una Raspberry Pi Pico que actua como adaptador USB-UART.
Ejemplo real de montaje: la Raspberry Pi mantiene su alimentación normal y la Pico se conecta al ordenador por USB. Entre ambas placas solo se conectan TX, RX y GND común.
Raspberry Pi Pico con UF2 USB-UART Función Raspberry Pi convencional
GP0, pin físico 1 TX de la Pico GPIO15 / RXD, pin físico 10
GP1, pin físico 2 RX de la Pico GPIO14 / TXD, pin físico 8
GND, por ejemplo pin físico 3 Masa común GND, por ejemplo pin físico 6
Nunca conectes TX con TX ni RX con RX. Si no se cruzan las señales, normalmente no se recibirá ningún dato.

Conecta primero GND y después TX/RX, especialmente cuando ambos equipos están alimentados desde fuentes distintas. La Pico se alimenta por el USB conectado al ordenador; la Raspberry Pi debe tener su propia fuente de alimentación.

4. Activar la consola serie en la Raspberry Pi

El objetivo es habilitar una consola Linux con pantalla de login, no usar UART para un sensor o una aplicación propia.

sudo raspi-config

Ruta habitual:

Interface Options
└── Serial Port

Responde:

Would you like a login shell to be accessible over serial? Yes
Would you like the serial port hardware to be enabled? Yes
sudo reboot

Para este caso deben activarse ambas cosas: hardware UART y login shell por UART. En proyectos con sensores, GPS u otros periféricos normalmente se activa el hardware pero se desactiva la consola.

grep -o 'console=[^ ]*' /boot/firmware/cmdline.txt
systemctl status serial-getty@serial0.service
ls -l /dev/serial0
En versiones antiguas de Raspberry Pi OS los archivos de arranque pueden estar en /boot/. En versiones recientes suelen estar en /boot/firmware/. No edites cmdline.txt introduciendo saltos de línea: debe permanecer en una única línea. Haz copia de seguridad antes de editar manualmente archivos de arranque.

5. Configuración manual opcional

Solo si raspi-config no funciona. Normalmente se necesita:

# /boot/firmware/config.txt
enable_uart=1

# En la unica linea de /boot/firmware/cmdline.txt
console=serial0,115200

No sobrescribas completamente cmdline.txt. El contenido exacto depende de la versión de Raspberry Pi OS y del modelo.

Raspberry Pi 5 puede diferir porque incorpora un conector de depuración UART dedicado. Antes de asumir que serial0 está sobre GPIO14 y GPIO15, comprueba la asignación del sistema y la documentación del modelo usado.
ls -l /dev/serial*
pinctrl get 14
pinctrl get 15
grep -E 'enable_uart|dtoverlay' /boot/firmware/config.txt

6. Conectar desde macOS

  1. Instalar y configurar correctamente la Raspberry Pi Pico si no se ha hecho (sigue estos pasos).
Animación del flujo en macOS: buscar el puerto USB de la Pico y abrir minicom a 115200 baudios para entrar en la Raspberry Pi por UART.
Ejemplo real en macOS: primero se identifica el puerto /dev/cu.usbmodem*, después se abre minicom a 115200 baudios y aparece la terminal de la Raspberry Pi por UART.
ls /dev/cu.usbmodem*
ls /dev/cu.*

Para comparar antes y después de conectar la Pico:

ls /dev/cu.* > /tmp/ports-before.txt
# Conecta la Pico
ls /dev/cu.* > /tmp/ports-after.txt
diff /tmp/ports-before.txt /tmp/ports-after.txt

El puerto suele tener una forma similar a /dev/cu.usbmodemXXXX, pero el nombre cambia entre ordenadores y conexiones.

screen /dev/cu.usbmodemXXXX 115200

La configuración es 115200 8N1: 115200 baudios, 8 bits de datos, sin paridad, 1 bit de parada y sin control de flujo.

Para salir de screen: pulsa Ctrl+A, después \ y confirma con y.

brew install minicom
minicom -D /dev/cu.usbmodemXXXX -b 115200

Si Homebrew no está instalado, revisa su página oficial: brew.sh.

lsof | grep usbmodem
screen -ls
screen -r
screen -D -r

7. Conectar desde Linux

ls /dev/ttyACM*
dmesg --follow
sudo dmesg --follow
sudo apt update
sudo apt install minicom
minicom -D /dev/ttyACM0 -b 115200
screen /dev/ttyACM0 115200

No asumas siempre /dev/ttyACM0: puede aparecer como /dev/ttyACM1, /dev/ttyUSB0 u otro dispositivo.

ls -l /dev/ttyACM0
sudo usermod -aG dialout "$USER"

Después de añadir el usuario al grupo correspondiente, cierra la sesión y vuelve a iniciarla. No uses chmod 777 sobre el dispositivo.

8. Conectar desde Windows con PuTTY

Instala PuTTY desde Microsoft Store verificando el paquete oficial, desde el instalador oficial en chiark.greenend.org.uk/~sgtatham/putty/latest.html, o con winget tras comprobar el identificador exacto:

winget search PuTTY

Conecta la Pico, abre el Administrador de dispositivos, despliega “Puertos (COM y LPT)”, busca un dispositivo serie USB o CMSIS-DAP y anota el puerto, por ejemplo COM5.

Get-CimInstance Win32_SerialPort |
    Select-Object DeviceID, Name, Description

En PuTTY:

  • Connection type: Serial
  • Serial line: COM5
  • Speed: 115200
  • Connection -> Serial: 8 data bits, 1 stop bit, parity None, flow control None

Si la ventana aparece vacía, pulsa Enter una o dos veces. Para cerrar, ejecuta exit antes de cerrar la ventana.

9. Iniciar sesión

Raspberry Pi OS raspberrypi login: daniel Password: daniel@raspberrypi:~ $ hostname

Usa un usuario existente de la Raspberry Pi. La contraseña no muestra caracteres, puntos ni asteriscos mientras se escribe; es normal en Linux. Tras autenticarte tendrás una shell real de la Raspberry Pi, independiente de Wi-Fi, Ethernet o SSH.

hostname
ip address
uname -a
systemctl --failed
journalctl -b -p warning

10. Diagnóstico de problemas

Síntoma Posible causa Solución
No aparece ningún puerto serie Cable solo de carga, UF2 incorrecto, problema USB o Pico en BOOTSEL. Prueba otro cable de datos, reinstala el UF2, revisa el Administrador de dispositivos, /dev/cu.* o /dev/ttyACM*, y reconecta la Pico.
El puerto existe, pero no aparece texto TX/RX no cruzados, falta GND, consola serie desactivada, velocidad incorrecta, puerto equivocado o Raspberry Pi apagada. Verifica el cableado, pulsa Enter, reinicia con el terminal ya abierto y confirma console=serial0,115200 y serial-getty.
Aparecen caracteres ilegibles Baud rate incorrecto, configuración distinta de 8N1, control de flujo activado o UART mal asignada. Usa 115200 baudios, 8 bits, sin paridad, 1 bit de parada y sin control de flujo.
Se ven mensajes, pero no aparece login Hardware UART activado, pero consola de login desactivada, o getty no ejecutándose. Comprueba serial0 y ejecuta systemctl status serial-getty@serial0.service. Si procede: sudo systemctl enable --now serial-getty@serial0.service.
Se puede leer, pero no escribir La línea Pico TX -> Pi RX funciona, pero la línea Pi TX -> Pico RX no; GP0/GP1 intercambiados; cable defectuoso; control de flujo activado. Revisa la línea de retorno, cambia el cable sospechoso y desactiva el control de flujo.
screen muestra “Resource busy” Otro programa o sesión conserva abierto el puerto. Ejecuta lsof | grep -E 'usbmodem|ttyACM|ttyUSB' y cierra el proceso o recupera/cierra la sesión screen.
La consola funciona, pero SSH no UART y SSH son mecanismos independientes. Usa UART para reparar red, firewall, dirección IP, claves SSH, servicios o errores de arranque.

Configurar correctamente la Pico y cargar el UF2 del puente UART

Después de usar Thonny para MicroPython o para comprobar que el Mac detecta la placa, el puente UART no se vuelve a cargar con Thonny. Para este caso se usa el modo BOOTSEL de la Pico y se copia directamente un archivo .uf2 ya compilado a la unidad RPI-RP2.

Este firmware propio convierte la Pico en puente USB-UART usando Serial por USB y Serial1 por UART0. Este UF2 usa GP0 como TX y GP1 como RX.

Archivos descargables para la Pico

Descarga el UF2 ya compilado para cargarlo directamente en la Pico. El sketch Arduino se incluye por si quieres revisar el código o recompilarlo tú mismo.

SHA-256: e81d2f46e79dbd3f2e4d864bf0d03309dcfa2fd98e372a13236c1359cc6459a8
Este UF2 corresponde al firmware propio con GP0 como TX y GP1 como RX: GP0 -> Raspberry Pi RXD/GPIO15, GP1 <- Raspberry Pi TXD/GPIO14 y GND común.

Pasos exactos desde macOS

  1. Pon la Pico en modo BOOTSEL: desconecta el USB, mantén pulsado BOOTSEL, conecta el USB, espera 2-3 segundos y suelta BOOTSEL.
  1. Comprueba que macOS la ve como volumen.
ls /Volumes

Debe aparecer:

RPI-RP2
  1. Descarga desde esta página el firmware UF2 ya compilado.
pico_usb_uart_bridge.ino.uf2
  1. Copia ese archivo a la Pico montada como RPI-RP2.
cp ~/Downloads/pico_usb_uart_bridge.ino.uf2 /Volumes/RPI-RP2/
  1. Cuando termina la copia, la Pico se reinicia sola y vuelve como puerto serie. El nombre exacto puede cambiar; en este montaje apareció así:
/dev/cu.usbmodem21201
  1. Abre la Pico como puerto serie a 115200 baudios, sustituyendo el puerto si macOS le asignó otro nombre.
minicom -D /dev/cu.usbmodem21201 -b 115200
  1. Para salir de minicom, pulsa Ctrl-A y después X.
  2. Conecta GP0 TX de la Pico a GPIO15/RXD de la Raspberry Pi, GP1 RX de la Pico a GPIO14/TXD de la Raspberry Pi y GND con GND.
De dónde sale ese UF2

El archivo pico_usb_uart_bridge.ino.uf2 se obtiene al compilar el sketch Arduino/C++ descargable de esta página con exportación de binarios. Si quieres recompilarlo con arduino-cli, crea una carpeta de sketch llamada pico_usb_uart_bridge y guarda dentro el archivo pico_usb_uart_bridge.ino:

arduino-cli compile --export-binaries -b rp2040:rp2040:rpipico pico_usb_uart_bridge
Notas
  • Si no aparece RPI-RP2, la Pico no está en modo BOOTSEL.
  • Si no aparece /dev/cu.usbmodem*, macOS no está detectando la Pico.
  • Si minicom muestra Resource busy, otro programa está usando el puerto. Cierra Thonny, screen, Arduino IDE u otra terminal serie.
  • El firmware pico_usb_uart_bridge convierte la Pico en un puente USB-UART a 115200 baudios.

Código fuente del firmware

// Raspberry Pi Pico USB <-> UART bridge for Raspberry Pi serial console.
static constexpr uint32_t UART_BAUD = 115200;
static constexpr int UART_TX_PIN = 0;  // GP0 -> Pi RXD GPIO15, pin 10
static constexpr int UART_RX_PIN = 1;  // GP1 <- Pi TXD GPIO14, pin 8

void setup() {
  Serial.begin(115200);
  Serial1.setTX(UART_TX_PIN);
  Serial1.setRX(UART_RX_PIN);
  Serial1.begin(UART_BAUD);
  Serial.ignoreFlowControl(true);

  unsigned long start = millis();
  while (!Serial && (millis() - start < 1500)) {
    delay(10);
  }

  delay(200);
  while (Serial.available()) {
    Serial.read();
  }

  Serial.println("Pico USB-UART bridge ready (GP0 TX, GP1 RX, 115200)");
}

void loop() {
  while (Serial.available()) {
    Serial1.write(Serial.read());
  }

  while (Serial1.available()) {
    Serial.write(Serial1.read());
  }
}