ILOGICS 제품 사용설명서

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
====== IanalogWrite2f() ======

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

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

''void IanalogWrite2f(uint8_t ch, float min, float max, float value)''

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

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''IanalogWrite2f(ch, min, max, value)'' | ''uint8_t ch'' — MPINO는 ''A0'' 같은 아날로그 핀, MPAINO는 ''0''부터 시작하는 전체 모듈 채널 번호\\ ''float min''\\ ''float max''\\ ''float value'' — ''min'' ~ ''max'' 범위로 표현한 출력값 | ''void'' | 사용자 실수값을 4~20mA 출력 범위로 변환합니다. |


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

MPAINO-8A8R(T)에 Y 출력 모듈을 연결하고 **Analog Output Module → Y**를 선택해주시기 바랍니다. CH0의 DIP 스위치를 OFF로 설정한 뒤 ''I+''와 ''−'' 단자에서 4~20mA 출력을 확인해주시기 바랍니다.

<code cpp>
void setup() {}

void loop() {
  IanalogWrite2f(0, 0.0F, 100.0F, 25.0F);  // 25%를 4~20mA 범위로 환산해 약 8mA를 출력합니다.
  delay(500);
}
</code>

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

  * MPAINO Y모듈 CH0의 DIP를 OFF로 설정하고 4~20mA 출력을 ''I+''와 ''−'' 단자에 연결해주시기 바랍니다.
  * 약 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:analogwrite2|analogWrite2() 상세 설명 보기]]
  * [[commands:reference:ianalogwrite2|IanalogWrite2() 상세 설명 보기]]

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