XCP 通信を使用したエクスターナルモードシミュレーション

エクスターナルモードシミュレーションでは、パラメーターをリアルタイムで調整し、ターゲットアプリケーションの信号を監視できます。[カスタムハードウェア上で実行] アプリを使用して、開発用コンピューターで、またはカスタムハードウェアで、XCP 通信チャネルを使用するエクスターナルモードシミュレーションを設定して実行できます。

エクスターナルモードシミュレーションについて、以下を行います。

開発用コンピューターでターゲットアプリケーションをビルドします。
ターゲットアプリケーションをターゲットハードウェアに展開します。
ターゲットハードウェア上で実行するターゲットアプリケーションに Simulink^® を接続します。
ターゲットハードウェア上で生成コードの実行を開始します。

開発用コンピューターでの XCP エクスターナルモードシミュレーションの実行

XCP 通信プロトコルを使用するエクスターナルモードシミュレーションを構成して実行します。シミュレーション中に以下を行います。

Scope ブロック、Dashboard ブロック、およびシミュレーションデータインスペクターを使用して信号を監視する。
Dashboard ブロックを使用してパラメーターを調整する。

XCP の信号の監視とパラメーター調整の構成

この例で使用するフォルダーを作成します。
```
mkdir ext_mode_xcp_example
cd ext_mode_xcp_example
```
Simulink を開いて、以下のブロックを含む簡単なモデル xcpExample を作成します。
- Sine Wave
- Gain
- Scope
- Half Gauge
- Knob
Sine Wave ブロックをダブルクリックします。[サンプル時間] を 0.1 に設定してから、[OK] をクリックします。
Gain ブロックをダブルクリックします。[ゲイン] を 2 に設定して [OK] をクリックします。
Sine Wave ブロックを Gain ブロックに接続し、その接続に名前を付けます (たとえば Test Signal)。
Gain ブロックを Scope ブロックに接続し、その接続に名前を付けます (たとえば Output Signal)。
ログ記録用に Test Signal を構成します。
1. Test Signal を選択します。
2. [信号] タブの [モニター] セクションで [信号のログ] を選択します。
信号のログ記録を有効にしない場合、Test Signal をシミュレーションデータインスペクターにストリーミングできません。
Test Signal の値を監視するように Half Gauge ブロックを構成します。
1. Half Gauge ブロックをダブルクリックします。
2. Simulink エディターで、Test Signal を選択します。
3. [ブロックパラメーター] ダイアログボックスで、以下を行います。
  - ブロックを Test Signal に接続します。
  - [最大値] フィールドに値を入力します (たとえば 1)。
4. [OK] をクリックします。
Sine Wave ブロックの [振幅] パラメーターを調整するように Knob ブロックを構成します。
1. Knob ブロックをダブルクリックします。
2. Simulink エディターで、Sine Wave ブロックを選択します。
3. [ブロックパラメーター] ダイアログボックスで、以下を行います。
  - ブロックを Sine Wave ブロックの [振幅] パラメーターに接続します。
  - [最小値] フィールドと [最大値] フィールドに値を入力します (たとえば、それぞれ 0.1 と 1)。
4. [OK] をクリックします。
モデルを xcpExample として保存します。

ハードウェアの指定とモデルの準備

Simulink ツールストリップの [アプリ] タブから、[ハードウェアで実行するように設定] セクションで、[カスタムハードウェア上で実行] をクリックします。[カスタムハードウェア上で実行] ポップアップダイアログボックスで [終了] をクリックします。
[ハードウェア] セクションの [Board] フィールドで、既定の [No Board] を使用します。
[準備] ギャラリーの [モデルコンフィギュレーション] で、[ハードウェア設定] をクリックします。[コンフィギュレーションパラメーター] ダイアログボックスが開き、システムターゲットファイルによって決定された [ハードウェア実行] 設定が表示されます。
1. [ソルバー] ペインの [タイプ] フィールドで、[固定ステップ] を指定します。次に、[ソルバーの詳細] の [固定ステップサイズ (基本サンプル時間)] フィールドに 0.1 を指定します。
2. [コード生成] 、 [最適化] ペインで、[既定のパラメーター動作] を [調整可能] に設定します。
3. [コード生成] 、 [インターフェイス] ペインで、[エクスターナルモード] チェックボックスをオンにします。次に、[トランスポート層] を [XCP on TCP/IP] に設定します。[XCP on TCP/IP] を選択すると自動的に、[MEX ファイル名] に ext_xcp が指定され、[静的メモリの自動割り当て] チェックボックスがオンになり、[最大持続時間] が有効になります。この例では、[最大持続時間] の既定値を使用します。
4. [システムターゲットファイル] が [ert.tlc] である場合、[コード生成] 、 [テンプレート] ペインで、[メインプログラム例の生成] チェックボックスをオンにして、[ターゲットオペレーティングシステム] を [BareBoardExample] に設定します。コードジェネレーターは、エクスターナルモード抽象化レイヤーのドキュメント (matlabroot\toolbox\coder\xcp\src\target\ext_mode\include\ext_mode.h で入手可能) を使用して、オペレーティングシステムを実行しないベアボードに XCP エクスターナルモードのターゲット接続を提供できる方法を示す例を作成します。
5. [OK] をクリックして変更を適用し、ダイアログボックスを閉じます。
[ハードウェア] タブの [接続] フィールドに、IP: "localhost" – Port:17725 と表示されます。Simulink と開発用コンピューターの間の接続は、[トランスポート層] を [XCP on TCP/IP] に設定する際にステップ c で指定されました。
モデルを保存します。

