
私は子供の頃からMetal Gear Solidが大好きでした。小さなESP32-S3ボードを手に入れたとき、ひとつの疑問が頭から離れませんでした。こんなに小さなものでPlayStationのゲームが動くのだろうか?

使用したボードはSeeed Studio XIAO ESP32S3 Senseです。デュアルコアESP32-S3に8 MBのPSRAMと8 MBのフラッシュを搭載し、モジュールサイズは21 × 17.8 mmです。SenseバージョンにはカメラとmicroSDスロットを備えた拡張ボードが付属しており、ゲームのデータはこのmicroSDスロットに置かれています。
答えを見つけるまでにかなりの時間を費やしました。まず、PC上で動作するCコードとしてすでに再構築されたバージョンのゲームを探し、次にそのロジック全体がESP32-S3のフラッシュとmicroSDカードに収まるかどうかを確認しました。何度か試行錯誤しましたが、最終的にはうまくいきました。素晴らしいゲームが、約15米ドルのマイコンボード上で動作するようになったのです。
携帯機でのゲームプレイ — YouTubeで視聴する。
本記事では、Metal Gear Solid(PlayStation、1998年)がESP32-S3上でネイティブ移植としてどのように動作するかを解説します。FoxdieTeamのmgs_reversing逆コンパイルプロジェクトによって再構築されたゲームのCソースは、Xtensaマシンコードへ直接コンパイルされます。かつてPlayStationのハードウェアが提供していたものはすべて、ソフトウェアで置き換えられています。
- SDK
- GPU
- GTEジオメトリコプロセッサ
- CDドライブ
- 垂直帰線割り込み
- コントローラ
本記事では、ハードウェア、プラットフォーム層、メモリ配置、デバッグ手法、最も重要だったバグ、性能、携帯機、そしてまだ動作しないものについて扱います。
コードと関連プロジェクト:
- MGS移植 — davidmonterocrespo24/mgs_reversing、ブランチ
esp32-port。 - 携帯機ハードウェアガイド — HARDWARE.md。
- psyzフォーク — davidmonterocrespo24/psyz。
自分のディスクが必要です。リポジトリにはゲームから派生したものは一切含まれておらず、port/extract_disc.pyが自分のディスクイメージからファイルを抽出します。
ハードウェア

