
Eu amo Metal Gear Solid desde criança. Quando consegui uma placa ESP32-S3 minúscula, uma pergunta ficou na minha cabeça: será que um jogo de PlayStation poderia rodar em algo tão pequeno?

A placa é a Seeed Studio XIAO ESP32S3 Sense: um ESP32-S3 dual-core com 8 MB de PSRAM e 8 MB de flash, em um módulo de 21 × 17,8 mm. A versão Sense adiciona uma placa de expansão com câmera e um slot de microSD, e é nesse slot de microSD que os dados do jogo ficam.
Passei um bom tempo descobrindo. Primeiro procurei uma versão do jogo que já tivesse sido reconstruída como código C que roda em um PC, e depois verifiquei se toda aquela lógica caberia na flash do ESP32-S3 e em um cartão microSD. Foram várias tentativas, mas no final deu certo. Um jogo maravilhoso agora roda em uma placa de microcontrolador que custa cerca de 15 dólares.
Gameplay no portátil: assista no YouTube.
Neste artigo, descrevo como Metal Gear Solid (PlayStation, 1998) roda no ESP32-S3 como um port nativo. O código-fonte C do jogo, reconstruído pela decompilação mgs_reversing da FoxdieTeam, é compilado diretamente para código de máquina Xtensa. Tudo o que o hardware do PlayStation costumava fornecer é substituído por software:
- O SDK.
- A GPU.
- O coprocessador de geometria GTE.
- A unidade de CD.
- A interrupção de blank vertical.
- O controle.
O artigo aborda o hardware, a camada de plataforma, o posicionamento de memória, o método de depuração, os bugs que mais importaram, o desempenho, o portátil e o que ainda não funciona.
O código e os projetos relacionados:
- Port do MGS: davidmonterocrespo24/mgs_reversing, branch
esp32-port. - Guia de hardware do portátil: HARDWARE.md.
- Fork do psyz: davidmonterocrespo24/psyz.
Você precisa do seu próprio disco. O repositório não contém nada derivado do jogo, e port/extract_disc.py extrai os arquivos da sua própria imagem de disco.
Hardware

