Differences

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

--- en-us_commands:reference:iton [2026/09/07 23:35] – 바깥 편집 127.0.0.1
+++ en-us_commands:reference:iton [2026/09/14 20:30] (current) – external edit 127.0.0.1
@@ Line 14: / Line 14: @@
 ===== Example =====
+This example selects MPINO-8A4R(T)-S and uses input ''P0'' and output ''P32''. Call the command on every pass through ''loop()'' without blocking it. The output turns on after 1 s of continuous input and turns off immediately when the input goes off.
 <code cpp>
-const uint8_t START_INPUT = 0;
+const uint8_t INPUT_PIN = 0;
-const uint8_t RESET_INPUT = 1;
+const uint8_t OUTPUT_PIN = 32;
-const uint8_t RUN_OUTPUT = 32;
-void setup() {
+void setup() {}
-  Serial.begin(115200);
-}
 void loop() {
-  const bool start = IdigitalRead(START_INPUT, 5);  // Read the input repeatedly and update only if all samples match. If HIGH and LOW are mixed, retain the previous stable state.
+  const bool inputOn = digitalRead(INPUT_PIN) == HIGH;
-  const bool reset = IdigitalRead(RESET_INPUT, 5);  // Read the input repeatedly and update only if all samples match. If HIGH and LOW are mixed, retain the previous stable state.
+  const bool outputOn = Iton(0, inputOn, 1000);  // Return true only after the input stays ON for 1 s.
-  const bool ready = Iton(0, start, 1000);  // (On Delay Timer) Return true only after the condition remains ON for the set time.
+  digitalWrite(OUTPUT_PIN, outputOn ? HIGH : LOW);
-  const bool stopDelay = Itof(1, ready, 500);  // (Off Delay Timer) Return false after a set delay following the condition turning OFF.
-  const bool startPulse = Itpl(2, ready, 200);  // (Pulse Timer) Return true for the set duration from the instant the condition turns ON.
-  const bool inspectionWindow = Itmon(3, startPulse, 3000);  // (Monostable Timer) Output a pulse whose duration is not extended by another trigger while running.
-  const bool batchDone = Itmr(4, ready, 10000, reset);  // (Retentive Timer) Accumulate the time the condition is ON; clear it with the Reset input.
-  const unsigned long elapsed = IgetTime(4);  // Return the specified timer's current elapsed time.
-  const bool savedDone = IgetState(4);  // Return the specified timer's current output state.
-  digitalWrite(RUN_OUTPUT, stopDelay && !batchDone ? HIGH : LOW);
-  if (inspectionWindow && elapsed % 1000 < 20) {
-    Serial.println(savedDone ? F("batch complete") : F("batch running"));
-  }
 }
 </code>
@@ Line 44: / Line 32: @@
 ===== Precautions =====
-  * Timer interrupt callbacks run inside an ISR. For safety, change only flags in the callback and perform actual control processing in ''loop()''.
+  * Call the timer command repeatedly in ''loop()'' so elapsed time and OFF input are processed.
-  * Do not use slow or interrupt-dependent code such as ''delay()'', ''Serial'', I2C or SPI in callbacks.
+  * Do not share a ''timer_id'' between different timer operations; use a separate ID for each.
-  * 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()''.
-  * Do not use the default ''ItimerSet()'' together with ''tone()'' using Timer2 or ''analogWrite()'' on Timer2 PWM pins.
+===== Built-in Commands in the Same Category =====
-  * Explicitly using Timer1, Timer3, Timer4 or Timer5 may conflict with PWM, analog output or high-speed counter functions using that timer.
-  * Configure only one ''Itimer'' callback per hardware timer.
+  * [[:en-us_commands:reference:itof|Itof() View detailed description]]
-  * Defining an ISR for the same timer directly in the sketch may conflict with ''Itimer'' operation.
+  * [[:en-us_commands:reference:itpl|Itpl() 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:itmon|Itmon() View detailed description]]
+  * [[:en-us_commands:reference:itmr|Itmr() View detailed description]]
 [[:en-us_commands:builtin|← Built-in Command List]]