
Me ha encantado Metal Gear Solid desde que era un crío. Cuando conseguí una placa ESP32-S3 diminuta, se me quedó grabada una pregunta: ¿podría un juego de PlayStation ejecutarse en algo tan pequeño?

La placa es la Seeed Studio XIAO ESP32S3 Sense: un ESP32-S3 de doble núcleo con 8 MB de PSRAM y 8 MB de flash, en un módulo de 21 × 17,8 mm. La versión Sense añade una placa de expansión con cámara y una ranura microSD, y esa ranura microSD es donde viven los datos del juego.
Tardé un buen rato en averiguarlo. Primero busqué una versión del juego que ya se hubiera reconstruido como código C que se ejecutara en un PC, y luego comprobé si toda esa lógica cabría en la flash del ESP32-S3 y en una tarjeta microSD. Hicieron falta varios intentos, pero al final funcionó. Un juego maravilloso se ejecuta ahora en una placa de microcontrolador que cuesta unos 15 USD.
Jugabilidad en la consola portátil: míralo en YouTube.
En este artículo describo cómo Metal Gear Solid (PlayStation, 1998) se ejecuta en el ESP32-S3 como un port nativo. El código fuente en C del juego, reconstruido por la descompilación mgs_reversing del FoxdieTeam, se compila directamente a código máquina Xtensa. Todo lo que antes proporcionaba el hardware de PlayStation se sustituye por software:
- El SDK.
- La GPU.
- El coprocesador de geometría GTE.
- La unidad de CD.
- La interrupción de borrado vertical.
- El mando.
El artículo cubre el hardware, la capa de plataforma, la ubicación de la memoria, el método de depuración, los errores que más importaron, el rendimiento, la consola portátil y lo que aún no funciona.
El código y los proyectos relacionados:
- Port de MGS: davidmonterocrespo24/mgs_reversing, rama
esp32-port. - Guía de hardware de la consola portátil: HARDWARE.md.
- Fork de psyz: davidmonterocrespo24/psyz.
Necesitas tu propio disco. El repositorio no contiene nada derivado del juego, y port/extract_disc.py extrae los archivos de tu propia imagen de disco.
Hardware

