사용자 도구

사이트 도구


commands:reference:idigitalread

IdigitalRead()

IdigitalRead()는 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.

IdigitalRead 명령어 동작 흐름

bool IdigitalRead(uint8_t pin, uint8_t samples)

명령어

명령어 인수 반환값 동작
IdigitalRead(pin, samples) uint8_t pin — 디지털 입력 핀 번호
uint8_t samples — 연속 읽기 횟수. 1 이하는 1회 읽기, 최대 255회까지 적용
bool 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.

동작 방식

  • samples회 연속으로 입력을 읽습니다.
  • 모든 읽기값이 HIGH이면 안정 상태를 HIGH로 갱신합니다.
  • 모든 읽기값이 LOW이면 안정 상태를 LOW로 갱신합니다.
  • HIGHLOW가 섞이면 짧은 노이즈가 포함된 것으로 보고 이전 안정 상태를 유지합니다.
  • 이전 안정 상태가 아직 없고 읽기값이 섞이면 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);
  }
}

주의사항

  • samples1 이하이면 입력을 한 번만 읽습니다.
  • samples를 크게 설정할수록 한 번 호출하는 시간이 길어집니다. 일반적인 입력 노이즈 확인에는 3회 또는 5회를 권장합니다.
  • 이 명령어는 여러 번 즉시 읽는 방식입니다. 기계식 스위치처럼 ms 단위 채터링을 제거하려면 Ibounce()를 사용하십시오.

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

commands/reference/idigitalread.txt · 마지막으로 수정됨: 저자 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki