テストハーネスとモデルの関係

"テストハーネス" は、Simulink^® モデルのテスト、編集、デバッグに使用できるモデルのブロック線図です。メインモデルで、モデルコンポーネントまたは最上位モデルにハーネスを関連付けます。テストハーネスには、個別のモデルワークスペースとコンフィギュレーションセットがあります。テストハーネスはメインモデルに関連付けられ、モデルキャンバスからアクセスできます。

外部ハーネスを作成すると、メタデータ XML ファイルも作成されます。XML ファイルには設計モデルの固有 ID が格納されており、これによってモデルとそのハーネスの間の関連付けが維持されます。両方が MATLAB^® パス上にある限り、メタデータファイルがモデルと同じフォルダーにある必要はありません。

テストハーネスモデルは、テスト対象のコンポーネントを中心に作成します。これにより、ハーネスがメインモデルにリンクされます。ハーネスでテスト対象のコンポーネントを編集すると、ハーネスを閉じるときにメインモデルが更新されます。テストハーネスを生成できる対象は次のとおりです。

サブシステム、ライブラリブロック、Subsystem Reference ブロック、Model ブロック、System Composer™ コンポーネントなどのモデルコンポーネント。テストハーネスにより、コンポーネントが個別のシミュレーション環境に分離されます。Subsystem ブロックまたは Subsystem Reference ブロックを Model ブロックに変換すると、テストハーネスがモデル参照に転送されます (テストハーネスの考慮事項を参照)。
最上位モデル。テスト対象のコンポーネントは、メインモデルを参照する Model ブロックです。サブシステムモデルでもテストハーネスを作成できます。

Test harnesses for top-level model and model component

モデルコンポーネントのハーネスとモデルの関係

テストハーネスをモデルコンポーネントに関連付けると、コンポーネントに関連付けられているパラメーターのコピーがハーネスモデルのワークスペースに格納されます。たとえば、Gain ブロックを含むコンポーネントのテストハーネスを作成してから、ハーネスに 2 つ目の Gain ブロックを追加するとします。

パラメーター g はテスト対象のコンポーネントの部分を定義しているため、ハーネスモデルのワークスペースに g のコピーが格納されます。
パラメーター a はテスト対象のコンポーネントの外にあるメインモデルの部分を定義しているため、ハーネスモデルのワークスペースに a のコピーは格納されません。
パラメーター h は、ハーネスに追加した Gain ブロックのゲインです。このブロックはテスト対象のコンポーネントの外にあるため、h はハーネスモデルのワークスペースにのみ存在します。

Model component and test harness relationship

最上位モデルのハーネスとモデルの関係

ハーネスをメインモデルの最上位に関連付ける場合、ハーネスモデルのワークスペースにコンポーネントに関連するパラメーターのコピーは格納されません。テスト対象のコンポーネントはメインモデルを参照する Model ブロックであるため、パラメーターはメインモデルのワークスペースに残ります。たとえば、Gain ブロックを含む最上位モデルのテストハーネスを作成してから、ハーネスに 2 つ目の Gain ブロックを追加するとします。

テスト対象のコンポーネントはメインモデルを参照しており、パラメーター g はメインモデルのワークスペースに存在します。ハーネスモデルのワークスペースに g のコピーは格納されません。
パラメーター h は、ハーネスに追加した Gain ブロックのゲインです。このブロックはテスト対象のコンポーネントの外にあるため、h はハーネスモデルのワークスペースにのみ存在します。

Top level model and test harness relationship

パラメーターの関連付け

テストハーネスのパラメーターは、最も局所的なワークスペースに関連付けられます。ハーネスモデルのワークスペース、システムモデルのワークスペース、ベース MATLAB ワークスペースの順に、パラメーターが関連付けられます。

テストハーネスの考慮事項