ESP32-S3は240 MHzで動作する2つのXtensaコアと512 KBの内蔵SRAMを備えています。ここで使用した両ボードには8 MBのPSRAMも搭載されており、フラッシュと同じキャッシュの背後に配置されています。
| Waveshare ESP32-S3-Touch-LCD-2 | DIY携帯機(Seeed XIAO ESP32S3 Sense) | |
|---|---|---|
| パネル | ST7789、320x240 | ILI9341、320x240ネイティブ |
| フラッシュ | 16 MB | 8 MB |
| ゲームデータ | microSD、またはフラッシュ内のトリミング済みSTAGE.DIR | microSD(完全なSTAGE.DIR) |
| 入力 | シリアル経由のキーボード(play.py) | ドローンジンバルスティック、6ボタン抵抗ラダー、2つの直接ボタン |
コードを書く前にギャップを測る
移植コードを書く前に、逆コンパイル版がXtensa向けにビルドするまでどれだけ離れているかを測定しました。
- エンジンライブラリ(libgv、libdg、libgcl、libhzd、libfs)は、psyzのヘッダーに対して
xtensa-esp32s3-elf-gcc14.2でほぼ一気にコンパイルできました。58ファイル中57ファイルです。 - それらの中に絶対アドレス
0x800xxxxxは含まれていません。 - すべてのグラフィックス出力は11個のlibgpu呼び出し(
DrawOTag、LoadImage、ClearOTagRなど)を通ります。これはまさにpsyzのソフトウェアレンダラが置き換える層です。
失敗した1つのファイルlibdg/chanl.cは、意図的に失敗させたままにしました。警告を黙らせるためのキャストは、ストライドを暗黙的に変えてしまうからです(後述のオーダリングテーブルのセクションを参照)。
残りは機械的なパスで対応し、それぞれが問題のクラス全体を解決しました。
-std=gnu17と-mlongcallsはどちらも必須です。GCC 14のデフォルトであるgnu23はこのコードを拒否し、Xtensaのcall8は±512 KBしか届きません。- psyzとMGSはどちらも
common.hを持っているため、MGSのインクルードパスを先に通す必要があります。 - GCC 2.x拡張である12個のcast-as-lvalue式を書き換えました。
- MGSはlibcの
printfを独自のスタブで置き換えています。これをmts_printfにリネームしましたが、これが後に最も紛らわしいバグの1つを引き起こしました(「ハングしたように見えたブート」を参照)。 - 16ファイルに散在する346個のリテラルスクラッチパッドアドレス(
0x1f8000xx)をSCRPAD_ADDR + offsetに置き換え、配列で裏付けました。
結果は497ファイル中497のCファイルがXtensa向けにコンパイル成功でした。ELFは未定義参照0、重複定義0でした(text 987,073 B、bss 2,434,276 B)。ゲーム自身のメモリは804 KiB(428 KiBのヒープと2つの188 KiBパケットバッファ)で、PSRAMに余裕を持って収まります。
アーキテクチャ
この移植には、ゲームとSoCの間に3つの層があります。
ゲームからハードウェアまでの層は次のとおりです。
- MGSエンジン — 逆コンパイルされたC、Xtensaへコンパイル
- psyz — CによるPlayStation SDKとGTE、ソフトウェアラスタライザ
- プラットフォーム層 — FreeRTOS上のmtsスケジューラ、vblankティック、仮想CD、LCD、入力
- ESP32-S3
psyzとGTE
psyzはXeeynamoによるPlayStation SDKの再実装で、GTEのレジスタファイル全体とすべてのGTE命令をすでにCでモデル化しており、PCSX-ReduxのGTEテストスイートで検証済みでした。
当初の見積もりでは、不足しているマクロは64〜70個でした。この見積もりは過大でした。MGSは独自のMIPSインラインアセンブリヘッダ(inline_n.h、inline_x.h)を同梱しており、-fsyntax-onlyはレジスタ名をチェックしません。これらのヘッダをpsyzへ振り向けた時点で、実際の不足は41マクロでした。各マクロがどのCOP2レジスタに触れるかの仕様としてゲーム自身のアセンブリを使い、それらをpsyzに追加しました。その後、修正したpsyzに対して他のpsyzベースのプロジェクトを再ビルドし、何も壊れていないことを確認しました。
GTEマクロをエイリアスするときは、各制約が入力か出力かを確認してください。たとえばgte_read_opzは"=r"出力を持つので、そのエイリアスは&xを取る必要があります。
オーダリングテーブルのタグ — PSXでは1ワード、psyzでは2ワード
これが最も重要なレイアウトの違いであり、最も多くのバグを引き起こしました。PlayStationでは、すべてのプリミティブは1つの32ビットタグで始まります。次のプリミティブのアドレス24ビットと、長さ8ビットです。ホストのポインタは24ビットに収まらないため、psyzは2ワード、tagとlenを使います。すべてのプリミティブは4バイト増え、タグ以降のすべてのフィールドは1ワード分ずれます。
MGSはさらに長さバイトを悪用します。libdgは16ビット深度に対して2パスの基数ソートを実行します。
divide.cが下位バイトでバケット分けし、上位バイトをタグの長さに退避します。sort.cがその上位バイトで再度バケット分けし、実際の長さを書き込みます。
psyzは2つのフィールドを分離しているため、変換は正確です。
pack->tag = (hi << 24) | *ot; *ot = pack; /* PSX */
addPrim(ot, pack); setlen(pack, hi); /* psyz */
42個のローカル宣言と100個のパラメータをOT_TYPE*へ書き換えるのは簡単な部分でした。難しかったのは、パックされたレイアウトを前提としていることを明示せずに仮定していたコードです。
DG_PrimInfosは最初の頂点を+12ではなく+8に置いていました。LinkModelToParentは親頂点オフセットを*56 + 12ではなく*52 + 8として事前計算していました。- 後述の「白画面」で説明するプリミティブコンストラクタ。
さらに厄介な要素があります。コンソールではaddPrim()が挿入のたびにタグワード全体を書き換えていたため、長さの設定忘れは決して気づかれませんでした。psyzでは、設定されなかった長さは単に書き込まれません。
FreeRTOS内のKonami製スケジューラ
MGSはKonami独自の協調スケジューラ上で動作します。起動バナーには今もMulti Task Scheduler for PSX ver2.02 Jul 11 1998と表示されます。これはBIOSのスレッドAPI(OpenTh/ChangeTh)上に位置し、vblank割り込みを使ってタイマーが期限切れになったタスクを起床させます。
移植では、各mtsスレッドはFreeRTOSタスクであり、同時に実行可能なのは常に1つだけです。最終的な設計は次のとおりです。
- すべてのmtsタスクはコア0に固定され、優先度10のvblankティックも同様です。これにより、PSX割り込みと同じようにティックがゲームをプリエンプトします。LCDスキャンアウトはコア1で動作します。これらの割り当てを入れ替えると、停止中のタスクをスタック途中で復活させる競合が発生しました。あるログでは
Main()の2つのコピーが1行ずつ交互に実行されていました。 - 新しいタスクはトランポリン内で自身をサスペンドします。
xTaskCreateの直後にvTaskSuspendを呼ぶのはアトミックではなく、2コアではタスクが制御ブロックの初期化前に実行されてしまいました。 - クリティカルセクションは本物です。 各タスクは絶対フラグを持ち、MIPSのステータスレジスタのように切り替えのたびに保存・復元されます。ゲームが
Enterと対になっていないExitCriticalSectionを呼ぶため、カウンタではなくフラグです。 - ティックはアイドルタスク(11)がアクティブな間だけmtsコールバックを実行します。 そのタスクはKonamiのSIOコンソールループであり、スケジューラの状態に決して触れない唯一のコードです。コンソールではまさにこの理由で割り込み有効のまま実行されていました。ゲームは毎フレームアイドルを通過するため、起床レイテンシは1フレーム未満に収まります。この変更により、断続的なハングが根本から解消されました。以前のフラグベースのバージョンでは競合の窓を狭めることしかできていませんでした。
mts_GetTcbEntryは固定アドレス0x100にあるBIOSのテーブル・オブ・テーブルを読み、その結果を通じて書き込みもしていました。PSXの外ではそのアドレスはゴミを保持しているため、現在はプライベートなTCBテーブルを使用しています。
vblankティックと2つのクロック
port/esp32_vblank.cは16 msごとにゲームのVSyncコールバックを発火します。そのためにはVSyncCallback()をpsyzに実装する必要があり、そこではポインタすら保存されていませんでした。
VSync(-1)はフリーランニングのvblankカウントを返さなければなりません。最初のバージョンは提示されたフレーム数を返していたため、何も描画しないとカウントが進まず、タイマーが期限切れになることはありませんでした。
フレームレートは変動します。廊下では1フレームあたり2 vblank、広い部屋では4〜5です。そのため、vblankの仕事に見えて実はゲームフレームに属する2つのものがあります。
- シリアルキーのホールドは
DG_ActFirst内、GV_UpdatePadSystemの直後でデクリメントされます。これは「フレームがパッドを読んだ」ことを意味する唯一のポイントです。そこでvblankを数えると、Snakeが歩きすぎたり、ゲームがキーを認識する前にキーが離されたりしました。 - LCDは
DG_SwapFrameでインクリメントされたシーケンス番号が変化したときだけフレームを送信し、250 msのフォールバックを持ちます。
メモリ配置
内蔵SRAMは乏しく高速です。PSRAMは豊富で低速です。フラッシュ読み出しはPSRAMも依存するキャッシュを無効化します。
- ゲームのRAMマップは1つのdefine、
MEM_BOTTOMにぶら下がっています。両方のパケットアリーナ、ヒープ、libfsのセクタバッファはそこから減算で得られます。これは静的PSRAM配列(mgs_main_ram[0xC9000]、EXT_RAM_BSS_ATTR)上に再配置されます。RESIDENT_BOTTOMが静的初期化子として使われておりmallocが使えないため、静的でなければなりません。 - 1 MBのPSX VRAMはPSRAM上にあります。
EXT_RAM_BSS_ATTRがないと、dram0が約900 KBオーバーフローします。 - タスクスタックは行き来しました。
- 内蔵SRAMからの32 KBスタックでは、4回目の
xTaskCreateが黙って失敗しました(「失敗したmallocだった優先度デッドロック」を参照)。 - PSRAMへ移したスタックは、タスクが
fopenを呼ぶまで動作しました。フラッシュドライバがキャッシュを無効化し、タスクは自身のスタックを失い、SoCはパニックを出力せずにリセットしました。 - 現在スタックは内蔵SRAMに20 KBです。ハイウォーターマークは、5つのタスクが約2 KB、1つが14,484 Bを使用していることを示しています。
- 内蔵SRAMからの32 KBスタックでは、4回目の
- 型の間違ったスタブは読み取り専用フラッシュに置かれます。
_spu_transferCallbackは関数ポインタです。関数として宣言すると.textに置かれ、最初の= 0でクラッシュしました。動作するpsyzベースのELFと本ELFに対してnmを実行し、commで比較して、あちらではB/DでこちらではTであるシンボルを列挙することで発見しました。
このメモリマップにのみ存在するバグのクラスがあります。符号ビットに基づくポインタテストです。MGSはスクリプトブロックポインタと16ビットのproc idをproc_id < 0で区別します。PSX RAMは0x8xxxxxxxにあり、符号付き値としては負です。PSRAMは0x3Cxxxxxxにあり、正です。結果はPROC 3C1987D2 NOT FOUND、続いてEXCVADDR 0x00000003でのLoadProhibitedでした。GCL_IS_BLOCK_PTRマクロが、ヒットした箇所を修正します。同じパターンを持つ他の箇所はまだ監査が必要です。
FAT上の仮想CD
libfsは絶対セクタで動作します。ISO9660ディレクトリを一度読み、その後はファイル名を二度と使いません。port/virtual_cd.cがCD BIOSを置き換えます。
- 各ファイルは100万セクタの合成範囲を取得するため、セクタ番号は除算で(ファイル、オフセット)に逆写像されます。
CDBIOS_ReadRequestはデータをセクタ単位で配送し、各セクタ後にコールバックを呼びます。コールバックは残りサイズを書き換えてよいことになっています。FS_CdStageFileInitはこれに依存して、最初の4バイトからSTAGE.DIRテーブルのサイズを取得します。リクエストを単なるバイトコピーとして扱いコールバックを無視すると、すべてのステージ検索がNOT FOUNDを返しました。- 配送は非同期でなければなりません。 パーサと「ディスク」は1つのバッファウィンドウを共有するコルーチンです。すべてを一度に配送すると、ファイル2がパース前にファイル1を上書きしてしまいました。
ReadRequestは現在リクエストを記録するだけで、ReadSyncがコールバックが2(「バッファリダイレクト」)を返すまでセクタを送り出します。
データは当初PSRAM上にあり、ゲームは少数のステージに制限されていました。本当の解決策はmicroSDでした。カードはSPIペリフェラルで、XIPフラッシュとは別であるため、読み出しが命令キャッシュを無効化しません。ファイルはカード上に留まり、PSRAMを消費しません。
- 完全な71,892,992バイトの
STAGE.DIR(全96ステージ)がオンデマンドで読み込まれます。 - 93個のステージファイルのうち、65個は完全にシンボリックなアクタテーブルを持ちます。残りの28個はアクタコードが逆コンパイルされていないため、生のMIPSアドレスを保持しています。
- ジェネレータが1つの重複排除されたアクタテーブルとホワイトリストを生成します。56ステージと149アクタークラスです。スクリプトのステージ変更コマンドは、現在のワールドがまだ無傷であるうちにホワイトリストをチェックします。
カードとLCDはSPI2を共有しており、ESP-IDFは両者の間を調停しません。1つのLCDフレームは30個の非同期転送をキューに入れるため、フレームの途中でカード読み出しが起きるとassert failed: spi_hal_iram.c:134が発火し、再起動ループを引き起こしました。修正は明示的なバス所有権(Mgs_SpiBusTake/Give)で、バスを解放する前に進行中の転送をドレインします。
手法 — 推測せず、計測する
このプロジェクトで明らかと思われた説明のおよそ3分の1は、実際には間違っていた。うまくいったのは、仮説を決定づける数値をボードに出力させることだった。最も有用な教訓は、誤った答えを返したプローブから得られた。
- 誰もインクリメントしないカウンタは発見を捏造する。
[trap] scanning 63 triggers, 0 entered so farは、もう少しで「トリガーシステムは死んでいる」という結論になりかけた。カウンタに++がなかったのだ。本物のカウンタを入れると、トリガーは最初の1秒から発火した。 - トートロジーなチェックは偽の自信を与える。 スケルトン監査は
|R·t|と|t|を比較していた。これらはどんな回転でも等しいので、すべてのスケルトンが変形している間も何週間もチェックはグリーンのままだった(「Strict aliasingが回転を削除した」を参照)。 - フィールドを解釈する前に、それがどこで書き込まれるか確認せよ。
eye_inv.tはカメラ位置のように見えるが、回転された方向ベクトルである。これを位置として読むと、カメラが飛び去るという詳細で誤った物語が生まれた。 - データが絞り込むまでプローブは広く保て。 全画面プリミティブのプローブを、テクスチャなしのプリミティブに絞り込んだ。閃光にはテクスチャがないという考えからだ。サーチライトのコーンにはテクスチャがある。
- カウンタは原因別に分割せよ。 「継ぎ目の65%が古い」は1つのバケツに4つの原因があり、最大のものは無害なルートオブジェクトだった。分割後、自分の修正は一度も発火しなかったので削除した。
- N個すべての書き込み側を計装せよ。
DG_UnDrawFrameCount = 0x7fff0000で画面が真っ黒になったとき、私は2回推測を外した。4つの書き込み側に"file:line"をタグ付けすると、game/gamed.c:476が即座に判明した。 - インタプリタを疑う前にデータをデコードせよ。 ドックのスクリプトは1つのコマンドしか実行していないように見えた。リテールのバイトコードをデコードすると19ノードあり、そのうち表示するのは1つだけだった(「空のドックは2パススクリプトだった」を参照)。
- プローブがバイナリに入っているか確認せよ。 「(nothing)」と表示されたパンくずは、スクリプトによる
str.replaceが黙って失敗したため、一度も挿入されていなかった。.bin内の文字列をgrepせよ。 - 不正な書き込み側にはハードウェアウォッチポイントを使え。
esp_cpu_set_watchpoint(0, addr, 4, STORE)により、約230件のGPUデシンクがDG_PcxRead4Bppから来ていることが判明した。これはテクスチャデコーダで、そのスクラッチバッファがライブパケットと重なっていた。 - 突然の改善は疑え。 カードのマウントに失敗すると、ボードはフラッシュ内の9ステージにフォールバックし、ロード時間は693から21 vblanksに短縮された。これは35倍の高速化に見えるが、カードが欠けていることを意味する。まず
microSD mountedとtable_size 1152 -> 96 stagesを確認せよ。
ボードに書き込まずに各ビルドを実行する
この手法は試行のコストが低いときにしか機能しません。何時間も試行錯誤を続けると、変更のたびにボードへ書き込むのは安くありませんでした。USB で XIAO にイメージを書き込み、再起動を待ち、シリアルログを読み、また最初から。そこで各ビルドの実行と確認には Velxio のコマンドラインクライアント velxio-cli を使いました。ツールチェーンが生成したのと同じ .bin を受け取り、Velxio のシミュレートされた ESP32-S3 上で決まったシミュレーション時間だけ実行し、シリアル出力を返します。おかげで上記のプローブをハードウェアに触れずに読めました。ボードに新しいイメージを書き込むのは、そのビルドにその価値があるときだけでした。
# 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 クイックスタートを参照してください。
バグ

