Consola portátil Pocket Pi SF32¶

¿Qué es Pocket Pi?¶

SiFliSparks/PocketPi es una referencia de consola portátil y emulador para SF32LB52. La revisión fijada integra el emulador NES Nofrendo, un explorador de juegos LVGL, una ruta de pantalla ST7789 8080 de 320 × 240, audio, guardado y carga de estados, un sistema de archivos integrado y un directorio de ROM en tarjeta TF. La compilación pública usa como base Huangshan Pi / sf32lb52-lchspi-ulp.

Resulta útil para probar cómo conviven los gráficos locales, la entrada, el audio, el almacenamiento externo, la asignación de PSRAM y la carga del emulador en un sistema SF32LB52. El repositorio no incluye ROM comerciales; cada usuario debe aportar archivos .nes/.NES cuyo uso tenga autorizado. El código fuente público tampoco constituye un diseño de consola portátil listo para producción ni sustituye las revisiones de seguridad de la batería, audio, EMC, aspectos térmicos, licencias o distribución de contenido.

¿Por qué la implementación en SF32?¶

La emulación NES reúne varios retos habituales del desarrollo embebido en una carga de trabajo fácil de entender: la emulación de CPU, los gráficos PPU, el muestreo de audio, la entrada de baja latencia, la lectura de archivos, el búfer de cuadros y los estados guardados deben funcionar en conjunto. Un sistema basado en SF32LB52 aporta los recursos de pantalla, audio, almacenamiento externo y PSRAM necesarios para esta carga; Huangshan Pi también ofrece una plataforma de evaluación alimentada por batería.

Esto no significa que todos los títulos NES sean totalmente compatibles. La compatibilidad con los mappers de las ROM, la tasa de cuadros, el audio, el guardado, el pico de memoria y la latencia de entrada pueden variar según el juego. Cada ROM o mapper que se añada requiere su propia decisión de compatibilidad y derechos de autor.

Resultado, alcance y criterios de entrada¶

Resultado: generar una imagen reproducible a partir del commit de PocketPi fijado en la especificación de software, iniciar al menos una ROM de prueba cuyo uso esté autorizado, validar pantalla, entrada, audio, pausa, guardado, carga, salida y recuperación, y completar una adaptación acotada.

Esta página no garantiza la compatibilidad con todos los mappers NES, la temporización PAL/NTSC, la ruta de audio de los juegos, el formato de guardado ni ROM de terceros. Tampoco concede derechos para copiar o distribuir contenido de juegos. La revisión fijada del repositorio no contiene un archivo de licencia en el directorio raíz. Antes de incorporar código a un producto o distribuir binarios, alguien responsable debe determinar las licencias de PocketPi, Nofrendo y cada componente de terceros integrado.

Antes de empezar, tenga preparado:

• SF32LB52-DevKit-ULP / Huangshan Pi, o hardware compatible con la definición de placa sf32lb52-lchspi-ulp del repositorio;
• la pantalla de 320 × 240, el expansor de entrada I²C AW9523, las teclas, el audio y la ruta opcional de tarjeta TF que espera el código fijado; el nombre de la placa no garantiza que todos los periféricos estén montados;
• SiFli-SDK, SCons y herramientas de descarga por UART y de registro;
• una ROM de prueba .nes propia, de dominio público o con licencia adecuada;
• la ROM en disk/ del repositorio para el sistema de archivos integrado o en el directorio de ROM de la tarjeta TF configurado por el firmware. La revisión fijada busca ROM durante la ejecución en /sdcard/roms/nes; compruebe en esa revisión que la ruta coincida con el punto de montaje de la tarjeta;
• medios para observar la fluidez de imagen, el audio, la entrada, la memoria y la corriente.

Especificaciones de hardware y software¶

Especificación de hardware¶

Especificación de software¶

Elegir una configuración de referencia admitida¶

Use la revisión de PocketPi fijada en la especificación de software, en lugar de compilar el commit al que apunte main en ese momento:

git clone https://github.com/SiFliSparks/PocketPi.git
cd PocketPi
git checkout 7d9fac2cb577d6c9b66a99521aebf3c9de0ae163
cd project
scons --board=sf32lb52-lchspi-ulp -j8

El script de compilación convierte ../disk en una imagen del sistema de archivos y la incorpora al firmware como fs_root. En Windows, el archivo generado build_sf32lb52-lchspi-ulp_hcpu\uart_download.bat proporciona la ruta de descarga. En otros hosts se debe usar la herramienta de descarga correspondiente de SiFli-SDK y registrar los parámetros equivalentes.

Etapas del proyecto¶

Arquitectura del sistema y dependencias¶

flowchart LR
    B["Entrada de compilación\nROM NES cuyo uso está autorizado en disk/"] --> F["Imagen del sistema de archivos fs_root"]
    C["Tarjeta TF\n/sdcard/roms/nes"] --> L["Explorador de juegos LVGL"]
    F --> L
    L --> N["Emulador NES Nofrendo\nCPU, PPU, mappers y estados"]
    I["Teclas I²C AW9523\nA/B, direcciones, Start, Select, Menu y L/R"] --> N
    N --> V["Pantalla ST7789 de 320 × 240"]
    N --> A["Ruta de audio de 32 kHz"]
    N <--> S["Guardar estado / Cargar estado"]
    D["SiFli-SDK y soporte de placa\nPSRAM, Flash, tarjeta TF y batería"] --> L
    D --> N