O ESP32-S3 tem dois núcleos Xtensa a 240 MHz e 512 KB de SRAM interna. Ambas as placas usadas aqui também têm 8 MB de PSRAM, que fica atrás do mesmo cache que a flash.
| Waveshare ESP32-S3-Touch-LCD-2 | Portátil DIY (Seeed XIAO ESP32S3 Sense) | |
|---|---|---|
| Painel | ST7789, 320x240 | ILI9341, 320x240 nativo |
| Flash | 16 MB | 8 MB |
| Dados do jogo | microSD, ou um STAGE.DIR reduzido na flash | microSD (STAGE.DIR completo) |
| Entrada | teclado via serial (play.py) | stick de gimbal de drone, escada de resistores de 6 botões, 2 botões diretos |
Medindo a lacuna antes de escrever código
Antes de escrever qualquer código de port, medi o quão longe a decompilação estava de compilar para Xtensa:
- As bibliotecas da engine (libgv, libdg, libgcl, libhzd, libfs) compilaram quase de imediato com
xtensa-esp32s3-elf-gcc14.2 contra os cabeçalhos do psyz: 57 de 58 arquivos. - Nenhuma delas contém endereços absolutos
0x800xxxxx. - Toda a saída gráfica passa por 11 chamadas da libgpu (
DrawOTag,LoadImage,ClearOTagRe assim por diante). Essa é exatamente a camada que o renderizador por software do psyz substitui.
Deixei o único arquivo que falhava, libdg/chanl.c, falhando de propósito. O cast que teria silenciado o erro também teria alterado silenciosamente o stride (veja a seção sobre a tabela de ordenação abaixo).
O resto exigiu passagens mecânicas, cada uma corrigindo uma classe inteira de problema:
-std=gnu17e-mlongcallssão ambos obrigatórios. O padrão gnu23 do GCC 14 rejeita este código, e ocall8do Xtensa só alcança +/-512 KB.- psyz e MGS ambos têm um
common.h, então os caminhos de include do MGS devem vir primeiro. - 12 expressões de cast como lvalue, uma extensão do GCC 2.x, foram reescritas.
- O MGS substitui o
printfda libc por seu próprio stub. Renomeei-o paramts_printf, e isso depois causou um dos bugs mais enganosos (veja “O boot que parecia travado”). - 346 endereços literais de scratchpad (
0x1f8000xx) em 16 arquivos tornaram-seSCRPAD_ADDR + offset, apoiados por um array.
O resultado foi 497 de 497 arquivos C compilados para Xtensa. O ELF tinha 0 referências indefinidas e 0 definições duplicadas (text 987.073 B, bss 2.434.276 B). A memória do próprio jogo é de 804 KiB (428 KiB de heap mais dois buffers de pacote de 188 KiB), o que cabe confortavelmente na PSRAM.
----- END POST -----
Arquitetura
O porte tem três camadas entre o jogo e o SoC:
As camadas, do jogo até o hardware:
- Motor do MGS: C descompilado, compilado para Xtensa
- psyz: SDK do PlayStation e GTE em C, rasterizador por software
- Camada de plataforma: escalonador mts sobre FreeRTOS, tick de vblank, CD virtual, LCD, entrada
- ESP32-S3
psyz e o GTE
O psyz, a reimplementação do SDK do PlayStation feita pelo Xeeynamo, já modelava todo o arquivo de registradores do GTE e cada operação do GTE em C, validado contra a suíte de testes do GTE do PCSX-Redux.
Minha primeira estimativa foi de que faltavam de 64 a 70 macros. Essa estimativa era alta demais. O MGS traz seus próprios cabeçalhos de assembly inline de MIPS (inline_n.h, inline_x.h), e -fsyntax-only não verifica nomes de registradores. Depois que esses cabeçalhos foram desviados para o psyz, a lacuna real era de 41 macros. Eu as adicionei ao psyz, usando o próprio assembly do jogo como especificação de quais registradores COP2 cada uma toca. Em seguida, recompilei meus outros projetos baseados no psyz contra o psyz modificado para garantir que nada quebrasse.
Quando você cria um alias para uma macro do GTE, verifique se cada restrição é uma entrada ou uma saída. Por exemplo, gte_read_opz tem uma saída "=r", então seu alias precisa receber &x.
A tag da tabela de ordenação: uma palavra no PSX, duas no psyz
Esta é a diferença de layout mais importante, e foi a que causou mais bugs. No PlayStation, toda primitiva começa com uma tag de 32 bits: 24 bits de endereço da próxima primitiva e 8 bits de comprimento. Um ponteiro de host não cabe em 24 bits, então o psyz usa duas palavras, tag e len. Toda primitiva cresce 4 bytes, e todo campo após a tag se desloca uma palavra.
O MGS também abusa do byte de comprimento. O libdg executa uma ordenação radix de duas passagens sobre a profundidade de 16 bits:
divide.cdistribui em baldes pelo byte baixo e guarda o byte alto no comprimento da tag.sort.credistribui em baldes por esse byte alto e escreve o comprimento real.
Como o psyz separa os dois campos, a tradução é exata:
pack->tag = (hi << 24) | *ot; *ot = pack; /* PSX */
addPrim(ot, pack); setlen(pack, hi); /* psyz */
Redigitar 42 declarações locais e 100 parâmetros para OT_TYPE* foi a parte fácil. A parte difícil foi o código que assumia o layout empacotado sem dizer isso:
DG_PrimInfoscolocava o primeiro vértice em +8 em vez de +12.LinkModelToParentpré-calculava os deslocamentos dos vértices pais como*52 + 8em vez de*56 + 12.- Os construtores de primitivas descritos em “A tela branca” abaixo.
Há também um fator agravante. No console, addPrim() reescrevia a palavra da tag inteira a cada inserção, então um comprimento esquecido nunca poderia ser notado. No psyz, um comprimento que nunca foi definido simplesmente nunca é escrito.
O escalonador da Konami dentro do FreeRTOS
O MGS roda sobre o escalonador cooperativo da própria Konami. O banner de boot ainda exibe Multi Task Scheduler for PSX ver2.02 Jul 11 1998. Ele fica sobre a API de threads da BIOS (OpenTh/ChangeTh) e usa a interrupção de vblank para acordar tarefas cujos temporizadores expiraram.
No porte, cada thread mts é uma tarefa do FreeRTOS, e apenas uma delas é executável por vez. O design final:
- Todas as tarefas mts estão fixadas no núcleo 0, junto com o tick de vblank na prioridade 10, para que o tick faça preempção no jogo da mesma forma que a interrupção do PSX fazia. A varredura do LCD roda no núcleo 1. Cruzar essas atribuições causou condições de corrida que reviviam tarefas estacionadas no meio da pilha. Um log mostrou duas cópias de
Main()intercaladas linha por linha. - Uma nova tarefa suspende a si mesma em seu trampolim.
xTaskCreateseguido devTaskSuspendnão é atômico, e em dois núcleos a tarefa rodava antes de seu bloco de controle ser preenchido. - As seções críticas são reais. Cada tarefa tem uma flag absoluta, salva e restaurada a cada troca como o registrador de status do MIPS. É uma flag em vez de um contador porque o jogo chama
ExitCriticalSectionsem umEntercorrespondente. - O tick executa o callback do mts apenas enquanto a tarefa ociosa (11) está ativa. Essa tarefa é o loop do console SIO da Konami, o único código que nunca toca no estado do escalonador. No console ele rodava com interrupções habilitadas exatamente por esse motivo. O jogo passa pelo ocioso a cada quadro, então a latência de despertar fica abaixo de um quadro. Essa mudança eliminou travamentos intermitentes na origem, onde versões anteriores baseadas em flags apenas haviam estreitado a janela da condição de corrida.
mts_GetTcbEntry também lia a tabela de tabelas da BIOS no endereço fixo 0x100 e escrevia através do resultado. Fora de um PSX esse endereço contém lixo, então agora ele usa uma tabela de TCB privada.
O tick de vblank e os dois relógios
port/esp32_vblank.c dispara o callback de VSync do jogo a cada 16 ms. Isso exigiu que VSyncCallback() fosse implementado no psyz, onde ele nem sequer armazenava o ponteiro.
VSync(-1) precisa retornar uma contagem de vblank de execução livre. A primeira versão retornava o número de quadros apresentados, que para de avançar quando nada é desenhado, então nenhum temporizador jamais expirava.
A taxa de quadros varia: 2 vblanks por quadro em um corredor, 4 a 5 em uma sala aberta. Por causa disso, duas coisas que pareciam ser assunto de vblank na verdade pertencem ao quadro do jogo:
- As retenções de tecla seriais são decrementadas em
DG_ActFirst, logo apósGV_UpdatePadSystem, o único ponto que significa “um quadro leu o gamepad”. Contar vblanks ali ou fazia o Snake andar longe demais ou liberava teclas antes que o jogo as visse. - O LCD envia um quadro apenas quando um número de sequência incrementado em
DG_SwapFramemudou, com um fallback de 250 ms.
Posicionamento de memória
A SRAM interna é escassa e rápida. A PSRAM é abundante e lenta. Leituras da flash desabilitam o cache do qual a PSRAM também depende.
- O mapa de RAM do jogo pende de um único define,
MEM_BOTTOM. Ambas as arenas de pacotes, o heap e o buffer de setor do libfs vêm dele por subtração. Ele é realocado para um array estático na PSRAM (mgs_main_ram[0xC9000],EXT_RAM_BSS_ATTR). Precisa ser estático porqueRESIDENT_BOTTOMé usado como inicializador estático, o que descartamalloc. - A VRAM de 1 MB do PSX vive na PSRAM. Sem
EXT_RAM_BSS_ATTR, a dram0 estoura em cerca de 900 KB. - As pilhas de tarefas foram e voltaram.
- Pilhas de 32 KB na SRAM interna fizeram o quarto
xTaskCreatefalhar silenciosamente (veja “Um deadlock de prioridade que era um malloc falho”). - Pilhas movidas para a PSRAM funcionaram até uma tarefa chamar
fopen. O driver da flash desabilita o cache, a tarefa perde sua própria pilha, e o SoC reinicia sem imprimir um panic. - As pilhas agora têm 20 KB na SRAM interna. As marcas de nível máximo mostram cinco tarefas usando cerca de 2 KB e uma usando 14.484 B.
- Pilhas de 32 KB na SRAM interna fizeram o quarto
- Um stub com o tipo errado acaba na flash somente leitura.
_spu_transferCallbacké um ponteiro de função. Declará-lo como função o colocou em.text, então o primeiro= 0travou. Eu o encontrei executandonmem um ELF funcional baseado no psyz e neste, comparando-os comcomm, e listando símbolos que sãoB/Dlá eTaqui.
Uma classe de bug só existe neste mapa de memória: testes de ponteiro baseados no bit de sinal. O MGS distingue um ponteiro de bloco de script de um id de proc de 16 bits com proc_id < 0. A RAM do PSX fica em 0x8xxxxxxx, que é negativo como valor com sinal. A PSRAM fica em 0x3Cxxxxxx, que é positivo. O resultado foi PROC 3C1987D2 NOT FOUND, seguido de um LoadProhibited em EXCVADDR 0x00000003. Uma macro GCL_IS_BLOCK_PTR corrige o local que foi atingido. Outros locais com o mesmo padrão ainda precisam de auditoria.
Um CD virtual sobre FAT
O libfs trabalha em setores absolutos. Ele lê o diretório ISO9660 uma vez e nunca mais usa um nome de arquivo. port/virtual_cd.c substitui a BIOS do CD:
- Cada arquivo recebe uma faixa sintética de 1.000.000 de setores, então um número de setor mapeia de volta para (arquivo, deslocamento) com uma divisão.
CDBIOS_ReadRequestentrega dados setor por setor e chama um callback após cada setor. O callback pode reescrever o tamanho restante.FS_CdStageFileInitdepende disso para descobrir o tamanho da tabelaSTAGE.DIRa partir de seus primeiros 4 bytes. Tratar a requisição como uma simples cópia de bytes e ignorar o callback fazia toda busca de estágio retornarNOT FOUND.- A entrega precisa ser assíncrona. O parser e o “disco” são corrotinas compartilhando uma única janela de buffer. Entregar tudo de uma vez deixava o arquivo 2 sobrescrever o arquivo 1 antes de ele ser analisado.
ReadRequestagora apenas registra a requisição, eReadSyncbombeia setores até o callback retornar 2 (“buffer redirecionado”).
Os dados primeiro viviam na PSRAM, o que limitava o jogo a um punhado de estágios. A correção real foi o microSD. O cartão é um periférico SPI, separado da flash XIP, então lê-lo não desabilita o cache de instruções. Os arquivos ficam no cartão e não custam PSRAM.
- O
STAGE.DIRcompleto de 71.892.992 bytes (todos os 96 estágios) é lido sob demanda. - De 93 arquivos de estágio, 65 têm tabelas de atores totalmente simbólicas. Os outros 28 ainda contêm endereços MIPS brutos porque seu código de ator não foi descompilado.
- Um gerador constrói uma tabela de atores deduplicada e uma whitelist: 56 estágios e 149 classes de ator. O comando de mudança de estágio do script verifica a whitelist enquanto o mundo atual ainda está intacto.
O cartão e o LCD compartilham o SPI2, e o ESP-IDF não arbitra entre eles. Um quadro do LCD são 30 transferências assíncronas enfileiradas, então uma leitura do cartão no meio de um quadro disparava assert failed: spi_hal_iram.c:134 e causava um loop de reinicialização. A correção é a posse explícita do barramento (Mgs_SpiBusTake/Give), drenando transferências em andamento antes de liberar o barramento.
Método: meça, não adivinhe
Cerca de um terço das explicações óbvias neste projeto acabaram se revelando erradas. O que funcionou foi fazer a placa imprimir um número que decide entre hipóteses. As lições mais úteis vieram de sondagens que deram respostas erradas:
- Um contador que ninguém incrementa inventa uma descoberta.
[trap] scanning 63 triggers, 0 entered so farquase virou “o sistema de gatilhos está morto”. O contador não tinha++. Com um de verdade, os gatilhos dispararam desde o primeiro segundo. - Uma verificação tautológica dá falsa confiança. A auditoria de esqueleto comparava
|R·t|com|t|. Esses valores são iguais para qualquer rotação, então a verificação ficou verde por semanas enquanto todo esqueleto estava deformado (veja “Strict aliasing deletou uma rotação”). - Verifique onde um campo é escrito antes de interpretá-lo.
eye_inv.tparece uma posição de câmera, mas é um vetor de direção rotacionado. Lê-lo como posição produziu uma história detalhada e falsa sobre uma câmera voando para longe. - Mantenha uma sondagem ampla até que os dados a estreitem. Filtrei a sondagem de primitivas de tela cheia para primitivas sem textura, com a ideia de que um flash não tem textura. Um cone de holofote tem.
- Separe contadores por causa. “65% das costuras estão obsoletas” eram quatro causas em um único balde, e a maior delas eram objetos raiz inofensivos. Depois da separação, minha correção disparou zero vezes, e eu a removi.
- Instrumente todos os N escritores. Quando
DG_UnDrawFrameCount = 0x7fff0000apagou a tela, eu errei duas vezes. Marcar os quatro escritores com"file:line"apontougame/gamed.c:476de imediato. - Decodifique os dados antes de suspeitar do interpretador. O script do dock parecia executar um comando. Decodificar o bytecode retail mostrou 19 nós, dos quais apenas um imprime (veja “O dock vazio era um script de duas passagens”).
- Verifique se a sondagem está no binário. Uma migalha que lia “(nothing)” nunca tinha sido inserida, porque um
str.replacescriptado falhou silenciosamente. Façagrepda string no.bin. - Use watchpoints de hardware para escritores rebeldes.
esp_cpu_set_watchpoint(0, addr, 4, STORE)mostrou que cerca de 230 dessincronizações da GPU vinham deDG_PcxRead4Bpp, um decodificador de textura cujo buffer de rascunho se sobrepunha a pacotes ativos. - Desconfie de melhorias repentinas. Quando o cartão falhou ao montar, a placa caiu para 9 estágios na flash, e os tempos de carregamento caíram de 693 para 21 vblanks. Isso parece um ganho de velocidade de 35x, mas significa que o cartão está faltando. Verifique primeiro
microSD mountedetable_size 1152 -> 96 stages.
Rodar cada build sem gravar a placa
Esse método só funciona quando testar algo é barato, e depois de várias horas de tentativa e erro, gravar a placa a cada mudança não era: escrever a imagem na XIAO por USB, esperar o reboot, ler o log serial, repetir. Então, para rodar e conferir cada build, usei o velxio-cli, o cliente de linha de comando do Velxio. Ele recebe o mesmo .bin que o meu toolchain gerou, executa no ESP32-S3 simulado do Velxio por um tempo simulado fixo e devolve a saída serial, então eu conseguia ler as sondas acima sem tocar no hardware. A placa só recebia uma imagem nova quando um build valia a pena.
# velxio.toml, next to the build: board = "xiao-esp32-s3", firmware = the merged .bin
velxio-cli run --timeout 5000 --timeout-exit-code 0 --serial-log-file serial.log .
Instalar e fazer a primeira execução leva poucos minutos: veja o guia rápido do velxio-cli.
Os bugs

