차이

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

--- commands:reference:itimerstopall [2026/09/08 00:53] – 바깥 편집 127.0.0.1
+++ commands:reference:itimerstopall [2026/09/12 22:54] (현재) – 바깥 편집 127.0.0.1
@@ 줄 14: / 줄 14: @@
 ===== 예제 =====
+기본 콜백 타이머(Timer2)를 사용합니다. 콜백에서는 플래그만 바꾸고 시리얼 출력은 ''loop()''에서 수행합니다.
 <code cpp>
-const uint8_t CALLBACK_TIMER = 3;
+void onTimer() {}
-volatile bool sampleDue = false;
-void sampleTask() {
-  sampleDue = true;
-}
 void setup() {
   Serial.begin(115200);
-  if (!ItimerSet(CALLBACK_TIMER, 100, sampleTask)) {  // 주기와 콜백 함수 또는 사용할 하드웨어 타이머를 설정합니다.
+  if (!ItimerSet(1000, onTimer)) return;  // 콜백과 주기를 먼저 설정해야 합니다.
-    Serial.println(F("timer setup failed"));
+  ItimerStart();  // 설정한 콜백 타이머를 실행합니다.
-    return;
-  }
-  ItimerStart(CALLBACK_TIMER);  // 설정한 콜백 타이머를 시작합니다.
 }
 void loop() {
-  if (sampleDue) {
+  static bool stopped = false;
-    noInterrupts();
+  if (!stopped && millis() >= 5000) {
-    sampleDue = false;
+    ItimerStopAll();  // 실행 중인 모든 콜백 타이머를 정지합니다.
-    interrupts();
+    stopped = true;
-    Serial.println(analogRead(A0));  // 지정한 채널의 원시 아날로그값을 읽습니다.
+    Serial.println(F("timer stopped"));
   }
-  const bool pause = IdigitalRead(0, 5);  // 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.
-  if (pause && ItimerState(CALLBACK_TIMER)) ItimerStop(CALLBACK_TIMER);  // 기본 또는 지정한 콜백 타이머의 실행 상태를 반환합니다. / 기본 또는 지정한 콜백 타이머를 정지합니다.
-  if (!pause && !ItimerState(CALLBACK_TIMER)) ItimerStart(CALLBACK_TIMER);  // 설정한 콜백 타이머를 시작합니다. / 기본 또는 지정한 콜백 타이머의 실행 상태를 반환합니다.
-  if (IdigitalRead(1, 5)) ItimerStopAll();  // 실행 중인 콜백 타이머를 모두 정지합니다. / 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.
 }
 </code>
@@ 줄 49: / 줄 38: @@
 ===== 주의사항 =====
-  * 타임 인터럽트 콜백은 ISR 안에서 실행된다. 콜백 안에서는 플래그만 바꾸고 실제 제어 처리는 ''loop()''에서 수행하는 것이 안전하다.
+  * 콜백은 인터럽트에서 실행됩니다. 콜백 안에서는 플래그만 바꾸고 ''delay()''·''Serial''·I2C·SPI를 사용하지 마십시오.
-  * 콜백 안에서 ''delay()'', ''Serial'', I2C, SPI처럼 오래 걸리거나 인터럽트에 의존하는 코드는 사용하지 않는다.
+  * 인수를 생략한 콜백 타이머는 Timer2를 사용합니다. 같은 타이머를 쓰는 ''tone()''이나 PWM 출력과 동시에 사용하지 마십시오.
-  * Modbus RTU는 기본적으로 ''loop()''에서 ''ImodbusRTU()''를 반복 호출한다. ''loop()''가 긴 ''delay()''나 디버그 출력 때문에 늦어지는 경우에만 충분한 주기의 타임 인터럽트에서 ''ImodbusRTU()''를 호출한다.
+  * 다른 하드웨어 타이머를 지정할 때도 해당 타이머를 사용하는 PWM·아날로그 출력·고속카운터 기능과 중복되는지 확인하십시오.
-  * Timer2를 쓰는 ''tone()'' 또는 Timer2 PWM 핀의 ''analogWrite()''와 기본 ''ItimerSet()''은 동시에 사용하지 않는다.
+  * ''ItimerStopAll()''은 콜백용 하드웨어 타이머만 멈춥니다. ''Iton()''·''Itof()''·''Itmr()''의 상태는 초기화하지 않습니다.
-  * Timer1, Timer3, Timer4, Timer5를 명시적으로 사용하면 해당 타이머를 쓰는 PWM, 아날로그 출력, 고속카운터 기능과 충돌할 수 있다.
-  * 같은 하드웨어 타이머에는 하나의 ''Itimer'' 콜백만 설정한다.
-  * 스케치에서 같은 타이머의 ISR을 직접 정의하면 ''Itimer'' 동작과 충돌할 수 있다.
-  * ''ItimerStopAll()''은 하드웨어 인터럽트 타이머만 정지한다. ''Iton'', ''Itof'', ''Itmr'' 같은 PLC 스타일 타이머 상태는 초기화하지 않는다.
 ===== 같은 카테고리의 내장 명령어 =====