writeline

シリアル ポートへの ASCII データ行の書き込み

R2019b 以降

構文

writeline(device,data)

説明

writeline(device,data) は、指定されたシリアル ポートに ASCII テキスト data を書き込み、その後に終端文字を書き込みます。この関数は、データおよび終端文字が書き込まれるまで、MATLAB^® の実行を一時停止します。

例

シリアル ポート デバイスからの ASCII データ行の書き込みと読み取り

シリアル ポート デバイスへの接続を作成します。この例では、COM3 のシリアル ポートはループバック デバイスに接続しています。

device = serialport("COM3",9600)

device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

既定の ASCII 終端文字をチェックします。

device.Terminator

ans = 

    "LF"

終端文字を "CR" に設定し、ASCII データの文字列を書き込みます。関数 writeline は、終端文字をデータに自動的に追加します。

configureTerminator(device,"CR")
writeline(device,"hello")

終端文字が自動的に追加された別の ASCII データの文字列を書き込みます。

writeline(device,"world")

ポートはループバック デバイスに接続しているため、デバイスに書き込むデータは MATLAB に返されます。ASCII データ文字列を読み取ります。関数 readline は、終端文字に到達するまでデータを返します。

readline(device)

ans = 

    "hello"

ASCII データ文字列をもう一度読み取り、書き込んだ 2 つ目の文字列を返します。

readline(device)

ans = 

    "world"

シリアル ポート接続をクリアします。

clear device

入力引数

device — シリアル ポート接続

serialport オブジェクト

シリアル ポート接続。serialport オブジェクトとして指定します。

例: writeline(device,1:5) は、シリアル ポート接続 device に書き込みます。

data — ASCII データ

文字ベクトル | string スカラー

書き込む ASCII データ。テキストの文字ベクトルまたは string スカラーとして指定します。

例: writeline(device,"*IDN?") は、ASCII 文字列 "*IDN?" を書き込みます。

データ型: char | string

バージョン履歴

R2019b で導入

参考

関数

• serialport | readline | write | configureTerminator