Strict aliasing apagou uma rotação
- Sintoma: todos os personagens tinham os braços desligados do torso, um joelho dobrado para trás e os pés apontando para direções diferentes. O mundo estava bem.
- Becos sem saída:
- Um “conserto” em
MulRotMatrixque piorou muito as coisas e foi revertido. - O stride do modelo, provado ser de 88 bytes a partir dos dados de três maneiras independentes.
- Costuras obsoletas, medidas com efeito zero.
- Um dump congelado da pose de repouso colocou todas as 16 juntas a menos de um milímetro das posições decodificadas do disco, com
det = 4096ed2 == wantem todos os ossos.
- Um “conserto” em
- Por que essas verificações não pegaram: na pose de repouso toda rotação é a identidade,
d2 == wanté uma tautologia, edetverifica o bloco 3x3, que estava correto. - O que pegou: posições das juntas em dois frames diferentes. O deslocamento de pai para filho permaneceu idêntico byte a byte enquanto o pai rotacionava 19 graus.
- Causa raiz:
CompMatrixescrevia a translação através de(VECTOR*)&tmp.t[0]sobre umlong[3]. O GCC 14 em-O2concluiu que nada lê essas escritas e removeu a chamada. O disassembly não tinha instruções de multiplicação. Ele calculavam2->t = m0->t + m1->t. - Correção: aritmética com
long longsem type punning, mais-fno-strict-aliasingpara todo o jogo. Existe um segundo caso idêntico emlibdg/display.c:318, então a flag é a proteção real. Uma auditoria[rig]agora verifica cada esqueleto usando razões invariantes à escala contra o osso mais longo: 14.416 juntas auditadas, 0 ruins.
A tela branca: cinco hipóteses erradas, três causas reais
- Sintoma: quando um inimigo avistava o Snake, uma folha branca cobria a cena. O HUD ainda aparecia, e havia flashes de cor.
- Hipóteses descartadas por medição:
- Um flash de tela cheia. A sonda registrou 0 linhas.
change camera -1como erro. É a sentinela de “sem câmera fixa aqui”, e tratá-la como erro congelava a câmera atrás do jogador.- Uma câmera descontrolada. Era o
eye_inv.tmal lido; a posição real estava estável. - Estouro da fila de desenho. Uma correção de culling reduziu os modelos desenhados de 25.093 para 14.054 e o branco permaneceu.
setlen(pack, z_idx >> 8)emdivide.c.setlenfaz cast parau_char, então não pode produzir comprimentos como0x2E000000.
- Causa 1:
SetDrawStpfazia((u_long*)p)[1] = 0xE6000000 | stp. No psyz, a palavra 1 élen, e o comando pertence acode[0]. O leitor via um pacote com bilhões de palavras de comprimento, o descartava e retomava no meio de uma primitiva, decodificando vértices como comandos. Disparava em combate, porque flashes de cano e fumaça são o que ativa a semitransparência. O psyz já havia corrigido o mesmo erro em seu própriosetDrawTPage, mas ninguém tinha revisado o gêmeo do lado do jogo. Após a correção: 0 descartados, 0 dessincronização. - Causa 2:
DG_MakePrimnunca inicializava o comprimento. É corrigido em um lugar derivandolen = psize/4 - 2e verificando o resultado contra as macros do psyz (FT4 dá 9, GT4 dá 12, TILE dá 3). - Causa 3, a regra de hardware ausente: uma vez incluídas as primitivas texturizadas, a sonda mostrou
[cover] code 3E abe 1 tex 1 box -1024,-1024..142,66, que é o limite de saturação da GTE. Polígonos que cruzam atrás da câmera ficam fixados ali como quads que abrangem a tela. A GPU do PSX recusa qualquer polígono maior que 1023x511, e o jogo depende disso. Nosso rasterizador os desenhava: 27,8 M texels por 120 frames, cerca de três telas por frame, e 142 ms de rasterização. O teste de tamanho agora roda emsoft_raster.inc.cantes do clipping, porque o clipping encolheria o polígono ao tamanho da tela e esconderia exatamente a propriedade em teste.
A correção de culling da hipótese 4 era real, mesmo não sendo a causa. O teste de bounding-box tratava uma caixa que cruza o plano próximo da mesma forma que uma inteiramente atrás dele. Separar os dois casos levou kept-saturated de 16.090 para 4.947. Uma tentativa anterior baseada em coordenadas saturadas resgatou 97% de tudo que o teste de tela rejeitava (+40% de rasterização), porque uma parede grande e distante também satura. Perguntar diretamente sobre Z (SZ <= H/2) deu 1.440 em vez de 15.000.
Square0 deslocado em 12 bits: toda distância /64
O Snake dava três passos, batia numa parede, ricocheteava e nunca progredia. A taxa de quadros foi o primeiro suspeito. Uma observação a descartou: o mundo se movia bem e só o jogador não. Uma sonda em GM_ActControl mostrou um passo de +4481 seguido de um rebote de -14641.
No PSY-Q o sufixo numérico é o deslocamento: Square0 não desloca e Square12 desloca. O Square0 do port deslocava em 12, então todo comprimento Square0 -> sum -> sqrt saía /64. Isso quebrou:
- Movimento e colisões.
- Alcance de visão dos inimigos.
- Balas.
- O sensor infravermelho.
- Atenuação de luz.
Remover o deslocamento tornou a trajetória monotônica.
Cinco opcodes da GTE copiados da linha errada
O Snake havia caído para fora do mundo (Y = -3250), o movimento estava fixado em 0,1 por frame, e o dock não tinha água. Os Psyz_GteRtv0/Rtv1/Rtv2/Ll/Llv0 do psyz usavam opcodes MVMVA da linha errada da própria tabela inline_n.h do MGS. “Rotacione este vetor” virou “rotacione-o e some a translação obsoleta”, e a iluminação usava a matriz de rotação em vez da matriz de luz.
Após a correção:
- Um passo de
27,0sustentado. - Y = 250.
- Curva suave.
- Pixels texturizados por frame subiram de 23.500 para 107.877.
- A água voltou também, porque ela depende da câmera estar dentro do volume de água.
O dock vazio era um script de duas passagens
O dock tinha apenas um punhado de grupos de objetos, e o script parecia executar um comando. A estrutura real de s00a é if (var[5] < 6) { set up the Colonel's call } else { build the dock }, e o proc da chamada é um restart. O mundo é construído na segunda passagem, e responder ao codec a dispara.
Eu mesmo tinha mascarado o codec para evitar um crash, e isso desabilitou todo radio -c ... -p proc em todos os estágios. MENU_RadioDrainHeadless agora responde à chamada e despacha seu proc sem abrir a tela do codec. Os grupos de objetos foram de 480 para 3.240 por 120 frames, e a área de água foi criada. A lição: um stub temporário precisa de algo que force você a revisitá-lo.
Divisão por zero: o MIPS sobrevive, o Xtensa reinicia
libhzd/near.c divide por um comprimento 2D ao quadrado que pode ser zero em casos degenerados. O R3000 continua com um resultado indefinido. O Xtensa levanta IntegerDivideByZero e a placa reinicia. HZD_DIV foi aplicado às 7 divisões com divisor em tempo de execução. Depois disso, 80 s de caminhada nas quatro direções, o padrão que costumava travar, deu 0 panics. Neste port, toda divisão por um divisor calculado precisa de uma guarda.
O congelamento de 17,6 minutos
O VSync do psyz truncava seu resultado para 16 bits em todos os modos, mas VSync(-1) deve retornar a contagem de campos de 32 bits. Em 65.536 campos (17,6 minutos a 60 Hz), o relógio do mts deu a volta de 64.800 para 1.064 enquanto uma tarefa esperava por 65.537, e esperou para sempre. A correção retorna a contagem completa para mode < 0. Isso afeta todo projeto construído sobre o psyz. Bugs que dependem de tempo decorrido nunca aparecem em testes de 60 segundos.
O boot que parecia travado
Por horas o boot pareceu travado. O mts_printf da Konami era um stub vazio no PSX, e meu #define printf mts_printf enviava toda a saída do jogo para ele, então o boot progredia silenciosamente. Assim que mts_printf chamou vprintf, o log mostrou que o jogo havia chegado a memcard_init(). Antes de diagnosticar um travamento, certifique-se de que a saída vai para algum lugar.
Um deadlock de prioridade que era um malloc falho
O daemon de arquivos (tarefa 10) nunca recebia tempo de CPU, e o trace parecia um deadlock de prioridade. Duas correções reais (a semântica de ChangeThFromISR e o relógio de VSync(-1)) não mudaram nada. Então uma linha resolveu: [thread] OpenTh: xTaskCreate failed.
Eu havia aumentado as pilhas para 32 KB, o FreeRTOS as retira da SRAM interna, e a quarta tarefa não cabia. OpenTh retornou -1, e ChangeTh rejeitava aquele tid para sempre. Neste SoC, sempre verifique o valor de retorno de xTaskCreate, mesmo com megabytes de PSRAM livre.
Tela preta após adicionar os dados de cutscene
Copiar DEMO.DAT, VOX.DAT e ZMOVIE.STR para o cartão deixou a tela preta: 720 frames, 0 panics, e zero primitivas enviadas.
O código de troca de estágio espera por GM_StreamStatus() == -1. O stream de DEMO.DAT da cutscene nunca avançava, porque o CD virtual serve leituras de setor mas não o caminho de streaming contínuo em ring-buffer. Antes de os arquivos existirem, o stream havia sido rejeitado cedo e tudo continuava.
O tratamento atual:
- Todos os streams de entrada são recusados em
NewStreamControlexecutando seu callback, com um watchdog de 600 frames como rede de segurança. Isso custa cutscenes e vozes, e entrega um jogo que dá para jogar. - A entrada de pad gravada de uma cutscene começava de imediato e o Snake saía andando sozinho. Essa reprodução agora é pulada da mesma forma que o jogo a pula no START.
- FMV também é recusado, porque o psyz não tem decodificador MDEC.
Bugs menores
PSX_Wera 256, herdado do código que eu reutilizei. O MGS renderiza 320 colunas, então um quinto da imagem era perdido. Audite toda constante herdada.- Corrida no boot: o tick lia a serial USB antes de o driver estar instalado, causando
LoadProhibitedem 2 de 6 boots medidos. - O frame dropper da Konami: dois atores liam a flag de skip em momentos diferentes, então os buffers eram trocados sem serem desenhados e a tela piscava. Ambas as flags são forçadas a 0 sob
__psyz. Cenas pesadas agora rodam mais devagar em vez de piscar. - “Colisão quebrada”: os empurrões de parede mediam cerca de 452 contra um raio de 450, o que está exatamente certo. A 8 a 10 fps, uma correção de 450 unidades só parece um salto.
Desempenho
O tempo de rasterização é um contador esp_timer no rasterizador, somado ao longo de 120 frames na mesma posição.
A primeira passagem foi em s07a, uma sala pequena. O tempo total de rasterização caiu de 923.000 para 903.900, depois 794.000, depois 741.700 us (de 7,69 para 6,18 ms por frame). As três etapas:
SOFT_RASTER_IRAMestava vazio na build do MGS, então os laços por pixel rodavam a partir da flash. Deveria serIRAM_ATTR. Corrigir isso rendeu -2%.- PSRAM e flash a 120 MHz renderam -12%. Primeiro concluí que esta placa não conseguiria. O erro “FLASH and PSRAM Mode configuration are not supported” significa apenas que falta
CONFIG_IDF_EXPERIMENTAL_FEATURES=y. VerifiqueCONFIG_SPIRAM_SPEED 120nosdkconfig.hgerado. - O scanout rodava a 62,5 Hz para um jogo de 30 fps. Metade dos pushes reenviava a mesma imagem, cada um lendo cerca de 120 KB de PSRAM e expulsando as texturas do rasterizador no outro núcleo. Igualar à taxa do jogo rendeu -6,6%.
O dock (s00a) é bem mais pesado. Um profile ali mediu 46.400 pixels texturizados e 71.680 pixels planos por frame: 40,9 ms de rasterização mais cerca de 25 ms de lógica e GTE, o que dá cerca de 15 fps. O README atualmente indica cerca de 15 fps para o dock com inimigos. O documento de status indica de 8 a 15 fps por cena, contra uma meta de 30.
Um caminho rápido de 32 bits para preenchimentos planos ganhou apenas 2%. O custo está nos pixels texturizados, a cerca de 207 ciclos cada. Um jogo 2D roda muito mais rápido no mesmo rasterizador: um tilemap percorre texturas em linha reta, e uma linha de cache de 64 bytes serve 128 pixels. Nos triângulos rotacionados do MGS, U e V mudam a cada pixel, e quase todo pixel é um cache miss. O cache de dados já está no seu máximo de 64 KB.
O próximo passo é mover páginas de textura quentes para a SRAM interna, o que o documento de status estima ser 40 vezes mais rápido. Isso exige os cerca de 90 KB presos em pilhas mts superdimensionadas (24 KB para a tarefa grande e 6 KB para o resto). Encolher as texturas não é opção, porque as UVs estão embutidas nos modelos.
O carregamento também é lento: cerca de 11,5 s para 1,1 MB do cartão (aproximadamente 95 KB/s).
- Uma rajada de 128 em vez de 16 setores ganhou apenas 7%.
- O cartão é confiável a 20 MHz na placa Waveshare. A 40 MHz ele dá erros de CRC.
- Pular chamadas redundantes de
fseekestá implementado, mas ainda não foi medido.
Colocando o portátil para funcionar

O portátil é construído com:
- Um XIAO ESP32S3 Sense, cuja placa de expansão fornece o slot de microSD.
- Um painel SPI ILI9341.
- Um gimbal de controle de drone.
- 8 botões: 6 em uma escada de resistores em um pino ADC, mais fire e aim em pinos próprios, porque uma escada só registra um botão por vez.

Todos os 11 pinos do XIAO são usados. A fiação está documentada no guia de hardware. Notas de bring-up:
- O terra que faltava. O painel brilhava em branco e mudava de brilho quando dados eram enviados, porque ele estava se alimentando através dos diodos de proteção em suas entradas. Antes disso, a medição descartou a fiação, o pulso de reset, a tensão de alimentação e a configuração de SPI. Um bug meu também custou duas rodadas: uma edição por script que deveria inserir
lcd_bus_init()falhou silenciosamente, e o painel foi ressoldado à toa. - ILI9341, não ILI9488. O plano assumia um ILI9488 de 480x320, que por SPI só aceita RGB666 de 3 bytes. Um projeto meu anterior com o mesmo painel mostrou que é um ILI9341 de 320x240. Isso foi melhor que o planejado: resolução nativa, sem escalonamento, 2 bytes por pixel. A ordem de cores foi verificada com três faixas R/G/B rotuladas ao mesmo tempo.
- RST em um pino real. Com RESET ligado a 3V3 e apenas um reset por software, o ILI9341 não iniciava de forma confiável, então RST foi movido para D4. D4 estava livre porque o CS do cartão é o GPIO21, interno à placa Sense. Uma busca na web tinha dado pinos de SD errados. O erro era
ESP_ERR_INVALID_ARG, um erro de configuração e não de cartão, o que apontou para a documentação oficial da Seeed. - Botões e potenciômetros. Solde switches de 4 pernas nas pernas diagonais, ou um botão fica lido como permanentemente pressionado. Para os potenciômetros:
- Uma leitura travada em 0 ou 4095 significa que o fio está em uma perna externa.
- Uma leitura presa no meio da escala significa que o potenciômetro não tem 3V3/GND.
- Uma faixa ampla significa que o eixo está saudável.
- Calibração do analógico. O gimbal repousa em 2317, não em 2048, e o X vai de 141 a 2888.
- O centro é a leitura de repouso no boot, e cada metade é escalonada pelo curso visto naquela direção.
- A zona morta é de 60 contagens (cerca de 4x o ruído medido de +/-15), subtraída dos dois lados para que o movimento comece suavemente.
- Cada eixo faz a média de 8 leituras, e ambos os eixos são invertidos em software.
- Um min/max acumulado desde o boot é inútil aqui, porque uma entrada flutuante toca 0 e 4095 na energização. Use uma janela móvel.
- Leituras de ADC no tick de vblank congelavam tudo. 24 conversões por tick travavam o tick e todas as tarefas mts. O aviso já estava escrito em
esp_input.c. Uma tarefa no núcleo 1 agora amostra a cada 10 ms e publica três inteiros. printfpela USB nativa bloqueia quando nenhum host drena (a UART não). O MGS imprime muito, então uma impressão bloqueada parava o escalonador cooperativo.port/mgs_printf.hescreve com timeout zero.- Pares de clock. PSRAM a 120 MHz com flash a 80 MHz não é um par MSPI suportado, e a falha parece um bug de toolchain. O XIAO roda 80/80 por enquanto, e 120/120 é a próxima coisa a medir.
- SPI do painel. Com fios jumper o painel é estável a 40 MHz. A 80 MHz, faixas da imagem deslizam para o lado.
O MGS agora inicia no portátil, monta o cartão, carrega o dock e roda sem panics, a uma taxa de frames que o README descreve como semelhante à da placa Waveshare.
O que ainda não funciona
- Chamadas de codec. O grupo de rostos de 417.792 bytes agora carrega de uma reserva estática de PSRAM, porque o pool do jogo recusa a alocação. O índice do
RADIO.DATainda está errado: o setor inicial calculado é 31.392, e o arquivo tem 867 setores. O valor de entrada é ruim; a aritmética está correta. Habilitar a tela real do codec também dá panic dentro de umprintf. - A introdução. Iniciar passando pela tela de título deu 11 panics. A última linha antes do primeiro foi
this memcard is OK. O swim-in e o briefing precisam do memory card, do streaming de CD e do codec. - O elevador. Sondas em ambos os construtores de elevador ficam silenciosas por uma sessão inteira, então o script do estágio nunca o solicita. A razão provável, ainda não comprovada, é uma variável de história que só uma chamada de codec avança.
- Streaming de CD (cutscenes, vozes), FMV (sem MDEC), áudio e saves no memory card.
- 28 estágios cujo código de atores ainda é assembly MIPS.
- Desempenho além de cerca de 15 fps.
Próximos passos
- Dimensionar corretamente as pilhas mts e mover páginas de textura quentes para a SRAM interna.
- Medir os clocks de memória 120/120 MHz no XIAO.
- Corrigir o índice do
RADIO.DAT, depois verificar se o elevador acompanha. - Implementar streaming no CD virtual, para recuperar cutscenes e vozes.
- Adicionar áudio através de uma SPU por software.
- Remover as sondas de depuração.
Conclusão
Um PlayStation tolera type punning, divisão por zero, leituras além de arrays e ponteiros testados por sinal. Um compilador e uma CPU modernos não toleram nada disso. A abordagem que funcionou neste port foi projetar cada medição de modo que ela possa falhar.