ILOGICS 제품 사용설명서

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
====== ImodbusRTUmaster() ======

''ImodbusRTUmaster()''는 하나의 Master 요청을 즉시 실행합니다.

{{: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'' | 하나의 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''이 아닌지 확인해야 합니다.

===== 같은 카테고리의 내장 명령어 =====

  * [[commands:reference:imodbusrtumasterinit|ImodbusRTUmasterInit() 상세 설명 보기]]
  * [[commands:reference:imodbusrtumasteradd|ImodbusRTUmasterAdd() 상세 설명 보기]]
  * [[commands:reference:imodbusrtumasterrun|ImodbusRTUmasterRun() 상세 설명 보기]]

[[commands:builtin|← 내장 명령어 리스트]]