El ESP32-S3 tiene dos núcleos Xtensa a 240 MHz y 512 KB de SRAM interna. Ambas placas usadas aquí también tienen 8 MB de PSRAM, que se sitúa detrás de la misma caché que la flash.
| Waveshare ESP32-S3-Touch-LCD-2 | Consola portátil casera (Seeed XIAO ESP32S3 Sense) | |
|---|---|---|
| Panel | ST7789, 320x240 | ILI9341, 320x240 nativo |
| Flash | 16 MB | 8 MB |
| Datos del juego | microSD, o un STAGE.DIR recortado en la flash | microSD (STAGE.DIR completo) |
| Entrada | teclado por puerto serie (play.py) | stick de gimbal de dron, escalera de resistencias de 6 botones, 2 botones directos |
Medir la distancia antes de escribir código
Antes de escribir cualquier código del port, medí a qué distancia estaba la descompilación de compilar para Xtensa:
- Las bibliotecas del motor (libgv, libdg, libgcl, libhzd, libfs) compilaron casi de inmediato con
xtensa-esp32s3-elf-gcc14.2 contra las cabeceras de psyz: 57 de 58 archivos. - Ninguna de ellas contiene direcciones absolutas
0x800xxxxx. - Toda la salida gráfica pasa por 11 llamadas de libgpu (
DrawOTag,LoadImage,ClearOTagR, etc.). Esa es exactamente la capa que sustituye el renderizador software de psyz.
Dejé el único archivo que fallaba, libdg/chanl.c, fallando a propósito. El cast que lo habría silenciado también habría cambiado el stride en silencio (véase la sección de la tabla de ordenación más abajo).
El resto requirió pasadas mecánicas, cada una arreglando toda una clase de problema:
-std=gnu17y-mlongcallsson ambos obligatorios. El gnu23 por defecto de GCC 14 rechaza este código, y elcall8de Xtensa solo alcanza +/-512 KB.- Tanto psyz como MGS tienen un
common.h, así que las rutas de inclusión de MGS deben ir primero. - Se reescribieron 12 expresiones de cast como lvalue, una extensión de GCC 2.x.
- MGS sustituye el
printfde libc por su propio stub. Lo renombré amts_printf, y eso después provocó uno de los errores más engañosos (véase “El arranque que parecía colgado”). - 346 direcciones literales de scratchpad (
0x1f8000xx) repartidas en 16 archivos se convirtieron enSCRPAD_ADDR + offset, respaldadas por un array.
El resultado fue 497 de 497 archivos C compilados a Xtensa. El ELF tenía 0 referencias sin definir y 0 definiciones duplicadas (text 987.073 B, bss 2.434.276 B). La memoria propia del juego es de 804 KiB (428 KiB de heap más dos búferes de paquetes de 188 KiB), que cabe holgadamente en la PSRAM.
Arquitectura
El port tiene tres capas entre el juego y el SoC:
Las capas, desde el juego hasta el hardware:
- Motor de MGS — C descompilado, compilado a Xtensa
- psyz — SDK de PlayStation y GTE en C, rasterizador por software
- Capa de plataforma — planificador de mts sobre FreeRTOS, tick de vblank, CD virtual, LCD, entrada
- ESP32-S3
psyz y el GTE
psyz, la reimplementación del SDK de PlayStation de Xeeynamo, ya modelaba todo el fichero de registros del GTE y cada operación del GTE en C, validado contra la suite de pruebas del GTE de PCSX-Redux.
Mi primera estimación fue que faltaban entre 64 y 70 macros. Esa estimación era demasiado alta. MGS incluye sus propias cabeceras de ensamblador en línea de MIPS (inline_n.h, inline_x.h), y -fsyntax-only no comprueba los nombres de los registros. Una vez que esas cabeceras se redirigieron a psyz, la brecha real era de 41 macros. Las añadí a psyz, usando el propio ensamblador del juego como especificación de qué registros COP2 toca cada una. Después recompilé mis otros proyectos basados en psyz contra el psyz modificado para asegurarme de que nada se rompía.
Cuando alias una macro del GTE, comprueba si cada restricción es una entrada o una salida. Por ejemplo, gte_read_opz tiene una salida "=r", así que su alias tiene que tomar &x.
La etiqueta de la tabla de ordenación — una palabra en PSX, dos en psyz
Esta es la diferencia de diseño más importante, y la que causó más errores. En la PlayStation, cada primitiva empieza con una etiqueta de 32 bits — 24 bits de dirección de la siguiente primitiva y 8 bits de longitud. Un puntero del host no cabe en 24 bits, así que psyz usa dos palabras, tag y len. Cada primitiva crece 4 bytes, y cada campo después de la etiqueta se desplaza una palabra.
MGS también abusa del byte de longitud. libdg ejecuta una ordenación radix de dos pasadas sobre la profundidad de 16 bits:
divide.cagrupa por el byte bajo y aparca el byte alto en la longitud de la etiqueta.sort.creagrupa por ese byte alto y escribe la longitud real.
Como psyz separa los dos campos, la traducción es exacta:
pack->tag = (hi << 24) | *ot; *ot = pack; /* PSX */
addPrim(ot, pack); setlen(pack, hi); /* psyz */
Reescribir 42 declaraciones locales y 100 parámetros a OT_TYPE* fue la parte fácil. La parte difícil fue el código que asumía el diseño empaquetado sin decirlo:
DG_PrimInfosponía el primer vértice en +8 en lugar de +12.LinkModelToParentprecalculaba los desplazamientos de los vértices padre como*52 + 8en lugar de*56 + 12.- Los constructores de primitivas descritos en “La pantalla blanca” más abajo.
También hay un factor agravante. En la consola, addPrim() reescribía toda la palabra de la etiqueta en cada inserción, así que una longitud olvidada nunca podía notarse. En psyz, una longitud que nunca se estableció simplemente nunca se escribe.
El planificador de Konami dentro de FreeRTOS
MGS se ejecuta sobre el propio planificador cooperativo de Konami. El banner de arranque todavía dice Multi Task Scheduler for PSX ver2.02 Jul 11 1998. Se apoya en la API de hilos de la BIOS (OpenTh/ChangeTh) y usa la interrupción de vblank para despertar tareas cuyos temporizadores han expirado.
En el port, cada hilo de mts es una tarea de FreeRTOS, y solo una de ellas es ejecutable en un momento dado. El diseño final:
- Todas las tareas de mts están fijadas al núcleo 0, junto con el tick de vblank a prioridad 10, para que el tick interrumpa el juego igual que lo hacía la interrupción de la PSX. El escaneo del LCD se ejecuta en el núcleo 1. Cruzar esas asignaciones causaba condiciones de carrera que revivían tareas aparcadas a mitad de pila. Un registro mostraba dos copias de
Main()intercaladas línea a línea. - Una tarea nueva se suspende a sí misma en su trampolín.
xTaskCreateseguido devTaskSuspendno es atómico, y con dos núcleos la tarea se ejecutaba antes de que su bloque de control estuviera relleno. - Las secciones críticas son reales. Cada tarea tiene un flag absoluto, guardado y restaurado en cada cambio igual que el registro de estado de MIPS. Es un flag en lugar de un contador porque el juego llama a
ExitCriticalSectionsin unEntercorrespondiente. - El tick ejecuta la llamada de retorno de mts solo mientras la tarea idle (11) está activa. Esa tarea es el bucle de consola SIO de Konami, el único código que nunca toca el estado del planificador. En la consola se ejecutaba con las interrupciones habilitadas exactamente por esta razón. El juego pasa por idle en cada fotograma, así que la latencia de despertar se mantiene por debajo de un fotograma. Este cambio eliminó los cuelgues intermitentes en su origen, donde las versiones anteriores basadas en flags solo habían estrechado la ventana de la carrera.
mts_GetTcbEntry también leía la tabla de tablas de la BIOS en la dirección fija 0x100 y escribía a través del resultado. Fuera de una PSX esa dirección contiene basura, así que ahora usa una tabla de TCB privada.
El tick de vblank y los dos relojes
port/esp32_vblank.c dispara la llamada de retorno de VSync del juego cada 16 ms. Eso requería que VSyncCallback() estuviera implementada en psyz, donde ni siquiera almacenaba el puntero.
VSync(-1) tiene que devolver un contador de vblank de ejecución libre. La primera versión devolvía el número de fotogramas presentados, que deja de avanzar cuando no se dibuja nada, así que ningún temporizador expiraba jamás.
La tasa de fotogramas varía — 2 vblanks por fotograma en un pasillo, 4 o 5 en una sala abierta. Por eso, dos cosas que parecían cosa de vblank en realidad pertenecen al fotograma del juego:
- Las retenciones de teclas en serie se decrementan en
DG_ActFirst, justo después deGV_UpdatePadSystem, el único punto que significa “un fotograma ha leído el pad”. Contar vblanks ahí o bien hacía caminar a Snake demasiado lejos o bien soltaba las teclas antes de que el juego las viera. - El LCD envía un fotograma solo cuando ha cambiado un número de secuencia incrementado en
DG_SwapFrame, con un respaldo de 250 ms.
Ubicación de la memoria
La SRAM interna es escasa y rápida. La PSRAM es abundante y lenta. Las lecturas de flash deshabilitan la caché de la que también depende la PSRAM.
- El mapa de RAM del juego cuelga de un único define,
MEM_BOTTOM. Tanto las arenas de paquetes como el heap y el búfer de sectores de libfs salen de él por sustracción. Se reubica sobre un array estático en PSRAM (mgs_main_ram[0xC9000],EXT_RAM_BSS_ATTR). Tiene que ser estático porqueRESIDENT_BOTTOMse usa como inicializador estático, lo que descartamalloc. - El 1 MB de VRAM de la PSX vive en PSRAM. Sin
EXT_RAM_BSS_ATTR, dram0 se desborda unos 900 KB. - Las pilas de las tareas fueron y vinieron.
- Pilas de 32 KB desde SRAM interna hacían que el cuarto
xTaskCreatefallara silenciosamente (ver “Un interbloqueo de prioridades que era un malloc fallido”). - Las pilas movidas a PSRAM funcionaban hasta que una tarea llamaba a
fopen. El driver de flash deshabilita la caché, la tarea pierde su propia pila, y el SoC se reinicia sin imprimir ningún pánico. - Ahora las pilas son de 20 KB en SRAM interna. Las marcas de nivel máximo muestran cinco tareas usando unos 2 KB y una usando 14.484 B.
- Pilas de 32 KB desde SRAM interna hacían que el cuarto
- Un stub con el tipo equivocado acaba en flash de solo lectura.
_spu_transferCallbackes un puntero a función. Declararlo como función lo ponía en.text, así que el primer= 0se estrellaba. Lo encontré ejecutandonmsobre un ELF funcional basado en psyz y sobre este, comparándolos concomm, y listando los símbolos que sonB/Dallí yTaquí.
Hay una clase de error que solo existe en este mapa de memoria — comprobaciones de punteros basadas en el bit de signo. MGS distingue un puntero a bloque de script de un id de proc de 16 bits con proc_id < 0. La RAM de la PSX está en 0x8xxxxxxx, que es negativa como valor con signo. La PSRAM está en 0x3Cxxxxxx, que es positiva. El resultado era PROC 3C1987D2 NOT FOUND, seguido de un LoadProhibited en EXCVADDR 0x00000003. Una macro GCL_IS_BLOCK_PTR arregla el sitio que se vio afectado. Otros sitios con el mismo patrón todavía necesitan una auditoría.
Un CD virtual sobre FAT
libfs trabaja en sectores absolutos. Lee el directorio ISO9660 una vez y nunca vuelve a usar un nombre de fichero. port/virtual_cd.c sustituye a la BIOS del CD:
- Cada fichero recibe un rango sintético de 1.000.000 de sectores, así que un número de sector se mapea de vuelta a (fichero, desplazamiento) con una división.
CDBIOS_ReadRequestentrega datos sector a sector y llama a una función de retorno después de cada sector. La función de retorno puede reescribir el tamaño restante.FS_CdStageFileInitdepende de eso para conocer el tamaño de la tablaSTAGE.DIRa partir de sus primeros 4 bytes. Tratar la petición como una simple copia de bytes e ignorar la función de retorno hacía que cada búsqueda de escenario devolvieraNOT FOUND.- La entrega tiene que ser asíncrona. El parser y el “disco” son corrutinas que comparten una ventana de búfer. Entregar todo de golpe dejaba que el fichero 2 sobrescribiera el fichero 1 antes de que se parseara.
ReadRequestahora solo registra la petición, yReadSyncbombea sectores hasta que la función de retorno devuelve 2 (“búfer redirigido”).
Los datos vivían primero en PSRAM, lo que limitaba el juego a un puñado de escenarios. La solución real fue la microSD. La tarjeta es un periférico SPI, separado de la flash XIP, así que leerla no deshabilita la caché de instrucciones. Los ficheros se quedan en la tarjeta y no cuestan PSRAM.
- El
STAGE.DIRcompleto de 71.892.992 bytes (los 96 escenarios) se lee bajo demanda. - De 93 ficheros de escenario, 65 tienen tablas de actores totalmente simbólicas. Los otros 28 todavía contienen direcciones MIPS en bruto porque su código de actor no está descompilado.
- Un generador construye una tabla de actores deduplicada y una lista blanca — 56 escenarios y 149 clases de actor. El comando de cambio de escenario del script comprueba la lista blanca mientras el mundo actual todavía está intacto.
La tarjeta y el LCD comparten SPI2, y ESP-IDF no arbitra entre ellos. Un fotograma del LCD son 30 transferencias asíncronas en cola, así que una lectura de tarjeta en medio de un fotograma disparaba assert failed: spi_hal_iram.c:134 y causaba un bucle de reinicio. La solución es una propiedad explícita del bus (Mgs_SpiBusTake/Give), drenando las transferencias en vuelo antes de liberar el bus.
Método: medir, no adivinar
Alrededor de un tercio de las explicaciones obvias de este proyecto resultaron ser erróneas. Lo que funcionó fue conseguir que la placa imprimiera un número que decidiera entre hipótesis. Las lecciones más útiles vinieron de sondas que dieron respuestas equivocadas:
- Un contador que nadie incrementa inventa un hallazgo.
[trap] scanning 63 triggers, 0 entered so farestuvo a punto de convertirse en “el sistema de triggers está muerto”. Al contador le faltaba un++. Con uno real, los triggers se dispararon desde el primer segundo. - Una comprobación tautológica da una falsa confianza. La auditoría de esqueletos comparaba
|R·t|con|t|. Son iguales para cualquier rotación, así que la comprobación se mantuvo en verde durante semanas mientras todos los esqueletos estaban deformados (ver “El aliasing estricto eliminó una rotación”). - Comprueba dónde se escribe un campo antes de interpretarlo.
eye_inv.tparece una posición de cámara, pero es un vector de dirección rotado. Leerlo como una posición produjo una historia detallada y falsa sobre una cámara que se aleja volando. - Mantén una sonda amplia hasta que los datos la acoten. Filtré la sonda de primitivas a pantalla completa a primitivas sin textura, con la idea de que un destello no tiene textura. Un cono de foco sí la tiene.
- Separa los contadores por causa. “El 65% de las costuras están obsoletas” eran cuatro causas en un mismo grupo, y la más grande eran objetos raíz inofensivos. Tras la separación, mi corrección se disparó cero veces, y la eliminé.
- Instrumenta los N escritores. Cuando
DG_UnDrawFrameCount = 0x7fff0000dejó la pantalla en negro, adiviné mal dos veces. Etiquetar los cuatro escritores con"file:line"señalógame/gamed.c:476de inmediato. - Decodifica los datos antes de sospechar del intérprete. El script del muelle parecía ejecutar un solo comando. Decodificar el bytecode de la versión comercial mostró 19 nodos, de los cuales solo uno imprime (ver “El muelle vacío era un script de dos pasadas”).
- Comprueba que la sonda está en el binario. Una miga de pan que mostraba “(nothing)” nunca se había insertado, porque un
str.replacepor script había fallado silenciosamente. Hazgrepde la cadena en el.bin. - Usa watchpoints de hardware para escritores descontrolados.
esp_cpu_set_watchpoint(0, addr, 4, STORE)mostró que unas 230 desincronizaciones de la GPU provenían deDG_PcxRead4Bpp, un decodificador de texturas cuyo búfer temporal se solapaba con paquetes activos. - Desconfía de las mejoras repentinas. Cuando la tarjeta no se montó, la placa recurrió a 9 etapas en flash, y los tiempos de carga bajaron de 693 a 21 vblanks. Eso parece una aceleración de 35x, pero significa que falta la tarjeta. Comprueba primero
microSD mountedytable_size 1152 -> 96 stages.
Ejecutar cada build sin grabar la placa
Ese método solo funciona si probar algo es barato, y tras varias horas de prueba y error, grabar la placa después de cada cambio no lo era: escribir la imagen en la XIAO por USB, esperar al reinicio, leer el log serie y vuelta a empezar. Así que para ejecutar y comprobar cada build usé velxio-cli, el cliente de línea de comandos de Velxio. Toma el mismo .bin que genera mi toolchain, lo ejecuta en el ESP32-S3 simulado de Velxio durante un tiempo simulado fijo y devuelve la salida serie, así que podía leer las sondas de arriba sin tocar el hardware. La placa solo recibía una imagen nueva cuando un build lo merecía.
# 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 .
Instalarlo y hacer una primera ejecución lleva unos minutos: mira la guía rápida de velxio-cli.
Los errores