Los principales dominios de fallo son el sistema de archivos/ROM, el mapper/emulador, la PSRAM/memoria, la pantalla/temporización de cuadros, la entrada AW9523, el audio, el estado guardado y la alimentación/reinicio. Ante una pantalla negra, conviene distinguir primero entre «no se detectó la ROM», «falló la decodificación de la imagen», «mapper no compatible», «falló la asignación del búfer de cuadros» y «falló la ruta LCD», en lugar de atribuirlo genéricamente a un fallo del emulador.

Etapa 1 — Establecer la base de juego sin modificaciones¶

Objetivo: demostrar con una ROM de prueba cuyo uso esté autorizado la ruta completa, desde los archivos de compilación hasta la ejecución del juego.

1. Fije los commits de PocketPi y SiFli-SDK, así como las revisiones de la placa y los periféricos.
2. Coloque en disk/ una ROM .nes cuyo uso esté autorizado; si añade una imagen, use un archivo .jpg con el mismo nombre base. Guarde el hash, la procedencia y el mapper de la ROM.
3. Compile desde cero y compruebe que se genera fs_root y se incluye en los artefactos de descarga.
4. Grabe el firmware y realice un arranque en frío. Confirme que el juego aparece en la lista, que se muestra la portada o la imagen predeterminada y que el juego se inicia.
5. Registre el tiempo de inicio, la estabilidad de vídeo, la respuesta de las teclas, el audio y los registros serie; después reinicie y repita.

Evidencias que deben conservarse: commits del repositorio y del SDK, placa y periféricos, hash/licencia de la ROM, registro de compilación, imagen del sistema de archivos, registro de descarga, registro serie y fotos de la lista de juegos y de la ejecución.

Criterio de salida del punto de control 1: dos arranques en frío muestran y ejecutan la misma ROM, con comportamiento repetible de pantalla, direcciones/A/B/Start/Select básicos y audio.

Etapa 2 — Validar la entrada, los estados y la recuperación ante fallos¶

Objetivo: convertir «el juego arranca» en una base de consola portátil que se pueda revisar.

Criterio de salida del punto de control 2: se registran la entrada, la pantalla, el audio, la pausa, el guardado, la carga, la salida y el reinicio para la ROM elegida, y cada fallo se asocia a un dominio definido.

Etapa 3 — Crear una base reproducible de código y contenido¶

Objetivo: permitir que otro ingeniero vuelva a generar el mismo firmware y la misma imagen de contenido.

1. Registre las revisiones de PocketPi, SiFli-SDK y cualquier núcleo de terceros.
2. Cree un manifiesto de disk/ con nombres de archivo, hashes, procedencia y licencias de cada ROM y portada. No suba al repositorio ROM que no pueda redistribuir.
3. Compile desde un directorio de salida vacío y conserve fs_root, el firmware, los informes de memoria y particiones, el script de descarga y los hashes.
4. Repita la compilación en otro ordenador o en un directorio limpio y vuelva a ejecutar las pruebas básicas de la Etapa 2.

Criterio de salida del punto de control 3: los manifiestos del código y del contenido permiten reconstruir una imagen con los mismos hashes o diferencias explicadas, sin archivos locales no documentados.

Etapa 4 — Adaptar una variable a la vez¶

Objetivo: medir los límites entre el emulador, el contenido y el hardware.

Criterio de salida del punto de control 4: se revisaron el cambio y los derechos del contenido, se puede recuperar la imagen original y se superan todas las pruebas de la Etapa 2 con la ROM seleccionada.

Etapa 5 — Revisión de preparación para producto¶

Antes de diseñar hardware de consola portátil propio o distribuir contenido, responda:

• ¿Qué mappers requiere el conjunto de juegos previsto y se han validado la tasa de cuadros, el audio, la memoria y el guardado de cada ROM?
• ¿Están claros los derechos y las licencias de PocketPi, Nofrendo, SiFli-SDK, fuentes, portadas, sonidos y ROM?
• ¿Tienen el AW9523, el LCD, el audio, la tarjeta TF, la batería y el circuito de carga esquemáticos, BOM y pruebas de producción completos?
• ¿Cuáles son la corriente durante el juego, la lista, la pausa, el reposo y el apagado, la autonomía, la temperatura y el comportamiento con batería baja?
• ¿Cómo se protegen y migran los estados guardados tras cortes de alimentación, actualizaciones, falta de espacio o corrupción?
• ¿Cómo se recupera el dispositivo ante un sistema de archivos dañado, una actualización fallida, una pantalla negra o una ROM que impide arrancar?

Criterio de salida del punto de control 5: la matriz de compatibilidad, las licencias de software/contenido, la responsabilidad del hardware, la alimentación y los riesgos de recuperación tienen responsables asignados y una decisión de continuar, aplazar o detener.

Traspaso a la fase de diseño del producto¶

Traslade la selección del chip o módulo SF32, los picos de uso de PSRAM y Flash, la ruta de pantalla/búfer de cuadros, la matriz de entrada AW9523, el amplificador y el altavoz, la tarjeta TF y el sistema de archivos integrado, el formato de los estados guardados, la batería y su circuito de carga, el puerto de descarga para recuperación, la matriz de compatibilidad ROM/mapper y el manifiesto completo de licencias. Continúe con SF32LB52x, SF32LB52-DevKit-ULP, Compilar, grabar y supervisar con SiFli-SDK y Diseño para producción.

Fuentes de referencia¶

• SiFliSparks/PocketPi
• Commit de referencia fijado 7d9fac2
• Placa Huangshan Pi SF32LB52-ULP de LCKFB
• OpenSiFli/SiFli-SDK
• Wiki de SiFli: guía de la placa Huangshan Pi
• Guía de inicio de SiFli-SDK
• pebri86/esplay-retro-emulation
• Documentación de LVGL

Última actualización: 2026-10-21