テストハーネスは、次のタイプのモデルコンポーネントについて作成できます。
- Model ブロック
- Subsystem Reference ブロック
- Subsystem ブロック
- 関数インターフェイスをもち、ライブラリの最上位にある、再利用可能なライブラリサブシステム
- Stateflow^® ブロック (Stateflow チャート、Truth Table ブロック、State Transition Table ブロック、Test Sequence ブロックなど)
- System Composer コンポーネント
- C Caller ブロック
- MATLAB Function ブロック
- ユーザー定義関数ブロック
次のタイプの Stateflow オブジェクトについては、テストハーネスはサポートされません。
- Subsystem Reference ブロック内の任意のコンポーネント
- Atomic サブチャート
- Simulink ベースのステート
- Simulink 関数
- MATLAB 関数
テストハーネスは、Simulink モデルごとに一度に 1 つだけ開きます。
テストハーネスでテスト対象のコンポーネントをコメントアウトしないでください。テスト対象のコンポーネントをコメントアウトすると、予期しない動作の原因になることがあります。
モデルおよびテストハーネスのロックは同期のタイプごとに固有です。同期の詳細については、Synchronization Modeを参照してください。
テスト対象のコンポーネントで使用されている信号名がモデルからテストハーネスに伝播されます。サブシステムのハーネスでは、伝播された一部の信号名がハーネスのコンパイル後でないと表示されないことがあります。ブロック線図のハーネスでは、[信号プロパティ] ダイアログボックスで [伝播信号の表示] を選択していない場合でも信号名が伝播されます。
Subsystem ブロックと Subsystem Reference ブロック
- サブシステムモデルに付加されたテストハーネスでは次のようになります。
  - 基となるモデルと常に同期される
  - コンパイルせずに作成される
  - ポストビルドコールバックはサポートされない
  - 入力が自動整形されない
- サブシステムにテストハーネスがある場合、そのサブシステムを含むモデルにサブシステムの内容を展開することはできません。テストハーネスを削除してからサブシステムを展開してください。詳細については、サブシステムの内容の展開を参照してください。
- Subsystem Reference ブロックでは、ブロックのパラメーターは同期されますが、ブロックの内容は同期されません。
- Subsystem ブロックまたは Subsystem Reference ブロックを Model ブロックに変換すると、モデル参照にテストハーネスが転送されます。Subsystem ブロックのハーネスは、ブロック線図のハーネスに変換されます。サブシステム内の入れ子になったハーネスは、モデル参照内の同一のブロックにコピーされます。転送されたハーネスは、モデル参照内ではいずれも内部ハーネスになります。テストハーネスは、転送されると名前が変わることがあります。変換アドバイザーの [変換を完了] ペインまたは MATLAB コマンドラインで、ハーネスの転送に関するフィードバックを参照できます。
  Subsystem ブロックまたは Subsystem Reference ブロックを Model ブロックに変換する際は、次の制限が適用されます。
  - SIL および PIL のハーネスは転送されません。
  - サブシステムのテストハーネスに含まれる要件は転送されません。それらは手動でコピーする必要があります。
テストハーネスに To Workspace ブロックが含まれている場合、テストの実行の完了後にベースワークスペースにブロック変数は保存されません。テストが完了した時点で、ベースワークスペースは元の状態に復元されます。
テストハーネスモデルについては、アップグレードアドバイザーおよび XML の差分はサポートされません。
Signal Editor ブロックをソースとするテストハーネスでは、以下はサポートされません。
- フレームベースの信号
- 可変次元の信号
Test Sequence ブロックまたは Stateflow チャートをソースとするテストハーネスでは、テスト対象のコンポーネントへのすべての入力が同じサンプル時間で動作しなければなりません。
テストハーネスでのカバレッジの収集には、次の考慮事項が適用されます。
- モデルにカバレッジ結果を読み込んだり、モデル間でカバレッジ結果を集計したりするには、モデルがカバレッジ結果と一貫している必要があります。そのため、カバレッジ収集の集計を実行するには、テスト対象のコンポーネントを自動的に同期するように構成されたテストハーネスを使用します。[同期モード] を [ハーネスの開閉時に同期] に設定します。詳細については、Synchronize Changes Between Test Harness and Modelを参照してください。
- テスト対象のコンポーネントをハーネスの開閉時に同期するようにテストハーネスが構成されている場合、テストハーネスからのカバレッジ結果がメインモデルに関連付けられます。テストハーネスを閉じると、カバレッジ結果はメモリにアクティブなまま残ります。メインモデルや別の同期されたテストハーネスから収集した追加の結果とカバレッジを集計できます。
- テスト対象のコンポーネントを手動でのプッシュ時とリビルド時にのみ同期するようにテストハーネスが構成されている場合、カバレッジ結果はテストハーネスに関連付けられます。
  - テストハーネスを閉じると、カバレッジ結果はメモリから削除されます。
  - テスト対象のコンポーネントの設計がテストハーネスとメインモデルで異なる場合、カバレッジ結果を集計することはできません。
  - テスト対象のコンポーネントの設計に違いがなければカバレッジ結果をメインモデルを使って集計できますが、カバレッジ結果をメインモデルに手動で読み込む必要があります。関数 cvload (Simulink Coverage) を参照してください。
カバレッジの詳細については、Collect Coverage in Testsを参照してください。

参考

テストハーネスの作成 | モデル参照変換アドバイザー