| 명령어 | 인수 | 반환값 | 동작 |
|---|---|---|---|
analogRead2Avg(ch, samples) | uint8_t ch — MPINO는 A0 같은 아날로그 핀, MPAINO는 0부터 시작하는 전체 모듈 채널 번호uint8_t samples — 읽기 이동 평균 샘플 개수. 최대 20개까지 적용 | int32_t | 4~20mA 입력값의 정수 평균을 반환합니다. |
MPAINO-8A8R(T)에 X 입력 모듈을 연결하고 Analog Input Module → X를 선택합니다. CH0의 DIP 스위치는 20mA·GND를 ON으로 설정한 뒤 4~20mA 신호를 연결합니다.
void setup() { Serial.begin(115200); } void loop() { const int32_t value = analogRead2Avg(0, 5); // 최근 정상 보정값 최대 5개의 정수 이동 평균을 읽습니다. if (value == ANALOG_READ2_AVG_ERROR) { Serial.println(F("4-20mA input error")); } else { Serial.println(value); } delay(500); }
0으로 반환하고, 3.6mA 미만은 오류값을 반환한다.IanalogRead2()와 IanalogRead2f()도 오류 시 사용자 범위 값이 아니라 65535를 반환하므로 결과를 사용하기 전에 오류를 확인한다.IanalogRead2()의 min~max에는 전체 int32_t 범위를 사용할 수 있지만, 정상 범위에 65535를 포함하면 오류값과 구분할 수 없다.analogRead2Avgf()는 analogRead2Avg()와 별도 상태·버퍼를 사용한다. 두 함수를 함께 사용하면 SRAM 사용량이 증가한다.analogRead2Avgf()의 samples가 0이거나 메모리 확보에 실패하면 현재 정상 보정값을 float로 반환한다.analogRead2()을 사용하지 않는다.analogReference(EXTERNAL)이 필요한 제품은 setup()에서 먼저 설정한다.IanalogWrite2()와 IanalogWrite2f()는 4~20mA 전용 간편 출력이다. 같은 채널에서 IanalogWrite()와 번갈아 쓰지 않는 것이 좋다.