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

''TCNTOUT()''는 32비트 확장 모드의 누적 상위 오버플로 값을 반환합니다.

{{: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에서는 카운트 증가 외의 작업을 하지 않습니다.

===== 같은 카테고리의 내장 명령어 =====

  * [[commands:reference:tcntsetup|TCNTSETUP() 상세 설명 보기]]

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