必要なドキュメント
ユーザプログラムに対して、プロセッサの インスタンスを操作(read,write)する方法を提供するインタフェースクラスです。 プロセッサに依存させないために、ユーザプログラムではMpuIfの 派生クラスのヘッダ(Sh7751.hなど)は#includeしてはいけません。
ライブラリプログラムに対して、プロセッサのインスタンスを 操作(createなど)する方法を提供するクラスです。純粋仮想関数を含むため、 インスタンス化できません。対応プロセッサを追加するときは、 Sh7751クラスと同様にMpuクラスをpublic継承したクラスを 作ります。 このクラスはmodel/MPU.vと対になっています。
プロセッサの動作を実装するクラスの一例です。 このクラスはmodel/SH7751.vと対になっています。
Singleton(インスタンスが一個だけ)のクラスです。 Mpu派生クラスのインスタンスを生成するのが役割です。
MpuFactoryに対して、実行時(ライブラリがロードされて静的 オブジェクトの初期化が行われるとき)にプロセッサの作り方を 教える役割を持つクラスです。 Sh7751.cppなどの、Mpuから派生したクラスの実装の中で使います。
シミュレータと実機の違いを吸収するためのテンプレートクラスです。 テンプレートから作られたuint32_c, uint16_cなどが、 FPGA構造体を定義するヘッダで使用されます。 なお、マクロREALWORLDが未定義の場合は、uint32_cなどは Cの組み込み型(unsigned int)のtypedefになり、Cでコンパイル 可能になります。
FPGAのレジスタ情報が記述されたFpganame.csvファイルを作ります。 csvファイルからFpganame.hとFpganame.cppが自動作成されるので、 ユーザプログラム(以降user.cppと表記)で#include "Fpganame.h"します。 そうすると、Fpganameの持つレジスタfooは fpganame.foo = 0x12345678; のような代入をしたり、 unsigned value = fpganame.foo;のような参照をしたりできるようになります。
ユーザプログラムの中で時間待ちをしたいときは、 fpganame.nop(uint32_t clocks)を呼び出してください。クロック数ですから、 時間を指定したい場合はnop(時間s/周波数Hz)としてください。 なお、fpganame.nop(uint32_t clocks)はマクロREALWORLDが定義されている場合はコンパイルエラーになります。
マクロ REALWORLD を定義した状態で、hoge.cppとuser.cppを コンパイルします。REALWORLDが定義されているとhoge.cppは C++でなくCコンパイラでもコンパイル可能なので、実機では C++コンパイラが使えないというときでも大丈夫です。 user.cppは、C++の機能に依存しないように書けばCコンパイラで コンパイルできます。
SH7751.vを参考にしてNEWCPU.vを作成し、Sh7751.hとSh7751.cpp を参考にしてNewcpu.hとNewcpu.cppを作ります。 注意点
備考
edit