差分

このページの2つのバージョン間の差分を表示します。

--- ja-jp_commands:reference:itimerstate [2026/09/07 23:35] – 바깥 편집 127.0.0.1
+++ ja-jp_commands:reference:itimerstate [2026/09/12 22:55] (現在) – 바깥 편집 127.0.0.1
@@ 行 15: / 行 15: @@
 ===== 使用例 =====
+既定のコールバックタイマ（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 unsigned long lastPrint = 0;
-    noInterrupts();
+  static bool stopped = false;
-    sampleDue = false;
+  if (!stopped && millis() >= 3000) {
-    interrupts();
+    ItimerStop();  // 5秒後に既定のコールバックタイマを停止します。
-    Serial.println(analogRead(A0));  // 指定チャンネルの生のアナログ値を読み取ります。
+    stopped = true;
+  }
+  if (millis() - lastPrint >= 1000) {
+    lastPrint = millis();
+    const bool running = ItimerState();  // 既定のコールバックタイマが実行中か確認します。
+    Serial.println(running ? F("running") : F("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>
@@ 行 50: / 行 44: @@
 ===== 注意事項 =====
-  * タイマ割り込みコールバックはISR内で実行されます。コールバックではフラグだけを変更し、実際の制御処理を''loop()''で行うのが安全です。
+  * コールバックは割り込み内で実行されます。フラグだけを変更し、''delay()''・''Serial''・I2C・SPIを呼び出さないでください。
-  * コールバック内で''delay()''、''Serial''、I2C、SPIなど時間がかかる処理や割り込みに依存するコードを使用しません。
+  * タイマ番号を省略したコールバックタイマはTimer2を使います。同じTimer2を使う''tone()''やPWM出力と併用しないでください。
-  * Modbus RTUは通常''loop()''で''ImodbusRTU()''を繰り返し呼び出します。長い''delay()''やデバッグ出力で''loop()''が遅くなる場合だけ、十分な周期のタイマ割り込みから''ImodbusRTU()''を呼び出します。
+  * 別のハードウェアタイマを指定する場合も、そのタイマを使用するPWM・アナログ出力・高速カウンタ機能との重複を確認してください。
-  * Timer2を使う''tone()''、またはTimer2 PWMピンの''analogWrite()''と、既定の''ItimerSet()''は同時使用しません。
-  * Timer1、Timer3、Timer4、Timer5を明示的に使用すると、同じタイマを使うPWM、アナログ出力、高速カウンタ機能と競合する場合があります。
+===== 同じカテゴリの内蔵コマンド =====
-  * 1つのハードウェアタイマには''Itimer''コールバックを1つだけ設定します。
-  * スケッチで同じタイマのISRを直接定義すると、''Itimer''の動作と競合する場合があります。
+  * [[:ja-jp_commands:reference:itimerset|ItimerSet() 詳細説明を見る]]
-  * ''ItimerStopAll()''はハードウェア割り込みタイマだけを停止します。''Iton''、''Itof''、''Itmr''などのPLCスタイルタイマの状態は初期化しません。
+  * [[:ja-jp_commands:reference:itimerstart|ItimerStart() 詳細説明を見る]]
+  * [[:ja-jp_commands:reference:itimerstop|ItimerStop() 詳細説明を見る]]
+  * [[:ja-jp_commands:reference:itimerstopall|ItimerStopAll() 詳細説明を見る]]
 [[:ja-jp_commands:builtin|← 内蔵コマンド一覧]]