Console portátil Pocket Pi com SF32¶

O que é o Pocket Pi?¶

SiFliSparks/PocketPi é um projeto de referência de console portátil e emulação para o SF32LB52. A revisão fixada integra o emulador NES Nofrendo, um navegador de jogos em LVGL, uma interface para display ST7789 8080 de 320 × 240, áudio, salvamento e carregamento de estados, um sistema de arquivos integrado e um diretório de ROMs no cartão TF. A configuração pública de compilação usa o alvo Huangshan Pi / sf32lb52-lchspi-ulp.

O projeto permite avaliar como gráficos locais, controles, áudio, armazenamento externo, alocação de PSRAM e carga do emulador coexistem em um sistema SF32LB52. O repositório não inclui ROMs comerciais; cada usuário deve fornecer arquivos .nes/.NES cujo uso esteja autorizado. O código disponível publicamente não constitui um projeto completo de console portátil pronto para produção nem substitui avaliações de segurança da bateria, áudio, EMC, comportamento térmico, licenciamento ou distribuição de conteúdo.

Por que usar a implementação SF32?¶

A emulação NES reúne diversas exigências de sistemas embarcados em uma carga de trabalho fácil de entender: emulação da CPU, gráficos do PPU, amostragem de áudio, controles de baixa latência, leitura de arquivos, buffer de quadros e estados salvos precisam funcionar em conjunto. Um sistema baseado no SF32LB52 oferece os recursos de display, áudio, armazenamento externo e PSRAM necessários; a Huangshan Pi também oferece uma plataforma de avaliação alimentada por bateria.

O projeto não garante compatibilidade total com todos os jogos NES. O suporte a mappers, a taxa de quadros, o áudio, o comportamento dos estados salvos, o pico de memória e a latência dos controles podem variar de um jogo para outro. Cada ROM ou mapper adicionado exige uma avaliação própria de compatibilidade e direitos autorais.

Resultado, escopo e critérios de entrada¶

Resultado esperado: gerar uma imagem reproduzível a partir do commit do PocketPi fixado na especificação de software, iniciar pelo menos uma ROM de teste cujo uso seja autorizado, validar display, controles, áudio, pausa, salvamento e carregamento de estados, saída e recuperação, e então concluir uma adaptação de escopo limitado.

Esta página não garante compatibilidade com todos os mappers NES, temporização PAL/NTSC, caminhos de áudio dos jogos, formatos de estado salvo ou ROMs de terceiros. Ela não concede direitos para copiar ou distribuir conteúdo de jogos. A revisão fixada do repositório não contém um arquivo de licença na raiz; antes de incorporar o código a um produto ou distribuir binários, uma pessoa responsável deve determinar as licenças do PocketPi, do Nofrendo e de cada componente de terceiros integrado.

Antes de começar, tenha em mãos:

• SF32LB52-DevKit-ULP / Huangshan Pi, ou hardware compatível com a definição de placa sf32lb52-lchspi-ulp do repositório;
• o display 320 × 240, o expansor de entradas I²C AW9523, as teclas, o áudio e o caminho opcional do cartão TF previstos pelo código na revisão fixada; o nome da placa, por si só, não comprova que todos os periféricos estejam montados;
• SiFli-SDK, SCons, ferramentas de download via UART e registro de logs;
• uma ROM .nes de teste criada por você, em domínio público ou com licença adequada;
• a ROM em disk/ no repositório para o sistema de arquivos integrado ou no diretório de ROMs do cartão TF configurado pelo firmware. A revisão fixada procura ROMs em /sdcard/roms/nes durante a execução; confira nessa revisão se o caminho corresponde ao ponto de montagem do cartão;
• meios para observar o comportamento dos quadros, áudio, entradas, memória e corrente.

Especificações de hardware e software¶

Especificação de hardware¶

Especificação de software¶

Escolher uma configuração de referência suportada¶

Use a revisão do PocketPi fixada na especificação de software, em vez de compilar o commit para o qual main apontar naquele momento:

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

O script de compilação transforma ../disk em uma imagem de sistema de arquivos e a inclui no firmware como fs_root. No Windows, o arquivo gerado build_sf32lb52-lchspi-ulp_hcpu\uart_download.bat fornece o fluxo de download. Em outros sistemas, use a ferramenta de download correspondente do SiFli-SDK e registre os parâmetros equivalentes.

Etapas do projeto¶

Arquitetura do sistema e dependências¶

flowchart LR
    B["Entrada da compilação\nROMs NES cujo uso é autorizado em disk/"] --> F["Imagem de sistema de arquivos fs_root"]
    C["Cartão TF\n/sdcard/roms/nes"] --> L["Navegador de jogos LVGL"]
    F --> L
    L --> N["Emulador NES Nofrendo\nCPU, PPU, mappers e estado"]
    I["Teclas I²C AW9523\nA/B, direções, Start, Select, Menu, L/R"] --> N
    N --> V["Tela ST7789 de 320 × 240"]
    N --> A["Caminho de áudio de 32 kHz"]
    N <--> S["Gravar / carregar estado"]
    D["SiFli-SDK e suporte à placa\nPSRAM, Flash, cartão TF, bateria"] --> L
    D --> N

Os principais domínios de falha são sistema de arquivos/ROM, mapper/emulador, PSRAM/memória, display/temporização dos quadros, entradas AW9523, áudio, estado salvo e alimentação/reset. Diante de uma tela preta, primeiro diferencie “ROM não encontrada”, “falha ao decodificar a capa”, “mapper não compatível”, “falha na alocação do buffer de quadros” e “falha no caminho do LCD”, em vez de atribuir tudo genericamente a uma falha do emulador.

