実機テストの前に複雑な状況をデバッグする方法

この記事ではマクロの基本について解説し、その使用例を示します。 

SetBreakpoint(){
    if (SlowInterruptCount++ == 2)
    {
       brk = __setCodeBreak("Fast_Interrupt_Handler", 0, "1", "TRUE", "");
       
    }
}

下に示すセットアップマクロ関数はデバッガを起動すると実行され、デバッグログウィンドウにメッセージを書き込んでMySetupMacroを呼び出し、ファイルを書き込みモードで開きます。

execUserSetup(){/* Write a message to the debug log  */
__message "Debugger started\n";
 
MySetupMacro();
 
/* Opens a text file for ASCII writing */
_fileHandle = __openFile("$PROJ_DIR$\\Memory.txt", "w");
}

このセットアップマクロ関数を使用すると、実際にアプリケーションをロードする前にハードウェアの一部を初期化することもできます。同種のセットアップマクロ関数として、ターゲットのリセット時に実行されるもの（execUserExit）、実行の開始時または停止時に実行されるもの（execUserStarted/Stopped）、あるいはデバッグ終了時に実行されるもの（execUserExit）などがあります。

C-SPYマクロは、マクロクイック起動ウィンドウから手動で呼び出したり、ブレークポイントに関連付けたりすることもできます。例えば、コードブレークポイントによってメモリの内容をファイルにダンプすることができます。

WriteMemory2File()
{
   __var byte,address,_fileHandle;
 
   _fileHandle = __openFile("$PROJ_DIR$\\Memory.txt", "w"); 
    
  for (address=0x20000000;address< 0x2000FFFF;address++)
  {
        byte=__readMemoryByte(address,"Memory");
        __writeFile( _fileHandle, byte );
  }
   __closeFile( _fileHandle );

}

このように定義したマクロを、以下のようにアクションとしてコードブレークポイントに関連付けられます。

ターゲットの実行をブレークポイントで停止させずに、メモリダンプ後直ちに実行を継続させたい場合は、アクション（Action）ではなく条件（Condition）としてC-SPYマクロを呼び出すことができます。

最後に、IAR Embedded Workbench IDE内からではなく、コマンドライン（CSPYBAT）からC-SPYデバッガを実行中に、このメモリダンプを行う場合を考えます。この場合は、以下のようにC-SPYに用意されているブレークポイントを設定するためのシステムマクロを利用すれば実現できます。

execUserSetup(){
...
/* __setCodeBreak(location, count, condition, cond_type, action) */
  __setCodeBreak("{myfile.c}.82.1",0,"WriteMemory2File()","TRUE","");
           ...
}

まとめ

デバッグ対象のハードウェアが利用できる場合でも、プロジェクトをシミュレーションしている場合でも、C-SPYマクロを使用すれば、有効かつ柔軟にデバッグセッションをカスタマイズすることができます。使用場面としては、デバッグのためのハードウェアの準備、実機テスト前の複雑な条件の動作確認とログ収集、周辺機器や割込みのシミュレーションなどが考えられます。使用可能なすべてのマクロについては、IAR Embedded WorkbenchのC-SPYデバッグガイドに記載されています。