⬆ Guía 09

⬆ Upgrade Buster

Guía experimental para quien ya tiene el Pocket CHIP estable con el Método Revive (Jessie + deploy.sh) y quiere Debian 10 (Buster) con repos más recientes, mejor soporte de paquetes y kernel armmp actualizado.

No es obligatorio. Jessie funciona bien para PICO-8, SSH y uso retro. Solo hazlo si entiendes el riesgo y tienes FEL listo para reflashear.

Resumen
Ruta Jessie (8) → Stretch (9) → Buster (10) — nunca saltar pasos
Tiempo 1–3 horas (descargas + reboots)
Conexión SSH + tmux instalado (Jessie no lo trae por defecto)
Plan B FEL + Flash-Chip-Arch opción p → deploy.sh

Prerrequisitos

  1. Método Revive completado y verificado (apt update, SSH, Pocket Home).
  2. Batería cargada o alimentación estable.
  3. Espacio libre en NAND (~500 MB mínimo recomendado): df -h /
  4. FEL preparado — Checklist FEL + Recovery CachyOS.
  5. tmux instalado — en Jessie stock no viene instalado; hay que instalarlo antes del upgrade:
sudo apt update
sudo apt install tmux
tmux new -s upgrade

Quédate dentro de tmux para todo el proceso (descargas, scripts, apt full-upgrade). Si se cae el SSH: tmux attach -t upgrade.

Alternativa: sudo apt install screen y luego screen -S upgrade (salir sin matar: Ctrl+A, D · volver: screen -r upgrade). O ejecutar desde la consola local del Pocket CHIP con teclado.

Scripts (alojados en esta web)

Paso Script Cuándo
1 upgrade-to-stretch.sh En Jessie (8.x)
reboot — Verificar cat /etc/debian_version → 9.x
2 upgrade-to-buster.sh En Stretch (9.x)
reboot — Verificar → 10.x
3 upgrade-buster-post.sh En Buster — PICO-8, teclado, SSH

Descarga desde el Pocket CHIP (dentro de tmux):

sudo apt install tmux    # obligatorio en Jessie — no viene por defecto
tmux new -s upgrade

wget https://pocketchip.2red.com.es/upgrade-to-stretch.sh
chmod +x upgrade-to-stretch.sh
sudo ./upgrade-to-stretch.sh

Tras cada reboot: tmux new -s upgrade (o tmux attach -t upgrade) y el script siguiente.

Archivos de referencia (incluidos en los scripts): /upgrade/ — sources.list y xorg.conf por versión.

Paso 1 — Jessie → Stretch

wget https://pocketchip.2red.com.es/upgrade-to-stretch.sh
chmod +x upgrade-to-stretch.sh
sudo ./upgrade-to-stretch.sh

El script:

Al terminar:

sudo reboot

Verifica:

cat /etc/debian_version    # debe ser 9.x
uname -r                   # kernel armmp

Si Pocket Home o el escritorio no arrancan bien, prueba consola local o SSH. Si el sistema no responde → FEL y reflasheo.

Paso 2 — Stretch → Buster

wget https://pocketchip.2red.com.es/upgrade-to-buster.sh
chmod +x upgrade-to-buster.sh
sudo ./upgrade-to-buster.sh

El script:

sudo reboot

Verifica: cat /etc/debian_version → 10.x

Paso 3 — Post-upgrade Buster

wget https://pocketchip.2red.com.es/upgrade-buster-post.sh
chmod +x upgrade-buster-post.sh
sudo ./upgrade-buster-post.sh

Verificación final

Check
Pocket Home o escritorio arranca
Wi-Fi + SSH
sudo apt update
PICO-8 abre desde Pocket Home
Teclas FN (brillo, volumen)
Reboot limpio

PICO-8 en juego: Enter = pausa · Ctrl+Q = cerrar · ver Método Revive — controles.

Qué NO hacer

❌ Por qué
apt dist-upgrade directo Jessie → Buster Rompe dependencias y Pocket Home
apt autoremove tras el upgrade Documentado — borra paquetes que Pocket Home necesita
Cerrar SSH sin tmux Proceso interrumpido = sistema a medias
Upgrade sin FEL listo Sin plan B si la NAND queda corrupta

Si algo sale mal

  1. SSH aún responde — no reinicies a ciegas. Revisa /var/log/apt/term.log.
  2. Pantalla negra pero SSH OK — revisa /etc/X11/xorg.conf; copia desde xorg-buster.conf o reflashea.
  3. No arranca — FEL + Flash-Chip-Arch opción p → deploy.sh.
  4. PICO-8 no abre — sudo ln -sfn /usr/lib/pico-8 /usr/lib/pico8 + libcurl (ver Post-flash).

Alternativa: no tocar NAND

Si solo quieres Linux moderno sin arriesgar la instalación stock:

Ver Roadmap — Fase 5.

Referencias

Resumen en una línea

Jessie OK → apt install tmux → tmux → upgrade-to-stretch → reboot → upgrade-to-buster → reboot → upgrade-buster-post → listo