IdigitalRead()

IdigitalRead()は入力を複数回連続で読み、すべての値が同じ場合だけ状態を更新します。HIGHとLOWが混在すると、前の安定状態を維持します。

bool IdigitalRead(uint8_t pin, uint8_t samples)

• 入力をsamples回連続で読み取ります。
• 読み取り値がすべてHIGHの場合、安定状態をHIGHに更新します。
• 読み取り値がすべてLOWの場合、安定状態をLOWに更新します。
• HIGHとLOWが混在すると、短いノイズが含まれると判断して前の安定状態を維持します。
• 前の安定状態がまだなく、読み取り値が混在する場合はLOWを返します。

MPAINO-8A8R(T)の入力0を読み取り、その結果を出力64に表示する例です。

void setup() {}
 
void loop() {
  bool input = IdigitalRead(0, 5);  // 入力を連続して複数回読み、すべて一致した場合のみ状態を更新します。HIGHとLOWが混在する場合は前の安定状態を保持します。
 
  if (input) {
    digitalWrite(64, HIGH);
  } else {
    digitalWrite(64, LOW);
  }
}

• samplesが1以下の場合、入力を1回だけ読み取ります。
• samplesを大きくするほど1回の呼び出し時間が長くなります。一般的な入力ノイズ確認には3回または5回を推奨します。
• このコマンドは即時に複数回読み取る方式です。機械式スイッチのようなms単位のチャタリングを除去するにはIbounce()を使用してください。

• Ibounce() 詳細説明を見る
• IbounceOn() 詳細説明を見る
• IbounceOff() 詳細説明を見る

← 内蔵コマンド一覧