Etapa 1 — Estabeleça a base de jogo sem modificações¶

Objetivo: usar uma ROM de teste cujo uso seja autorizado para comprovar o caminho completo, da entrada de compilação até o jogo em execução.

1. Fixe os commits do PocketPi e do SiFli-SDK, além das revisões da placa e dos periféricos.
2. Coloque em disk/ uma ROM .nes cujo uso esteja autorizado; se incluir uma capa, use um arquivo .jpg com o mesmo nome-base. Registre o hash, a procedência e o mapper da ROM.
3. Faça uma compilação limpa e confirme que fs_root foi gerado e está incluído nos artefatos de download.
4. Grave o firmware e faça uma inicialização a frio. Confirme que o jogo aparece na lista, que a capa ou a imagem padrão está visível e que o jogo inicia.
5. Registre o tempo de inicialização, a estabilidade do vídeo, a resposta das teclas, o áudio e os logs seriais; depois, reinicie e repita.

Evidências a guardar: commits do repositório/SDK, placa e periféricos, hash/licença da ROM, log de compilação, imagem do sistema de arquivos, log de download, log serial e fotos da lista de jogos e do jogo em execução.

Critério de saída do ponto de controle 1: duas inicializações a frio listam e executam a mesma ROM, com comportamento repetível do display, dos controles básicos (direções/A/B/Start/Select) e do áudio.

Etapa 2 — Valide entradas, estados e recuperação de falhas¶

Objetivo: transformar “o jogo inicia” em uma base de console portátil que possa ser revisada.

Critério de saída do ponto de controle 2: controles, display, áudio, pausa, salvamento, carregamento, saída e reset estão registrados para a ROM escolhida, e cada falha é associada a um domínio definido.

Etapa 3 — Crie uma base reproduzível de código-fonte e conteúdo¶

Objetivo: permitir que outro engenheiro reconstrua o mesmo firmware e a mesma imagem de conteúdo.

1. Registre as revisões do PocketPi, do SiFli-SDK e de qualquer núcleo de terceiros.
2. Crie um manifesto de disk/ com nomes de arquivo, hashes, procedência e licenças de cada ROM e capa. Não faça commit de ROMs que você não possa redistribuir.
3. Compile a partir de um diretório de saída vazio e guarde fs_root, firmware, resultados de memória/partições, script de download e hashes.
4. Recompile em um segundo computador ou diretório limpo e repita os testes essenciais da Etapa 2.

Critério de saída do ponto de controle 3: os manifestos de código-fonte e conteúdo permitem reproduzir uma imagem com hashes iguais ou diferenças explicadas, sem depender de arquivos locais não documentados.

Etapa 4 — Adapte uma variável por vez¶

Objetivo: medir os limites entre emulador, conteúdo e hardware.

Critério de saída do ponto de controle 4: a alteração e os direitos do conteúdo foram revisados, a imagem original pode ser restaurada e todos os testes da Etapa 2 aplicáveis à ROM selecionada foram aprovados.

Etapa 5 — Revisão de prontidão do produto¶

Antes de desenvolver hardware de console portátil personalizado ou distribuir conteúdo, responda:

• Quais mappers são necessários para os jogos previstos? A taxa de quadros, o áudio, a memória e o comportamento ao salvar o estado de cada ROM foram qualificados?
• As licenças e os direitos de distribuição do PocketPi, Nofrendo, SiFli-SDK, fontes, capas, sons e ROMs estão claros?
• AW9523, LCD, áudio, cartão TF, bateria e circuito de carga têm esquemáticos completos, BOMs e testes de produção?
• Qual é a corrente durante jogo, lista, pausa, suspensão e desligamento, além da autonomia, temperatura e comportamento com bateria fraca?
• Como os estados salvos são protegidos e migrados após perda de energia, atualização de versão, mídia cheia ou corrupção?
• Como recuperar o dispositivo após corrupção do sistema de arquivos, falha de atualização, tela preta ou ROM que não inicia?

Critério de saída do ponto de controle 5: há responsáveis designados pela matriz de compatibilidade, licenças de conteúdo/software, propriedade do hardware, alimentação e riscos de recuperação, além de uma decisão de prosseguir, adiar ou interromper.

Transição para o projeto do produto¶

Leve adiante a seleção do chip/módulo SF32, os picos de PSRAM e Flash, o caminho do display/buffer de quadros, a matriz de entradas AW9523, o amplificador e o alto-falante, o cartão TF e o sistema de arquivos integrado, o formato dos estados salvos, a bateria/recarga, a porta de download para recuperação, a matriz de compatibilidade ROM/mapper e o manifesto completo de licenças. Continue por SF32LB52x, SF32LB52-DevKit-ULP, SiFli-SDK: compilar, gravar e monitorar e Projeto para produção.

Fontes de referência¶

• SiFliSparks/PocketPi
• Commit de referência fixado 7d9fac2
• Placa Huangshan Pi SF32LB52-ULP da LCKFB
• OpenSiFli/SiFli-SDK
• Wiki da SiFli: guia da placa de desenvolvimento Huangshan Pi
• Guia de início do SiFli-SDK
• pebri86/esplay-retro-emulation
• Documentação do LVGL

Última atualização: 2026-10-21