====== IanalogWrite2() ======

''IanalogWrite2()''는 사용자 정수값을 4~20mA 출력 범위로 변환합니다.

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

''void IanalogWrite2(uint8_t ch, int32_t min, int32_t max, int32_t value)''

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

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''IanalogWrite2(ch, min, max, value)'' | ''uint8_t ch''\\ ''int32_t min''\\ ''int32_t max''\\ ''int32_t value'' | ''void'' | 사용자 정수값을 4~20mA 출력 범위로 변환합니다. |


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

<code cpp>
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);
}
</code>

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

  * 모듈 딥스위치, 외부 전원, 출력 범위를 일치시킵니다.
  * 같은 타이머를 공유하는 PWM 기능과 동시에 설정하지 않습니다.
  * 초기화하지 않은 채널에 값을 출력하지 않습니다.
  * MPAINO에서 Y 아날로그 출력의 현재 유효 채널은 최대 ''0~11''이므로 ''12~15''는 사용하지 않습니다.
  * ''analogWriteInit()'', ''analogWriteFreq()'', ''analogWriteMax()''는 Y 아날로그 출력 채널용이며 고속펄스 채널 ''20~31''에는 사용하지 않습니다.
  * 고속펄스 GPIO 번호 ''130~141''을 ''analogWrite()''에 사용하지 않습니다.

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

  * [[commands:reference:analogwrite2|analogWrite2() 상세 설명 보기]]
  * [[commands:reference:ianalogwrite2f|IanalogWrite2f() 상세 설명 보기]]

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