- 157 -
まず最初に、本チュートリアルで使用する評価用のサンプルコードを確認します。本チュートリアルは、ルネサステ クノロジ社製のクロス開発環境（High-performance Embedded Workshop）を使用した例を取り上げています。
「カバレッジマスターwinAMS チュートリアル」を参照して、このページ以降を差し替えて下さい。
本チュートリアルの教材として用意されているルネサステクノロジ社製統合開発環境を開きます。
1. (製品インストールフォルダ)\Sample\HEW_H8S\winAMS_CM1_HEW_H8S.exe を C ドライブにコピー後、解 凍して下さい。
※同一フォルダにある winAMS_CM1_HEW_H8S_COMP.exe は全ての実習が完了した状態の環境です。
2. C:\winAMS_CM1\target フォルダをエクスプローラで開きます
3. プロジェクトファイル「target.hws」をダブルクリックして、開発環境（フレームワーク）を立ち上げます
本チュートリアルには、5 つのソースファイルが用意されています。
main.c ： 評価対象の関数 func1()～func4() と main()関数があります。
resetprg.c ： C 言語で記述された H8S 用のスタートアップルーチンです。
dbsct.c ： C 言語で記述されたデータセクション定義です。（本チュートリアルでは使用しません。）
intprg.c ： C 言語で記述された割り込みハンドラ関数があります。（本チュートリアルでは使用しません。）
sbrk.c ： C 言語で記述されたヒープメモリ関数があります。（本チュートリアルでは使用しません。）
ソースファイル main.c に、本チュートリアルの実習で使用するテスト対象の関数が入っています。また、実際はアプ リケーションコードが記述される main 関数もありますが、このサンプルコードは空関数になっています。カバレッジマス ターは、実際のマイコンチップと等価な命令コード実行を行うマイコンシミュレータ（System Simulator）を利用するため、
リンカーで実行可能なコードを生成する必要があります。このため、main 関数を記述して、main のエントリを生成して います。
では、このソースサンプルをビルドして、実行可能なオブジェクトを生成します。
4. HEW で、最適化なし、デバック情報出力の設定で「ビルド」メニューから「すべてをビルド」を選択して、コ ンパイルします。
※１．実習で作成する実行オブジェクトは Version 4.04.01.001 で作成します。
※２．オブジェクトの出力形式は「アブソリュート(ELF/DWARF)」に設定して下さい。
HEW のバージョンが 3 以上(HEW3、HEW4)：フォーマット形式「アブソリュート(ELF/DWARF)」を推奨 HEW のバージョンが 3 未満(HEW、 HEW2)：フォーマット形式「アブソリュート(SYSROF)」を推奨
実習の準備： さあ、はじめましょう！
評価ソースサンプルを確認 （クロス開発環境：HEW マイコン：H8S）
開発ソースサンプルプロジェクトを開く
- 158 -
各種設定は「メニュー → ビルド → H8S,H8/300 Standard Toolchain...」で表示される ダイアログで設定して下さい。
「実習３： スタブ機能を使用して 呼び出し関数を置換」でも同様にコンパイルする必要が ありますので、HEWでコンパイルを実行して下さい。
デバッグ情報
AMSTB_SrcFile.cを追加して コンパイル
コンパイルスイッチ設定
※設定済みです 最適化
出力形式
- 159 -
本 チ ュ ー ト リ ア ル の 実 習 教 材 の フ ァ イ ル 構 成 は 以 下 の 通 り で す 。 コ ン パ イ ル 後 に は C:\winAMS_CM1\target\SAMP1\Debug フォルダに、実行オブジェクトファイル SAMP1.abs が生成されます。
カバレッジマスターでテストを実施する為には、HEW のコンパイラが生成した実行オブジェクトファイルをガイオ独 自の SAUF フォーマットのファイル「*.xlo」に変換する必要がありますので、カバレッジマスターに内蔵されているオブ ジェクト変換機能「OMF 変換」を使用して変換を行います。（オブジェクトファイル中のデバッグ情報を変換するだけ で、命令コードに関しては影響ありません。）
※OMF 変換については 4 ページを参照して下さい
また、この実行オブジェクトファイルは、「デバッグ情報」を含んでいる必要があります。カバレッジマスターで単体テ ストを行うためには、このデバッグ情報が必須です。コンパイラに与える最適化などのその他のコンパイルオプション は、そのまま使用することができます。
実習環境のファイル構成について
Ｃドライブ直下に用意
単体テスト環境（実習１で作成）
静的解析環境（実習４で作成）
カバレッジマスターの「OMF変換」機 能で、SAUFフォーマットに自動変換 評価ソースのコンパイル環境
SAMP1.abs が
評価用実行（H8S）コード
・SAMP1.absはルネサステクノロジ社製コンパイ ラのオブジェクトファイル（ELF/DWARFフォー マット）
・デバッグ情報が必要（コンパイルスイッチ指 定、debugモードでコンパイル）
←ICEデバッガ利用時と同様
- 160 -
まず最初は、評価サンプルをテストするための CSV ファイルを作成して、テスト実行後に結果を出力する、一連の テスト作業を体験してみましょう。この実習では、テスト入力 CSV ファイルの作成方法と、入出力テスト結果、C0 カバレ ッジ結果の確認方法が学習できます。
まず、本チュートリアルで使用するテストプロジェクトを作成します。
1. 「スタート」→「すべてのプログラム」→「システムシミュレータ」→「SSTManager」を起動します。
2. 「ファイル」メニュー→「プロジェクト新規作成」を選択します。
テストプロジェクト作成のダイアログで、以下の様に設定します。
3. プロジェクト名に、「UnitTest」と入力します。（この名称のフォルダが作成されます）
4. 参照ボタンを押して、フォルダに、「C:\winAMS_CM1」を選択します。（この位置に UnitTest フォルダが保 存されます。）
5. エンジン（マイコンシミュレータ）に「systemg.exe」を選択します。
6. MPU 名に「H8S(HEW)」を選択します。（ご利用のマイコンの種類に合わせて変更します。）
7. 型番に「H8S/2655 シリーズ ノーマルモード」を選択します。（ご利用のマイコンの種類に合わせて変更 します。）
8. コンパイル環境に「その他」を選択します。（「OMF 変換」のオプションが有効になります。）
9. 起動シミュレータに「WinAMS」を選択します。
10. CasePlayer2 プロジェクトは空欄のままにします。（後の実習４で使用します。）
これにより、C:\winAMS_CM1 フォルダが作成され、この中にテストに関するデータが格納するための、UnitTest フ ォルダが作成され、テストプロジェクトが開きます。
実習１： 一連のテスト実行フローを体験する（導入）
課題設定について
テストプロジェクトを新規作成
← プロジェクト名のフォルダが作成されます 「C:\winAMS_CM1」 を選択
← 「systemg.exe」を選択
← 「H8S(HEW)」を選択
← 「H8S/2655シリーズ ノーマルモード」を選択
← プロジェクト名のフォルダができます。
← その他
← winAMSを選択
← 実習１～３では空欄
※実習４で、テストデータ作成支援 機能を利用する際に使用します。
- 161 -
OMF 変換機能は、後で説明するテストプロジェクト作成のダイアログのコンパイル環境で「その他」を選択した場合 に機能が使用できるようになります。
OMF 変換機能が使用可能な状態で、OMF 変換の設定を行います。
1. 左に並んだ上から１番目の「起動設定」ボタンを押します 2. コンバータ名は ELF(ﾉｰﾏﾙﾓｰﾄﾞ) OMF コンバータを指定します
3. 参照ボタンで、オブジェクトファイルに「C:\winAMS_CM1\target\SAMP1\Debug\SAMP1.abs」を指定しま す
4. OMF 自動変換のチェックボックスを ON にします
※3.で指定したファイルに変更があれば、起動時やテスト実行前等に自動で OMF 変換を行いますので、
下記 5.の操作は最初の１回だけとなります。
5. ウィンドウ上部の「OMF 変換」ボタンを押します
6. 3.で指定したフォルダに SAMP1.abs.xlo のファイルが作成されます。
OMF 変換について
変換オプションについては、今回は設定がありません。
詳細についてはOMF Converter マニュアルでご確認できます。 スタート → プログラム → WinAMS → OMF Converter マニュアル
OMF 変換実行時に下記のワーニングがメッセージエリアに表示されますが、今回のチ ュートリアルには影響がありませんので、無視して下さい。
※func4で使用されていないAuto変数の情報不足に関するメッセージとなります。
Warning!! [i] 変換に必要な情報が不足しているため変換できません。 ( auto locinfo ) [C:\winAMS_CM1\target\SAMP1\main.c\func4]
- 162 -
プロジェクトが開いたら、本チュートリアルに最初に必要な設定を行います。本チュートリアルでは、CSV 作成のた めに、Microsoft EXCEL を使用します。（※使用する PC に EXCEL がインストールされている必要があります。）この ために、EXCEL が利用できるように設定を加えます。
1. 左に並んだ一番下のボタン「その他」を押します。
2. 設定項目の上から２行目「テスト結果 CSV ファイルを外部エディタで開く」をチェックします。
次に、本チュートリアルのテスト対象の設定を行います。
まず１つ目は、テスト対象とするマイコン実行オブジェクトファイルの指定です。ここには、前章でコンパイルして作 成し OMF 変換した「SAMP1.abs.xlo」を指定します。このファイルには、デバッグ情報が含まれており、テスト内容を設 定するための変数シンボル名や、ソースファイルパス、ソースコード行と実行コードの対応情報（ライン情報）などが含 まれています。このため、テスト対象に指定するファイルは、この.xlo ファイル１つだけです。
1. 左に並んだ上から２番目の「起動設定」ボタンを押します。
2. 参照ボタンで、オブジェクトファイルに「C:\winAMS_CM1\target\SAMP1\Debug\SAMP1.abs.xlo」を指定 します。
次に、マイコンシミュレータの環境設定のためのファイル「スタートアップコマンドファイル」を指定します。このファイ ルは、マイコンシミュレータ（System Simulator）起動時に実行されるコマンド（スクリプト）ファイルで、毎回のテスト環境 を同じ設定で起動するために、便利な機能です。
「作成」ボタンで基本コマンドのみが入った雛形を作成することができますが、本チュートリアルでは、実習のための 機能を盛り込んだスタートアップコマンドファイルを使用します。
3. 参照ボタンで、スタートアップコマンドファイルに「C:\winAMS_CM1\target\SS_STARTUP.com」を指定し ます。