analogRead2()は指定したチャネルの4~20mA補正入力値を読み取ります。

uint16_t analogRead2(uint8_t ch)

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);
}

• モジュールのDIPスイッチと配線は0~20mA電流入出力に合わせてください。
• 約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()を使用しません。
• analogReference(EXTERNAL)が必要なMPINO製品では、setup()で先に設定します。
• IanalogWrite2()とIanalogWrite2f()は4~20mA専用の簡易出力です。同じチャネルでIanalogWrite()と交互に使うことは推奨しません。
• アナログ出力回路には外部12~24V電源が必要です。USB電源だけでは正常に出力されない場合があります。
• 実際の電流入出力の検証は、テスト製品を準備して計測器で確認してください。

• analogRead2Avg() 詳細説明を見る
• analogRead2Avgf() 詳細説明を見る

← 内蔵コマンド一覧