ILOGICS 제품 사용설명서

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

''analogRead()''는 지정한 채널의 원시 아날로그값을 읽습니다.

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

''int analogRead(uint8_t pin)''

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

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''analogRead(pin)'' | ''uint8_t pin'' — MPAINO에서는 ''0'' ~ ''19''를 아날로그 입력 모듈 전체 채널 번호로 사용 | ''int'' | 지정한 채널의 원시 아날로그값을 읽습니다. |


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

MPAINO-8A8R(T)에 X 입력 모듈 2개를 연결하고 Arduino IDE에서 **Analog Input Module → X2**를 선택한 예제입니다. X1의 CH0은 ''0'', X2의 CH0은 ''4''입니다.

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

void loop() {
  const int first = analogRead(0);  // X1 CH0의 원시 아날로그값을 읽습니다.
  const int second = analogRead(4);  // X2 CH0의 원시 아날로그값을 읽습니다.
  Serial.print(F("X1 CH0: "));
  Serial.println(first);
  Serial.print(F("X2 CH0: "));
  Serial.println(second);
  delay(500);
}
</code>

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

  * MPAINO에서 ''analogRead(0~19)''의 반환값은 전압·전류·온도 단위로 변환된 값이 아니라 ADS1118의 원시 ADC 값입니다.
  * 4~20mA 입력에서 소프트웨어 컷과 단선 판정이 필요하면 MPINO에서는 ''analogRead2(A핀)'', MPAINO에서는 ''analogRead2(모듈 채널)''을 사용해주시기 바랍니다.
  * 샘플링 속도는 ''analogReadInit(sps)''로 설정할 수 있습니다. 설정하지 않으면 ''analogRead()''의 기본값이 적용됩니다.
  * 평균 샘플 수는 최대 ''20''입니다. ''samples = 0''이거나 메모리 확보에 실패하면 현재 원시값을 반환합니다.
  * 두 평균 함수를 모두 사용하면 각각 별도의 동적 버퍼를 확보하므로 SRAM 사용량이 증가합니다.
  * MPAINO 아날로그 입력 모듈의 딥스위치 설정과 실제 배선은 입력 종류와 일치해야 합니다.

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

  * [[commands:reference:analogreadinit|analogReadInit() 상세 설명 보기]]
  * [[commands:reference:analogreadavg|analogReadAvg() 상세 설명 보기]]
  * [[commands:reference:analogreadavgf|analogReadAvgf() 상세 설명 보기]]

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