UDP Send

UDP メッセージの送信

• 

ライブラリ:
DSP System Toolbox / Sinks

説明

UDP Send ブロックは、ユーザー データグラム プロトコル (UDP) を使用して、ネットワーク経由でデータ パケットを送信します。UDP は、単純なメッセージベースのコネクションレス型プロトコルであり、エンドツーエンドの接続はありません。このプロトコルは、受信側の準備が整っているかどうかを確認せずに、送信元から宛先に一方向にデータ パケットを送信します。このプロトコルにはハンドシェイク メカニズムがありません。データ パケットは、さまざまな理由で破棄される可能性があります。UDP には確認応答、再送信、またはタイムアウトがありません。ただし、UDP は非常に単純な送信プロトコルであり、時間的に制約のある用途など、再送信によって遅延するパケットを待つよりもパケットを破棄する方が望ましい場合に適しています。

UDP Send ブロックは、入力データ ベクトルを UDP パケットとしてリモート IP ネットワーク ポートに送信します。このブロックの UDP パケット送信先のリモート IP ポート番号は、生成されたコードで調整することができます。

一部の Simulink^® ブロックと、それらのブロックを含むモデルから構築された .exe ファイルには、Windows^® の .dll ファイルなどの共有ライブラリが必要です。UDP Send ブロックには networkdevice.dll ライブラリ ファイルが必要です。この要件を満たすには、packNGo (Simulink Coder) 関数のページの例に従って、モデルのコード ファイルをパッケージ化します。結果として得られる圧縮フォルダーには、networkdevice.dll といった、モデルに必要な .dll ファイルが格納されます。このタイプの .exe ファイルを MATLAB^® 環境の外部で実行するには、必要な .dll ファイルを .exe ファイルと同じフォルダーに置くか、Windows システム パス上のフォルダーに置きます。詳細については、How To Run a Generated Executable Outside MATLABを参照してください。

例

UDP を使用した Simulink でのデータ伝送

UDP ネットワーク経由で正弦波信号を送受信する。

• モデルを開く

端子

入力

Input — 入力データ ベクトル

ベクトル

ブロックが UDP パケットとして送信する入力データ ベクトルを指定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean
複素数のサポート: あり

パラメーター

リモート IP アドレス (ブロードキャストの場合は '255.255.255.255') — UDP パケットの送信先 IP アドレス

'127.0.0.1' (既定値) | IP アドレス | string

UDP パケットの送信先となる IP アドレスまたはホスト名を指定します。ホスト名を指定する場合は string として指定します。UDP パケットをブロードキャストする場合は '255.255.255.255' を指定します。

リモート IP ポート — リモート IP ポート番号

25000 (既定値) | 範囲 [1, 65535] のスカラー

UDP パケットの送信先となる IP ポート番号を指定します。このパラメーターは生成されたコードでは調整できますが、シミュレーション中は調整できません。

Linux^® で IP ポート番号を 1024 未満に設定するには、MATLAB を root 権限で実行します。たとえば、Linux のコマンド ラインで sudo matlab と入力します。

ローカル IP ポートのソース — ローカル IP ポートのソース

自動的に決定 (既定値) | ダイアログにより指定

ブロックがシステムによって割り当てられたローカル ポート番号を使用するか、[ローカル IP ポート] パラメーターで指定したローカル ポート番号を使用するかを指定します。ポート番号をシステムによって割り当てる場合は、[自動的に決定] を選択します。受信アドレスにおいて特定のポート番号で UDP パケットを受信する必要がある場合は、[ダイアログにより指定] を選択し、[ローカル IP ポート] パラメーターを使用してポート番号を指定します。

ローカル IP ポート — ローカル IP ポート番号

-1 (既定値) | 範囲 [1, 65535] のスカラー

UDP パケットの送信元となる IP ポート番号を指定します。受信アドレスにおいて特定のポート番号でメッセージを受信する必要がある場合は、このパラメーターを使用します。

パラメーターの依存関係

このパラメーターを有効にするには、[ローカル IP ポートのソース] を [ダイアログにより指定] に設定します。

送信バッファー サイズ (バイト) — UDP パケットを送信するバッファーのサイズ

8192 (既定値) | 範囲 [1, 67108864] のスカラー

UDP パケットを送信するバッファーのサイズをバイト単位で指定します。バッファー オーバーフローによるデータの損失を回避するため、バッファーを十分に大きくしてください。

ブロックの特性

データ型	Boolean | double | integer | single
直達	いいえ
多次元信号	いいえ
可変サイズの信号	いいえ
ゼロクロッシング検出	いいえ

拡張機能

C/C++ コード生成

Simulink® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• このブロックから生成される実行可能ファイルは、MATLAB に付属のプリビルドされたダイナミック ライブラリ ファイル (.dll ファイル) に依存します。このブロックから生成されたコードとすべての関連ファイルを ZIP 圧縮ファイルにパッケージ化するには、関数 packNGo を使用します。この ZIP ファイルを使用して、MATLAB がインストールされていない他の開発環境にプロジェクトを移動して解凍し、リビルドすることができます。詳細については、How To Run a Generated Executable Outside MATLABを参照してください。

• [リモート IP ポート] パラメーターは生成されたコードでは調整できますが、シミュレーション中は調整できません。生成されたコードにおけるパラメーターの調整可能性は、いくつかの方法で制御できます。方法の一つとして、生成されたコードにおいてグローバルな構造体の調整可能なフィールドとしてパラメーターを構成することができます。他の方法としては、組み込みストレージ クラスまたはカスタム ストレージ クラスを Simulink.Parameter オブジェクトに適用し、このオブジェクトを使用してブロック パラメーターの値を設定することができます。詳細については、生成されたコードにおける調整可能なキャリブレーション パラメーターの作成 (Simulink Coder)を参照してください。

バージョン履歴

R2010a で導入

参考

オブジェクト

• dsp.UDPReceiver | dsp.UDPSender

ブロック

• UDP Receive

トピック

• How To Run a Generated Executable Outside MATLAB