ターゲットアプリケーションのビルトと実行

[ハードウェアで実行] セクションで、次を行います。

シミュレーション終了時間の既定以外の値を指定するには、[終了時間] フィールドで、inf などの値を指定します。
[監視と調整] をクリックして、プロセスを開始します。ソフトウェアでは次が行われます。
1. 実行可能ファイルを含むターゲットアプリケーションファイルをビルドします。信号のデバッグシンボルは、コード生成の構成に従って、実行可能ファイルの一部として作成されるか、別のファイル内に作成されます。コード生成のさまざまな構成の詳細については、Simulink モデルから生成されたコードのビルドに使用するアプローチを参照してください。
2. ターゲットアプリケーションを開発用コンピューターで別のプロセスとして展開します。
3. Simulink をターゲットアプリケーションに接続します。
4. 生成されたモデルコードを開始します。
手順を個別に実行するには、[監視と調整] 、 [ステップ単位のコマンド] にある以下のボタンをその順にクリックします。
1. [監視用のビルド]
2. [展開]
3. [接続]
4. [開始]

信号の監視とパラメーターの調整

以下を使用して Test Signal を監視できます。

Scope ブロック –– ブロックをダブルクリックします。
シミュレーションデータインスペクター –– [シミュレーションデータインスペクター] ボタンをクリックします。シミュレーションデータインスペクターが開いたら、[Test Signal] チェックボックスをオンにします。これにより、ストリームデータが表示されます。
Half-Gauge ブロック。

正弦波の振幅を変更するには、Knob ブロックのポインターを必要な値まで回転させます。

次の表で、シミュレーション中に調整可能なブロックパラメーターを調整するさまざまな方法を示します。

方法	詳細
モデルデータエディター	モデルデータエディターを通じてパラメーターを調整するには、次のようにします。 Simulink エディターの [ハードウェア] タブの [準備] セクションで、[パラメーターの調整] をクリックして、モデルデータエディターを開きます。複数の調整可能なパラメーターを同時に更新する場合、[準備] セクションで、[更新を保留] をオンにします。モデルデータエディターの [パラメーター] タブの [値] 列で、調整可能なパラメーターの新しい値を指定します。 [更新を保留] をオフにするか、[すべてのパラメーターを更新] をクリックします (Ctrl+D)。Simulink は新しい値をターゲットアプリケーションに同時にダウンロードします。 [更新を保留] がオフの場合、新しい値を指定した直後に、Simulink は新しい値をターゲットアプリケーションにダウンロードします。詳細については、モデルデータエディターを参照してください。
[ブロックパラメーター] ダイアログボックス	[ブロックパラメーター] ダイアログボックスを通じてパラメーターを調整するには、次のようにします。更新するブロックごとに、次を実行します。ブロックをダブルクリックして [ブロックパラメーター] ダイアログボックスを開きます。パラメーターのフィールドで、新しいパラメーター値を指定します。 [適用] または [OK] をクリックします。 [更新を保留] がオンの場合、[更新を保留] をオフにするか、[すべてのパラメーターを更新] をクリックします (Ctrl+D)。Simulink は新しい値をターゲットアプリケーションに同時にダウンロードします。 [更新を保留] がオフの場合、[適用] または [OK] をクリックした直後に、Simulink は新しいブロック値をターゲットアプリケーションにダウンロードします。
MATLAB^® ワークスペース	ブロックパラメーターが MATLAB ワークスペース変数の場合、次のようにします。コマンドプロンプトで、変数に新しい値を割り当てます。 Simulink エディターの [ハードウェア] タブで、[準備] セクションの [すべてのパラメーターを更新] をクリックします (Ctrl+D)。Simulink は新しい値をターゲットアプリケーションにダウンロードします。詳細については、変数の作成と編集を参照してください。

方法

詳細

モデルデータエディター

モデルデータエディターを通じてパラメーターを調整するには、次のようにします。

Simulink エディターの [ハードウェア] タブの [準備] セクションで、[パラメーターの調整] をクリックして、モデルデータエディターを開きます。
複数の調整可能なパラメーターを同時に更新する場合、[準備] セクションで、[更新を保留] をオンにします。
モデルデータエディターの [パラメーター] タブの [値] 列で、調整可能なパラメーターの新しい値を指定します。
[更新を保留] をオフにするか、[すべてのパラメーターを更新] をクリックします (Ctrl+D)。Simulink は新しい値をターゲットアプリケーションに同時にダウンロードします。
[更新を保留] がオフの場合、新しい値を指定した直後に、Simulink は新しい値をターゲットアプリケーションにダウンロードします。

詳細については、モデルデータエディターを参照してください。

[ブロックパラメーター] ダイアログボックス

[ブロックパラメーター] ダイアログボックスを通じてパラメーターを調整するには、次のようにします。

