⚡ Guía 03

⚡ Recovery CachyOS

Guía para reflashear un Pocket CHIP que se queda en el logo CHIP tras un upgrade fallido. Probada conceptualmente con CachyOS (Arch-based); debería funcionar en cualquier Arch con acceso USB directo.

Tiempo estimado: 1–2 horas la primera vez (incluye descarga de imágenes).

Requisitos

Hardware

Material Notas
Pocket CHIP (módulo CHIP extraíble) Hay que sacarlo de la carcasa
Clip, cable puente o paperclip fino Para unir FEL + GND
Cable micro-USB de datos Corto y de calidad; muchos cables solo cargan
Portátil con CachyOS Linux nativo; no uses WSL
(Opcional) Fuente 5 V Si el USB da problemas de alimentación, conectar a pin CHG-IN

Software (instalar antes de conectar el CHIP)

sudo pacman -S git wget curl android-tools uboot-tools sunxi-tools

Comprueba que sunxi-fel y fastboot existen:

which sunxi-fel fastboot
sunxi-fel --version
fastboot --version

Paso 1: Preparar el entorno de flasheo

Opción A — Flash-Chip-Arch (recomendada)

Script adaptado a Arch/CachyOS. Instala dependencias, reglas udev y descarga imágenes.

cd ~
git clone https://github.com/maxaubel/Flash-Chip-Arch
cd Flash-Chip-Arch
chmod +x Flash.sh

No ejecutes aún. Primero prepara el hardware (Paso 2).

Opción B — CHIP-tools de nytpu (alternativa)

Si Flash-Chip-Arch falla, usa herramientas más recientes de la comunidad:

cd ~
git clone https://git.sr.ht/~nytpu/CHIP-tools
cd CHIP-tools

Paso 2: Modo FEL (hardware)

El CHIP debe estar en FEL mode para que el PC pueda escribir la NAND.

  1. Apaga el Pocket CHIP (mantén Power ~10 s si no responde).
  2. Saca el módulo CHIP de la carcasa del Pocket CHIP (sin tornillos; presiona las pestañas).
  3. Localiza el header U14 en el CHIP.
  4. Puente FEL ↔ GND con un cable Dupont o clip. En la PCB suelen estar etiquetados FEL y GND — foto de referencia. Si no hay etiquetas: pin 7 y pin 39 en U14.
  5. Con el puente puesto, conecta el micro-USB del CHIP (no el USB grande) al portátil.
  6. Usa un puerto USB 2.0 si tienes opción (más estable que USB 3.0).
  7. Deberían encenderse LEDs junto al micro-USB (rosa/blanco).

Detalle visual y checklist: 03-fel-checklist.md.

Verifica detección en CachyOS:

lsusb | grep -E '1f3a|Allwinner|sunxi'

Deberías ver algo como 1f3a:efe8 (modo FEL).

Paso 3: Flashear

Con Flash-Chip-Arch

Con el CHIP conectado en FEL:

cd ~/Flash-Chip-Arch
./Flash.sh

Cuando pida el sabor de imagen:

Tecla Imagen Cuándo usarla
p Pocket CHIP (stock) Tu caso — recovery con Pocket Home, PICO-8, etc.
pn Pocket CHIP + No-Limit Si hay problemas de alimentación USB
g Desktop (XFCE) CHIP suelto con monitor
s Server headless CHIP sin pantalla
f Force clean Re-descargar imágenes si corruptas

Para revivir un Pocket CHIP congelado en el logo: elige p.

El script:

  1. Instala paquetes vía pacman
  2. Configura udev para dispositivos Allwinner
  3. Clona CHIP-tools y descarga la imagen desde chip.jfpossibilities.com
  4. Escribe la NAND (varios minutos)

Éxito cuando veas:

FLASH VERIFICATION COMPLETE.
CHIP is ready to roll!

Con nytpu/CHIP-tools (alternativa)

cd ~/CHIP-tools
FEL='sudo sunxi-fel' FASTBOOT='sudo fastboot' SNIB=false ./chip-update-firmware.sh -p

-p = imagen Pocket CHIP.

Paso 4: Finalizar

  1. Desconecta el USB del CHIP.
  2. Quita el puente FEL ↔ GND.
  3. Vuelve a insertar el CHIP en la carcasa del Pocket CHIP.
  4. Enciende (Power ~2 s).
  5. Espera 2–5 minutos en el primer arranque (NAND lenta).
  6. Deberías ver Pocket Home o asistente de configuración.

Paso 5: Post-flash obligatorio

No te saltes esto o volverás a tener problemas con apt:

→ Sigue 05-post-flash.md

Resumen mínimo:

# En el Pocket CHIP (app Terminal), contraseña por defecto: chip
sudo nano /etc/apt/sources.list
# Sustituir opensource.nextthing.co por chip.jfpossibilities.com

sudo apt update
sudo apt install openssh-server
sudo systemctl enable ssh

Problemas durante el flash

→ 04-troubleshooting.md

Los más frecuentes en CachyOS:

Error Causa Fix rápido
waiting for FEL... TIMEOUT Cable solo carga, puente mal, USB 3.0 Cambiar cable/puerto; revisar puente
fastboot: invalid option -- 'i' fastboot demasiado nuevo Ver sección fastboot en troubleshooting
Script cuelga en fastboot Cambio de USB ID mid-flash Reiniciar script; reglas udev del Flash-Chip-Arch

Después del recovery: no repetir el error

  1. No hagas apt dist-upgrade a Stretch/Buster sin guía concreta.
  2. Sí puedes apt update && apt upgrade dentro de Jessie con repos de jfpossibilities.
  3. Documenta qué upgrade te rompió el sistema — será el primer post de tu web.
  4. Cuando esté estable, explora 06-roadmap.md para Linux moderno.

Registro para tu web (plantilla)

Copia y rellena mientras flasheas:

## Mi recovery — [FECHA]

- **Síntoma:** Logo CHIP congelado tras upgrade
- **Upgrade que hice:** [ej. apt upgrade / dist-upgrade a stretch]
- **Host:** CachyOS [versión kernel]
- **Script usado:** Flash-Chip-Arch / nytpu CHIP-tools
- **Imagen:** pocketchip stable b___
- **Problemas:** [ninguno / cable / fastboot -i / etc.]
- **Tiempo total:** ___ min
- **Resultado:** [OK / pendiente]