
Я люблю Metal Gear Solid с детства. Когда мне попалась крошечная плата ESP32-S3, у меня засела одна мысль: сможет ли игра для PlayStation работать на чём-то настолько маленьком?

Эта плата — Seeed Studio XIAO ESP32S3 Sense: двухъядерный ESP32-S3 с 8 МБ PSRAM и 8 МБ флеш-памяти, на модуле размером 21 × 17,8 мм. Версия Sense добавляет плату расширения с камерой и слотом microSD, и именно в этом слоте microSD хранятся данные игры.
Я потратил немало времени на выяснение. Сначала я искал версию игры, которая уже была пересобрана в виде C-кода, работающего на ПК, а затем проверил, поместится ли вся эта логика во флеш-память ESP32-S3 и на карту microSD. Потребовалось несколько попыток, но в конце концов всё заработало. Замечательная игра теперь работает на плате микроконтроллера стоимостью около 15 долларов.
Геймплей на портативной консоли: смотрите на YouTube.
В этой статье я описываю, как Metal Gear Solid (PlayStation, 1998) работает на ESP32-S3 в виде нативного порта. C-исходники игры, восстановленные декомпиляцией mgs_reversing от FoxdieTeam, компилируются напрямую в машинный код Xtensa. Всё, что раньше обеспечивало аппаратное обеспечение PlayStation, заменено программным:
- SDK.
- GPU.
- Геометрический сопроцессор GTE.
- Привод CD.
- Прерывание вертикальной синхронизации.
- Контроллер.
Статья охватывает аппаратное обеспечение, платформенный слой, размещение памяти, метод отладки, самые значимые баги, производительность, портативную консоль и то, что пока не работает.
Код и связанные проекты:
- Порт MGS: davidmonterocrespo24/mgs_reversing, ветка
esp32-port. - Руководство по аппаратному обеспечению портативной консоли: HARDWARE.md.
- Форк psyz: davidmonterocrespo24/psyz.
Вам нужен собственный диск. Репозиторий не содержит ничего, производного от игры, а port/extract_disc.py извлекает файлы из вашего собственного образа диска.
Аппаратное обеспечение