更新するブロックごとに、次を実行します。
1. ブロックをダブルクリックして [ブロックパラメーター] ダイアログボックスを開きます。
2. パラメーターのフィールドで、新しいパラメーター値を指定します。
3. [適用] または [OK] をクリックします。
[更新を保留] がオンの場合、[更新を保留] をオフにするか、[すべてのパラメーターを更新] をクリックします (Ctrl+D)。Simulink は新しい値をターゲットアプリケーションに同時にダウンロードします。
[更新を保留] がオフの場合、[適用] または [OK] をクリックした直後に、Simulink は新しいブロック値をターゲットアプリケーションにダウンロードします。

MATLAB^® ワークスペース

ブロックパラメーターが MATLAB ワークスペース変数の場合、次のようにします。

コマンドプロンプトで、変数に新しい値を割り当てます。
Simulink エディターの [ハードウェア] タブで、[準備] セクションの [すべてのパラメーターを更新] をクリックします (Ctrl+D)。Simulink は新しい値をターゲットアプリケーションにダウンロードします。

詳細については、変数の作成と編集を参照してください。

生成されたコードでのパラメーター調整の詳細については、TCP/IP またはシリアル通信を使用するエクスターナルモードシミュレーションおよび生成されたコードにおける調整可能なキャリブレーションパラメーターの作成 (Embedded Coder)を参照してください。

モデルに Stateflow^® チャートが含まれる場合、ステートアクティビティを表示できます。詳細については、Stateflow チャートのアニメーション化 (Stateflow)を参照してください。

ターゲットアプリケーションの停止

[終了時間] に達する前に、実行を停止してターゲットアプリケーションを切断するには、[ハードウェア] タブの [ハードウェアで実行] セクションで [停止] button in the shape of a small black square inside a larger gray square をクリックします。

コード実行を停止せずにターゲットアプリケーションを Simulink から切断する場合は、[停止] 、 [ステップ単位のコマンド] 、 [切断] をクリックします。

XCP エクスターナルモードシミュレーションのトリガーされた信号の監視

XCP エクスターナルモードシミュレーションについて、Simulink での信号監視のためのターゲットアプリケーションデータのアップロードを開始するトリガーを構成できます。

ローカルフォルダーに簡単なモデルを作成します。

コマンドウィンドウで次のコマンドを入力します。

% Create work folder
if mkdir('workFolder')
    rmdir 'workFolder' s
    mkdir('workFolder')
end
cd workFolder
open_system(new_system('myModel'));

% Add, configure, and connect blocks
add_block('simulink/Sources/Sine Wave','myModel/Signal',...
                                       'Bias','5',...
                                       'Amplitude','2',...
                                       'SampleTime','0.01');
set_param('myModel/Signal','position',[140,80,180,120]);

add_block('simulink/Math Operations/Gain','myModel/Signal Gain',...
                                       'Gain','2');
set_param('myModel/Signal Gain','position',[340,80,380,120]);
add_line('myModel','Signal/1','Signal Gain/1');

% Label signal
signal=get_param('myModel/Signal','PortHandles');
set_param(signal.Outport(1),'Name','test_signal');

% And so on
add_block('simulink/Math Operations/Product','myModel/Product');
set_param('myModel/Product','position',[540,160,580,200]);
add_line('myModel','Signal Gain/1','Product/1');

add_block('simulink/Sources/Sine Wave','myModel/Carrier',...
                                       'Bias','5',...
                                       'Amplitude','10',...
                                       'Frequency','3',...
                                       'SampleTime','0.02');

set_param('myModel/Carrier','position',[140,240,180,280]);

add_block('simulink/Math Operations/Gain','myModel/Carrier Gain');
set_param('myModel/Carrier Gain','position',[340,240,380,280]);
add_line('myModel','Carrier/1','Carrier Gain/1');

signal=get_param('myModel/Carrier','PortHandles');
set_param(signal.Outport(1),'Name','test_carrier');

add_block('simulink/Signal Attributes/Rate Transition',...
          'myModel/Rate Transition');
set_param('myModel/Rate Transition','position',[440,200,480,240]);
add_line('myModel','Carrier Gain/1','Rate Transition/1');
add_line('myModel','Rate Transition/1','Product/2');

add_block('simulink/Sources/Constant','myModel/Constant',...
          'Value','0');
set_param('myModel/Constant','position',[340,320,380,360]);

add_block('simulink/Logic and Bit Operations/Relational Operator',...
          'myModel/Relational Operator','Operator','>=');
set_param('myModel/Relational Operator','position',[540,300,580,340]);
add_line('myModel','Carrier Gain/1','Relational Operator/1');
add_line('myModel','Constant/1','Relational Operator/2');

signal=get_param('myModel/Carrier Gain','PortHandles');
set_param(signal.Outport(1),'Name','pos_carrier');

add_block('simulink/Sinks/Scope','myModel/ScopeA');
set_param('myModel/ScopeA','position',[740,160,780,200]);
add_line('myModel','Product/1','ScopeA/1');

signal=get_param('myModel/Product','PortHandles');
set_param(signal.Outport(1),'Name','test_output');

