차이

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

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