Odinで書かれたNESエミュレータ
A NES emulator written in Odin (lucypero.com)
要約
開発者はOdin言語を使用してNES(ファミリーコンピュータ)エミュレータ「lucyNES」を開発しました。このプロジェクトを通じて、NESのアーキテクチャ、ビット演算、Odin言語、コンピュータの仕組み、そしてエミュレーションの難しさについて多くを学びました。バトルトードなどのゲームを完璧に動作させる精度を持ち、デバッガやセーブステートなどの機能も備えています。
全文翻訳
lucyNES
OdinでNESエミュレータを作りました!
[画像: lucyNES]
はじめに
このプロジェクトは2024年6月下旬に開始しました。空き時間を使って、断続的に作業を進めました。2025年1月に、他のことに集中するためにこのプロジェクトを一時停止しました。
このプロジェクトで多くのことを学びました。
- NESのアーキテクチャ、そしておそらく一般的なゲーム機アーキテクチャについて
- ビットとバイト、16進数表記、ビット演算について。
- Odinプログラミング言語。真剣なプロジェクトで使うのは初めてでした。
- コンピュータがどのように動作するか。CPU命令、「サイクル」など。
- エミュレーション。これは非常に難しいです。エミュレータ開発者の方々に敬意を表します!
波乱万丈な道のりでした。多くの楽しみがありましたが、エミュレータを「完全に」正確にしようと試みた終盤では、より多くの苦労もしました。
プロジェクトの詳細については、Github Readmeをお読みください。
機能
- バトルトードや他の数百のゲームを完璧に実行できるエミュレーション精度。
- いくつかのデバッグ機能を備えたデバッガビュー。
- エミュレータと対話するためのメニュービュー。
- セーブステート。
- コントローラーサポート。
- CRTシェーダー切り替え。
- (部分的な)サウンド。
- サポートされているマッパー:NROM, MMC1, UXROM, CNROM, MMC3, GxROM, AxROM。
エミュレータの作成
NESエミュレータの作成は簡単な週末プロジェクトだと言う人もいますが、率直に言ってそれは信じがたいことでした。なぜなら、明らかに、そうではないからです。私のエミュレータが現在の状態になるまで7ヶ月かかりました。
彼らが実際に意味しているのは、NESエミュレータを「動作させる」のに短い時間で済むということだと思います。例えば、ドンキーコングを実行できるようになるまで。それは本当です。80%または90%まではかなり速く到達できます。しかし、最後の10%に非常に長い時間がかかります。
NESハードウェアには、特定のゲームを実行するためにエミュレートする必要がある多くの特異性があります。多くのゲームは非常に特定のNESの動作に依存しています。それを正しく実装しないと、ゲームは実行されません。多くの課題はタイミングに関するものです。CPUとPPU(NESのグラフィックレンダリングを担当するチップ)は並列で動作し、互いに通信します。そのタイミングが非常に正確でないと、多くの問題が発生する可能性があります。ほとんどのゲームは、それほど正確でないエミュレータでも問題なく実行されますが、多くのゲームはそうではなく、より詳細な検討が必要になります。
もう一つの問題はマッパーです。マッパーとは、カートリッジの一種の実装を指す言葉です。NESゲームはカートリッジに入っていますが、カートリッジは単なるデータではありません。それらは独自の動作と、ROMや書き込み可能なメモリなどの追加リソースを持つ回路基板です。中には追加のオーディオ機能を持つものもありますが、私はそれを実装していません。
いずれにせよ、そのカートリッジに入っているゲームを実行したい場合は、これらのマッパーを実装する必要があります。それらはNESの回路を補完します。ある意味、それらはNESハードウェアの一部です。マッパーは多数ありますが、ほんの数個を実装するだけで多くのゲームをサポートできます。私はいくつかマッパーの実装に苦労しましたし、まだいくつか不十分に実装されているため、一部のゲームは動作しません。マッパーのドキュメントを理解するのが難しいと感じました。
エミュレータ作成における最大の課題は、何を実装すべきかを知ることだと思います。ハードウェアに関する情報、そしてゲームがエミュレータで動作するためにハードウェアについて何をエミュレートする必要があるかです。幸いなことに、NESはオンラインで非常によく文書化されています。私は多くのリソースを使用しました。例えば:
- The Nesdev wiki
- The nesdev wiki discord。ここの人々は私の問題解決に大いに役立ちました。
- Javidx’s NES series。コードには多くの間違いがありますが、良い出発点です。
- This article about the NES’s PPU
- Test ROMS。これらのNES ROMは、エミュレータの特定の側面を徹底的にテストします。これはエミュレータの精度開発を加速するための素晴らしいツールです。
これらのリソースとnesdev discordの人々の助けなしには、これのどれもできなかったでしょう。
Odin
このプロジェクトを通じてOdinについて多くを学びました。この言語はこのプロジェクトにぴったりだと感じています。非常にシンプルで、強く型付けされたCライクな言語であり、私が望むすべての自由を与えてくれるため、他の言語よりもエミュレータ作成がずっと容易になると感じています。
私を戸惑わせたことの一つは、Odinには自動整数昇格がないことです。数値の計算を行う際、Odinは決して型をより大きなものに昇格させません。これがいくつかのバグの原因となりました。しかし、これはすべてCの整数昇格に慣れている私のせいだと考えています。
学んだ楽しいことの一つは、メモリ割り当て戦略を少し行うことでした。Odinには自動メモリ管理がないため、メモリを処理するための賢い方法を考え出す必要があります。メモリをどのように最良に処理すべきかを考えるのは楽しかったです。複雑なことをする必要はありませんでした。主に、フレームごとにクリアされる1つのテンポラリallocator、永続的に保持する必要があるもののためのグローバルヒープallocator、そしてNESセッションと一緒に保持する必要があるもののためのNES Arena allocatorを使用しました。メモリ割り当ては楽しいと感じました。
もう一つ学ばなければならなかったのは、Odinオブジェクトをシリアライズする方法です。CBORライブラリを使用し、いくつかの問題に遭遇しました。ライブラリのバグのせいでコードが誤動作していると思っていましたが、それは解決されました。私がシリアライズ方法を知らない奇妙な型をいくつか作成したため、問題が発生していただけでした。型に対してカスタムハンドリングを正しく書く方法を学んだら、すべてが完璧に機能しました。これはcborがシリアライズ方法を知らなかった、扱いにくい型の一つです:
PpuCtrl :: struct #raw_union {
// VPHB SINN
using flags: bit_field u8 {
n: u8 | 2,
i: u8 | 1,
s: u8 | 1, // sprite pattern table address for 8x8 sprites (0: $0000, 1: $1000)
b: u8 | 1, // bg pattern table address (0: $0000, 1: $1000)
h: u8 | 1, // sprite size (0: 8x8, 1: 8x16)
p: u8 | 1,
v: u8 | 1, // vblank NMI enable
},
reg: u8,
}
Odinがこのようにraw unionとbit fieldを定義できるのは素晴らしいです。エミュレータ開発に非常に適しています。
不足している点
このプロジェクトは「完了」したとは考えていません。もちろん、このようなプロジェクトが真に完了することはありませんが、多くの側面でかなりの作業が必要です。
- サウンド。lucyNESはまだあまり良い音を出しません。一部のゲームはうまく聞こえますが、ほとんどはそうではありません。実装を改善し、まだ実装していないDMCチャンネルを実装する必要があります。
- テストした一部のゲームは、マッパーの実装が不十分なため動作しません。
- より多くマッパーを実装すれば、より多くのゲームをサポートできます。
これらが現時点で主な欠点です。いつか戻って作業を続け、プロジェクトを「完了」したと感じられるようにするかもしれません。
ショーケース
デバッガショーケース
[動画][動画]
ゲームショーケース
[画像: showcase image]
[画像: showcase image]
[画像: showcase image]
[画像: showcase image]
[画像: showcase image]
[画像: showcase image]