add_block('simulink/Sinks/Scope','myModel/ScopeB');
set_param('myModel/ScopeB','position',[740,300,780,340]);
add_line('myModel','Relational Operator/1','ScopeB/1');

signal=get_param('myModel/Relational Operator','PortHandles');
set_param(signal.Outport(1),'Name','cmp_output');

% Finally, save the model
save_system('myModel');

Simulink エディターで、それぞれの信号を右クリックして [選択した信号のログ] を選択することで、次の信号のログ記録を構成します。
- test_signal
- test_carrier
- test_output
- cmp_output
Simulink ツールストリップの [アプリ] タブから、[ハードウェアで実行するように設定] セクションで、[カスタムハードウェア上で実行] をクリックします。[カスタムハードウェア上で実行] ポップアップダイアログボックスで [終了] をクリックします。
[準備] ギャラリーの [モデルコンフィギュレーション] で、[ハードウェア設定] をクリックします。
[ソルバー] ペインの [タイプ] フィールドで、[固定ステップ] を指定します。
[コード生成] 、 [インターフェイス] ペインで、[エクスターナルモード] チェックボックスをオンにします。
[トランスポート層] を [XCP on TCP/IP] に設定します。これにより、[MEX ファイル名] が ext_xcp に指定されます。
[OK] をクリックします。次に、モデルを保存します。
[外部信号とトリガー] ダイアログボックスを開くには、[準備] ギャラリーの [信号の監視とトレース] で、[コントロールパネル] をクリックします。
[コンフィギュレーション] セクションで [信号とトリガー] をクリックします。これにより [外部信号とトリガー] ダイアログボックスが開きます。

このダイアログボックスを通じて、監視する信号を選択して、ターゲットアプリケーションからデータをアップロードするためのトリガーを構成します。この例では、既定の設定を使用します。
- [すべて選択] チェックボックスがオン — ダイアログボックスで [選択] 列の各行に X が表示されます。シミュレーション中、ログ記録されたすべての信号を監視できます。
- [ソース] が [手動] に設定 –– エクスターナルモードコントロールパネルで [トリガーの準備] ボタンなどの、データのアップロードの手動での制御が提供されます。
- [ターゲットへ接続時にアーム] チェックボックスがオン — Simulink をターゲットアプリケーションに接続するときに、トリガーが準備されます。
[OK] をクリックして [外部信号とトリガー] ダイアログボックスを閉じてから、[OK] をクリックしてエクスターナルモードコントロールパネルを閉じます。
Simulink エディターで、[ハードウェア] タブに移動します。
[ハードウェアで実行] セクションの [終了時間] フィールドに値 (inf など) を指定します。
モデルを保存します。
[監視と調整] をクリックして、プロセスを開始します。ソフトウェアでは次が行われます。
1. ターゲットアプリケーションをビルドします。
2. ターゲットアプリケーションを開発用コンピューターで別のプロセスとして展開します。
3. Simulink をターゲットアプリケーションに接続します。
4. 生成されたモデルコードを開始します。

スコープの表示を表示するには、ScopeA および ScopeB をダブルクリックします。

シミュレーションデータインスペクターで信号を監視するには、[結果の確認] セクションで [データインスペクター] をクリックします。

[エクスターナルモードコントロールパネル] から、信号のログ記録と監視を中止したり再開したりできます。[接続とトリガー] セクションで [トリガーをキャンセル] または [トリガーの準備] をそれぞれクリックします。

ターゲットアプリケーションの実行を停止して Simulink をターゲット環境から切り離すには、[リアルタイムコードを停止] をクリックします。

信号の監視とトリガーオプションの詳細については、XCP エクスターナルモードコントロールパネルおよびXCP 外部信号とトリガーダイアログボックスを参照してください。

コマンドラインからの XCP エクスターナルモードシミュレーションの実行

コマンドを使用して、XCP エクスターナルモードシミュレーションを実行できます。モデルパラメーターの値を取得および設定するには、get_param コマンドと set_param コマンドを使用します。

これらのコマンドを実行するには、Simulink モデルを開き、ターゲットアプリケーションを実行していなければなりません。

モデルのシミュレーションモードをエクスターナルモードに設定します。
```
set_param(gcs,'SimulationMode','external');
```
Simulink をターゲットアプリケーションに接続します。
```
set_param(gcs,'SimulationCommand','connect')
```
生成されたモデルコードを実行します。
```
set_param(gcs,'SimulationCommand','start');
```
パラメーターを調整するには、そのワークスペース変数の値をラインコマンドを使用して変更します。たとえば、ブロックパラメーターの値が Simulink.Parameter オブジェクトとして指定されている場合、新しい値を Value プロパティに割り当てます。
```
myParamObj.Value = 5.23;
```
ターゲットアプリケーションに新しい値をダウンロードするには、モデルを更新します。
```
set_param(gcs,'SimulationCommand','update');
```
ターゲットアプリケーションを停止し、ターゲット環境から Simulink を切断します。
```
set_param(gcs,'SimulationCommand','stop');
```
生成コードの実行を停止せずにターゲットアプリケーションから Simulink を切断するには、以下のコマンドを使用します。
```
set_param(gcs,'SimulationCommand','disconnect');
```

