차이

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

--- commands:reference:itmr [2026/09/08 00:53] – 바깥 편집 127.0.0.1
+++ commands:reference:itmr [2026/09/14 20:30] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== Itmr() ======
-''Itmr()''는 (Retentive Timer) 조건이 ON인 시간을 누적하고 Reset 입력으로 초기화합니다.
+''Itmr()''은 입력이 ON인 시간을 누적하고 ''reset'' 입력으로 누적 시간을 초기화합니다.
 {{:commands:reference:itmr.svg?900|Itmr 명령어 동작 흐름}}
@@ 줄 10: / 줄 10: @@
 ^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
-| ''Itmr(timer_id, state, delayTime, reset)'' | ''uint8_t timer_id'' — 타이머 번호. ''0'' ~ ''255'' 범위에서 사용 가능\\ ''bool state'' — 타이머 입력 상태\\ ''unsigned long delayTime'' — 설정 시간. 단위는 ms\\ ''bool reset = false'' — ''Itmr'' 적산값 초기화 | ''bool'' | (Retentive Timer) 조건이 ON인 시간을 누적하고 Reset 입력으로 초기화합니다. |
+| ''Itmr(timer_id, state, delayTime, reset)'' | ''uint8_t timer_id'' — 타이머 번호. ''0'' ~ ''255'' 범위에서 사용 가능\\ ''bool state'' — 타이머 입력 상태\\ ''unsigned long delayTime'' — 설정 시간. 단위는 ms\\ ''bool reset = false'' — ''Itmr'' 적산값 초기화 | ''bool'' | 입력이 ON인 시간을 누적하고 ''reset'' 입력으로 누적 시간을 초기화합니다. |
 ===== 예제 =====
+MPINO-8A4R(T)-S 보드를 선택한 예제입니다. ''P0'' 입력과 ''P32'' 출력을 사용합니다. ''loop()''를 막지 않고 매번 명령어를 호출합니다. ''P0''이 ON인 시간을 합산해 3초가 되면 ''P32''를 켭니다. ''P0''이 OFF여도 누적시간은 유지되며 ''P1''이 ON이면 초기화합니다.
 <code cpp>
-const uint8_t START_INPUT = 0;
+const uint8_t RUN_INPUT = 0;
 const uint8_t RESET_INPUT = 1;
-const uint8_t RUN_OUTPUT = 32;
+const uint8_t OUTPUT_PIN = 32;
-void setup() {
+void setup() {}
-  Serial.begin(115200);
-}
 void loop() {
-  const bool start = IdigitalRead(START_INPUT, 5);  // 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.
+  const bool run = digitalRead(RUN_INPUT) == HIGH;
-  const bool reset = IdigitalRead(RESET_INPUT, 5);  // 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.
+  const bool reset = digitalRead(RESET_INPUT) == HIGH;
-  const bool ready = Iton(0, start, 1000);  // (On Delay Timer) 조건이 일정 시간 동안 ON이 되어야 true를 반환합니다.
+  const bool elapsed = Itmr(0, run, 3000, reset);  // 입력이 ON인 시간만 누적하고 reset이 true이면 초기화합니다.
-  const bool stopDelay = Itof(1, ready, 500);  // (Off Delay Timer) 조건이 OFF된 후 일정 시간이 지나면 false를 반환합니다.
+  digitalWrite(OUTPUT_PIN, elapsed ? HIGH : LOW);
-  const bool startPulse = Itpl(2, ready, 200);  // (Pulse Timer) 조건이 ON되는 순간부터 설정 시간 동안 true를 반환합니다.
-  const bool inspectionWindow = Itmon(3, startPulse, 3000);  // (Monostable Timer) 동작 중 재입력되어도 시간이 연장되지 않는 펄스를 출력합니다.
-  const bool batchDone = Itmr(4, ready, 10000, reset);  // (Retentive Timer) 조건이 ON인 시간을 누적하고 Reset 입력으로 초기화합니다.
-  const unsigned long elapsed = IgetTime(4);  // 지정한 타이머의 현재 경과시간을 반환합니다.
-  const bool savedDone = IgetState(4);  // 지정한 타이머의 현재 출력 상태를 반환합니다.
-  digitalWrite(RUN_OUTPUT, stopDelay && !batchDone ? HIGH : LOW);
-  if (inspectionWindow && elapsed % 1000 < 20) {
-    Serial.println(savedDone ? F("batch complete") : F("batch running"));
-  }
 }
 </code>
@@ 줄 44: / 줄 34: @@
 ===== 주의사항 =====
-  * 타임 인터럽트 콜백은 ISR 안에서 실행된다. 콜백 안에서는 플래그만 바꾸고 실제 제어 처리는 ''loop()''에서 수행하는 것이 안전하다.
+  * 타이머 명령어는 ''loop()''에서 반복 호출해야 시간이 경과하고 입력 OFF도 반영됩니다.
-  * 콜백 안에서 ''delay()'', ''Serial'', I2C, SPI처럼 오래 걸리거나 인터럽트에 의존하는 코드는 사용하지 않는다.
+  * 같은 ''timer_id''를 다른 타이머 동작과 공유하면 상태가 섞입니다. 동작마다 다른 번호를 사용하십시오.
-  * Modbus RTU는 기본적으로 ''loop()''에서 ''ImodbusRTU()''를 반복 호출한다. ''loop()''가 긴 ''delay()''나 디버그 출력 때문에 늦어지는 경우에만 충분한 주기의 타임 인터럽트에서 ''ImodbusRTU()''를 호출한다.
+  * ''reset''이 true이면 누적시간과 완료 상태가 초기화됩니다.
-  * Timer2를 쓰는 ''tone()'' 또는 Timer2 PWM 핀의 ''analogWrite()''와 기본 ''ItimerSet()''은 동시에 사용하지 않는다.
-  * Timer1, Timer3, Timer4, Timer5를 명시적으로 사용하면 해당 타이머를 쓰는 PWM, 아날로그 출력, 고속카운터 기능과 충돌할 수 있다.
-  * 같은 하드웨어 타이머에는 하나의 ''Itimer'' 콜백만 설정한다.
-  * 스케치에서 같은 타이머의 ISR을 직접 정의하면 ''Itimer'' 동작과 충돌할 수 있다.
-  * ''ItimerStopAll()''은 하드웨어 인터럽트 타이머만 정지한다. ''Iton'', ''Itof'', ''Itmr'' 같은 PLC 스타일 타이머 상태는 초기화하지 않는다.
 ===== 같은 카테고리의 내장 명령어 =====