- 149 -
まず最初に、本チュートリアルで使用する評価用のサンプルコードを確認します。本チュートリアルは、ルネサステ クノロジ社製のクロス開発環境(High-performance Embedded Workshop)を使用した例を取り上げています。
「カバレッジマスターwinAMS チュートリアル」を参照して、このページ以降を差し替えて下さい。
本チュートリアルの教材として用意されているルネサステクノロジ社製統合開発環境を開きます。
1. (製品インストールフォルダ)\Sample\HEW_M32C\winAMS_CM1_HEW_M32C.exe を C ドライブにコピー後、
解凍して下さい。
※同一フォルダにある winAMS_CM1_HEW_ M32C_COMP.exe は全ての実習が完了した状態の環境で す。
2. C:\winAMS_CM1\target フォルダをエクスプローラで開きます
3. プロジェクトファイル「target.hws」をダブルクリックして、開発環境(フレームワーク)を立ち上げます
本チュートリアルには、3 つのソースファイルが用意されています。
main.c : 評価対象の関数 func1()~func4() と main()関数があります。
ncrt0.a30 : アセンブラで記述された M16C 用のスタートアップルーチンです。
sect308.inc : アセンブラで記述されたデータセクション定義です。
ソースファイル main.c に、本チュートリアルの実習で使用するテスト対象の関数が入っています。また、実際はアプ リケーションコードが記述される main 関数もありますが、このサンプルコードは空関数になっています。カバレッジマス ターは、実際のマイコンチップと等価な命令コード実行を行うマイコンシミュレータ(System Simulator)を利用するため、
リンカーで実行可能なコードを生成する必要があります。このため、main 関数を記述して、main のエントリを生成して います。
では、このソースサンプルをビルドして、実行可能なオブジェクトを生成します。
4. HEW で、最適化なし、デバック情報出力の設定で「ビルド」メニューから「すべてをビルド」を選択して、コ ンパイルします。
※1.実習で作成する実行オブジェクトは Version 4.04.01.001 で作成します。
実習の準備: さあ、はじめましょう!
評価ソースサンプルを確認 (クロス開発環境:HEW マイコン:M32C)
開発ソースサンプルプロジェクトを開く
- 150 -
各種設定は「メニュー → ビルド → Renesas M32C Standard Toolchain...」で表示される ダイアログで設定して下さい。
「実習3: スタブ機能を使用して 呼び出し関数を置換」でも同様にコンパイルする必要が ありますので、HEWでコンパイルを実行して下さい。
デバッグ情報
AMSTB_SrcFile.cを追加して コンパイル
コンパイルスイッチ設定
※設定済みです
レジスタ変数に対する デバック情報抑止
最適化
- 151 -
本 チ ュ ー ト リ ア ル の 実 習 教 材 の フ ァ イ ル 構 成 は 以 下 の 通 り で す 。 コ ン パ イ ル 後 に は C:\winAMS_CM1\target\SAMP1\Debug フォルダに、実行オブジェクトファイル SAMP1.x30 が生成されます。
カバレッジマスターでテストを実施する為には、HEW のコンパイラが生成した実行オブジェクトファイルをガイオ独 自の SAUF フォーマットのファイル「*.xlo」に変換する必要がありますので、カバレッジマスターに内蔵されているオブ ジェクト変換機能「OMF 変換」を使用して変換を行います。(オブジェクトファイル中のデバッグ情報を変換するだけ で、命令コードに関しては影響ありません。)
※OMF 変換については 4 ページを参照して下さい
また、この実行オブジェクトファイルは、「デバッグ情報」を含んでいる必要があります。カバレッジマスターで単体テ ストを行うためには、このデバッグ情報が必須です。コンパイラに与える最適化などのその他のコンパイルオプション は、そのまま使用することができます。
実習環境のファイル構成について
Cドライブ直下に用意
単体テスト環境(実習1で作成)
静的解析環境(実習4で作成)
カバレッジマスターの「OMF変換」機 能で、SAUFフォーマットに自動変換 評価ソースのコンパイル環境
SAMP1.x30 が
評価用実行(M32C)コード
・SAMP1.x30はルネサステクノロジ社製コンパイ ラのオブジェクトファイル
・デバッグ情報が必要(コンパイルスイッチ指 定、debugモードでコンパイル)
←ICEデバッガ利用時と同様
- 152 -
まず最初は、評価サンプルをテストするための CSV ファイルを作成して、テスト実行後に結果を出力する、一連の テスト作業を体験してみましょう。この実習では、テスト入力 CSV ファイルの作成方法と、入出力テスト結果、C0 カバレ ッジ結果の確認方法が学習できます。
まず、本チュートリアルで使用するテストプロジェクトを作成します。
1. 「スタート」→「すべてのプログラム」→「システムシミュレータ」→「SSTManager」を起動します。
2. 「ファイル」メニュー→「プロジェクト新規作成」を選択します。
テストプロジェクト作成のダイアログで、以下の様に設定します。
3. プロジェクト名に、「UnitTest」と入力します。(この名称のフォルダが作成されます)
4. 参照ボタンを押して、フォルダに、「C:\winAMS_CM1」を選択します。(この位置に UnitTest フォルダが保 存されます。)
5. エンジン(マイコンシミュレータ)に「systemg.exe」を選択します。
6. MPU 名に「M32C(NC308)」を選択します。(ご利用のマイコンの種類に合わせて変更します。)
7. 型番に「M32C/80 Series(デフォルト)」を選択します。(ご利用のマイコンの種類に合わせて変更しま す。)
8. コンパイル環境に「その他」を選択します。(「OMF 変換」のオプションが有効になります。)
9. 起動シミュレータに「WinAMS」を選択します。
10. CasePlayer2 プロジェクトは空欄のままにします。(後の実習4で使用します。)
これにより、C:\winAMS_CM1 フォルダが作成され、この中にテストに関するデータが格納するための、UnitTest フ ォルダが作成され、テストプロジェクトが開きます。
実習1: 一連のテスト実行フローを体験する(導入)
課題設定について
テストプロジェクトを新規作成
← プロジェクト名のフォルダが作成されます 「C:\winAMS_CM1」 を選択
← 「systemg.exe」を選択
← 「M32C(NC308)」を選択
← 「M32C/80 Series(デフォルト)」を選択
← プロジェクト名のフォルダができます。
← その他
← winAMSを選択
← 実習1~3では空欄
※実習4で、テストデータ作成支援 機能を利用する際に使用します。
- 153 -
OMF 変換機能は、後で説明するテストプロジェクト作成のダイアログのコンパイル環境で「その他」を選択した場合 に機能が使用できるようになります。
OMF 変換機能が使用可能な状態で、OMF 変換の設定を行います。
1. 左に並んだ上から1番目の「起動設定」ボタンを押します 2. コンバータ名は m16c OMF コンバータを指定します
3. 参照ボタンで、オブジェクトファイルに「C:\winAMS_CM1\target\SAMP1\Debug\SAMP1.x30」を指定しま す
4. 変換オプションに「SAMP1.xlo -d」を指定します 5. OMF 自動変換のチェックボックスを ON にします
※3.で指定したファイルに変更があれば、起動時やテスト実行前等に自動で OMF 変換を行いますので、
下記 5.の操作は最初の1回だけとなります。
6. ウィンドウ上部の「OMF 変換」ボタンを押します
7. 3.で指定したフォルダに SAMP1.xlo のファイルが作成されます。
OMF 変換について
変換オプションの詳細についてはOMF Converter マニュアルでご確認できます。 スタート → プログラム → WinAMS → OMF Converter マニュアル
- 154 -
プロジェクトが開いたら、本チュートリアルに最初に必要な設定を行います。本チュートリアルでは、CSV 作成のた めに、Microsoft EXCEL を使用します。(※使用する PC に EXCEL がインストールされている必要があります。)この ために、EXCEL が利用できるように設定を加えます。
1. 左に並んだ一番下のボタン「その他」を押します。
2. 設定項目の上から2行目「テスト結果 CSV ファイルを外部エディタで開く」をチェックします。
次に、本チュートリアルのテスト対象の設定を行います。
まず1つ目は、テスト対象とするマイコン実行オブジェクトファイルの指定です。ここには、前章でコンパイルして作 成し OMF 変換した「SAMP1.xlo」を指定します。このファイルには、デバッグ情報が含まれており、テスト内容を設定 するための変数シンボル名や、ソースファイルパス、ソースコード行と実行コードの対応情報(ライン情報)などが含ま れています。このため、テスト対象に指定するファイルは、この.xlo ファイル1つだけです。
1. 左に並んだ上から2番目の「起動設定」ボタンを押します。
2. 参照ボタンで、オブジェクトファイルに「C:\winAMS_CM1\target\SAMP1\Debug\SAMP1.xlo」を指定しま す。
次に、マイコンシミュレータの環境設定のためのファイル「スタートアップコマンドファイル」を指定します。このファイ ルは、マイコンシミュレータ(System Simulator)起動時に実行されるコマンド(スクリプト)ファイルで、毎回のテスト環境 を同じ設定で起動するために、便利な機能です。
「作成」ボタンで基本コマンドのみが入った雛形を作成することができますが、本チュートリアルでは、実習のための 機能を盛り込んだスタートアップコマンドファイルを使用します。
3. 参照ボタンで、スタートアップコマンドファイルに「C:\winAMS_CM1\target\SS_STARTUP.com」を指定し ます。