引数 'SimulationCommand' を使用する set_param コマンドは非同期です。スクリプトからコマンドを連続して実行すると、各コマンドは、前のコマンドの完了を待たずに開始されます。各コマンドが完了したかどうかを確認するには、スクリプトで、引数 'SimulationStatus' を指定して get_param コマンドを使用します。たとえば、手順 1 ～ 3 で、スクリプトに以下のコマンドを指定します。

set_param(gcs,'SimulationMode','external');
set_param(gcs,'SimulationCommand','connect');

isExternalSimulationActive = false;
while ~isExternalSimulationActive
    simStatus = get_param(gcs, 'SimulationStatus');
    isExternalSimulationActive = strcmp(simStatus, 'external');
end
set_param(gcs,'SimulationCommand','start');

詳細については、プログラムによるシミュレーションの実行を参照してください。

診断ビューアーに、get_param コマンドと set_param コマンドで生成されたエラーメッセージが表示されます。

次の表は、get_param コマンドと set_param コマンドで使用できるパラメーターを示したものです。

XCP エクスターナルモードコマンドラインパラメーター

パラメーターと値	ダイアログボックスの等価物	説明
`ExtModeArmWhenConnect` `off`, `on`	外部信号とトリガー:[ターゲットへ接続時にアーム] チェックボックス	Simulink Coder™ ソフトウェアがターゲットに接続するとすぐにトリガーを装備します。
`ExtModeBatchMode` `off`, `on`	エクスターナルモードコントロールパネル:[バッチダウンロード] チェックボックス	バッチモードでのパラメーターのダウンロードの有効/無効を切り替えます。
`ExtModeConnected` `off`, `on`	エクスターナルモードコントロールパネル:[接続/切断] ボタン	ターゲットアプリケーションとの接続状況を示します。
`ExtModeEnableFloating` `off`, `on`	エクスターナルモードコントロールパネル:[データアップロードを有効にする] チェックボックス	フローティングスコープとの接続が確立されたときのトリガー装備および解除の有効/無効を切り替えます。
`ExtModeLogAll` `off`, `on`	外部信号とトリガー:[すべて選択] チェックボックス	入手できる信号をターゲットからホストにアップロードします。
`ExtModeSendContiguousSamples` `off`, `on`	外部信号とトリガー:[複数の連続するサンプルを同一パケットで送信] チェックボックス	信号を Simulink にストリーミングするための XCP DAQ Packed Mode を指定します。ターゲットアプリケーションはパケット内の複数のタイムステップからサンプルを送信します。`ExtModeTrigDuration` では、パケットで送信されるサンプルの数を決定します。
`ExtModeTrigDelay` `integer` (`0`)	外部信号とトリガー:[遅延] テキストフィールド	トリガーが発生してからデータ収集が開始されるまでの時間の長さ (基本レートステップ数) を指定します。
`ExtModeTrigDirection` `character vector` - `rising`, `falling`, `either`	外部信号とトリガー:[方向] メニュー	信号がしきい値を横切るときに移動する向きを指定します。
`ExtModeTrigDuration` `integer` (`1000`)	外部信号とトリガー:[持続時間] テキストフィールド	エクスターナルモードがトリガーイベント後のデータのログを作成する基本レートステップ数を指定します。 `ExtModeSendContiguousSamples` が `on` の場合、ターゲットアプリケーションから Simulink にパケットで送信されるサンプルの数は、以下と等しくなります。 `ExtModeTrigDuration/n` ここで、`n` = (基本レート)/(サンプルレート) `n`=1 の場合、パケットで送信されるサンプルの数は、完全に `ExtModeTrigDuration` になります。マルチレートモデルのサブレートの場合、パケットで送信されるサンプルの数は最も近い整数に丸められます。ターゲットアプリケーションは、Simulink に送信されないバッファーサンプルを破棄します。
`ExtModeTrigHoldOff` `integer` (`0`)	外部信号とトリガー:[ホールドオフ] テキストフィールド	トリガーイベントが終了してからトリガーが再装備されるまでの基本レートステップ数を指定します。
`ExtModeTrigLevel` `integer` (`0`)	外部信号とトリガー:[レベル] テキストフィールド	トリガー信号がトリガーを始動するために横切らなければならないしきい値を指定します。
`ExtModeTrigMode` `character vector` - `normal`, `oneshot`	外部信号とトリガー:[モード] メニュー	トリガーイベントが発生するたびにトリガーが自動的に再装備されるかどうか、またはトリガー装備のたびに収集されるのが 1 バッファー分のデータのみかどうかを指定します。
`ExtModeTrigSignalBlockPath` `character vector`	外部信号とトリガー:[信号選択] ビューで、信号を選択し、[トリガー信号] ボタンをクリック。	トリガー信号を提供する出力端子を含むブロックへのパスを指定します。
`ExtModeTrigSignalOutputPortIndex` `integer`	外部信号とトリガー:[信号選択] ビューで、信号を選択し、[トリガー信号] ボタンをクリック。	`ExtModeTrigSignalBlockPath` で指定されるブロックのトリガー信号出力端子のインデックスを指定します。
`ExtModeTrigType` `character vector` - `manual`, `signal`	外部信号とトリガー:[ソース] メニュー	データのログ作成の開始が、トリガーが装備されたときなのか、それとも指定されたトリガー信号がトリガー条件を満たしたときなのかを指定します。

