사용자 도구

사이트 도구


commands:reference:idigitalread

차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

다음 판
이전 판
commands:reference:idigitalread [2026/09/01 20:04] – 만듦 - 바깥 편집 127.0.0.1commands:reference:idigitalread [2026/09/14 20:30] (현재) – 바깥 편집 127.0.0.1
줄 1: 줄 1:
 ====== IdigitalRead() ====== ====== IdigitalRead() ======
  
-''IdigitalRead()''는 입력을 여러 번 읽어 짧은 노를 줄입니다.+''IdigitalRead()''는 입력을 여러 번 연속으로 고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.
  
 {{:commands:reference:idigitalread.svg?900|IdigitalRead 명령어 동작 흐름}} {{:commands:reference:idigitalread.svg?900|IdigitalRead 명령어 동작 흐름}}
줄 10: 줄 10:
  
 ^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^ ^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
-| ''IdigitalRead(pin, samples)'' | ''uint8_t pin'' — 디지털 입력 핀 번호\\ ''uint8_t samples'' — 연속 읽기 횟수. ''1'' 이하는 1회 읽기, 최대 ''255''회까지 적용 | ''bool'' | 입력을 여러 번 읽어 짧은 노이즈를 줄입니다. |+| ''IdigitalRead(pin, samples)'' | ''uint8_t pin'' — 디지털 입력 핀 번호\\ ''uint8_t samples'' — 연속 읽기 횟수. ''1'' 이하는 1회 읽기, 최대 ''255''회까지 적용 | ''bool'' | 입력을 여러 번 연속으로 고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다. | 
 + 
 +===== 동작 방식 ===== 
 + 
 +  * ''samples''회 연속으로 입력을 읽습니다. 
 +  * 모든 읽기값이 ''HIGH''이면 안정 상태를 ''HIGH''로 갱신합니다. 
 +  * 모든 읽기값이 ''LOW''이면 안정 상태를 ''LOW''로 갱신합니다. 
 +  * ''HIGH''와 ''LOW''가 섞이면 짧은 노이즈가 포함된 것으로 보고 이전 안정 상태를 유지합니다. 
 +  * 이전 안정 상태가 아직 없고 읽기값이 섞이면 ''LOW''를 반환합니다. 
  
 ===== 예제 ===== ===== 예제 =====
 +
 +MPAINO-8A8R(T)의 입력 ''0''을 읽고 출력 ''64''에 결과를 표시하는 예제입니다.
  
 <code cpp> <code cpp>
-void setup() { +void setup() {}
-  pinMode(0, INPUT); +
-}+
  
 void loop() { void loop() {
-  bool input = IdigitalRead(0, 5);+  bool input = IdigitalRead(0, 5);  // 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.
  
   if (input) {   if (input) {
줄 32: 줄 41:
 ===== 주의사항 ===== ===== 주의사항 =====
  
-''Ibounce'' 계열은 상태를 기억므로 ''loop()''에서 계속 호출하사용하는 제품의 실제 핀 또는 논리 채널을 지정해야 합니다.+  * ''samples''가 ''1''이면 입력을 한 번만 읽습니다. 
 +  * ''samples''를 크게 설정할수록 한 번 호출하는 간이 길어집니다일반적인 입력 노이즈 확인에는 ''3''회 또는 ''5''회를 권장합니다. 
 +  * 이 명령어는 여러 번 즉시 읽는 방식입니다. 기계식 스위치처럼 ms 단위 채터링을 제거하려면 ''Ibounce()''를 사용하십시오. 
 + 
 +===== 같은 카테고리의 내장 명령어 ===== 
 + 
 +  * [[commands:ibounce|Ibounce() 상세 설명 보기]] 
 +  * [[commands:reference:ibounceon|IbounceOn() 상세 설명 보기]] 
 +  * [[commands:reference:ibounceoff|IbounceOff() 상세 설명 보기]]
  
 [[commands:builtin|← 내장 명령어 리스트]] [[commands:builtin|← 내장 명령어 리스트]]
  
commands/reference/idigitalread.1788260660.txt.gz · 마지막으로 수정됨: 저자 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki