차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- commands:reference:analogread [2026/09/01 20:04] – 만듦 - 바깥 편집 127.0.0.1
+++ commands:reference:analogread [2026/10/25 11:33] (현재) – 바깥 편집 127.0.0.1
@@ 줄 11: / 줄 11: @@
 ^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
 | ''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>
@@ 줄 20: / 줄 23: @@
 void loop() {
-  int ai0 = analogRead(0);
+  const int first = analogRead(0);  // X1 CH0의 원시 아날로그값을 읽습니다.
-  int ai4 = analogRead(4);
+  const int second = analogRead(4);  // X2 CH0의 원시 아날로그값을 읽습니다.
-  int32_t avg0 = analogReadAvg(0, 5);
+  Serial.print(F("X1 CH0: "));
-  float avg0f = analogReadAvgf(0, 5);
+  Serial.println(first);
+  Serial.print(F("X2 CH0: "));
-  Serial.print("AI0: ");
+  Serial.println(second);
-  Serial.println(ai0);
-  Serial.print("AI4: ");
-  Serial.println(ai4);
-  Serial.print("AI0 AVG: ");
-  Serial.println(avg0);
-  Serial.print("AI0 AVG float: ");
-  Serial.println(avg0f, 2);
   delay(500);
 }
@@ 줄 43: / 줄 35: @@
 ===== 주의사항 =====
-  * MPAINO에서 ''analogRead(0~19)''의 반환값은 전압, 전류, 온도 단위로 변환된 값이 아니라 ADS1118 원시 ADC 값이다.
+  * MPAINO에서 ''analogRead(0~19)''의 반환값은 전압·전류·온도 단위로 변환된 값이 아니라 ADS1118의 원시 ADC 값입니다.
-  * 4~20mA 용도로 소프트웨어 컷과 단선 판정이 필요하면 MPINO는 ''analogRead2(A핀)'', MPAINO는 ''analogRead2(모듈 채널)''을 사용한다.
+  * 4~20mA 입력에서 소프트웨어 컷과 단선 판정이 필요하면 MPINO에서는 ''analogRead2(A핀)'', MPAINO에서는 ''analogRead2(모듈 채널)''을 사용해주시기 바랍니다.
-  * 샘플링 속도는 ''analogReadInit(sps)''로 설정할 수 있고, 설정하지 않으면 ''analogRead()'' 기본값을 따른다.
+  * 샘플링 속도는 ''analogReadInit(sps)''로 설정할 수 있습니다. 설정하지 않으면 ''analogRead()''의 기본값이 적용됩니다.
-  * 평균 샘플 수는 최대 ''20''이며 ''samples = 0'' 또는 메모리 확보 실패 시 현재 원시값을 반환한다.
+  * 평균 샘플 수는 최대 ''20''입니다. ''samples = 0''이거나 메모리 확보에 실패하면 현재 원시값을 반환합니다.
-  * 두 평균 함수를 모두 사용하면 각각 별도 동적 버퍼를 확보하므로 SRAM 사용량이 증가한다.
+  * 두 평균 함수를 모두 사용하면 각각 별도의 동적 버퍼를 확보하므로 SRAM 사용량이 증가합니다.
-  * MPAINO 아날로그 입력 모듈의 딥스위치와 실제 배선이 입력 종류와 일치해야 한다.
+  * MPAINO 아날로그 입력 모듈의 딥스위치 설정과 실제 배선은 입력 종류와 일치해야 합니다.
+===== 같은 카테고리의 내장 명령어 =====
+  * [[commands:reference:analogreadinit|analogReadInit() 상세 설명 보기]]
+  * [[commands:reference:analogreadavg|analogReadAvg() 상세 설명 보기]]
+  * [[commands:reference:analogreadavgf|analogReadAvgf() 상세 설명 보기]]
 [[commands:builtin|← 내장 명령어 리스트]]