XCP エクスターナルモードシミュレーションにおける通信バッファーのためのメモリ割り当て

XCP ベースのエクスターナルモードシミュレーションでは、例えば大量のデータを Simulink にストリーミングするモデルや低メモリのターゲットデバイスで実行されるモデルを扱う際に、メモリ要件を手動で特定する必要はありません。

[トランスポート層] を [XCP on TCP/IP] または [XCP on Serial] に設定すると、次のコンフィギュレーションパラメーターが有効になります。

静的メモリの自動割り当て (ExtModeAutomaticAllocSize)
最大持続時間 (ExtModeMaxTrigDuration) — 既定値は 10 基本レートステップ。

[最大持続時間] の値を含むモデル情報を使用して、以下に使用するメモリがソフトウェアによって割り当てられます。

XCP スタックで使用される内部データ構造体
XCP パケットのストレージ

[静的メモリの自動割り当て] チェックボックスをオフにした場合は次のようになります。

内部データ構造体に割り当てられるメモリは、既定値になります。
XCP パケットに割り当てられるメモリは、[静的なメモリバッファーサイズ] (ExtModeStaticAllocSize) フィールドを使用して指定できます。既定値は 1,000,000 バイトです。

十分なメモリが割り当てられていないと、エクスターナルモードシミュレーションで内部データ構造体または信号のストリーミング用のメモリを予約しようとしたときにメモリ不足エラーが発生します。この場合は、[静的メモリの自動割り当て] チェックボックスを再度オンにすると、必要なメモリの量をソフトウェアで計算できます。

XCP エクスターナルモード接続を設定するために target パッケージを使用する場合は、次の XCP パラメーターの値を指定することで、ターゲットハードウェアメモリの事前割り当てをより詳細に制御できます。

MaxCTOSize
MaxDTOSize

XCP エクスターナルモード接続オプションがある target.XCPExternalModeConnectivity オブジェクトを作成した後、関連する target.XCPTransport オブジェクトのプロパティを使用して XCP パラメーター値を指定します。次に例を示します。

extModeConnectivity = target.create('XCPExternalModeConnectivity', ...                
                                    'Name', 'External Mode Connectivity', ...
                                    'XCP', xcpConfiguration);

extModeConnectivity.XCP.XCPTransport.MaxCTOSize = 16
extModeConnectivity.XCP.XCPTransport.MaxDTOSize = 256

MaxCTOSize と MaxDTOSize の値を小さくすると、より少ないターゲットハードウェアメモリの事前割り当てが行われます。

詳細については、XCP エクスターナルモードシミュレーションの接続性のカスタマイズを参照してください。

ターゲットアプリケーションの引数

オプションの引数を使用してターゲットアプリケーションを実行できます。オプションの引数をカスタム起動ツールの実装を介してターゲットアプリケーションに渡します。

引数説明

引数	説明
`-w`	Simulink からメッセージを受信するまで、ターゲットアプリケーションが待機状態になり、その状態のままでいることを指定します。 `-w` を指定しない場合、ターゲットアプリケーションはモデルコードを即座に実行します。モデルコードは、モデルをビルドしたときのパラメーター値を使用して実行されます。
`-tf time`	モデルパラメーター `StopTime` をオーバーライドします。次で `time` を指定します。 `PurelyIntegerCode` が `'off'` に設定されている場合は秒。 `PurelyIntegerCode` が `'on'` に設定されている場合は基本レートステップ数。 `-tf inf` は、モデルコードが実行されるとモデルが無期限に実行されることを指定します。

-w

Simulink からメッセージを受信するまで、ターゲットアプリケーションが待機状態になり、その状態のままでいることを指定します。

-w を指定しない場合、ターゲットアプリケーションはモデルコードを即座に実行します。モデルコードは、モデルをビルドしたときのパラメーター値を使用して実行されます。

-tf time

モデルパラメーター StopTime をオーバーライドします。

次で time を指定します。

PurelyIntegerCode が 'off' に設定されている場合は秒。
PurelyIntegerCode が 'on' に設定されている場合は基本レートステップ数。

-tf inf は、モデルコードが実行されるとモデルが無期限に実行されることを指定します。

ホストベースのエクスターナルモードシミュレーションの場合、追加の rtiostream (Embedded Coder) 引数を指定できます。

引数説明

引数	説明
`-verbose level`	詳細レベルを指定します。 0 –– 情報なし 1 –– 詳しい情報
`-port number`	`[XCP on TCP/IP]` トランスポート層に対しては、TCP/IP サーバーのポート番号を指定します。256 と 65535 の間の整数値を使用します。既定値は 17725 です。 `[XCP on Serial]` トランスポート層に対しては、シリアルポート ID を指定します。たとえば、 Windows^® では、`COM1` に対しては `'COM1'` または 1、`COM2` に対しては `'COM2'` または 2 など。 Linux^® では、`'/dev/ttyS0'` など。
`-baud value`	`[XCP on Serial]` トランスポート層に対しては、ボー値を指定します。1200、2400、4800、9600、14400、19200、38400、57600 (既定値)、または 115200。

-verbose level

詳細レベルを指定します。

0 –– 情報なし

1 –– 詳しい情報

-port number

[XCP on TCP/IP] トランスポート層に対しては、TCP/IP サーバーのポート番号を指定します。256 と 65535 の間の整数値を使用します。既定値は 17725 です。

[XCP on Serial] トランスポート層に対しては、シリアルポート ID を指定します。たとえば、

Windows^® では、COM1 に対しては 'COM1' または 1、COM2 に対しては 'COM2' または 2 など。

Linux^® では、'/dev/ttyS0' など。

-baud value

[XCP on Serial] トランスポート層に対しては、ボー値を指定します。1200、2400、4800、9600、14400、19200、38400、57600 (既定値)、または 115200。

XCP エクスターナルモードの制限事項

次の表で、XCP 通信を使用するエクスターナルモードシミュレーションに適用される制限事項について説明します。

機能詳細

モデル構造を変更するパラメーターの更新

以下は変更できません。

ブロックの状態、入力または出力の数
サンプル時間またはサンプル時間の数
連続システムの積分アルゴリズム
モデルまたはブロックの名前

モデル構造を変更するパラメーターの更新を行う場合は、ターゲットアプリケーションをリビルドしなければなりません。

状態の数が変更されない場合、Transfer Fcn、Discrete Transfer Fcn、Discrete Filter ブロックの分子多項式パラメーターと分母多項式パラメーターを変更できます。

ユーザー指定または計算されたパラメーター (零点 - 極を状態空間に変換することで得られた行列 A、B、C、D) の State-Space、Zero-Pole、および Discrete Zero-Pole ブロックのゼロ要素は変更できません。

State-Space ブロックでは、可制御正準実現で行列を指定する場合、A、B、C、D 行列に対する、この実現と行列の次元を保持するすべての変更が許可されます。

Simulink ブロック線図がターゲットアプリケーションに一致しない場合、Simulink はチェックサムが一致しないことを通知するエラーを生成します。チェックサムは最上位モデルを考慮しますが、参照モデルは考慮しません。ターゲットアプリケーションをリビルドするには、更新されたブロック線図を使用します。

信号値の表示

シミュレーション中の信号値のグラフィカル表示はサポートされていません。たとえば、[Data Display in Simulation] のメニュー項目 [Show Value Labels When Hovering]、[Toggle Value Labels When Clicked] および [Show Value Label of Selected Port] は使用できません。詳細については、モデルブロック線図での信号値の表示を参照してください。

データのアーカイブ

[エクスターナルモードコントロールパネル] で使用できる [データのアーカイブ] 機能はサポートされていません。シミュレーションデータインスペクターを使用してデータを収集してエクスポートできます。

信号のログ設定のオーバーライド

[信号ログセレクター] を使用して信号のログ記録の設定をオーバーライドする場合、[間引き] および [データ点を制限] の設定をオーバーライドする制御はサポートされていません。

サブシステム信号のログ

エクスターナルモードシミュレーションの場合、ターゲットハードウェア上のイベントに応答して、信号のログが発生します。現在、サポートされているログイベントは、新しいサンプル時間刻みのみです。一部のサブシステムは、制御信号で有効化または無効化されます。これらのサブシステムでは、サブシステムへの制御信号が有効でない場合も信号値のログが記録されます。

たとえば、Enabled Subsystem ブロックの信号がログ記録用に設定されていれば、サブシステムへの制御信号が 0 より大きくない場合も信号値のログが記録されます。この場合、ログに記録される値は、制御信号が最後に 0 より大きかったときの信号の値です。

この制限が適用されるサブシステムの詳細については、Simulink Subsystem のセマンティクスを参照してください。

コンパイラのデバッグシンボルの形式

ツールチェーンは以下のいずれかの形式でデバッグ情報を生成しなければなりません。

DWARF
PDB

グローバル変数

信号、パラメーター、および状態はグローバル変数として指定しなければなりません。変数が格納されるターゲットメモリの位置は、0 ～ 4294967295 の範囲になければなりません。

パラメーター構造体

構造体であるパラメーターは調整できません。

純粋な整数コード

純粋な整数コードはサポートされます。コード生成では、PurelyIntegerCode が 'on' の場合、1 マイクロ秒以上の分解能で FixedStep を指定します。たとえば、1.0000001 ではなく 1.000001 と指定します。

実行コマンドで -tf finalTime を指定しない場合、ターゲットアプリケーションは生成されたモデルコードを無期限に実行し、StopTime を無視します。

実行コマンドで -tf finalTime を指定する場合、次のようになります。

finalTime 値は基本レートステップを表します (秒数ではありません)。
finalTime の最大値 (目盛り単位) は MAX_int32_T になる。

可変サイズの信号

可変サイズの信号のアップロードはサポートされていません。

アドレスの粒度

ワードのアドレスを使用するターゲットハードウェアはサポートされていません。

移植可能なワードサイズ

製品ターゲットハードウェアでワードのアドレスが指定可能である場合、移植可能なワードサイズを使用したホストベースのターゲットアプリケーションの生成はサポートされていません。製品ターゲットハードウェアは 8 ビット、16 ビットおよび 32 ビットのネイティブデータ型をサポートしなければなりません。

Scope ブロック

モデルが Scope ブロックを使用していて、エクスターナルモードシミュレーション中にログ記録されるデータの量が非常に大きくなると、Simulink の速度が低下する場合があります。Scope ブロックの代わりに、シミュレーションデータインスペクターまたは Dashboard ライブラリの同等のブロックを使用できます。詳細については、シミュレーションデータの可視化方法の決定を参照してください。

Scope ブロックおよび Floating Scope ブロックとスコープビューアー

一部の信号データ型はサポートされていません。シミュレーションで警告が発生します。

Floating Scope ブロックとスコープビューアーエクスターナルモードシミュレーションで Floating Scope ブロックとスコープビューアーを使用して参照モデルの信号を監視することはできません。参照モデルの信号を監視するには、信号のログ記録を有効にして、シミュレーションデータインスペクターを使用します。

参照モデル内の Scope ブロックと Display ブロック

モデルの階層構造では、最上位モデルがエクスターナルモードで実行されている場合、信号を表示するブロックは参照モデルで表示を提供しません。参照モデルで信号を監視するには、信号のログ記録を有効にして、シミュレーションデータインスペクターを使用します。

Simulink メッセージブロックに接続された Scope ブロックと Display ブロック

エクスターナルモードシミュレーションでは、Simulink メッセージブロックに接続された Scope ブロックおよび Display ブロックから内容が表示されません。

メッセージを可視化するには、シミュレーションデータインスペクターまたは Dashboard ブロックを使用します。

非ゼロのシミュレーション開始時刻

非ゼロのシミュレーション開始時間はサポートされていません。[ソルバー] 、 [開始時間] の既定値である 0.0 を使用します。

中間ステップ値

一部の Simulink ブロックは、シミュレーションタイムステップで複数の値を生成できます。以下に例を示します。

タイムステップで複数回呼び出される Simulink Function ブロックまたは Function-Call Subsystem ブロック。
タイムステップで複数回実行される Iterator Subsystem ブロック。

エクスターナルモードシミュレーションのタイムステップごとに、Simulink は、それらのブロックの最終的な値のみをターゲットアプリケーションからアップロードします。Simulink は、ステップ中に生成された中間値をアップロードしません。

サービスコードインターフェイス

ターゲット環境での生成コードの実行時に XCP 通信を使用してパラメーターを調整したり信号を監視したりすることは、ERT ベースのシステムターゲットファイルとサービスコードインターフェイスで構成されたコンポーネントモデルから生成されたコードではサポートされません。

ファイルスコープのデータ

ファイルスコープのデータはサポートされていません。たとえば、組み込みのカスタムストレージクラス FileScope を適用するデータ項目。シミュレーションで警告が発生します。

FileScope ストレージクラスの詳細については、生成されたコードでのデータ表示を制御するストレージクラスの選択 (Embedded Coder)を参照してください。

行優先のコード生成

行優先の形式で生成されたコードはサポートされていません。

同時実行

Windows および Linux コンピューター上では、同時実行がサポートされます。

Mac コンピューター上では、ネイティブスレッド例を使用した同時実行はサポートされていません。[エクスターナルモード] および [ターゲット上でタスクの同時実行を許可] チェックボックスが選択されている場合、エクスターナルモードシミュレーション用の同時実行をサポートするターゲットハードウェアサポートパッケージを使用していなければ、ターゲットアプリケーションを作成できません。

Windows コンピューター上では、実行時に、ターゲットアプリケーションの基本サンプル時間がシステムのタイマー割り込み間隔 (通常 15.625 ms) の最も近い倍数に量子化されます。サンプリングサブレートは、基本サンプルレートの想定される倍数です。シミュレーションデータインスペクター (SDI) にログが記録されるタイムスタンプは、時計時間ではなく、シミュレーション時間に相当します。例として次の表では、基本サンプル時間が 10 ms、サブレートサンプル時間が 20 ms である Simulink モデルのステップ時間を示します。

基本レート			サブレート
ステップ	時計時間 (ms)	ログに記録されるタイムスタンプ (ms)	ステップ	時計時間 (ms)	ログに記録されるタイムスタンプ (ms)
0	0	0	0	0	0
1	15.625	10
2	31.250	20	1	31.250	20
3	46.875	30
4	62.500	40	2	62.500	40

シミュレーションデータのエクスポート

ログ記録された信号と最上位モデルの出力データを MATLAB ワークスペースにエクスポートできます。

ログ記録された信号データの場合は、[信号のログ] チェックボックスをオンにします。
最上位モデルの出力データの場合は、[出力] チェックボックスをオンにして、[形式] リストから [データセット] を選択します。

MATLAB ワークスペースではなく、MAT ファイルにデータをエクスポートする場合は、[データセットのデータをファイルにログ] チェックボックスもオンにします。

シミュレーションの状態データのエクスポートはサポートされていません。

シミュレーション出力を単一オブジェクトとして保存することはサポートされていません。シミュレーションで警告が発生します。

参考

target

外部の Web サイト

https://www.asam.net/standards/detail/mcd-1-xcp/wiki/