strict aliasingが回転を削除した
- 症状: すべてのキャラクターで腕が胴体から外れ、片方の膝が逆に曲がり、足がそれぞれ別の方向を向いていた。ワールド自体は正常だった。
- 行き止まり:
MulRotMatrixの「修正」は事態をはるかに悪化させ、元に戻された。- モデルのストライドは88バイトであることが、3つの独立した方法でデータから証明された。
- 古いシームは、測定したところ効果ゼロだった。
- 凍結したレストポーズのダンプでは、16個の関節すべてがディスクからデコードされた位置から1ミリ以内に収まり、
det = 4096、すべてのボーンでd2 == wantだった。
- これらのチェックが見逃した理由: レストポーズではすべての回転が単位行列であり、
d2 == wantはトートロジーであり、detは3x3ブロックをチェックするが、それは正しかった。 - それを捕まえたもの: 2つの異なるフレームでの関節位置。親が19度回転している間、親から子へのオフセットはバイト単位で同一のままだった。
- 根本原因:
CompMatrixがlong[3]上で(VECTOR*)&tmp.t[0]を通じて平行移動を書き込んでいた。GCC 14の-O2は、これらのストアを読むものは何もないと結論し、呼び出しを削除した。逆アセンブリには乗算命令がなかった。 それはm2->t = m0->t + m1->tを計算していた。 - 修正: 型パンニングなしの
long long演算、およびゲーム全体に対する-fno-strict-aliasing。libdg/display.c:318に2つ目の同一ケースが存在するため、このフラグが真の保護である。[rig]監査は、最長ボーンに対するスケール不変比を使ってすべてのスケルトンをチェックするようになった。14,416個の関節を監査し、不良は0。
白画面: 5つの誤った仮説、3つの真の原因
- 症状: 敵がSnakeを発見すると、白いシートがシーンを覆った。HUDはまだ透けて見え、色のフラッシュがあった。
- 測定により除外された仮説:
- 全画面フラッシュ。プローブは0行を記録した。
change camera -1をエラーとして扱う。それは「ここに固定カメラなし」のセンチネルであり、エラーとして扱うとカメラがプレイヤーの後ろで凍結した。- 暴走したカメラ。それは
eye_inv.tの読み間違いであり、実際の位置は安定していた。 - 描画キューのオーバーフロー。カリング修正により描画モデルが25,093から14,054に削減されたが、白は残った。
divide.cのsetlen(pack, z_idx >> 8)。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の飽和限界である。カメラの後ろを横切るポリゴンは、画面全体に広がるクワッドとしてそこに固定される。PSX GPUは1023x511より大きいポリゴンを拒否する、そしてゲームはそれに依存している。我々のラスタライザはそれらを描画した。120フレームあたり27.8Mテクセル、1フレームあたり約3画面分、そして142msのラスタライズ。サイズテストは現在soft_raster.inc.cでクリッピングの前に実行される。クリッピングはポリゴンを画面サイズに縮小し、テスト対象のまさにその特性を隠してしまうからだ。
仮説4のカリング修正は、原因ではなかったものの、実際に効果があった。バウンディングボックステストは、ニアプレーンを横切るボックスを、完全にその背後にあるボックスと同じように扱っていた。2つのケースを分離することで、kept-saturatedは16,090から4,947になった。以前の試みは飽和座標に基づいており、画面テストが拒否したものの97%を救出した(ラスタライズ+40%)。大きく遠い壁も飽和するからだ。Zについて直接問い合わせる(SZ <= H/2)と、15,000ではなく1,440が得られた。
Square0が12ビットシフト: すべての距離が/64に
Snakeは3歩進み、壁に当たり、跳ね返り、決して前進しなかった。フレームレートが最初の容疑者だった。1つの観察がそれを除外した。ワールドは正常に動き、プレイヤーだけが動かなかった。GM_ActControlのプローブは、+4481のステップに続いて-14641のリバウンドを示した。
PSY-Qでは、数値サフィックスがシフトである。Square0はシフトせず、Square12はシフトする。移植版のSquare0は12だけシフトしていたため、すべてのSquare0 -> sum -> sqrtの長さが/64になった。これが壊したもの:
- 移動と衝突。
- 敵の視認範囲。
- 弾丸。
- 赤外線センサー。
- 光の減衰。
シフトを削除すると、軌道は単調になった。
間違った行からコピーされた5つのGTEオペコード
Snakeはワールドから落ち(Y = -3250)、移動は1フレームあたり0,1に固定され、ドックには水がなかった。psyzのPsyz_GteRtv0/Rtv1/Rtv2/Ll/Llv0は、MGS自身のinline_n.hテーブルの間違った行からMVMVAオペコードを使用していた。「このベクトルを回転」が「それを回転し、古い平行移動を加算」になり、ライティングはライト行列ではなく回転行列を使用していた。
修正後:
27,0のステップが持続。- Y = 250。
- 滑らかな旋回。
- 1フレームあたりのテクスチャ付きピクセルが23,500から107,877に増加。
- 水も戻った。カメラが水のボリューム内にあることを条件としているからだ。
空のドックは2パスのスクリプトだった
ドックにはほんの一握りのオブジェクトグループしかなく、スクリプトは1つのコマンドを実行しているように見えた。s00aの実際の構造はif (var[5] < 6) { set up the Colonel's call } else { build the dock }であり、コールのprocはrestartである。ワールドは2パス目で構築され、コーデックに応答することがそれをトリガーする。
私はクラッシュを避けるために自分でコーデックをマスクしており、それがすべてのステージのすべてのradio -c ... -p procを無効にしていた。MENU_RadioDrainHeadlessは現在、コーデック画面を開かずにコールに応答し、そのprocをディスパッチする。オブジェクトグループは120フレームあたり480から3,240になり、水エリアが作成された。教訓: 一時的なスタブには、それを再訪することを強制する何かが必要である。
ゼロ除算: MIPSは生き残る、Xtensaは再起動する
libhzd/near.cは、退化したケースでゼロになりうる2D長の二乗で除算する。R3000は未定義の結果で続行する。XtensaはIntegerDivideByZeroを発生させ、ボードはリセットする。HZD_DIVは7つの実行時除数除算に適用された。その後、4方向すべてに80秒歩行する、以前クラッシュしていたパターンで、パニックは0だった。この移植では、計算された除数によるすべての除算にガードが必要である。
17.6分のフリーズ
psyzのVSyncはすべてのモードで結果を16ビットに切り詰めていたが、VSync(-1)は32ビットのフィールドカウントを返さなければならない。65,536フィールド(60 Hzで17.6分)で、タスクが65,537を待っている間にmtsクロックが64,800から1,064にラップし、永遠に待ち続けた。修正はmode < 0に対して完全なカウントを返す。これはpsyz上に構築されたすべてのプロジェクトに影響する。経過時間に依存するバグは、60秒のテストでは決して現れない。
ハングに見えたブート
何時間もの間、ブートはスタックしているように見えた。Konamiのmts_printfはPSXでは空のスタブであり、私の#define printf mts_printfがゲームのすべての出力をそこに送っていたため、ブートは静かに進行していた。mts_printfがvprintfを呼ぶと、ログはゲームがmemcard_init()に到達したことを示した。ハングを診断する前に、出力がどこかに行っていることを確認せよ。
mallocの失敗だった優先度デッドロック
ファイルデーモン(タスク10)は決してCPU時間を得られず、トレースは優先度デッドロックのように見えた。2つの実際の修正(ChangeThFromISRのセマンティクスとVSync(-1)クロック)は何も変えなかった。そして1行がそれを決着させた: [thread] OpenTh: xTaskCreate failed。
私はスタックを32 KBに引き上げており、FreeRTOSはそれらを内部SRAMから取るため、4番目のタスクが収まらなかった。OpenThは-1を返し、ChangeThはそのtidを永遠に拒否した。このSoCでは、PSRAMが数メガバイト空いていても、常にxTaskCreateの戻り値をチェックせよ。
カットシーンデータを追加した後の黒画面
DEMO.DAT、VOX.DAT、ZMOVIE.STRをカードにコピーすると画面が黒くなった。720フレーム、パニック0、送信されたプリミティブはゼロ。
ステージ変更コードはGM_StreamStatus() == -1を待つ。カットシーンのDEMO.DATストリームは決して進まなかった。仮想CDはセクタ読み取りを提供するが、連続リングバッファストリーミングパスは提供しないからだ。ファイルが存在する前は、ストリームは早期に拒否され、すべてが続行していた。
現在の処理:
- すべての入力ストリームは
NewStreamControlで拒否され、そのコールバックを実行し、安全網として600フレームのウォッチドッグを備える。これはカットシーンとボイスを犠牲にし、プレイ可能なゲームを与える。 - カットシーンの記録されたパッド入力が即座に開始し、Snakeが勝手に歩き出した。その再生は現在、ゲームがSTARTでスキップするのと同じ方法でスキップされる。
- FMVも同様に拒否される。psyzにはMDECデコーダがないからだ。
より小さなバグ
PSX_Wが256だった、私が再利用したコードから継承された。MGSは320列をレンダリングするため、画像の5分の1が失われていた。継承されたすべての定数を監査せよ。- ブートレース: ティックがドライバのインストール前にUSBシリアルを読んだため、測定した6回のブートのうち2回で
LoadProhibitedが発生した。 - Konamiのフレームドロッパー: 2つのアクターが異なるタイミングでスキップフラグを読んだため、バッファが未描画のままスワップされ、画面がストロボのように点滅した。
__psyzでは両方のフラグが0に強制される。重いシーンは現在、ストロボではなく遅く動作する。 - 「壊れた衝突」: 壁の押し出しは半径450に対して約452と測定され、これはまさに正しい。8〜10 fpsでは、450単位の補正は単にジャンプのように見えるだけである。
パフォーマンス
ラスタライズ時間はラスタライザ内の esp_timer カウンタで、同じ位置で120フレームにわたって合計した値です。
最初の計測はs07aの小さな部屋で行いました。ラスタライズ時間の合計は923,000から903,900、次に794,000、そして741,700マイクロ秒へと減少しました(1フレームあたり7.69から6.18 ms)。3つのステップは次のとおりです。
- MGSのビルドでは
SOFT_RASTER_IRAMが空だったため、ピクセル単位のループがフラッシュから実行されていました。これはIRAM_ATTRであるべきです。修正により-2%となりました。 - PSRAMとフラッシュを120 MHzにすると-12%となりました。 当初はこのボードでは無理だと結論づけました。「FLASH and PSRAM Mode configuration are not supported」というエラーは、単に
CONFIG_IDF_EXPERIMENTAL_FEATURES=yが欠けていることを意味するだけです。生成されたsdkconfig.hのCONFIG_SPIRAM_SPEED 120を確認してください。 - スキャンアウトが30 fpsのゲームに対して62.5 Hzで動作していました。 プッシュの半分は同じ画像を再送しており、そのたびに約120 KBのPSRAMを読み込み、もう一方のコアにあるラスタライザのテクスチャを追い出していました。ゲームのレートに合わせることで-6.6%となりました。
ドック(s00a) ははるかに重いです。そこのプロファイルでは1フレームあたり46,400のテクスチャ付きピクセルと71,680のフラットピクセルが計測されました。ラスタライズに40.9 ms、加えてロジックとGTEに約25 msで、およそ15 fpsです。READMEには現在、敵がいるドックで約15 fpsと記載されています。ステータスドキュメントにはシーン別に8から15 fps、目標は30と記載されています。
フラットフィル用の32ビット高速パスはわずか2%の改善しか得られませんでした。コストはテクスチャ付きピクセルにあり、1ピクセルあたり約207サイクルです。2Dゲームは同じラスタライザではるかに高速に動作します。タイルマップはテクスチャを直線的に辿り、1つの64バイトキャッシュラインが128ピクセルに寄与します。MGSの回転した三角形では、UとVの両方がピクセルごとに変化し、ほぼすべてのピクセルがキャッシュミスとなります。データキャッシュはすでに64 KBの上限に達しています。
次のステップは、ホットなテクスチャページを内部SRAMへ移動することです。ステータスドキュメントでは40倍高速になると見積もられています。そのためには、過大なmtsスタックに閉じ込められている約90 KB(大きなタスクに24 KB、残りに6 KB)が必要です。UVはモデルに焼き込まれているため、テクスチャを縮小するという選択肢はありません。
ローディングも遅いです。カードから1.1 MBを読み込むのに約11.5秒かかります(およそ95 KB/s)。
- 16セクターではなく128セクターのバーストにすると、わずか7%の改善でした。
- Waveshareボードではカードは20 MHzで安定しています。40 MHzではCRCエラーが出ます。
- 冗長な
fseek呼び出しのスキップは実装済みですが、まだ計測されていません。
携帯機の立ち上げ

携帯機は以下から構成されています。
- XIAO ESP32S3 Sense。その拡張ボードがmicroSDスロットを提供します。
- ILI9341 SPIパネル。
- ドローンコントローラのジンバル。
- 8つのボタン。6つは1つのADCピン上の抵抗ラダーに、加えてfireとaimは専用ピンに配置しました。ラダーは同時に1つのボタンしか認識しないためです。

XIAOの11本のピンすべてを使用しています。配線はハードウェアガイドに記載されています。立ち上げ時のメモ:
- 欠けていたグラウンド。 パネルは白く光り、データを送ると明るさが変化しました。入力の保護ダイオードを通じて自己給電していたためです。その前に、計測によって配線、リセットパルス、供給電圧、SPI設定は除外していました。私のバグも2ラウンド分の時間を浪費しました。
lcd_bus_init()を挿入するはずのスクリプト編集が黙って失敗し、パネルを無駄にはんだ付けし直すことになりました。 - ILI9488ではなくILI9341。 計画では480x320のILI9488を想定していましたが、これはSPI経由では3バイトのRGB666しか受け付けません。同じパネルを使った以前の私のプロジェクトで、320x240のILI9341であることが判明しました。これは計画より良かったです。ネイティブ解像度、スケーリングなし、1ピクセルあたり2バイト。色の順序は、ラベル付きのR/G/Bストライプを3本同時に表示して確認しました。
- RSTは実際のピンに。 RESETを3V3に接続しソフトウェアリセットのみにすると、ILI9341は安定して起動しなかったため、RSTをD4へ移動しました。D4が空いていたのは、カードのCSがSenseボード内部のGPIO21だからです。ウェブ検索では誤ったSDピンが示されていました。エラーは
ESP_ERR_INVALID_ARGで、カードのエラーではなく設定エラーであり、Seeedの公式ドキュメントを指し示していました。 - ボタンとポテンショメータ。 4本足のスイッチは対角の足に配線してください。そうしないと1つのボタンが常時押下として読み取られます。ポテンショメータについては:
- 読み取り値が0または4095に張り付いている場合、配線が外側の足に接続されています。
- 読み取り値が中間スケールで止まっている場合、ポテンショメータに3V3/GNDがありません。
- 範囲が広ければ、その軸は正常です。
- スティックのキャリブレーション。 ジンバルは2048ではなく2317で静止し、Xは141から2888まで変化します。
- 中心は起動時の静止読み取り値で、各半分はその方向で見られた可動範囲でスケーリングされます。
- デッドゾーンは60カウント(計測された+/-15のノイズの約4倍)で、両側から差し引くことで動きが滑らかに始まります。
- 各軸は8回の読み取りを平均し、両軸ともソフトウェアで反転されます。
- 起動時から累積するmin/maxはここでは役に立ちません。浮いている入力は電源投入時に0と4095に触れるためです。移動窓を使用してください。
- vblankティック内でのADC読み取りがすべてをフリーズさせました。 ティックあたり24回の変換がティックとすべてのmtsタスクを停止させました。警告はすでに
esp_input.cに書かれていました。現在はコア1上のタスクが10 msごとにサンプリングし、3つの整数を公開しています。 - ネイティブUSB経由の
printfはブロックします。ホストが排出しない場合です(UARTはブロックしません)。MGSは大量に出力するため、ブロックされたprintが協調スケジューラを停止させました。port/mgs_printf.hはタイムアウト0で書き込みます。 - クロックペア。 PSRAM 120 MHzとフラッシュ80 MHzはサポートされたMSPIペアではなく、その失敗はツールチェーンのバグのように見えます。XIAOは今のところ80/80で動作し、120/120が次に計測すべきものです。
- パネルSPI。 ジャンパワイヤではパネルは40 MHzで安定しています。80 MHzでは画像の帯が横にずれます。
MGSは現在、携帯機上で起動し、カードをマウントし、ドックをロードし、パニックなしで動作します。フレームレートはREADMEがWaveshareボードと同程度と記載しています。
まだ動作しないもの
- コーデック通話。 417,792バイトのフェイスグループは、ゲームのプールが割り当てを拒否するため、静的なPSRAM予約からロードされるようになりました。
RADIO.DATのインデックスはまだ誤っています。計算された開始セクターは31,392で、ファイルには867セクターあります。入力値が悪く、計算自体は正しいです。実際のコーデック画面を有効にすると、printfの内部でパニックも発生します。 - イントロ。 タイトル画面を通過する起動で11回のパニックが発生しました。最初のパニック前の最後の行は
this memcard is OKでした。swim-inとブリーフィングにはメモリーカード、CDストリーミング、コーデックが必要です。 - エレベーター。 両方のエレベーターコンストラクタ内のプローブはセッション全体を通じて沈黙したままで、ステージスクリプトがそれを要求することはありません。まだ証明されていませんが、可能性の高い理由は、コーデック通話によってのみ進むストーリー変数です。
- CDストリーミング(カットシーン、ボイス)、FMV(MDECなし)、オーディオ、メモリーカードセーブ。
- アクターコードがまだMIPSアセンブリである28ステージ。
- 約15 fpsを超えるパフォーマンス。
次のステップ
- mtsスタックを適正なサイズにし、ホットなテクスチャページを内部SRAMへ移動する。
- XIAOで120/120 MHzのメモリクロックを計測する。
RADIO.DATのインデックスを修正し、エレベーターがそれに続くか確認する。- 仮想CDにストリーミングを実装し、カットシーンとボイスを取り戻す。
- ソフトウェアSPUを通じてオーディオを追加する。
- デバッグプローブを削除する。
結論
PlayStationは型パンニング、ゼロ除算、配列の範囲外読み取り、符号検査されたポインタを許容します。現代のコンパイラとCPUはそのいずれも許容しません。この移植でうまくいったアプローチは、あらゆる計測を失敗しうるように設計することでした。