ILOGICS 제품 사용설명서

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

''ImodbusRTUmasterAdd()''는 반복 실행할 Master 요청을 등록합니다.

{{:commands:reference:imodbusrtumasteradd.svg?900|ImodbusRTUmasterAdd 명령어 동작 흐름}}

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

===== 명령어 =====

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''ImodbusRTUmasterAdd(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'' | ''bool'' | 반복 실행할 Master 요청을 등록합니다. |


===== 예제 =====

<code cpp>
void setup() {
  ImodbusRTUmasterInit(Serial2, 9600);  // Master 통신 포트와 보레이트를 설정합니다.
  ImodbusRTUmasterAdd(Serial2, 1, 0x03, 0x00, 1, &D[1]);  // 반복 실행할 Master 요청을 등록합니다.
  ImodbusRTUmasterAdd(Serial2, 1, 0x03, 0x01, 1, &D[2]);  // 반복 실행할 Master 요청을 등록합니다.
}

void loop() {
  ImodbusRTUmasterRun();  // 등록 요청 또는 지정한 단일 요청을 실행합니다.
}
</code>

===== 주의사항 =====

  * Slave 또는 Master 실행 함수는 ''loop()''에서 계속 호출해야 합니다.
  * 데이터 배열은 요청된 데이터 개수(quantity) 이상의 항목을 담을 수 있어야 합니다.
  * 반환 코드 BUSY와 IDLE은 통신 실패로 처리하지 않아야 합니다.
  * Cnet/MC Protocol과 ''M'', ''D''를 공유하면 최종 메모리 크기와 초기화 순서를 하나로 정해야 합니다. ''ImodbusRTUMem()'' 또는 ''ICnetMem()''을 실행 중 다시 호출하지 않아야 합니다.
  * 메모리 할당 함수는 성공 여부를 반환하지 않으므로 크기가 0이 아니면 사용자 코드에서 접근하기 전에 ''M'', ''D''가 ''nullptr''이 아닌지 확인해야 합니다.

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

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

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