====== IanalogRead() ======

''IanalogRead()''는 아날로그 입력값을 지정한 정수 범위로 변환합니다.

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

''int32_t IanalogRead(uint8_t ch, int32_t min, int32_t max)''

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

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''IanalogRead(ch, min, max)'' | ''uint8_t ch'' — 읽을 아날로그 입력 핀 또는 채널\\ ''int32_t min'' — ''int32_t'' 변환 결과의 최솟값\\ ''int32_t max'' — ''int32_t'' 변환 결과의 최댓값 | ''int32_t'' | 아날로그 입력값을 지정한 정수 범위로 변환합니다. |


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

<code cpp>
void setup() {
  Serial.begin(115200);
}

void loop() {
  int32_t percent = IanalogRead(A0, 0, 100);  // 아날로그 입력값을 지정한 정수 범위로 변환합니다.
  Serial.println(percent);
  delay(500);
}
</code>

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

  * ''min''과 ''max''는 센서의 실제 전기적 입력 범위를 설정하는 값이 아니라 반환값의 변환 범위이다.
  * ''Iscale()'' 또는 ''Iscalef()''의 범위 제한이 적용되므로 결과는 지정한 두 출력 끝값을 벗어나지 않는다.
  * ''min''을 ''max''보다 크게 지정하면 출력 범위가 반전된다. 예: ''IanalogRead(A0, 100, 0)''.
  * MPINO와 MPAINO의 원시 ADC 범위가 다르므로 반드시 선택한 보드에 맞는 ''ch''를 사용한다.
  * MPAINO 아날로그 입력 모듈의 딥스위치와 배선은 실제 입력 종류에 맞게 설정해야 한다.
  * 이 명령어는 선형 범위 변환만 수행한다. 센서 오차 보정, 단선 판정 또는 4~20mA 소프트웨어 Cut이 필요하면 별도 처리가 필요하다.

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

  * [[commands:reference:ianalogreadf|IanalogReadf() 상세 설명 보기]]

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