Differences

This shows you the differences between two versions of the page.

--- en-us_commands:reference:itimerstop [2026/09/07 21:52] – 만듦 - 바깥 편집 127.0.0.1
+++ en-us_commands:reference:itimerstop [2026/09/12 22:54] (current) – 바깥 편집 127.0.0.1
@@ Line 15: / Line 15: @@
 ===== Example =====
+This uses the default callback timer (Timer2). The callback changes only a flag; serial output runs in ''loop()''.
 <code cpp>
-bool ItimerSet(unsigned long intervalMs, void (*callback)());
+void onTimer() {}
-bool ItimerSet(uint8_t timerNumber, unsigned long intervalMs, void (*callback)());
-bool ItimerStart();
+void setup() {
-bool ItimerStart(uint8_t timerNumber);
+  Serial.begin(115200);
-void ItimerStop();
+  if (!ItimerSet(1000, onTimer)) return;  // Configure the callback and interval first.
-void ItimerStop(uint8_t timerNumber);
+  ItimerStart();  // Start the configured callback timer.
-void ItimerStopAll();
+}
-bool ItimerState();
-bool ItimerState(uint8_t timerNumber);
+void loop() {
+  static bool stopped = false;
+  if (!stopped && millis() >= 5000) {
+    ItimerStop();  // Stop the default callback timer after 5 s.
+    stopped = true;
+    Serial.println(F("timer stopped"));
+  }
+}
 </code>
 ===== Precautions =====
-  * Timer interrupt callbacks run inside an ISR. For safety, change only flags in the callback and perform actual control processing in ''loop()''.
+  * The callback runs in an interrupt. Change only a flag there; do not call ''delay()'', ''Serial'', I2C or SPI in it.
-  * Do not use slow or interrupt-dependent code such as ''delay()'', ''Serial'', I2C or SPI in callbacks.
+  * The callback timer without a timer number uses Timer2. Do not use it together with ''tone()'' or PWM output that uses Timer2.
-  * Normally, call ''ImodbusRTU()'' repeatedly in ''loop()''. Call it from a timer interrupt with a sufficient interval only when long ''delay()'' calls or debug output slow down ''loop()''.
+  * When specifying another hardware timer, check for conflicts with PWM, analog output and high-speed counter functions using it.
-  * Do not use the default ''ItimerSet()'' together with ''tone()'' using Timer2 or ''analogWrite()'' on Timer2 PWM pins.
-  * Explicitly using Timer1, Timer3, Timer4 or Timer5 may conflict with PWM, analog output or high-speed counter functions using that timer.
+===== Built-in Commands in the Same Category =====
-  * Configure only one ''Itimer'' callback per hardware timer.
-  * Defining an ISR for the same timer directly in the sketch may conflict with ''Itimer'' operation.
+  * [[:en-us_commands:reference:itimerset|ItimerSet() View detailed description]]
-  * ''ItimerStopAll()'' stops only hardware interrupt timers. It does not reset PLC-style timer states such as ''Iton'', ''Itof'' or ''Itmr''.
+  * [[:en-us_commands:reference:itimerstart|ItimerStart() View detailed description]]
+  * [[:en-us_commands:reference:itimerstopall|ItimerStopAll() View detailed description]]
+  * [[:en-us_commands:reference:itimerstate|ItimerState() View detailed description]]
 [[:en-us_commands:builtin|← Built-in Command List]]