====== Itpl() ======

''Itpl()'' (Pulse Timer) returns true for the preset time starting when the condition turns ON.

{{:en-us_commands:reference:itpl.svg?900|Itpl command operation flow}}

''bool Itpl(uint8_t timer_id, bool state, unsigned long delayTime)''

===== Commands =====

^ Command ^ Arguments ^ Return Value ^ Operation ^
| ''Itpl(timer_id, state, delayTime)'' | ''uint8_t timer_id'' — Timer number. Supports ''0'' ~ ''255''\\ ''bool state'' — Timer input state\\ ''unsigned long delayTime'' — Preset time in ms | ''bool'' | (Pulse Timer) returns true for the preset time starting when the condition turns ON. |


===== 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. A rising input turns the output on for 1 s; another rising edge during the pulse restarts the 1 s period.

<code cpp>
const uint8_t INPUT_PIN = 0;
const uint8_t OUTPUT_PIN = 32;

void setup() {}

void loop() {
  const bool inputOn = digitalRead(INPUT_PIN) == HIGH;
  const bool outputOn = Itpl(0, inputOn, 1000);  // Make a 1 s pulse on a rising edge; another edge restarts it.
  digitalWrite(OUTPUT_PIN, outputOn ? HIGH : LOW);
}
</code>

===== Precautions =====

  * Call the timer command repeatedly in ''loop()'' so elapsed time and OFF input are processed.
  * Do not share a ''timer_id'' between different timer operations; use a separate ID for each.

===== Built-in Commands in the Same Category =====

  * [[:en-us_commands:reference:iton|Iton() View detailed description]]
  * [[:en-us_commands:reference:itof|Itof() View detailed description]]
  * [[: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]]