ブレークポイント機能の修正
[YACASL2.git] / include / exec.h
index dbf2c49..f081089 100644 (file)
 #define YACASL2_EXEC_INCLUDED
 
 #include <stdbool.h>
+#include <stdio.h>
 #include "struct.h"
 #include "word.h"
+#include "cmem.h"
 
 enum {
     INSIZE = 256    /**<IN命令の、入力領域 */
 };
 
 /**
- * 実行モード
+ * @brief 実行モードを表すデータ
  */
 typedef struct {
-    bool trace;           /**<レジストリの内容を表示する場合はtrue */
+    bool trace;           /**<レジストリの内容をステップごとに表示する場合はtrue */
     bool logical;         /**<レジストリの内容を論理値(0から65535)で表示する場合はtrue */
-    bool dump;            /**<メモリの内容を表示する場合はtrue */
+    bool dump;            /**<メモリの内容をステップごとに表示する場合はtrue */
+    bool step;           /**<ステップ実行の場合はtrue */
 } EXECMODE;
 
 /**
- * 実行モード: trace, logical, dump
+ * @brief 実行モード: trace, logical, dump, step
  */
 extern EXECMODE execmode;
 
 /**
- * 実行エラーをエラーリストに追加
+ * @brief 実行エラーをエラーリストに追加する
  */
 void addcerrlist_exec();
 
 /**
- * アセンブル結果読み込みエラーをエラーリストに追加
+ * @brief アセンブル結果読み込みエラーをエラーリストに追加する
  */
 void addcerrlist_load();
 
 /**
- * 指定されたファイルからアセンブル結果を読み込む
+ * @brief 指定されたファイルからアセンブル結果を読み込む
  */