ESP32-S3 имеет два ядра Xtensa на 240 МГц и 512 КБ внутренней SRAM. Обе используемые здесь платы также имеют 8 МБ PSRAM, которая находится за тем же кэшем, что и флеш-память.
| Waveshare ESP32-S3-Touch-LCD-2 | Самодельная портативная консоль (Seeed XIAO ESP32S3 Sense) | |
|---|---|---|
| Панель | ST7789, 320x240 | ILI9341, 320x240 нативно |
| Флеш-память | 16 МБ | 8 МБ |
| Данные игры | microSD или урезанный STAGE.DIR во флеш-памяти | microSD (полный STAGE.DIR) |
| Ввод | клавиатура через последовательный порт (play.py) | стик от дронового подвеса, резисторная лестница на 6 кнопок, 2 прямые кнопки |
Измерение разрыва перед написанием кода
Прежде чем писать какой-либо код порта, я измерил, насколько декомпиляция далека от сборки под Xtensa:
- Библиотеки движка (libgv, libdg, libgcl, libhzd, libfs) скомпилировались почти сразу с
xtensa-esp32s3-elf-gcc14.2 против заголовков psyz: 57 из 58 файлов. - Ни одна из них не содержит абсолютных адресов
0x800xxxxx. - Весь графический вывод идёт через 11 вызовов libgpu (
DrawOTag,LoadImage,ClearOTagRи так далее). Именно этот слой и заменяет программный рендерер psyz.
Я оставил единственный не собирающийся файл, libdg/chanl.c, падающим намеренно. Приведение типа, которое заглушило бы ошибку, также незаметно изменило бы шаг (см. раздел про таблицы упорядочивания ниже).
Остальное потребовало механических проходов, каждый из которых исправлял целый класс проблем:
-std=gnu17и-mlongcallsоба обязательны. Стандарт gnu23 по умолчанию в GCC 14 отвергает этот код, а Xtensacall8достигает только +/-512 КБ.- И у psyz, и у MGS есть
common.h, поэтому пути включения MGS должны идти первыми. - 12 выражений с приведением типа как lvalue, расширение GCC 2.x, были переписаны.
- MGS заменяет libc-шный
printfсвоим собственным заглушком. Я переименовал его вmts_printf, и это позже вызвало один из самых обманчивых багов (см. «Загрузка, которая выглядела зависшей»). - 346 литеральных адресов scratchpad (
0x1f8000xx) в 16 файлах сталиSCRPAD_ADDR + offset, подкреплёнными массивом.
Результат — 497 из 497 C-файлов скомпилированы под Xtensa. В ELF было 0 неопределённых ссылок и 0 дублирующихся определений (text 987 073 Б, bss 2 434 276 Б). Собственная память игры составляет 804 КиБ (428 КиБ кучи плюс два буфера пакетов по 188 КиБ), что с запасом помещается в PSRAM.
Архитектура
Порт состоит из трёх слоёв между игрой и SoC:
Слои, от игры до аппаратного обеспечения:
- Движок MGS: декомпилированный C, скомпилированный под Xtensa
- psyz: PlayStation SDK и GTE на C, программный растеризатор
- Платформенный слой: планировщик mts на FreeRTOS, тик vblank, виртуальный CD, LCD, ввод
- ESP32-S3
psyz и GTE
psyz, реимплементация PlayStation SDK от Xeeynamo, уже моделировала весь регистровый файл GTE и каждую операцию GTE на C, проверенную против тестового набора GTE из PCSX-Redux.
Моя первая оценка была, что не хватает от 64 до 70 макросов. Эта оценка была завышена. MGS поставляется с собственными заголовками inline-asm для MIPS (inline_n.h, inline_x.h), а -fsyntax-only не проверяет имена регистров. Как только эти заголовки были перенаправлены на psyz, реальный разрыв составил 41 макрос. Я добавил их в psyz, используя собственный ассемблер игры как спецификацию того, какие регистры COP2 затрагивает каждый из них. Затем я пересобрал свои другие проекты на основе psyz против модифицированного psyz, чтобы убедиться, что ничего не сломалось.
Когда вы создаёте псевдоним для макроса GTE, проверьте, является ли каждое ограничение входным или выходным. Например, gte_read_opz имеет выход "=r", поэтому его псевдоним должен принимать &x.
Тег таблицы упорядочивания: одно слово на PSX, два в psyz
Это самое важное различие в раскладке, и оно вызвало больше всего багов. На PlayStation каждый примитив начинается с одного 32-битного тега: 24 бита адреса следующего примитива и 8 бит длины. Хостовый указатель не помещается в 24 бита, поэтому psyz использует два слова, tag и len. Каждый примитив вырастает на 4 байта, и каждое поле после тега сдвигается на одно слово.
MGS также злоупотребляет байтом длины. libdg выполняет двухпроходную поразрядную сортировку по 16-битной глубине:
divide.cраскладывает по корзинам по младшему байту и сохраняет старший байт в длине тега.sort.cперераскладывает по этому старшему байту и записывает реальную длину.
Поскольку psyz разделяет эти два поля, перевод точен:
pack->tag = (hi << 24) | *ot; *ot = pack; /* PSX */
addPrim(ot, pack); setlen(pack, hi); /* psyz */
Перепечатать 42 локальных объявления и 100 параметров в OT_TYPE* было лёгкой частью. Сложной частью был код, который предполагал упакованную раскладку, не говоря об этом:
DG_PrimInfosпомещал первую вершину на +8 вместо +12.LinkModelToParentпредвычислял смещения родительских вершин как*52 + 8вместо*56 + 12.- Конструкторы примитивов, описанные в разделе «Белый экран» ниже.
Есть также отягчающий фактор. На консоли addPrim() перезаписывал всё слово тега при каждой вставке, поэтому забытая длина никогда не могла быть замечена. В psyz длина, которая никогда не была установлена, просто никогда не записывается.
Планировщик Konami внутри FreeRTOS
MGS работает на собственном кооперативном планировщике Konami. Загрузочный баннер по-прежнему гласит Multi Task Scheduler for PSX ver2.02 Jul 11 1998. Он опирается на API потоков BIOS (OpenTh/ChangeTh) и использует прерывание vblank для пробуждения задач, чьи таймеры истекли.
В порте каждый поток mts — это задача FreeRTOS, и только одна из них может быть запущена в любой момент времени. Финальный дизайн:
- Все задачи mts привязаны к ядру 0, вместе с тиком vblank на приоритете 10, так что тик вытесняет игру так же, как это делало прерывание PSX. Вывод на LCD работает на ядре 1. Пересечение этих назначений вызывало гонки, которые оживляли припаркованные задачи посреди стека. Один лог показал две копии
Main(), чередующиеся строка за строкой. - Новая задача приостанавливает себя в своём трамплине.
xTaskCreateс последующимvTaskSuspendне атомарны, и на двух ядрах задача запускалась до того, как её управляющий блок был заполнен. - Критические секции настоящие. Каждая задача имеет абсолютный флаг, сохраняемый и восстанавливаемый при каждом переключении, как регистр состояния MIPS. Это флаг, а не счётчик, потому что игра вызывает
ExitCriticalSectionбез соответствующегоEnter. - Тик запускает колбэк mts только пока активна задача простоя (11). Эта задача — консольный цикл SIO Konami, единственный код, который никогда не трогает состояние планировщика. На консоли он работал с включёнными прерываниями именно по этой причине. Игра проходит через простой каждый кадр, поэтому задержка пробуждения остаётся меньше кадра. Это изменение устранило периодические зависания у источника, тогда как более ранние версии на основе флагов лишь сужали окно гонки.
mts_GetTcbEntry также читал таблицу таблиц BIOS по фиксированному адресу 0x100 и писал через результат. Вне PSX по этому адресу находится мусор, поэтому теперь используется приватная таблица TCB.
Тик vblank и двое часов
port/esp32_vblank.c вызывает колбэк VSync игры каждые 16 мс. Для этого потребовалось реализовать VSyncCallback() в psyz, где он даже не сохранял указатель.
VSync(-1) должен возвращать свободно идущий счётчик vblank. Первая версия возвращала количество представленных кадров, которое перестаёт расти, когда ничего не рисуется, поэтому ни один таймер никогда не истекал.
Частота кадров варьируется: 2 vblank на кадр в коридоре, 4–5 в открытой комнате. Из-за этого две вещи, которые выглядели как дело vblank, на самом деле принадлежат кадру игры:
- Удержания клавиш последовательного порта уменьшаются в
DG_ActFirst, сразу послеGV_UpdatePadSystem, единственной точки, означающей «кадр прочитал геймпад». Подсчёт vblank там либо уводил Снейка слишком далеко, либо отпускал клавиши до того, как игра их видела. - LCD отправляет кадр только когда изменился номер последовательности, увеличенный в
DG_SwapFrame, с запасным вариантом в 250 мс.
Размещение памяти
Внутренняя SRAM скудна и быстра. PSRAM обильна и медленна. Чтения из флеша отключают кэш, от которого также зависит PSRAM.
- Карта RAM игры висит на одном define,
MEM_BOTTOM. Обе арены пакетов, куча и буфер секторов libfs получаются из неё вычитанием. Она перемещена на статический массив в PSRAM (mgs_main_ram[0xC9000],EXT_RAM_BSS_ATTR). Она должна быть статической, потому чтоRESIDENT_BOTTOMиспользуется как статический инициализатор, что исключаетmalloc. - 1 МБ PSX VRAM живёт в PSRAM. Без
EXT_RAM_BSS_ATTRdram0 переполняется примерно на 900 КБ. - Стеки задач ходили туда-сюда.
- Стеки по 32 КБ из внутренней SRAM заставили четвёртый
xTaskCreateтихо провалиться (см. «Дедлок приоритетов, который оказался провалившимся malloc»). - Стеки, перемещённые в PSRAM, работали, пока задача не вызывала
fopen. Драйвер флеша отключает кэш, задача теряет собственный стек, и SoC перезагружается без вывода паники. - Теперь стеки по 20 КБ во внутренней SRAM. Отметки высокого уровня показывают, что пять задач используют около 2 КБ, а одна — 14 484 Б.
- Стеки по 32 КБ из внутренней SRAM заставили четвёртый
- Заглушка с неправильным типом попадает в read-only флеш.
_spu_transferCallback— это указатель на функцию. Объявление его как функции поместило его в.text, поэтому первое= 0привело к краху. Я нашёл это, запустивnmна работающем ELF на основе psyz и на этом, сравнив их с помощьюcommи перечислив символы, которые тамB/D, а здесьT.
Один класс багов существует только на этой карте памяти: проверки указателей на основе знакового бита. MGS отличает указатель на блок скрипта от 16-битного id процесса с помощью proc_id < 0. PSX RAM находится по адресу 0x8xxxxxxx, что как знаковое значение отрицательно. PSRAM находится по адресу 0x3Cxxxxxx, что положительно. Результатом было PROC 3C1987D2 NOT FOUND, за которым следовал LoadProhibited по адресу EXCVADDR 0x00000003. Макрос GCL_IS_BLOCK_PTR исправляет место, которое было затронуто. Другие места с тем же паттерном всё ещё нуждаются в аудите.
Виртуальный CD поверх FAT
libfs работает с абсолютными секторами. Он читает каталог ISO9660 один раз и больше никогда не использует имя файла. port/virtual_cd.c заменяет CD BIOS:
- Каждый файл получает синтетический диапазон из 1 000 000 секторов, так что номер сектора отображается обратно в (файл, смещение) с помощью деления.
CDBIOS_ReadRequestдоставляет данные сектор за сектором и вызывает колбэк после каждого сектора. Колбэк может перезаписать оставшийся размер.FS_CdStageFileInitзависит от этого, чтобы узнать размер таблицыSTAGE.DIRиз её первых 4 байт. Обращение с запросом как с простым побайтовым копированием и игнорирование колбэка заставляло каждый поиск стадии возвращатьNOT FOUND.- Доставка должна быть асинхронной. Парсер и «диск» — это корутины, разделяющие одно окно буфера. Доставка всего сразу позволяла файлу 2 перезаписать файл 1 до того, как он был разобран.
ReadRequestтеперь только записывает запрос, аReadSyncпрокачивает секторы, пока колбэк не вернёт 2 («буфер перенаправлен»).
Данные сначала жили в PSRAM, что ограничивало игру горсткой стадий. Настоящим решением стала microSD. Карта — это SPI-периферия, отдельная от XIP-флеша, поэтому её чтение не отключает кэш инструкций. Файлы остаются на карте и не стоят PSRAM.
- Полный
STAGE.DIRразмером 71 892 992 байта (все 96 стадий) читается по требованию. - Из 93 файлов стадий 65 имеют полностью символьные таблицы актёров. Остальные 28 всё ещё содержат сырые адреса MIPS, потому что их код актёров не декомпилирован.
- Генератор строит одну дедуплицированную таблицу актёров и белый список: 56 стадий и 149 классов актёров. Команда смены стадии в скрипте проверяет белый список, пока текущий мир ещё цел.
Карта и LCD делят SPI2, и ESP-IDF не арбитрирует между ними. Один кадр LCD — это 30 поставленных в очередь асинхронных передач, поэтому чтение карты посреди кадра вызывало assert failed: spi_hal_iram.c:134 и цикл перезагрузки. Исправление — явное владение шиной (Mgs_SpiBusTake/Give), слив передач в полёте перед освобождением шины.
Метод — измеряй, а не угадывай
Примерно треть очевидных объяснений в этом проекте оказалась неверной. Работало то, что заставляло плату напечатать число, которое решает спор между гипотезами. Самые полезные уроки дали пробы, которые давали неверные ответы:
- Счётчик, который никто не инкрементирует, выдумывает находку.
[trap] scanning 63 triggers, 0 entered so farчуть не стало выводом «система триггеров мертва». В счётчике не было++. С настоящим счётчиком триггеры срабатывали с первой секунды. - Тавтологическая проверка даёт ложную уверенность. Аудит скелетов сравнивал
|R·t|с|t|. Они равны для любого поворота, поэтому проверка оставалась зелёной неделями, пока каждый скелет был деформирован (см. «Строгий алиасинг удалил поворот»). - Проверь, куда записывается поле, прежде чем его интерпретировать.
eye_inv.tвыглядит как позиция камеры, но это повёрнутый вектор направления. Прочтение его как позиции породило подробную, но ложную историю о камере, улетающей прочь. - Держи пробу широкой, пока данные её не сузят. Я отфильтровал пробу полноэкранных примитивов до неоттекстуренных примитивов, исходя из идеи, что у вспышки нет текстуры. У конуса прожектора она есть.
- Разделяй счётчики по причине. «65% швов устарели» — это четыре причины в одной корзине, и большая из них — безвредные корневые объекты. После разделения моё исправление сработало ноль раз, и я его удалил.
- Инструментируй всех N писателей. Когда
DG_UnDrawFrameCount = 0x7fff0000затемнил экран, я дважды угадал неверно. Пометка четырёх писателей строкой"file:line"сразу назвалаgame/gamed.c:476. - Декодируй данные, прежде чем подозревать интерпретатор. Скрипт дока, казалось, выполнял одну команду. Декодирование розничного байткода показало 19 узлов, из которых печатает только один (см. «Пустой док был двухпроходным скриптом»).
- Проверь, что проба есть в бинарнике. Хлебная крошка, читавшаяся как «(nothing)», никогда не была вставлена, потому что скриптовый
str.replaceмолча не сработал. Ищи строку черезgrepв.bin. - Используй аппаратные точки наблюдения для блуждающих писателей.
esp_cpu_set_watchpoint(0, addr, 4, STORE)показал, что около 230 рассинхронизаций GPU исходили изDG_PcxRead4Bpp— декодера текстур, чей временный буфер перекрывался с живыми пакетами. - Относись с подозрением к внезапным улучшениям. Когда карта не смонтировалась, плата откатилась к 9 стадиям во флеше, и время загрузки упало с 693 до 21 vblank. Это выглядит как ускорение в 35 раз, но означает, что карта отсутствует. Сначала проверь
microSD mountedиtable_size 1152 -> 96 stages.
Запуск каждой сборки без прошивки платы
Этот метод работает, только когда попытка обходится дёшево, а после нескольких часов проб и ошибок прошивать плату после каждого изменения было совсем не дёшево: записать образ в XIAO по USB, дождаться перезагрузки, прочитать последовательный лог, и снова. Поэтому для запуска и проверки каждой сборки я использовал velxio-cli, клиент командной строки Velxio. Он берёт тот же .bin, что собрал мой тулчейн, запускает его на симулированном ESP32-S3 в Velxio на фиксированное симулированное время и возвращает вывод последовательного порта, так что пробы, описанные выше, можно было читать, не трогая железо. Новый образ в плату попадал только тогда, когда сборка того стоила.
# 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 .
Установка и первый запуск занимают несколько минут: см. быстрый старт velxio-cli.
Баги

