====== ImodbusRTUmaster() ======

''ImodbusRTUmaster()''は1つのMaster要求を直ちに実行します。

{{:ja-jp_commands:reference:imodbusrtumaster.svg?900|ImodbusRTUmaster コマンドの動作フロー}}

''uint8_t ImodbusRTUmaster(HardwareSerial& serialPort, uint8_t slaveId, uint8_t functionCode, uint16_t address, uint16_t quantity, uint16_t* data, uint16_t timeoutMs = 100)''

===== コマンド =====

^ コマンド ^ 引数 ^ 戻り値 ^ 動作 ^
| ''ImodbusRTUmaster(serialPort, slaveId, functionCode, address, quantity, data, timeoutMs)'' | ''HardwareSerial& serialPort'' — RS-485に接続したSerial\\ ''uint8_t slaveId'' — Slaveアドレス\\ ''uint8_t functionCode''\\ ''uint16_t address''\\ ''uint16_t quantity''\\ ''uint16_t* data''\\ ''uint16_t timeoutMs = 100'' | ''uint8_t'' | 1つのMaster要求を直ちに実行します。 |


===== 使用例 =====

<code cpp>
uint16_t data[10];
uint16_t readValue0;
uint16_t readValue1;

void setup() {
  ImodbusRTUmasterInit(Serial2, 9600);  // Master通信ポートとボーレートを設定します。
}

void loop() {
  uint8_t result;

  result = ImodbusRTUmaster(Serial2, 1, 0x03, 0, 2, data);  // 単一のMaster要求を即時実行します。
  if (result == IMODBUS_RTU_SUCCESS) {
    readValue0 = data[0];
    readValue1 = data[1];
  }

  data[0] = 1234;
  ImodbusRTUmaster(Serial2, 1, 0x06, 10, 1, data);  // 単一のMaster要求を即時実行します。
}
</code>

===== 注意事項 =====

  * SlaveまたはMasterの実行関数を''loop()''で継続的に呼び出します。
  * データ配列のサイズは要求quantity以上にしてください。
  * 戻りコードのBUSYとIDLEを通信失敗として扱わないでください。
  * Cnet/MC Protocolと''M''、''D''を共有する場合、最終サイズと初期化順序を統一します。''ImodbusRTUMem()''や''ICnetMem()''を実行中に再呼び出ししないでください。
  * メモリ割り当て関数は成功状態を返しません。サイズが0でない場合、''M''、''D''が''nullptr''でないことを確認してからユーザーコードでアクセスしてください。

===== 同じカテゴリの内蔵コマンド =====

  * [[:ja-jp_commands:reference:imodbusrtumasterinit|ImodbusRTUmasterInit() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:imodbusrtumasteradd|ImodbusRTUmasterAdd() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:imodbusrtumasterrun|ImodbusRTUmasterRun() 詳細説明を見る]]

[[:ja-jp_commands:builtin|← 内蔵コマンド一覧]]