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

''IanalogWrite2()''はユーザーの整数値を4~20mA出力範囲に変換します。

{{:ja-jp_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>

===== 注意事項 =====

  * モジュールのDIPスイッチ、外部電源、出力範囲を一致させます。
  * 同じタイマを共有するPWM機能と同時に設定しないでください。
  * 初期化していないチャネルに値を出力しないでください。
  * MPAINOのYアナログ出力の現在の有効チャネルは最大''0~11''のため、''12~15''は使用しません。
  * ''analogWriteInit()''、''analogWriteFreq()''、''analogWriteMax()''はYアナログ出力チャネル用で、高速パルスチャネル''20~31''には使用しません。
  * 高速パルスGPIO番号''130~141''を''analogWrite()''に使用しないでください。

===== 同じカテゴリの内蔵コマンド =====

  * [[:ja-jp_commands:reference:analogwrite2|analogWrite2() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:ianalogwrite2f|IanalogWrite2f() 詳細説明を見る]]

[[:ja-jp_commands:builtin|← 内蔵コマンド一覧]]