Строгий алиасинг удалил поворот
- Симптом: у каждого персонажа руки были оторваны от туловища, колено выгнуто назад, а ступни указывали в разные стороны. Мир при этом был в порядке.
- Тупиковые пути:
- «Исправление»
MulRotMatrix, которое сделало всё намного хуже и было откачено. - Шаг модели, доказанный равным 88 байтам из данных тремя независимыми способами.
- Устаревшие швы, измеренное влияние которых оказалось нулевым.
- Дамп замороженной rest-позы поместил все 16 суставов в пределах миллиметра от позиций, декодированных с диска, с
det = 4096иd2 == wantна каждой кости.
- «Исправление»
- Почему эти проверки не заметили проблему: в rest-позе каждый поворот является единичным,
d2 == want— тавтология, аdetпроверяет блок 3x3, который был корректен. - Что её поймало: позиции суставов в двух разных кадрах. Смещение от родителя к потомку оставалось идентичным байт в байт, пока родитель поворачивался на 19 градусов.
- Первопричина:
CompMatrixзаписывал трансляцию через(VECTOR*)&tmp.t[0]поверхlong[3]. GCC 14 при-O2заключил, что никто не читает эти записи, и удалил вызов. В дизассемблере не было инструкций умножения. Он вычислялm2->t = m0->t + m1->t. - Исправление: арифметика
long longбез type punning, плюс-fno-strict-aliasingдля всей игры. Второй идентичный случай существует вlibdg/display.c:318, так что флаг — это настоящая защита. Аудит[rig]теперь проверяет каждый скелет, используя масштабно-инвариантные отношения к самой длинной кости: проверено 14 416 суставов, 0 плохих.
Белый экран: пять неверных гипотез, три реальные причины
- Симптом: когда враг замечал Снейка, белая пелена покрывала сцену. HUD всё ещё просвечивал, и были цветовые вспышки.
- Гипотезы, опровергнутые измерением:
- Полноэкранная вспышка. Зонд залогировал 0 строк.
change camera -1как ошибка. Это сигнальное значение «здесь нет фиксированной камеры», и трактовка его как ошибки замораживала камеру за игроком.- Убегающая камера. Это было неверно прочитанное
eye_inv.t; реальная позиция была стабильной. - Переполнение очереди отрисовки. Исправление отсечения сократило число отрисованных моделей с 25 093 до 14 054, а белый экран остался.
setlen(pack, z_idx >> 8)вdivide.c.setlenприводит кu_char, так что не может дать длины вроде0x2E000000.
- Причина 1:
SetDrawStpделал((u_long*)p)[1] = 0xE6000000 | stp. В psyz слово 1 — этоlen, а команда должна быть вcode[0]. Читатель видел пакет длиной в миллиарды слов, отбрасывал его и возобновлял работу посреди примитива, декодируя вершины как команды. Это срабатывало в бою, потому что именно вспышки выстрелов и дым включают полупрозрачность. psyz уже исправил ту же ошибку в своёмsetDrawTPage, но никто не проверил игрового двойника. После исправления: 0 отброшенных, 0 рассинхронизаций. - Причина 2:
DG_MakePrimникогда не инициализировал длину. Это исправлено в одном месте путём выводаlen = psize/4 - 2и проверки результата против макросов psyz (FT4 даёт 9, GT4 даёт 12, TILE даёт 3). - Причина 3, отсутствующее аппаратное правило: как только текстурированные примитивы были включены, зонд показал
[cover] code 3E abe 1 tex 1 box -1024,-1024..142,66, что является пределом насыщения GTE. Полигоны, пересекающие пространство за камерой, прибиваются туда как квады, охватывающие весь экран. GPU PSX отказывается от любого полигона размером больше 1023x511, и игра полагается на это. Наш растеризатор их рисовал: 27,8 млн текселей на 120 кадров, около трёх экранов на кадр, и 142 мс растеризации. Тест размера теперь выполняется вsoft_raster.inc.cдо отсечения, потому что отсечение уменьшило бы полигон до размера экрана и скрыло бы само проверяемое свойство.
Исправление отсечения из гипотезы 4 было реальным, хотя и не было причиной. Тест ограничивающего прямоугольника обрабатывал прямоугольник, пересекающий ближнюю плоскость, так же, как полностью находящийся за ней. Разделение этих двух случаев снизило kept-saturated с 16 090 до 4 947. Более ранняя попытка опиралась на насыщенные координаты, и она спасла 97% всего, что отверг тест экрана (+40% растеризации), потому что большая далёкая стена тоже насыщается. Прямой запрос о Z (SZ <= H/2) дал 1 440 вместо 15 000.
Square0 сдвигал на 12 бит: каждая дистанция /64
Снейк делал три шага, ударялся в стену, отскакивал и никогда не продвигался. Первым подозреваемым была частота кадров. Одно наблюдение исключило её: мир двигался нормально, и только игрок — нет. Зонд в GM_ActControl показал шаг +4481, за которым следовал отскок -14641.
В PSY-Q числовой суффикс — это сдвиг: Square0 не сдвигает, а Square12 сдвигает. Square0 в порте сдвигал на 12, поэтому каждая длина Square0 -> sum -> sqrt получалась /64. Это сломало:
- Движение и коллизии.
- Дальность обзора врагов.
- Пули.
- Инфракрасный сенсор.
- Затухание света.
Удаление сдвига сделало траекторию монотонной.
Пять опкодов GTE, скопированных не из той строки
Снейк выпал из мира (Y = -3250), движение застряло на 0,1 за кадр, а в доке не было воды. Psyz_GteRtv0/Rtv1/Rtv2/Ll/Llv0 из psyz использовали опкоды MVMVA из неверной строки собственной таблицы inline_n.h MGS. «Повернуть этот вектор» превратилось в «повернуть его и добавить устаревшую трансляцию», а освещение использовало матрицу поворота вместо матрицы света.
После исправления:
- Устойчивый шаг
27,0. - Y = 250.
- Плавные повороты.
- Текстурированных пикселей за кадр выросло с 23 500 до 107 877.
- Вода тоже вернулась, потому что она зависит от нахождения камеры внутри объёма воды.
Пустой док был двухпроходным скриптом
В доке было лишь несколько групп объектов, и скрипт, казалось, выполнял одну команду. Реальная структура s00a — это if (var[5] < 6) { set up the Colonel's call } else { build the dock }, а proc вызова — это restart. Мир строится на втором проходе, и ответ на кодек запускает его.
Я сам замаскировал кодек, чтобы избежать краха, и это отключило каждый radio -c ... -p proc на каждом уровне. MENU_RadioDrainHeadless теперь отвечает на вызов и диспетчеризует его proc, не открывая экран кодека. Группы объектов выросли с 480 до 3 240 на 120 кадров, и область воды была создана. Урок: временная заглушка нуждается в чём-то, что заставит вас к ней вернуться.
Деление на ноль: MIPS это переживает, Xtensa перезагружается
libhzd/near.c делит на квадрат двумерной длины, который в вырожденных случаях может быть нулём. R3000 продолжает работу с неопределённым результатом. Xtensa вызывает IntegerDivideByZero, и плата сбрасывается. HZD_DIV был применён к 7 делениям на вычисляемый делитель во время выполнения. После этого 80 с ходьбы во всех четырёх направлениях — паттерн, который раньше приводил к краху, — дали 0 паник. В этом порте каждое деление на вычисляемый делитель нуждается в защите.
Зависание на 17,6 минуты
VSync из psyz усекал свой результат до 16 бит во всех режимах, но VSync(-1) должен возвращать 32-битный счётчик полей. На 65 536 полях (17,6 минуты при 60 Гц) часы mts перескочили с 64 800 на 1 064, пока задача ждала 65 537, и она ждала вечно. Исправление возвращает полный счётчик для mode < 0. Это затрагивает каждый проект, построенный на psyz. Баги, зависящие от прошедшего времени, никогда не проявляются в 60-секундных тестах.
Загрузка, которая выглядела зависшей
Часами загрузка казалась застрявшей. mts_printf от Konami был пустой заглушкой на PSX, и мой #define printf mts_printf отправлял весь вывод игры в неё, так что загрузка шла молча. Как только mts_printf стал вызывать vprintf, лог показал, что игра дошла до memcard_init(). Прежде чем диагностировать зависание, убедитесь, что вывод куда-то идёт.
Дедлок приоритетов, который оказался неудачным malloc
Файловый демон (задача 10) так и не получал процессорного времени, и трассировка выглядела как дедлок приоритетов. Два реальных исправления (семантика ChangeThFromISR и часы VSync(-1)) ничего не изменили. Затем одна строка всё решила: [thread] OpenTh: xTaskCreate failed.
Я поднял стеки до 32 КБ, FreeRTOS берёт их из внутренней SRAM, и четвёртая задача не поместилась. OpenTh вернул -1, и ChangeTh навсегда отвергал этот tid. На этом SoC всегда проверяйте возвращаемое значение xTaskCreate, даже при свободных мегабайтах PSRAM.
Чёрный экран после добавления данных катсцен
Копирование DEMO.DAT, VOX.DAT и ZMOVIE.STR на карту превратило экран в чёрный: 720 кадров, 0 паник и ноль отправленных примитивов.
Код смены уровня ждёт GM_StreamStatus() == -1. Поток DEMO.DAT катсцены никогда не продвигался, потому что виртуальный CD обслуживает чтение секторов, но не путь непрерывного потокового кольцевого буфера. До появления файлов поток отвергался рано, и всё продолжало работать.
Текущая обработка:
- Все входные потоки отклоняются в
NewStreamControlпутём запуска их колбэка, со сторожевым таймером на 600 кадров в качестве страховки. Это стоит катсцен и голосов, и это даёт игру, в которую можно играть. - Записанный ввод с геймпада катсцены начинался сразу, и Снейк уходил сам по себе. Это воспроизведение теперь пропускается так же, как игра пропускает его по START.
- FMV также отклоняется, потому что в psyz нет декодера MDEC.
Баги поменьше
PSX_Wбыл равен 256, унаследовано из кода, который я переиспользовал. MGS рендерит 320 столбцов, так что пятая часть изображения терялась. Проверяйте каждую унаследованную константу.- Гонка при загрузке: тик читал USB-серийный порт до установки драйвера, вызывая
LoadProhibitedв 2 из 6 измеренных загрузок. - Сбрасыватель кадров Konami: два актора читали флаг пропуска в разные моменты, поэтому буферы менялись местами неотрисованными, и экран мерцал. Оба флага принудительно устанавливаются в 0 под
__psyz. Тяжёлые сцены теперь идут медленнее вместо мерцания. - «Сломанная коллизия»: отталкивания от стен измерялись около 452 при радиусе 450, что абсолютно верно. При 8–10 fps коррекция на 450 единиц просто выглядит как прыжок.
Производительность
Время растеризации — это счётчик esp_timer в растеризаторе, просуммированный за 120 кадров в одной и той же позиции.
Первый проход был в s07a, небольшой комнате. Общее время растеризации упало с 923 000 до 903 900, затем до 794 000, затем до 741 700 мкс (с 7,69 до 6,18 мс на кадр). Три шага:
SOFT_RASTER_IRAMбыл пуст в сборке MGS, поэтому циклы на каждый пиксель выполнялись из флеша. Должно бытьIRAM_ATTR. Исправление дало -2%.- PSRAM и флеш на 120 МГц дали -12%. Сначала я заключил, что эта плата не способна на это. Ошибка “FLASH and PSRAM Mode configuration are not supported” означает лишь отсутствие
CONFIG_IDF_EXPERIMENTAL_FEATURES=y. ПроверьтеCONFIG_SPIRAM_SPEED 120в сгенерированномsdkconfig.h. - Сканирование работало на 62,5 Гц для игры с 30 fps. Половина отправок повторно передавала то же изображение, каждая из них читала около 120 КБ из PSRAM и вытесняла текстуры растеризатора на другом ядре. Согласование с частотой игры дало -6,6%.
Док (s00a) гораздо тяжелее. Профилирование там показало 46 400 текстурированных и 71 680 плоских пикселей на кадр: 40,9 мс растеризации плюс около 25 мс логики и GTE, что составляет примерно 15 fps. README в настоящее время указывает около 15 fps для дока с врагами. Документ статуса даёт от 8 до 15 fps в зависимости от сцены, против цели в 30.
32-битный быстрый путь для плоских заливок дал всего 2%. Затраты — в текстурированных пикселях, примерно 207 циклов на каждый. 2D-игра работает на том же растеризаторе гораздо быстрее: тайлмап обходит текстуры по прямой линии, и одна 64-байтовая строка кэша обслуживает 128 пикселей. В повёрнутых треугольниках MGS и U, и V меняются на каждом пикселе, и почти каждый пиксель — это промах кэша. Кэш данных уже на своём максимуме в 64 КБ.
Следующий шаг — перенести горячие страницы текстур во внутреннюю SRAM, что, по оценке документа статуса, даст ускорение в 40 раз. Для этого нужны примерно 90 КБ, запертые в раздутых стеках mts (24 КБ для большой задачи и 6 КБ для остальных). Уменьшение текстур не вариант, потому что UV-координаты запечены в моделях.
Загрузка тоже медленная: около 11,5 с для 1,1 МБ с карты (примерно 95 КБ/с).
- Пакет из 128 секторов вместо 16 дал всего 7%.
- Карта надёжна на 20 МГц на плате Waveshare. На 40 МГц она даёт ошибки CRC.
- Пропуск избыточных вызовов
fseekреализован, но ещё не измерен.
Запуск портативной консоли

Портативная консоль собрана из:
- XIAO ESP32S3 Sense, чья плата расширения предоставляет слот microSD.
- Панели ILI9341 SPI.
- Подвеса дрона-контроллера.
- 8 кнопок: 6 на резисторной лестнице на одном выводе ADC, плюс огонь и прицеливание на своих выводах, потому что лестница регистрирует только одну кнопку за раз.

Используются все 11 выводов XIAO. Схема подключения задокументирована в руководстве по аппаратному обеспечению. Заметки по запуску:
- Отсутствующая земля. Панель светилась белым и меняла яркость при отправке данных, потому что питалась через защитные диоды на своих входах. До этого измерения исключили схему подключения, импульс сброса, напряжение питания и настройку SPI. Ещё один мой баг стоил двух раундов: скриптовое редактирование, предназначенное для вставки
lcd_bus_init(), молча не сработало, и панель была перепаяна напрасно. - ILI9341, а не ILI9488. План предполагал ILI9488 480x320, который по SPI принимает только 3-байтовый RGB666. Мой более ранний проект с той же панелью показал, что это ILI9341 с разрешением 320x240. Это было лучше, чем планировалось: нативное разрешение, без масштабирования, 2 байта на пиксель. Порядок цветов был проверен тремя помеченными полосами R/G/B одновременно.
- RST на реальном выводе. С RESET, подключённым к 3V3, и только программным сбросом ILI9341 запускался ненадёжно, поэтому RST был перенесён на D4. D4 был свободен, потому что CS карты — это GPIO21, внутренний для платы Sense. Веб-поиск дал неверные выводы SD. Ошибка была
ESP_ERR_INVALID_ARG, ошибка конфигурации, а не ошибка карты, что указало на официальную документацию Seeed. - Кнопки и потенциометры. Подключайте 4-выводные переключатели по диагональным выводам, иначе одна кнопка читается как постоянно нажатая. Для потенциометров:
- Показание, зафиксированное на 0 или 4095, означает, что провод на внешнем выводе.
- Показание, застрявшее на середине шкалы, означает, что у потенциометра нет 3V3/GND.
- Широкий диапазон означает, что ось здорова.
- Калибровка стика. Подвес в покое находится на 2317, а не на 2048, и X проходит от 141 до 2888.
- Центр — это показание в покое при загрузке, и каждая половина масштабируется по ходу, наблюдаемому в этом направлении.
- Мёртвая зона — 60 отсчётов (примерно в 4 раза больше измеренного шума +/-15), вычитается с обеих сторон, чтобы движение начиналось плавно.
- Каждая ось усредняет 8 показаний, и обе оси инвертируются в программном обеспечении.
- Накопленные с момента загрузки min/max здесь бесполезны, потому что плавающий вход касается 0 и 4095 при включении питания. Используйте скользящее окно.
- Чтения ADC в тике vblank замораживали всё. 24 преобразования за тик останавливали тик и все задачи mts. Предупреждение уже было написано в
esp_input.c. Теперь задача на ядре 1 опрашивает каждые 10 мс и публикует три целых числа. printfчерез нативный USB блокируется, когда ни один хост не вычитывает его (UART — нет). MGS печатает много, поэтому заблокированная печать останавливала кооперативный планировщик.port/mgs_printf.hпишет с нулевым таймаутом.- Пары тактовых частот. PSRAM на 120 МГц с флешем на 80 МГц — это неподдерживаемая пара MSPI, и сбой выглядит как баг инструментальной цепочки. XIAO пока работает на 80/80, и 120/120 — следующее, что нужно измерить.
- SPI панели. С соединительными проводами панель стабильна на 40 МГц. На 80 МГц полосы изображения смещаются в сторону.
MGS теперь загружается на портативной консоли, монтирует карту, загружает док и играет без паник, с частотой кадров, которую README описывает как похожую на плату Waveshare.
Что пока не работает
- Вызовы кодеков. Группа лиц размером 417 792 байта теперь загружается из статического резерва PSRAM, потому что пул игры отказывает в выделении. Индекс
RADIO.DATвсё ещё неверен: вычисленный начальный сектор — 31 392, а в файле 867 секторов. Входное значение плохое; арифметика в порядке. Включение настоящего экрана кодека также вызывает панику внутриprintf. - Интро. Загрузка через экран заголовка дала 11 паник. Последняя строка перед первой была
this memcard is OK. Заплыв и брифинг требуют карту памяти, потоковую передачу с CD и кодек. - Лифт. Пробы в обоих конструкторах лифта молчат всю сессию, поэтому скрипт этапа никогда его не запрашивает. Вероятная причина, пока не доказанная, — сюжетная переменная, которую продвигает только вызов кодека.
- Потоковая передача с CD (катсцены, голоса), FMV (нет MDEC), аудио и сохранения на карту памяти.
- 28 этапов, код актёров которых всё ещё является ассемблером MIPS.
- Производительность выше примерно 15 fps.
Следующие шаги
- Привести стеки mts к правильному размеру и перенести горячие страницы текстур во внутреннюю SRAM.
- Измерить тактовые частоты памяти 120/120 МГц на XIAO.
- Исправить индекс
RADIO.DAT, затем проверить, последует ли за этим лифт. - Реализовать потоковую передачу в виртуальном CD, чтобы вернуть катсцены и голоса.
- Добавить аудио через программный SPU.
- Убрать отладочные пробы.
Заключение
PlayStation терпит каламбуры типов, деление на ноль, чтения за пределами массивов и указатели, проверяемые на знак. Современный компилятор и процессор не терпят ничего из этого. Подход, который сработал в этом порте, — проектировать каждое измерение так, чтобы оно могло провалиться.