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

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

ハードウェアが次の条件に該当する場合は、後述の手順に従ってください。

Linux^® または VxWorks^® オペレーティングシステムを実行している
TCP/IP ソフトウェアスタックが含まれている
イーサネットインターフェイスを介してホストコンピューターに接続されている

カスタムエクスターナルモードの作成の詳細については、XCP 通信を使用したエクスターナルモードシミュレーションを参照してください。

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

ExternalMode オブジェクトのプロパティを表示します。

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'}
```
メモ
$(MATLAB_ROOT) は、MATLAB のルートフォルダーを表すトークンです。このトークンは、コード生成ソフトウェアによって解決されます。
Simulink^® と生成されたコードの間でエクスターナルモード接続が確立される前に、MATLAB で関数を実行するように指定します。ExternalMode オブジェクトの PreConnectFcn プロパティを 'pause(5);' などに設定します。
```
ext.PreConnectFcn = 'pause(5);'
```
ターゲットを説明する情報をそのフレームワークに保存します。
```
saveTarget(tgt);
```
エクスターナルモードが正しく機能することをテストします。
```
testTarget(tgt,'externalmode');
```
テストが完了すると、結果の概要が表示されます。テストが PASSED の場合、次の機能の追加に進むことができます。それ以外の場合、テストが FAILED または INCOMPLETE であれば、テストの概要の下にテスト診断ログへのリンクが表示されます。

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

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

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

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

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

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

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

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

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

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