🛠 Guía 05

🛠 Troubleshooting

Errores habituales al reflashear un Pocket CHIP desde CachyOS / Arch.

waiting for FEL... TIMEOUT

Causa: El PC no ve el CHIP en modo FEL.

Soluciones (en orden):

  1. Revisar puente pin 7 ↔ pin 39.
  2. Cambiar cable micro-USB (debe ser de datos).
  3. Probar puerto USB 2.0 directo (sin hub).
  4. Desconectar, quitar puente, esperar 10 s, repetir secuencia FEL.
  5. Alimentación extra: 5 V en pin CHG-IN mientras flasheas.
  6. Elegir imagen No-Limit (pn en lugar de p).

Verificación:

sudo sunxi-fel ping

fastboot: invalid option -- 'i'

Causa: La versión de fastboot en Arch/CachyOS es demasiado nueva. Los scripts del CHIP usan -i para vendor ID, eliminado en fastboot moderno.

Comprobar:

fastboot --help 2>&1 | grep "\-i"

Si no aparece -i, necesitas fastboot antiguo o CHIP-tools parcheados.

Fix A — platform-tools r26 (recomendado si usas Flash-Chip-Arch)

cd /tmp
wget https://dl.google.com/android/repository/platform-tools_r26.0.1-linux.zip
unzip platform-tools_r26.0.1-linux.zip
export PATH="/tmp/platform-tools:$PATH"
fastboot --help 2>&1 | grep "\-i"   # debe aparecer ahora

cd ~/Flash-Chip-Arch
PATH="/tmp/platform-tools:$PATH" ./Flash.sh

Fix B — nytpu/CHIP-tools (ya sin -i en parte del script)

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

waiting for fastboot... TIMEOUT

Causa: Tras FEL, el CHIP reinicia en modo fastboot pero el PC pierde la conexión USB (cambio de ID).

Soluciones:

  1. Asegurar reglas udev (Flash-Chip-Arch las crea en /etc/udev/rules.d/99-allwinner.rules).
  2. Reiniciar el script — a menudo funciona al segundo intento.
  3. No uses máquina virtual ni WSL.
  4. Desactivar ahorro de energía USB en el portátil si existe.

Durante el timeout, monitoriza:

watch -n1 'lsusb | grep -E "1f3a|18d1"'

sunxi-nand-image-builder: command not found

Causa: El binario no viene en el paquete sunxi-tools de Arch.

Fix:

git clone --branch v1.4.1 https://github.com/linux-sunxi/sunxi-tools.git
cd sunxi-tools
make install-all install-misc
# Si sigue fallando, copiar manualmente:
sudo cp sunxi-nand-image-builder /usr/local/bin/

FLASH VERIFICATION FAILED

Causas posibles:

Acción: Ctrl+C, desconectar, repetir desde FEL con imagen pn y cable/puerto distintos.

apt update muy lento o "Waiting for headers"

Síntoma: apt update se queda en Waiting for headers minutos sin avanzar.

Causa: Líneas rotas en sources.list (mirrors Jessie activos, nextthing.co, http.debian.net).

Solución: Limpiar sources.list y dejar solo archive.debian.org + chip.jfpossibilities.com. Ver 00-mi-recovery.md paso 7. Luego:

wget -O deploy.sh https://pocketchip.2red.com.es/deploy.sh
sudo INTERACTIVE=0 bash deploy.sh

En Pocket CHIP, 1–3 min por repo puede ser normal; 10+ min sin cambiar = atascado.

Síntoma: Errores en apt update con URLs que parecen mal (http://http.debian.net).

Explicación: El hostname http.debian.net es real (por eso se ve doble "http"). Pero Jessie está archivado y esos mirrors fallan.

Solución: Usar archive.debian.org. Ver 05-post-flash.md o el deploy.sh actualizado en la web.

Flash termina OK pero sigue en logo CHIP

  1. Espera 5 minutos — primer boot es lento.
  2. ¿Quitaste el puente FEL antes de encender en el Pocket?
  3. ¿Reinsertaste bien el CHIP en la carcasa?
  4. Prueba hard reset: Power 10 s apagado, soltar, Power 2 s encender.
  5. Si nada: reflashear otra vez con f (force clean).

Pantalla negra pero LEDs activos

UART: 115200 8N1, adaptador 3.3 V (no 5 V).

Flash-Chip-Arch: el script no flashea / termina sin mensaje

El repo original tiene lógica frágida en install_chip_tools. Si falla:

  1. Clona CHIP-tools manualmente:
cd ~/Flash-Chip-Arch
git clone https://github.com/Project-chip-crumbs/CHIP-tools.git
cd CHIP-tools
FEL='sudo sunxi-fel' FASTBOOT='sudo fastboot' SNIB=false ./chip-update-firmware.sh -p
  1. O usa directamente nytpu/CHIP-tools.

Tabla rápida

Mensaje Primer intento
FEL TIMEOUT Cable + puerto USB 2.0 + revisar puente
fastboot -i platform-tools r26 en PATH
fastboot TIMEOUT Re-ejecutar script + udev rules
VERIFICATION FAILED Opción f + pn + otro cable
OK flash, no boot Esperar 5 min + quitar puente FEL

Cuándo pedir ayuda

Documenta y pregunta en r/ChipCommunity con: