エクスターナルモード機能の有効化

エクスターナルモードは、パラメーターの調整と信号の監視を有効にしてアルゴリズムコードを検証するために使用されます。このセクションでは、エクスターナルモード機能をターゲットに追加します。

ここでは、ハードウェアがシリアル通信インターフェイスを介してホストコンピューターに接続されていると想定します。ハードウェアがイーサネットインターフェイスを介してホストコンピューターに接続されている場合も、同様の手順が適用されます。それ以外の場合は、カスタムエクスターナルモードの作成が必要な場合があります。カスタムエクスターナルモードの作成の詳細については、TCP/IP またはシリアルのエクスターナルモード通信のためのトランスポート層の作成を参照してください。

このエクスターナルモード構成に使用する名前 (例: 'My New External mode') を指定して addNewExternalMode を呼び出すことで、ExternalMode オブジェクト ext を作成して Target オブジェクト tgt に追加します。
```
ext = addNewExternalMode(tgt,'My New External mode');
```
ターゲットを保存する前に、MATLAB^® ワークスペースから ExternalMode オブジェクト ext を削除しないでください。
エクスターナルモード構成 'My New External mode' がターゲットに追加されていることを確認します。
```
show(tgt);
```
```
                               My ARM Cortex M Board
Display Name                   My ARM Cortex M Board
My New Deployer                         1
My Baremetal Scheduler                  1
My New PIL                      My Serial Interface
My New External Mode                    0
```
エクスターナルモード構成 'My New External Mode' がターゲットに追加されていることが出力で示されています。ただし、このエクスターナルモード構成はハードウェア 'My ARM Cortex M Board' には使用されていません。この事実は、そのハードウェアに対応する位置に 0 が表示されることで示されています。
ExternalMode オブジェクト ext を Hardware オブジェクト hw および 'My Serial Interface' という名前のその I/O インターフェイスにマッピングします。
```
map(tgt,hw,ext,'My Serial Interface');
```
エクスターナルモード構成 'My External Mode' が、ハードウェア 'My ARM Cortex M Board' およびその I/O インターフェイス 'My Serial Interface' に使用されていることを確認します。
```
show(tgt);
```
```
                                 My ARM Cortex M Board
Display Name                     My ARM Cortex M Board
My New Deployer                           1
My Baremetal Scheduler                    1
My New PIL                        My Serial Interface
My New External Mode              My Serial Interface
```
エクスターナルモード構成 'My New External Mode' がハードウェア 'My ARM Cortex M Board' に使用されていることが出力で示されています。この事実は、そのハードウェアに対応する位置に、使用される I/O インターフェイスである 'My Serial Interface' が表示されることで示されています。
ExternalMode オブジェクト ext のプロパティを表示します。
```
ext
```
```
         ext =

        ExternalMode with properties:

                Name: 'My New External Mode'
         SourceFiles: {}
       PreConnectFcn: ''
            SetupFcn: ''
            CloseFcn: ''
```
ご使用のハードウェアに合わせて、必要に応じてプロパティ値を設定します。詳細については、matlabshared.targetsdk.ExternalMode を参照してください。
ExternalMode オブジェクトの SourceFiles プロパティを設定して、エクスターナルモード機能を使用するモデルをビルドするときに使用されるソースファイルを指定します。たとえば、シリアル I/O インターフェイスを使用したエクスターナルモードのソースファイルを設定するには、次のように入力します。
```
ext.SourceFiles = {'$(TARGET_ROOT)/src/rtiostream_serial.c', ...
	'$(MATLAB_ROOT)/rtw/c/src/ext_mode/serial/ext_serial_pkt.c', ...  
	'$(MATLAB_ROOT)/rtw/c/src/ext_mode/serial/rtiostream_serial_interface.c', ... 
	'$(MATLAB_ROOT)/rtw/c/src/ext_mode/serial/ext_svr_serial_transport.c'}
```
ここで、'$(TARGET_ROOT)/src/rtiostream_serial.c' は、XCP 通信を使用したエクスターナルモードシミュレーションに記載されている指示に従ってホストとターゲットハードウェアの間のシリアル通信を実装するソースファイルを表します。他の 3 つのファイルは、シリアル通信インターフェイス用にコードジェネレーターソフトウェアで提供されているファイルです。
メモ
$(TARGET_ROOT) は、ターゲットのルートフォルダーを表すトークンであり、コード生成ソフトウェアによって解決されます。
$(MATLAB_ROOT) は、MATLAB のルートフォルダーを表すトークンであり、コード生成ソフトウェアによって解決されます。
Simulink^® と生成されたコードの間でエクスターナルモード接続が確立される前に実行される MATLAB 関数を指定します。ExternalMode オブジェクトの PreConnectFcn プロパティを 'pause(5);' などに設定します。
```
ext.PreConnectFcn = 'pause(5);'
```
同様に、プロパティ SetupFcn および CloseFcn を設定できます。詳細については、ExternalMode を参照してください。
ターゲットを説明する情報をそのフレームワークに保存します。
```
saveTarget(tgt);
```
エクスターナルモードが正しく機能することをテストします。
```
testTarget(tgt,'externalmode');
```
テストが完了すると、結果の概要が表示されます。テストが PASSED の場合、次の機能の追加に進むことができます。それ以外の場合、テストが FAILED または INCOMPLETE であれば、テストの概要の下にテスト診断ログへのリンクが表示されます。

