commands:reference:ianalogread2
IanalogRead2()
IanalogRead2()는 4~20mA 입력값을 지정한 정수 범위로 변환합니다.
int32_t IanalogRead2(uint8_t ch, int32_t min, int32_t max)
명령어
| 명령어 | 인수 | 반환값 | 동작 |
|---|---|---|---|
IanalogRead2(ch, min, max) | uint8_t ch — MPINO는 A0 같은 아날로그 핀, MPAINO는 0부터 시작하는 전체 모듈 채널 번호int32_t minint32_t max | int32_t | 4~20mA 입력값을 지정한 정수 범위로 변환합니다. |
예제
MPINO-8A4R(T)-S의 4~20mA 입력 A2를 0~100%로 환산하는 예제입니다.
void setup() { Serial.begin(115200); } void loop() { const int32_t percent = IanalogRead2(A2, 0, 100); // A2의 4~20mA 입력을 0~100% 정수로 환산합니다. if (percent == ANALOG_READ2_ERROR) { Serial.println(F("4-20mA input error")); } else { Serial.print(F("A2: ")); Serial.println(percent); } delay(500); }
주의사항
- 이 예제의
A2는 MPINO-8A4R(T)-S의 전류 입력입니다. 다른 제품에서는 4~20mA 지원 채널과 배선을 해당 제품의 핀맵에서 확인하십시오. - 약 3.6~4.0mA 입력은 정상값
0으로 반환하고, 3.6mA 미만은 오류값을 반환한다. - 오류값은 단선 판정을 돕기 위한 기준이다. 최종 경보와 안전 동작은 사용자가 프로그램에서 구현해야 한다.
IanalogRead2()와IanalogRead2f()도 오류 시 사용자 범위 값이 아니라65535를 반환하므로 결과를 사용하기 전에 오류를 확인한다.IanalogRead2()의min~max에는 전체int32_t범위를 사용할 수 있지만, 정상 범위에65535를 포함하면 오류값과 구분할 수 없다.analogRead2Avgf()는analogRead2Avg()와 별도 상태·버퍼를 사용한다. 두 함수를 함께 사용하면 SRAM 사용량이 증가한다.analogRead2Avgf()의samples가0이거나 메모리 확보에 실패하면 현재 정상 보정값을float로 반환한다.- MPINO에서는 4~20mA 입력이 아닌 전압·NTC 채널에
analogRead2()을 사용하지 않는다. - MPINO에서
analogReference(EXTERNAL)이 필요한 제품은setup()에서 먼저 설정한다. IanalogWrite2()와IanalogWrite2f()는 4~20mA 전용 간편 출력이다. 같은 채널에서IanalogWrite()와 번갈아 쓰지 않는 것이 좋다.- 아날로그 출력 회로는 외부 12~24V 전원이 필요하다. USB 전원만으로는 정상 출력되지 않을 수 있다.
- 실제 전류 입력/출력 검증은 테스트 제품 준비 후 계측기로 확인해야 한다.
같은 카테고리의 내장 명령어
commands/reference/ianalogread2.txt · 마지막으로 수정됨: 저자 127.0.0.1
