概要

PC上で組込み系プログラムをデバッグしたいと思っている方に向けて、１つのソリューションをご紹介します。本ソリューションを使用してデバッグできるプログラムは以下のものです。

• ベアメタル・プログラム
• 組込み制御系 OS(TOPPERS OS, AUTOSAR OS 等)
• OS上で動作するリアルタイムなアプリケーション

今回は、TOPPERS OS(ASP3)をデバッグします。

athrill(アスリル)

ここでご紹介するソリューション (CPU エミュレータ) は athrill(アスリル) というものです。
athrillは、athrill開発プロジェクトで公開されているオープンソースですので、誰でも使用可能です。
※第7回TOPPERS活用アイデア・アプリケーション開発コンテスト 活用アイディア部門の受賞作品

athrillの特徴を以下にまとめます(2018/03時点)。

• 仮想化範囲

• 支援機能

• ソース

動作環境

ダウンロード方法

GitHub上で公開されいてるathrill開発プロジェクトをダウンロードしてください。

インストール方法

• Windows

• Linux

athrillを空打ちして、以下のメッセージが出力されていれば、インストール成功です。

Usage:athrill -m<memory config file> [OPTION]... <load_file>
-c                             : set core num. if -c is not set, core num = 2.
-i                             : execute on the interaction mode. if -i is not set, execute on the background mode.
-r                             : execute on the remote mode. this option is valid on the interaction mode.
-t<timeout>                    : set program end time using <timeout> clocks. this option is valid on the background mode.
-m<memory config file>         : set athrill memory configuration. rom, ram region is configured on your system.
-d<device config file>         : set device parameter.

事前準備

デバッグ対象となるプログラムは、事前にv850のクロスコンパイラでビルドされている必要があります。v850のクロスコンパイラは、このサイトからダウンロードできます。

athrillプロジェクトでは、すでにビルド済みのTOPPERS OS(ASP3)のサンプルプログラムを用意していますので、そのバイナリを使用して、athrillの使用方法をお見せします。

サンプル・バイナリの配置場所は、
　"athrill/sample/os/asp3/OBJ/asp"
です。

デモ

今回のデモは、Ubuntu(32bit)環境で、Visual Studio COde を使用します。
$ uname -a

 4.13.0-38-generic #43-Ubuntu SMP Wed Mar 14 15:23:42 UTC 2018 i686 i686 i686 GNU/Linux

$ cat /etc/lsb-release

DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=17.10
DISTRIB_CODENAME=artful
DISTRIB_DESCRIPTION="Ubuntu 17.10"

Visual Studio Code 起動

以下のコマンドで Visual Studio Code を起動します。

 $ code

Visual Studio Code 起動後、athrill プロジェクトのトップフォルダをワークスペースフォルダとして追加してください。athrill でデバッグする場合、ターミナルは右側に配置しておくと便利です。

ターミナル上でカレントディレクトリを asp3 のフォルダに移動してください。

 $ cd sample/os/asp3/OBJ

athrill 起動

athrill に asp バイナリファイル(ELF形式)を渡して起動します。

 $ athrill -i -m memory.txt -d device_config.txt asp

athrillが起動すると、ELFファイルのローディングメッセージが出力され、プログラムカウンタのアドレス 0x0 番地に停止し、コマンド入力待ちとなります。
※オプション説明
※ -i :インタラクションモード(デバッグするためのオプション)
※ -d :デバイスコンフィグファイル(athrill のカスタマイズ情報を指定する)

asp3 実行

athrill のコマンド上で、continue コマンド(c)を実行すると、asp3の起動メッセージが出力され、TASK1 のメッセージが連続出力されていることがわかります。

ブレークポイント設定

ブレークポイントは、「関数名」、「ファイル名と行番号のセット」、「アドレス番地」のいずれかで設定できます。今回は、TASK1 の特定ポイント(sample1.c 150行目)に設定し、continueすると、設定したポイントでブレーク発生していることがわかります。

[DBG>b sample1.c 150
break 0x916

さらに、「lコマンド」を実行すると、Visual Studio Codeの左側のエディタに、該当ファイル/行を指し示してくれます。

※「lコマンド」を実行するとフォーカスを奪われますので、Visual Studio Code のキーボード・ショートカットで
※「前のターミナルフォーカス」に「Ctrl+L」を割り当てると便利です。

割り込み発生

割り込み発生コマンド(i コマンド)を使用すると、任意の割り込みを発生させることができるます。今回は、36 番の割り込みを発生させ、ステップ実行(n コマンド)します。

[DBG>i 36
[DBG>n
[DONE> core0 pc=0x95c task(+ec) 0x95c: B cond(0x1):0x94c
[NEXT> pc=0x2c0 kernel_cfg_asm.S 415

0x94c 番地の命令実行後、プログラムカウンタが 0x2c0 番地に移動していることがわかります。0x2c0 番地は 36 番の割り込み発生時のアドレス番地であり,割り込み発生したことになります。割り込み発生してから、プログラムカウンタが TASK1 に戻るまでの命令の流れを記録するため、v コマンドでロギングしてみます。

[DBG>v
VIEW_MODE=ON

命令ログ確認

命令ログは athrill 起動フォルダ直下に log.txt としてテキスト出力されます。エクスプローラから log.txt をクリックし、内容を確認すると、v コマンド実行からのログ情報が大量に生成されていることがわかります(1 行 1 命令)。

1行目のログ情報は、TASK1 の命令実行ポイントであり,その直後に 36 番地の割り込み発生し,割り込み処理が実行されていることがわかります。最終行を確認すると、割り込み復帰命令(RETI)実行後、無事、TASK1 の命令アドレス(0x94c)に戻っていることが確認できました！

関連記事

• マルチコア対応仮想環境(athrill)を使用して TOPPERS/ATK2 を実行する
• メモリ保護対応版 athrill(アスリル) のご紹介
• 今さらなぜCPUエミュレータを自作しようとおもったのか？
• athrill(アスリル)を使用してC言語ポインタ変数を理解する
• athrill(アスリル)機能マニュアル
• athrill(アスリル) を使用してベアメタル・プログラミング(１回目：main関数が動き出すまで)
• athrill(アスリル) を使用してベアメタル・プログラミング(2回目：割り込みがソフトウェアに通知されるまで)
• WSLでマイコンシミュレータ環境(athrill)をつくる
• TOPPERS/ATK2カーネル向け実機レス環境(athrill2)
• 64bitCPUへの道 and/or 64歳の決意(1)V850/RH850 gcc 64bit
• dockerでathrill