El aliasing estricto eliminó una rotación
- Síntoma: todos los personajes tenían los brazos separados del torso, una rodilla doblada hacia atrás y los pies apuntando en direcciones distintas. El mundo estaba bien.
- Callejones sin salida:
- Un “arreglo” de
MulRotMatrixque empeoró mucho las cosas y se revirtió. - El stride del modelo, demostrado que era de 88 bytes a partir de los datos de tres formas independientes.
- Costuras obsoletas, medidas con efecto cero.
- Un volcado congelado de la pose de reposo situó las 16 articulaciones a menos de un milímetro de las posiciones decodificadas del disco, con
det = 4096yd2 == wanten todos los huesos.
- Un “arreglo” de
- Por qué esas comprobaciones no lo detectaron: en la pose de reposo toda rotación es la identidad,
d2 == wantes una tautología, ydetcomprueba el bloque de 3x3, que era correcto. - Lo que lo detectó: las posiciones de las articulaciones en dos fotogramas diferentes. El desplazamiento de padre a hijo permanecía idéntico byte a byte mientras el padre rotaba 19 grados.
- Causa raíz:
CompMatrixescribía la traslación a través de(VECTOR*)&tmp.t[0]sobre unlong[3]. GCC 14 con-O2concluyó que nada lee esos almacenamientos y eliminó la llamada. El desensamblado no tenía instrucciones de multiplicación. Calculabam2->t = m0->t + m1->t. - Solución: aritmética con
long longsin type punning, más-fno-strict-aliasingpara todo el juego. Existe un segundo caso idéntico enlibdg/display.c:318, así que el flag es la protección real. Una auditoría[rig]ahora comprueba cada esqueleto usando ratios invariantes a la escala contra el hueso más largo: 14.416 articulaciones auditadas, 0 defectuosas.
La pantalla blanca: cinco hipótesis erróneas, tres causas reales
- Síntoma: cuando un enemigo detectaba a Snake, una sábana blanca cubría la escena. El HUD seguía viéndose, y había destellos de color.
- Hipótesis descartadas por medición:
- Un flash a pantalla completa. La sonda registró 0 líneas.
change camera -1como error. Es el centinela de “aquí no hay cámara fija”, y tratarlo como error congelaba la cámara detrás del jugador.- Una cámara descontrolada. Eso era el
eye_inv.tmal leído; la posición real era estable. - Desbordamiento de la cola de dibujo. Un arreglo de culling redujo los modelos dibujados de 25.093 a 14.054 y el blanco permaneció.
setlen(pack, z_idx >> 8)endivide.c.setlenhace un cast au_char, así que no puede producir longitudes como0x2E000000.
- Causa 1:
SetDrawStphacía((u_long*)p)[1] = 0xE6000000 | stp. En psyz, la palabra 1 eslen, y el comando pertenece acode[0]. El lector veía un paquete de miles de millones de palabras, lo descartaba y reanudaba a mitad de primitiva, decodificando vértices como comandos. Se disparaba en combate, porque los fogonazos y el humo son lo que activa la semitransparencia. psyz ya había corregido el mismo error en su propiosetDrawTPage, pero nadie había revisado el gemelo del lado del juego. Tras el arreglo: 0 descartados, 0 desincronizaciones. - Causa 2:
DG_MakePrimnunca inicializaba la longitud. Se corrige en un solo sitio derivandolen = psize/4 - 2y comprobando el resultado contra las macros de psyz (FT4 da 9, GT4 da 12, TILE da 3). - Causa 3, la regla de hardware que faltaba: una vez incluidas las primitivas texturizadas, la sonda mostró
[cover] code 3E abe 1 tex 1 box -1024,-1024..142,66, que es el límite de saturación del GTE. Los polígonos que cruzan por detrás de la cámara quedan fijados ahí como quads que abarcan toda la pantalla. La GPU de PSX rechaza cualquier polígono mayor de 1023x511, y el juego depende de ello. Nuestro rasterizador los dibujaba: 27,8 M de téxeles por cada 120 fotogramas, unas tres pantallas por fotograma, y 142 ms de rasterización. La comprobación de tamaño ahora se ejecuta ensoft_raster.inc.cantes del clipping, porque el clipping reduciría el polígono al tamaño de la pantalla y ocultaría justamente la propiedad que se está probando.
El arreglo de culling de la hipótesis 4 era real, aunque no fuera la causa. La prueba de bounding-box trataba una caja que cruza el plano cercano igual que una completamente detrás de él. Separar los dos casos llevó kept-saturated de 16.090 a 4.947. Un intento anterior basado en coordenadas saturadas rescataba el 97% de todo lo que la prueba de pantalla rechazaba (+40% de rasterización), porque una pared grande y lejana también satura. Preguntar directamente por Z (SZ <= H/2) daba 1.440 en lugar de 15.000.
Square0 desplazado 12 bits: todas las distancias /64
Snake daba tres pasos, chocaba con una pared, rebotaba y nunca avanzaba. La tasa de fotogramas fue el primer sospechoso. Una observación lo descartó: el mundo se movía bien y solo el jugador no. Una sonda en GM_ActControl mostró un paso de +4481 seguido de un rebote de -14641.
En PSY-Q el sufijo numérico es el desplazamiento: Square0 no desplaza y Square12 sí. El Square0 del port desplazaba 12, así que toda longitud Square0 -> sum -> sqrt salía /64. Eso rompía:
- El movimiento y las colisiones.
- El alcance de visión de los enemigos.
- Las balas.
- El sensor infrarrojo.
- La atenuación de la luz.
Eliminar el desplazamiento hizo que la trayectoria fuera monótona.
Cinco opcodes del GTE copiados de la fila equivocada
Snake se había caído del mundo (Y = -3250), el movimiento estaba fijado en 0,1 por fotograma, y el muelle no tenía agua. Los Psyz_GteRtv0/Rtv1/Rtv2/Ll/Llv0 de psyz usaban opcodes MVMVA de la fila equivocada de la propia tabla inline_n.h de MGS. “Rotar este vector” se convertía en “rotarlo y sumar la traslación obsoleta”, y la iluminación usaba la matriz de rotación en lugar de la matriz de luz.
Tras el arreglo:
- Un paso de
27,0sostenido. - Y = 250.
- Giro suave.
- Píxeles texturizados por fotograma subieron de 23.500 a 107.877.
- El agua también volvió, porque está condicionada a que la cámara esté dentro del volumen de agua.
El muelle vacío era un script de dos pasadas
El muelle solo tenía un puñado de grupos de objetos, y el script parecía ejecutar un solo comando. La estructura real de s00a es if (var[5] < 6) { set up the Colonel's call } else { build the dock }, y el proc de la llamada es un restart. El mundo se construye en la segunda pasada, y responder al códec la dispara.
Yo mismo había enmascarado el códec para evitar un crash, y eso desactivó todos los radio -c ... -p proc en todas las fases. MENU_RadioDrainHeadless ahora responde a la llamada y despacha su proc sin abrir la pantalla del códec. Los grupos de objetos pasaron de 480 a 3.240 por cada 120 fotogramas, y se creó el área del agua. La lección: un stub temporal necesita algo que te obligue a revisitarlo.
División por cero: MIPS la sobrevive, Xtensa se reinicia
libhzd/near.c divide por una longitud 2D al cuadrado que puede ser cero en casos degenerados. El R3000 continúa con un resultado indefinido. Xtensa lanza IntegerDivideByZero y la placa se reinicia. Se aplicó HZD_DIV a las 7 divisiones con divisor en tiempo de ejecución. Después de eso, 80 s caminando en las cuatro direcciones, el patrón que solía provocar el crash, dieron 0 pánicos. En este port, toda división por un divisor calculado necesita una guarda.
El congelamiento de 17,6 minutos
El VSync de psyz truncaba su resultado a 16 bits en todos los modos, pero VSync(-1) debe devolver el contador de campos de 32 bits. A los 65.536 campos (17,6 minutos a 60 Hz), el reloj de mts daba la vuelta de 64.800 a 1.064 mientras una tarea esperaba 65.537, y esperaba para siempre. El arreglo devuelve el contador completo para mode < 0. Afecta a todos los proyectos construidos sobre psyz. Los errores que dependen del tiempo transcurrido nunca aparecen en pruebas de 60 segundos.
El arranque que parecía colgado
Durante horas el arranque parecía atascado. El mts_printf de Konami era un stub vacío en la PSX, y mi #define printf mts_printf enviaba toda la salida del juego ahí, así que el arranque progresaba en silencio. Una vez que mts_printf llamó a vprintf, el log mostró que el juego había llegado a memcard_init(). Antes de diagnosticar un cuelgue, asegúrate de que la salida va a algún sitio.
Un deadlock de prioridades que era un malloc fallido
El daemon de ficheros (tarea 10) nunca obtenía tiempo de CPU, y la traza parecía un deadlock de prioridades. Dos arreglos reales (la semántica de ChangeThFromISR y el reloj de VSync(-1)) no cambiaron nada. Entonces una línea lo resolvió: [thread] OpenTh: xTaskCreate failed.
Había subido las pilas a 32 KB, FreeRTOS las toma de la SRAM interna, y la cuarta tarea no cabía. OpenTh devolvía -1, y ChangeTh rechazaba ese tid para siempre. En este SoC, comprueba siempre el valor de retorno de xTaskCreate, incluso con megabytes de PSRAM libres.
Pantalla negra tras añadir los datos de las cinemáticas
Copiar DEMO.DAT, VOX.DAT y ZMOVIE.STR a la tarjeta puso la pantalla en negro: 720 fotogramas, 0 pánicos, y cero primitivas enviadas.
El código de cambio de fase espera a GM_StreamStatus() == -1. El stream de DEMO.DAT de la cinemática nunca avanzaba, porque el CD virtual sirve lecturas por sector pero no la ruta de streaming continuo con ring-buffer. Antes de que existieran los ficheros, el stream se había rechazado pronto y todo seguía funcionando.
El manejo actual:
- Todos los streams de entrada se rechazan en
NewStreamControlejecutando su callback, con un watchdog de 600 fotogramas como red de seguridad. Eso cuesta las cinemáticas y las voces, y da un juego que se puede jugar. - La entrada de mando grabada de una cinemática empezaba de inmediato y Snake se iba caminando solo. Esa reproducción ahora se omite igual que el juego la omite con START.
- El FMV también se rechaza, porque psyz no tiene decodificador MDEC.
Errores menores
PSX_Wera 256, heredado del código que reutilicé. MGS renderiza 320 columnas, así que se perdía un quinto de la imagen. Audita cada constante heredada.- Carrera en el arranque: el tick leía el serial USB antes de que el driver estuviera instalado, causando
LoadProhibiteden 2 de 6 arranques medidos. - El descartador de fotogramas de Konami: dos actores leían el flag de salto en momentos distintos, así que los buffers se intercambiaban sin dibujar y la pantalla parpadeaba. Ambos flags se fuerzan a 0 bajo
__psyz. Las escenas pesadas ahora van más lentas en lugar de parpadear. - “Colisión rota”: los empujes contra la pared medían unos 452 frente a un radio de 450, que es exactamente correcto. A 8-10 fps, una corrección de 450 unidades simplemente parece un salto.
Rendimiento
El tiempo de rasterizado es un contador de esp_timer en el rasterizador, sumado a lo largo de 120 fotogramas en la misma posición.
La primera pasada fue en s07a, una sala pequeña. El tiempo total de rasterizado pasó de 923.000 a 903.900, luego a 794.000 y después a 741.700 us (de 7,69 a 6,18 ms por fotograma). Los tres pasos:
SOFT_RASTER_IRAMestaba vacío en la compilación de MGS, así que los bucles por píxel se ejecutaban desde la flash. Debería serIRAM_ATTR. Corregirlo dio un -2%.- PSRAM y flash a 120 MHz dieron un -12%. Primero concluí que esta placa no podía con ello. El error “FLASH and PSRAM Mode configuration are not supported” solo significa que falta
CONFIG_IDF_EXPERIMENTAL_FEATURES=y. CompruebaCONFIG_SPIRAM_SPEED 120en elsdkconfig.hgenerado. - El scanout funcionaba a 62,5 Hz para un juego a 30 fps. La mitad de los envíos reenviaban la misma imagen, y cada uno leía unos 120 KB de PSRAM y desalojaba las texturas del rasterizador en el otro núcleo. Igualar la tasa del juego dio un -6,6%.
El muelle (s00a) es mucho más pesado. Un perfil allí midió 46.400 píxeles texturizados y 71.680 planos por fotograma: 40,9 ms de rasterizado más unos 25 ms de lógica y GTE, lo que supone unos 15 fps. El README indica actualmente unos 15 fps para el muelle con enemigos. El documento de estado da entre 8 y 15 fps según la escena, frente a un objetivo de 30.
Una ruta rápida de 32 bits para rellenos planos solo ganó un 2%. El coste está en los píxeles texturizados, a unos 207 ciclos cada uno. Un juego 2D se ejecuta mucho más rápido en el mismo rasterizador: un tilemap recorre las texturas en línea recta, y una sola línea de caché de 64 bytes sirve 128 píxeles. En los triángulos rotados de MGS, tanto U como V cambian por píxel, y casi todos los píxeles son un fallo de caché. La caché de datos ya está en su máximo de 64 KB.
El siguiente paso es mover las páginas de textura activas a la SRAM interna, lo que el documento de estado estima en 40 veces más rápido. Eso requiere los aproximadamente 90 KB atrapados en pilas mts sobredimensionadas (24 KB para la tarea grande y 6 KB para el resto). Reducir las texturas no es una opción, porque las UV están integradas en los modelos.
La carga también es lenta: unos 11,5 s para 1,1 MB desde la tarjeta (aproximadamente 95 KB/s).
- Una ráfaga de 128 en lugar de 16 sectores solo ganó un 7%.
- La tarjeta es fiable a 20 MHz en la placa Waveshare. A 40 MHz da errores CRC.
- Omitir llamadas
fseekredundantes está implementado pero aún no medido.
Poniendo en marcha la consola portátil

La consola portátil está construida con:
- Un XIAO ESP32S3 Sense, cuya placa de expansión proporciona la ranura microSD.
- Un panel SPI ILI9341.
- Un gimbal de mando de dron.
- 8 botones: 6 en una escalera de resistencias en un pin ADC, más disparo y apuntado en sus propios pines, porque una escalera solo registra un botón a la vez.

Se usan los 11 pines del XIAO. El cableado está documentado en la guía de hardware. Notas de puesta en marcha:
- La masa que faltaba. El panel brillaba en blanco y cambiaba de brillo cuando se enviaban datos, porque se alimentaba a través de los diodos de protección de sus entradas. Antes de eso, las mediciones descartaron el cableado, el pulso de reset, la tensión de alimentación y la configuración SPI. Un error mío también costó dos rondas: una edición por script destinada a insertar
lcd_bus_init()falló silenciosamente, y el panel se resoldó para nada. - ILI9341, no ILI9488. El plan asumía un ILI9488 de 480x320, que por SPI solo acepta RGB666 de 3 bytes. Un proyecto mío anterior con el mismo panel demostró que es un ILI9341 a 320x240. Eso fue mejor de lo planeado: resolución nativa, sin escalado, 2 bytes por píxel. El orden de colores se comprobó con tres franjas R/G/B etiquetadas a la vez.
- RST en un pin real. Con RESET conectado a 3V3 y solo un reset por software, el ILI9341 no arrancaba de forma fiable, así que RST se movió a D4. D4 estaba libre porque el CS de la tarjeta es GPIO21, interno a la placa Sense. Una búsqueda web había dado pines SD incorrectos. El error era
ESP_ERR_INVALID_ARG, un error de configuración más que de tarjeta, lo que apuntó a la documentación oficial de Seeed. - Botones y potenciómetros. Cablea los interruptores de 4 patas en patas diagonales, o un botón se leerá como permanentemente pulsado. Para los potenciómetros:
- Una lectura clavada en 0 o 4095 significa que el cable está en una pata exterior.
- Una lectura estancada a media escala significa que el potenciómetro no tiene 3V3/GND.
- Un rango amplio significa que el eje está sano.
- Calibración del joystick. El gimbal reposa en 2317, no en 2048, y X viaja de 141 a 2888.
- El centro es la lectura en reposo al arrancar, y cada mitad se escala por el recorrido visto en esa dirección.
- La zona muerta es de 60 cuentas (unas 4 veces el ruido medido de +/-15), restada en ambos lados para que el movimiento empiece suavemente.
- Cada eje promedia 8 lecturas, y ambos ejes se invierten por software.
- Un mínimo/máximo acumulado desde el arranque es inútil aquí, porque una entrada flotante toca 0 y 4095 al encender. Usa una ventana móvil.
- Las lecturas del ADC en el tick de vblank congelaban todo. 24 conversiones por tick bloqueaban el tick y todas las tareas mts. La advertencia ya estaba escrita en
esp_input.c. Ahora una tarea en el núcleo 1 muestrea cada 10 ms y publica tres enteros. printfpor USB nativo se bloquea cuando ningún host lo drena (UART no). MGS imprime mucho, así que una impresión bloqueada detenía el planificador cooperativo.port/mgs_printf.hescribe con un tiempo de espera cero.- Pares de reloj. PSRAM a 120 MHz con flash a 80 MHz no es un par MSPI soportado, y el fallo parece un error de la toolchain. El XIAO funciona a 80/80 por ahora, y 120/120 es lo siguiente que hay que medir.
- SPI del panel. Con cables de puente el panel es estable a 40 MHz. A 80 MHz, bandas de la imagen se deslizan lateralmente.
MGS ahora arranca en la consola portátil, monta la tarjeta, carga el muelle y se juega sin pánicos, a una tasa de fotogramas que el README describe como similar a la de la placa Waveshare.
Lo que aún no funciona
- Llamadas del códec. El grupo de caras de 417.792 bytes ahora se carga desde una reserva estática de PSRAM, porque el pool del juego rechaza la asignación. El índice de
RADIO.DATsigue mal: el sector de inicio calculado es 31.392, y el archivo tiene 867 sectores. El valor de entrada es incorrecto; la aritmética está bien. Habilitar la pantalla real del códec también provoca un pánico dentro de unprintf. - La intro. Arrancar pasando por la pantalla de título dio 11 pánicos. La última línea antes del primero fue
this memcard is OK. El swim-in y el briefing necesitan la tarjeta de memoria, el streaming de CD y el códec. - El ascensor. Las sondas en ambos constructores del ascensor permanecen silenciosas durante toda una sesión, así que el script de la fase nunca lo solicita. La razón probable, aún no demostrada, es una variable de historia que solo avanza una llamada del códec.
- Streaming de CD (cinemáticas, voces), FMV (sin MDEC), audio y guardado en tarjeta de memoria.
- 28 fases cuyo código de actores sigue siendo ensamblador MIPS.
- Rendimiento más allá de unos 15 fps.
Próximos pasos
- Dimensionar correctamente las pilas mts y mover las páginas de textura activas a la SRAM interna.
- Medir los relojes de memoria a 120/120 MHz en el XIAO.
- Arreglar el índice de
RADIO.DATy luego comprobar si el ascensor va detrás. - Implementar el streaming en el CD virtual, para recuperar las cinemáticas y las voces.
- Añadir audio mediante una SPU por software.
- Eliminar las sondas de depuración.
Conclusión
Una PlayStation tolera el type punning, la división por cero, las lecturas más allá de los arrays y los punteros con prueba de signo. Un compilador y una CPU modernos no toleran nada de eso. El enfoque que funcionó en este port fue diseñar cada medición de modo que pueda fallar.