====== TCNTOUT() ======

''TCNTOUT()''は32ビット拡張モードの累積上位オーバーフロー値を返します。

{{:ja-jp_commands:reference:tcntout.svg?900|TCNTOUT コマンドの動作フロー}}

''uint16_t TCNTOUT(uint8_t timerNumber)''

===== コマンド =====

^ コマンド ^ 引数 ^ 戻り値 ^ 動作 ^
| ''TCNTOUT(timerNumber)'' | ''uint8_t timerNumber'' — 製品が対応する外部クロックタイマ番号 | ''uint16_t'' | 32ビット拡張モードの累積上位オーバーフロー値を返します。 |


===== 使用例 =====

<code cpp>
const uint8_t COUNTER_TIMER = 1;

void setup() {
  Serial.begin(115200);
  TCNTSETUP(COUNTER_TIMER, true);  // タイマ外部クロック入力と32ビット拡張モードを設定します。
}

void loop() {
  static uint16_t previousOverflow = 0;
  const uint16_t overflowCount = TCNTOUT(COUNTER_TIMER);  // 32ビット拡張モードの上位オーバーフロー累積値を返します。
  if (overflowCount != previousOverflow) {
    previousOverflow = overflowCount;
    Serial.println(overflowCount);
  }
}
</code>

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

  * タイマ外部クロック方式はMPINO-8A8RとMPINO-16A8R8Tだけが対応しています。
  * 対応製品でもTCNT端子とタイマ番号を製品資料で確認してください。
  * ''TCNTOUT()''を単純な16ビット現在カウンタ読み取り関数として解釈しないでください。
  * 他の製品の割り込みISRでは、カウント増加以外の処理を行わないでください。

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

  * [[:ja-jp_commands:reference:tcntsetup|TCNTSETUP() 詳細説明を見る]]

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