-bool loadassemble(char *file);
+bool loadassemble(const char *file);
+
+
+/**
+ * @class Exec
+ * @brief execから関数ポインタで呼び出される関数
+ * @relatesalso exec
+ **/
+
+/**
+ * @brief COMET II仮想マシンを実行する
+ *
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void exec();
+
+/**
+ * @brief NOP命令。語長1(OPのみ)
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void nop();
 
 /**
- * COMET II仮想マシンのリセット
+ * @brief LD命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void reset();
+void ld_r_adr_x();
 
 /**
- * NOP命令
+ * @brief LD命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void nop(const WORD r, const WORD v);
+void ld_r1_r2();
 
 /**
- * LD命令
+ * @brief ST命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void ld(const WORD r, const WORD v);
+void st();
 
 /**
- * ST命令
+ * @brief LAD命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void st(const WORD r, const WORD v);
+void lad();
 
 /**
- * LAD命令
+ * @brief ADDA命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void lad(const WORD r, const WORD v);
+void adda_r_adr_x();
 
 /**
- * ADDA命令
+ * @brief ADDA命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void adda(const WORD r, const WORD v);
+void adda_r1_r2();
 
 /**
- * SUBA命令
+ * @brief SUBA命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void suba(const WORD r, const WORD v);
+void suba_r_adr_x();
 
 /**
- * ADDL命令
+ * @brief SUBA命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void addl(const WORD r, const WORD v);
+void suba_r1_r2();
 
 /**
- * SUBL命令
+ * @brief ADDL命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void subl(const WORD r, const WORD v);
+void addl_r_adr_x();
 
 /**
- * AND命令
+ * @brief ADDL命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void and(const WORD r, const WORD v);
+void addl_r1_r2();
 
 /**
- * OR命令
+ * @brief SUBL命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void or(const WORD r, const WORD v);
+void subl_r_adr_x();
 
 /**
- * XOR命令
+ * @brief SUBL命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void xor(const WORD r, const WORD v);
+void subl_r1_r2();
 
 /**
- * CPA命令
+ * @brief AND命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void cpa(const WORD r, const WORD v);
+void and_r_adr_x();
 
 /**
- * CPL命令
+ * @brief AND命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void cpl(const WORD r, const WORD v);
+void and_r1_r2();
 
 /**
- * SLA命令
+ * @brief OR命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void sla(const WORD r, const WORD v);
+void or_r_adr_x();
 
 /**
- * SRA命令
+ * @brief OR命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void sra(const WORD r, const WORD v);
+void or_r1_r2();
 
 /**
- * SLL命令
+ * @brief XOR命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void sll(const WORD r, const WORD v);
+void xor_r_adr_x();
 
 /**
- * SRL命令
+ * @brief XOR命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void srl(const WORD r, const WORD v);
+void xor_r1_r2();
 
 /**
- * JMI命令
+ * @brief CPA命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void jmi(const WORD r, const WORD v);
+void cpa_r_adr_x();
 
 /**
- * JNZ命令
+ * @brief CPA命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void jnz(const WORD r, const WORD v);
+void cpa_r1_r2();
 
 /**
- * JZE命令
+ * @brief CPL命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void jze(const WORD r, const WORD v);
+void cpl_r_adr_x();
 
 /**
- * JUMP命令
+ * @brief CPL命令 - オペランドr1,r2。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void jump(const WORD r, const WORD v);
+void cpl_r1_r2();
 
 /**
- * JPL命令
+ * @brief SLA命令 - オペランドr,adr,x。語長2
+ *
+ * 算術演算なので、第15ビットは送り出されない
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void jpl(const WORD r, const WORD v);
+void sla();
 
 /**
- * JOV命令
+ * @brief SRA命令 - オペランドr,adr,x。語長2
+ *
+ * 算術演算なので、第15ビットは送り出されない
+ * 空いたビット位置には符号と同じものが入る
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void jov(const WORD r, const WORD v);
+void sra();
 
 /**
- * PUSH命令
+ * @brief SLL命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void push(const WORD r, const WORD v);
+void sll();
 
 /**
- * POP命令
+ * @brief SRL命令 - オペランドr,adr,x。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void pop(const WORD r, const WORD v);
+void srl();
 
 /**
- * CALL命令
+ * @brief JPL命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void call(const WORD r, const WORD v);
+void jpl();
 
 /**
- * RET命令
+ * @brief JMI命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void ret(const WORD r, const WORD v);
+void jmi();
 
 /**
- * SVC命令
+ * @brief JNZ命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-void svc(const WORD r, const WORD v);
+void jnz();
 
+/**
+ * @brief JZE命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void jze();
+
+/**
+ * @brief JOV命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void jov();
 
 /**
- * COMET II仮想マシンの実行
+ * @brief JUMP命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
  */
-bool exec();
+void jump();
 
 /**
- * COMET IIのメモリを表示
+ * @brief PUSH命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void push();
+
+/**
+ * @brief POP命令。語長1
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void pop();
+
+/**
+ * @brief CALL命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void call();
+
+/**
+ * @brief RET命令。語長1(OPのみ)
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void ret();
+
+/**
+ * @brief SVC命令。語長2
+ * @relatesalso Exec
+ *
+ * @return なし
+ */
+void svc();
+
+/**
+ * @brief COMET IIのメモリを表示する
+ *
+ * @return なし
  */
 void dumpmemory();
 
 /**
- * COMET IIのレジスタを表示
+ * @brief COMET IIのレジスタを表示する
+ *
+ * @return なし
  */
 void dspregister();
 
+/**
+ * @brief CASL IIのオブジェクトファイルを逆アセンブルし、標準出力へ出力する
+ *
+ * @return 正常終了時は0、異常終了時は0以外
+ *
+ * @param *file オブジェクトファイルのファイル名
+ */
+bool disassemble_file(const char *file);
+
+/**
+ * @brief COMET IIデバッガーを起動する
+ *
+ * @return なし
+ */
+void debugger();
+
 #endif            /* YACASL2_EXEC_INCLUDEDの終端 */