사용자 도구

사이트 도구


commands:reference:ianalogread2f

문서의 이전 판입니다!


IanalogRead2f()

IanalogRead2f()는 4~20mA 입력값을 지정한 실수 범위로 변환합니다.

IanalogRead2f 명령어 동작 흐름

float IanalogRead2f(uint8_t ch, float min, float max)

명령어

명령어 인수 반환값 동작
IanalogRead2f(ch, min, max) uint8_t ch — MPINO는 A0 같은 아날로그 핀, MPAINO는 0부터 시작하는 전체 모듈 채널 번호
float min
float max
float 4~20mA 입력값을 지정한 실수 범위로 변환합니다.

예제

void setup() {
  Serial.begin(115200);
}
 
void loop() {
  uint16_t raw2 = analogRead2(0);  // 지정한 채널의 4~20mA 보정 입력값을 읽습니다.
  int32_t filtered2 = analogRead2Avg(0, 5);  // 4~20mA 입력값의 정수 평균을 반환합니다.
  float filtered2f = analogRead2Avgf(0, 5);  // 4~20mA 입력값의 실수 평균을 반환합니다.
  float currentmA = IanalogRead2f(0, 4.0F, 20.0F);  // 4~20mA 입력값을 지정한 실수 범위로 변환합니다.
 
  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);
}

주의사항

  • 모듈 딥스위치와 배선은 0~20mA 전류 입출력 기준으로 맞춰야 한다.
  • 약 3.6~4.0mA 입력은 정상값 0으로 반환하고, 3.6mA 미만은 오류값을 반환한다.
  • 오류값은 단선 판정을 돕기 위한 기준이다. 최종 경보와 안전 동작은 사용자가 프로그램에서 구현해야 한다.
  • IanalogRead2()IanalogRead2f()도 오류 시 사용자 범위 값이 아니라 65535를 반환하므로 결과를 사용하기 전에 오류를 확인한다.
  • IanalogRead2()min~max에는 전체 int32_t 범위를 사용할 수 있지만, 정상 범위에 65535를 포함하면 오류값과 구분할 수 없다.
  • analogRead2Avgf()analogRead2Avg()와 별도 상태·버퍼를 사용한다. 두 함수를 함께 사용하면 SRAM 사용량이 증가한다.
  • analogRead2Avgf()samples0이거나 메모리 확보에 실패하면 현재 정상 보정값을 float로 반환한다.
  • MPINO에서는 4~20mA 입력이 아닌 전압·NTC 채널에 analogRead2()을 사용하지 않는다.
  • MPINO에서 analogReference(EXTERNAL)이 필요한 제품은 setup()에서 먼저 설정한다.
  • IanalogWrite2()IanalogWrite2f()는 4~20mA 전용 간편 출력이다. 같은 채널에서 IanalogWrite()와 번갈아 쓰지 않는 것이 좋다.
  • 아날로그 출력 회로는 외부 12~24V 전원이 필요하다. USB 전원만으로는 정상 출력되지 않을 수 있다.
  • 실제 전류 입력/출력 검증은 테스트 제품 준비 후 계측기로 확인해야 한다.

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

commands/reference/ianalogread2f.1788796396.txt.gz · 마지막으로 수정됨: 저자 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki