차이

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

--- commands:reference:analogread2avg [2026/09/01 20:04] – 만듦 - 바깥 편집 127.0.0.1
+++ commands:reference:analogread2avg [2026/09/14 20:30] (현재) – 바깥 편집 127.0.0.1
@@ 줄 11: / 줄 11: @@
 ^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
 | ''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 신호를 연결합니다.
 <code cpp>
@@ 줄 20: / 줄 23: @@
 void loop() {
-  uint16_t raw2 = analogRead2(0);
+  const int32_t value = analogRead2Avg(0, 5);  // 최근 정상 보정값 최대 5개의 정수 이동 평균을 읽습니다.
-  int32_t filtered2 = analogRead2Avg(0, 5);
+  if (value == ANALOG_READ2_AVG_ERROR) {
-  float filtered2f = analogRead2Avgf(0, 5);
+    Serial.println(F("4-20mA input error"));
-  float currentmA = IanalogRead2f(0, 4.0F, 20.0F);
+  } else {
+    Serial.println(value);
-  if (raw2 == ANALOG_READ2_ERROR || filtered2 == ANALOG_READ2_AVG_ERROR ||
-      filtered2f == (float)ANALOG_READ2_AVG_ERROR ||
-      currentmA == (float)ANALOG_READ2_ERROR) {
-    Serial.println("4-20mA input error");
-    delay(500);
-    return;
   }
-  int32_t percent = Iscale((int32_t)raw2, 0, 32767, 0, 100);
-  IanalogWrite2(0, 0, 100, 50);       // 50% → 약 12mA
-  IanalogWrite2f(1, 0.0F, 10.0F, 2.5F); // 25% → 약 8mA
-  Serial.print("4-20mA raw: ");
-  Serial.println(raw2);
-  Serial.print("4-20mA filtered: ");
-  Serial.println(filtered2);
-  Serial.print("4-20mA filtered float: ");
-  Serial.println(filtered2f, 2);
-  Serial.print("percent: ");
-  Serial.println(percent);
-  Serial.print("current: ");
-  Serial.println(currentmA, 2);
   delay(500);
 }
@@ 줄 55: / 줄 35: @@
 ===== 주의사항 =====
-채널, 입력 모듈의 전압·전류 선택과 딥스위치 설정을 먼저 확인하십시오. 평균 횟수를 늘리면 값은 안정되지만 응답이 느려집니다.
+  * MPAINO X모듈 CH0의 DIP 스위치를 20mA·GND ON으로 설정하고 전류 입력의 극성에 맞춰 배선하십시오.
+  * 약 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:analogread2|analogRead2() 상세 설명 보기]]
+  * [[commands:reference:analogread2avgf|analogRead2Avgf() 상세 설명 보기]]
 [[commands:builtin|← 내장 명령어 리스트]]