Modbusクライアント

定義された各リクエストには次のパラメータがあります。

• 名前 - リクエストの一意の名前。この名前は、クライアントコンポーネントの入出力端末名を定義するために使用されます。
• 機能コード - リクエストが実行する機能を定義します。機能には以下が含まれます。
  • コイルを読む
  • 離散入力を読み取る
  • 保持レジスタを読み取る
  • 入力レジスタの読み取り
  • シングルコイルを書く
  • 単一レジスタへの書き込み
  • 複数のコイルを書き込む
  • 複数のレジスタに書き込む
  • 複数のレジスタの読み取り書き込み
  • 入力レジスタの高度な読み取り
  • 保持レジスタの高度な読み取り
  • レジスタ書き込みアドバンス
• 読み取りアドレス - レジスタ値の読み取りに使用されるアドレス値
• 読み取る数 - 読み取るレジスタの数
• 書き込みアドレス - レジスタ値を書き込むために使用されるアドレス値
• 書き込む数 - 書き込むレジスタの数
• 「アドバンス」型関数コードのレジスタ定義では、括弧内の数字はすべて、その変数用に予約された16ビットレジスタのグループ（最大4桁、つまり64ビット）を表し、その横の文字は変数の型（i：int、u：unsigned int、f：32ビットレジスタグループの場合はfloat、64ビットレジスタグループの場合はdouble）を表します。例えば、[0,1,2,3]fは、0、1、2、3の16ビットレジスタに格納されるdouble型の変数を表します。レジスタは昇順に定義することが重要です。詳細については、 Modbusデバイスドキュメントの「保持レジスタと入力レジスタのアドレスの定義」を参照してください。
• 送信タイプ - 各リクエストが送信される際のイベントを定義します。送信タイプは以下のいずれかになります。
  • イベント時 - 選択すると、コンポーネント上にイベント信号を接続できる追加の端子が作成されます。
  • タイマーで
  • イベント時およびタイマー時 - 選択すると、コンポーネント上にイベント信号を接続できる追加の端子が作成されます。
• 送信期間 - リクエストの送信期間（ミリ秒単位）を定義します。

例外コードは、予期せぬ事態が発生した場合にサーバーから受信される値です。Modbusプロトコルでは、以下の例外コードが定義されています。

• 0x01 - 不正な関数
• 0x02 - 不正なデータアドレス
• 0x03 - 不正なデータ値
• 0x04 - サーバーデバイスの障害
• 0x05 - 確認応答
• 0x06 - サーバーデバイスがビジー状態
• 0x08 - メモリパリティエラー
• 0x0A - ゲートウェイパスが利用できません
• 0x0B - ゲートウェイターゲットデバイスが応答に失敗しました

リクエスト情報を変更するには、リクエストのリストを リクエスト プロパティ。このリストは、定義済みのフィールドを持つPython辞書で構成されています。各リクエスト辞書には以下のフィールドがあります。

表4 .リクエスト情報辞書フィールド

フィールド名	許容値
"名前"	ASCII文字列
「関数コード」	0x1、0x2、0x3、0x4、0x5、0x6、0xF、0x10、0x17、「コイルの読み取り」、「個別入力の読み取り」、「保持レジスタの読み取り」、「入力レジスタの読み取り」、「単一コイルの書き込み」、「単一レジスタの書き込み」、「複数コイルの書き込み」、「複数レジスタの書き込み」、「複数レジスタの読み取り/書き込み」、「高度なレジスタの書き込み」、「高度な入力レジスタの読み取り」、「高度な保持レジスタの読み取り」
「読み取りアドレス」	0 - 65535
「読み取るレジスタの数」	値は指定された機能コードによって異なります。 読み取りコイル数: 1 - 2000 離散入力を読み取る: 1 - 2000 保持レジスタの読み取り: 1 - 125 入力レジスタの読み取り: 1 - 125 複数のレジスタの読み取り/書き込み: 1 - 125
「書き込みアドレス」	0 - 65535
「書き込むレジスタの数」	値は指定された機能コードによって異なります。 シングルコイルの書き込み：1 単一レジスタへの書き込み: 1 複数のコイルを書き込む: 1 - 1968 複数のレジスタへの書き込み: 1 - 123 複数のレジスタの読み取り/書き込み: 1 - 121
「レジスタ仕様」	この値は、「レジスタ書き込みアドバンス」、「入力レジスタ読み取りアドバンス」、「保持レジスタ読み取りアドバンス」の各ファンクションコードで使用され、アクセスするレジスタのリストを定義します。この値はリクエスト定義セクションで定義されます。
「送信タイプ」	「イベント時」、「期間」、「イベント時および期間」
「送信期間」	1 - 1800000

で定義された要求を指定するために 図1、次のコードを実行する必要があります。

requests = [
    {"name": "request0", "function_code": "read holding registers", "read_address": 0, "number_of_registers_to_read": 5, "transmit_type": "on timer", "transmit_period": 1000},
    {"name": "request1", "function_code": "write multiple registers", "write_address": 100, "number_of_registers_to_write": 1, "transmit_type": "on timer", "transmit_period": 1000},
    {"name": "request2", "function_code": "read write multiple registers", "read_address": 0, "number_of_registers_to_read": 5, "write_address": 100, "number_of_registers_to_write": 1, "transmit_type": "on event", "transmit_period": 1000},
    {"name": "request3", "function_code": "write registers advanced", "register_specification": "[5]i, [6,7]u, [8,9,10,11]f", "transmit_type": "on timer", "transmit_period": 1000},
    {"name": "request4", "function_code": "read holding registers advanced", "register_specification": "[5]i, [6,7]u, [8,9,10,11]f", "transmit_type": "on timer", "transmit_period": 1000}
]

mdl.set_property_value(mdl.prop(modbus_client, "requests"), requests)