TCP/IP クライアントの作成と設定の構成

MATLAB® TCP/IP クライアント サポートを使用すると、MATLAB からリモート ホストまたはハードウェアに接続してデータの読み取りと書き込みができます。一般的なワークフローは以下のとおりです。

  • サーバーまたはハードウェアに TCP/IP 接続を作成します。

  • 必要に応じて接続を構成します。

  • 読み取りと書き込みの操作を実行します。

  • 接続をクリアして閉じます。

TCP/IP インターフェイスを介して通信するには、まず tcpclient オブジェクトを作成します。

t = tcpclient(address,port);

アドレスは、リモート ホスト名またはリモート IP アドレスのいずれかになります。いずれの場合も、ポートは 1 と 65535 の間の正の整数でなければなりません。

ホスト名を使用したオブジェクトの作成

次に示すホスト アドレスとポート 80 を使用して、TCP/IP オブジェクト t を作成します。

t = tcpclient("www.mathworks.com",80)
t = 
  tcpclient with properties:

              Address: 'www.mathworks.com'
                 Port: 80
    NumBytesAvailable: 0

  Show all properties, functions

指定した Web アドレスまたは 'localhost' などのホスト名を使用して接続する場合、IP アドレスには既定で IPv6 形式が使用されます。接続先のサーバーで IPv4 形式が必要な場合、接続は失敗します。IPv4 では、ホスト名ではなく、明示的な IP アドレスを指定することで接続を作成できます。

IP アドレスを使用したオブジェクトの作成

次に示す IP アドレスとポート 80 を使用して、TCP/IP オブジェクト t を作成します。

t = tcpclient("144.212.130.17",80)
t = 
  tcpclient with properties:

              Address: '144.212.130.17'
                 Port: 80
    NumBytesAvailable: 0

  Show all properties, functions

Timeout プロパティの設定

オブジェクトを作成し、名前と値のペアの引数を使用して Timeout の値を設定します。Timeout パラメーターは、読み取りおよび書き込み操作を終了するまでの待ち時間 (秒) を指定します。既定値は 10 です。この値は、オブジェクトの作成中またはオブジェクトの作成後に変更できます。

タイムアウトが 20 秒の TCP/IP オブジェクトを作成します。

t = tcpclient("144.212.130.17",80,"Timeout",20)
t = 
  tcpclient with properties:

              Address: '144.212.130.17'
                 Port: 80
    NumBytesAvailable: 0

  Show all properties, functions

Timeout プロパティを表示します。

t.Timeout
ans =

    20

出力は、Timeout プロパティの変更を反映しています。

ConnectTimeout プロパティの設定

オブジェクトを作成し、名前と値のペアの引数を使用して ConnectTimeout の値を設定します。ConnectTimeout パラメーターは、指定したリモート ホストへの接続要求が成功または失敗するまで待機する最大時間を秒単位で指定します。値は 1 以上でなければなりません。ConnectTimeout を指定しない場合、既定値の Inf になります。この値は、オブジェクトの作成時にのみ指定できます。

TCP/IP オブジェクトを作成し、ConnectTimeout を 10 秒に指定します。

t = tcpclient("144.212.130.17",80,"ConnectTimeout",10)
t = 
  tcpclient with properties:

              Address: '144.212.130.17'
                 Port: 80
    NumBytesAvailable: 0

  Show all properties, functions

ConnectTimeout プロパティを表示します。

t.ConnectTimeout
ans =

    10

出力には ConnectTimeout プロパティの変更が反映されます。

メモ

無効なアドレスやポートを指定した場合、あるいはサーバーへの接続が確立できない場合、オブジェクトは作成されません。

転送遅延プロパティの設定

オブジェクトを作成し、名前と値のペアの引数を使用して EnableTransferDelay の値を設定します。EnableTransferDelay パラメーターは Nagle アルゴリズムがオンとオフのどちらであるかを指定します。転送遅延が有効になっている場合、クライアントは未処理データの小さいセグメントを収集し、サーバーから肯定応答 (ACK) が到着すると 1 つのパケットでそれらを送信します。転送遅延が無効になっている場合、クライアントは即座にデータをネットワークに送信します。EnableTransferDelay を指定しない場合、既定で true になります。この値は、オブジェクトの作成時にのみ指定できます。

転送遅延が無効に設定された TCP/IP オブジェクトを作成します。

t = tcpclient("144.212.130.17",80,"EnableTransferDelay",false)
t = 
  tcpclient with properties:

              Address: '144.212.130.17'
                 Port: 80
    NumBytesAvailable: 0

  Show all properties, functions

EnableTransferDelay プロパティを表示します。

t.EnableTransferDelay
ans =

  logical

   0

出力は、EnableTransferDelay プロパティの変更を反映しています。

TCP/IP オブジェクト プロパティの表示

tcpclient オブジェクトの作成後、各プロパティとその値の完全なリストを表示できます。tcpclient の出力の properties をクリックします。

t = tcpclient("www.mathworks.com",80)
t = 
  tcpclient with properties:

              Address: 'www.mathworks.com'
                 Port: 80
    NumBytesAvailable: 0

  Show all properties, functions

                   Address: 'www.mathworks.com'
                      Port: 80
         NumBytesAvailable: 0

            ConnectTimeout: Inf
                   Timeout: 10
                 ByteOrder: "little-endian"
                Terminator: "LF"

     BytesAvailableFcnMode: "off"
    BytesAvailableFcnCount: 64
         BytesAvailableFcn: []
           NumBytesWritten: 0

       EnableTransferDelay: 1
          ErrorOccurredFcn: []
                  UserData: []

これらのプロパティの設定方法の詳細については、プロパティを参照してください。

特定のプロパティを設定するには、関数 configureTerminator と configureCallback を使用できます。

参考

トピック