エクスターナルモードがハードウェアに登録されていることの確認

MATLAB の [ホーム] タブで、[新規]、[Simulink モデル] を選択します。モデルの既定の名前は untitled です。名前を test に変更します。
[アプリ] タブで [ハードウェアボードで実行] をクリックします。[ハードウェアボードで実行] ダイアログボックスで、[ハードウェアボード] を登録したハードウェア (たとえば、'My ARM Cortex M Board') に設定します。
[ハードウェア] タブの [ハードウェア設定] をクリックします。
[コンフィギュレーションパラメーター] ダイアログボックスで、[ソルバー] を選択します。
[タイプ] リストで [固定ステップ] を選択します。[ソルバー] リストで [自動] を選択します。
[コンフィギュレーションパラメーター] ダイアログボックスで [ハードウェア実行] タブを選択します。
[エクスターナルモード] グループを選択します。エクスターナルモードのプロパティがハードウェアに対して正しく表示されていることを確認します。

エクスターナルモードの動作の確認

MATLAB の [ホーム] タブで、[新規]、[Simulink モデル] を選択します。モデルの既定の名前は untitled です。[ファイル]、[名前を付けて保存] をクリックし、モデルを test として保存します。
[アプリ] タブで [ハードウェアボードで実行] をクリックします。[ハードウェアボードで実行] ダイアログボックスで、[ハードウェアボード] を登録したハードウェア (たとえば、'My ARM Cortex M Board') に設定します。
[ハードウェア] タブの [ハードウェア設定] をクリックします。
[コンフィギュレーションパラメーター] ダイアログボックスで、[ソルバー] を選択します。
[タイプ] リストで [固定ステップ] を選択します。[ソルバー] リストで [自動] を選択します。
MATLAB の [ホーム] タブで [Simulink ライブラリ] を選択します。Simulink ライブラリで [Sources] を開き、Constant ブロックをモデルに追加します。
Simulink ライブラリで [Math Operations] を開き、Gain ブロックをモデルに追加します。Constant ブロックと Gain ブロックを接続します。
Simulink ライブラリで [Sinks] を開き、Scope ブロックをモデルに追加します。Scope ブロックと Gain ブロックを接続します。
[ハードウェア] タブで [監視と調整] をクリックして、エクスターナルモードでシミュレーションを実行します。Scope ブロックの出力が 1 であることを確認します。

エクスターナル モード機能の有効化

エクスターナル モードがハードウェアに登録されていることの確認

エクスターナル モードの動作の確認

エクスターナルモード機能の有効化

エクスターナルモードがハードウェアに登録されていることの確認

エクスターナルモードの動作の確認