HAN JIE

🚀 XenonRecomp コンパイラドキュメント

XenonRecompは、PowerPC（PPC）アセンブリコードをC++に変換するツールです。主にゲームシミュレータの開発に使用されます。このドキュメントでは、XenonRecompの使用方法や設定方法について詳しく説明します。機能、入出力処理、設定オプション、テスト方法などを含みます。

🚀 クイックスタート

XenonRecompを使ってPPCアセンブリコードをC++に変換するには、以下の手順に従います。

入力形式

XenonRecompは以下の入力を受け付けます。

• PPCアセンブリコードファイル：変換するPPCアセンブリ命令を含むファイルです。
• コンテキストヘッダファイル：アセンブリコードで使用されるレジスタやその他のコンテキスト情報を定義したファイルです。

出力形式

変換後のC++ファイルが生成され、その中にはアセンブリ命令がC++コードに変換された結果が含まれます。出力ファイルの保存先はユーザーが指定できます。

コマンド例

以下のコマンドを使用して変換を行います。

XenonRecomp [入力テストディレクトリのパス] [入力PPCコンテキストヘッダファイルのパス] [出力ディレクトリのパス]

生成されたファイルは src/xenia/cpu/ppc/testing/bin ディレクトリに保存されます。

✨ 主な機能

1. 割り込み処理

config.toml 設定ファイルを使用して、スキップするコードセグメントを定義できます。

# 割り込み処理のアセンブリコードのC++への変換を無効にする
skip_assembler = ["Altivec"]

2. デバッグフック

config.toml 設定ファイルを通じて、カスタムデバッグフックを挿入できます。

[[debug_hook]]
name = "デバッグフックの例"
address = 0x12345678
registers = ["r0", "r1"]

3. カスタム変換ルール

rules.toml ファイルで、アセンブリ命令からC++への変換ルールをカスタマイズできます。

# 例：PPC命令 'add' をC++式 'r0 = r1 + r2' に変換する
[add]
cpp = "r0 = r1 + r2;"

📦 インストール

依存関係

このプロジェクトは、CMake 3.20以上とClang 18以上が必要です。リポジトリにはサブモジュールが含まれているため、git clone --recursive を使用してクローンしてください。

コンパイラの推奨事項

開発にはClangコンパイラの使用が推奨されます。このプロジェクトはClangの特定の機能に依存しているためです。Windowsでは、clang-cl ツールチェーンを使用し、Visual StudioのCMake統合を通じて開発できます。

📚 ドキュメント

設定オプション

XenonRecompには以下の設定オプションがあります。

📄 ライセンス

本プロジェクトは、Xenia シミュレータのPPCコード変換器を参考にして実現されました。また、Xenia Canary のパッチを使用してXEXバイナリファイルを処理しています。