基礎 · 読了まで16分

Arduinoのウォッチドッグタイマー:フリーズしたボードを自動でリセットする

Arduinoのウォッチドッグタイマーとは?UnoではAVRのavr/wdt.h、ESP32ではTask WDT、Picoではmachine.WDTを使い、フリーズしたボードを自動でリセットする方法と、フィードの正しい置き場所を解説します。

Arduinoのウォッチドッグは、プログラムが固まったことを検知して、ボードを自動で再起動するハードウェアの安全タイマーです。プログラムは「まだ動いています」という合図を定期的に送ります。決められた時間内にその合図が届かないと、ウォッチドッグはリセットボタンを押したときと同じようにボードをリセットします。そのため、無限ループに入ったプロジェクトや、センサーを待ったまま止まったプロジェクト、Wi-Fiライブラリの中でフリーズしたプロジェクトも、わざわざ電源を抜きに行かなくても数秒で復帰します。

机の上で試しているなら、フリーズしたボードを手でリセットするのは簡単です。しかし、庭の水やりシステムや屋根の上の気象ステーション、何週間も動き続けるスマートホーム機器ではそうはいきません。この記事では、ウォッチドッグの仕組み、Arduino Unoでのavr/wdt.h、ESP32でのTask WDT、Raspberry Pi Picoでのmachine.WDTの使い方、フィード命令の正しい置き場所、そしてボードを無限リセットループに陥らせる典型的な間違いを、例のコードとともに学びます。

Arduino UnoのボードとATmega328Pマイコン
Arduino UnoのATmega328Pは、専用の128 kHzの発振器で動くウォッチドッグタイマーを内蔵しています。追加の部品は必要ありません。

ウォッチドッグタイマーとは?その仕組み

ウォッチドッグは、マイコンの中でメインのプログラムとは独立してカウントする小さなカウンターです。たとえば2秒といった時間を指定して開始すると、カウントが始まります。プログラムの周回ごとに呼び出すフィード(餌やり)命令(「kick the dog」、つまり「犬を蹴る」とも呼ばれます)がカウンターをリセットします。プログラムが正常に動いている限り、カウンターが最後まで達することはありません。プログラムがどこかで固まるとフィードが届かず、カウンターが時間切れになり、ウォッチドッグがマイコンにハードウェアリセットをかけます。リセット後のボードは、電源を入れ直したときと同じようにsetup()から動き始めます。

ウォッチドッグが信頼できる理由は、メインのクロックとは別のクロック源で動いていることです。Arduino UnoのATmega328Pでは、このクロック源は内蔵の128 kHzの発振器です。プログラムの16 MHzの水晶振動子やコードの流れがおかしくなっても、ウォッチドッグはカウントを続けます。フリーズの典型的な原因は次のとおりです。終了条件が成立しないwhileループ、応答しないI2Cセンサーをいつまでも待ち続けるライブラリ、Stringの連結で時間とともに断片化したRAM、配列のあふれで壊れたメモリ、電気的なノイズでプログラムがでたらめなアドレスへ飛ぶこと。

項目Arduino Uno(ATmega328P)ESP32Raspberry Pi Pico(RP2040)
ライブラリ/モジュールavr/wdt.hesp_task_wdt.hmachine.WDT(MicroPython)
開始wdt_enable(WDTO_2S)esp_task_wdt_init / reconfigure + esp_task_wdt_add(NULL)(初期化/再設定とタスクの追加)WDT(timeout=5000)
フィードwdt_reset()esp_task_wdt_reset()wdt.feed()
最長のタイムアウト8秒設定可能(Arduinoの既定値は5秒)8388 ms(約8.3秒)
停止wdt_disable()esp_task_wdt_delete()でタスクを外す停止できない(リセットでのみ解除)
クロック源内蔵の128 kHz発振器ハードウェアのタイマーグループ(MWDT)内蔵の1 µsティック生成器

ウォッチドッグで解決できること、できないこと

  • 無限ループ:届かない値を待ち続けるwhileループや、ロジックの誤りで止まったステートマシンも、ウォッチドッグなら数秒で抜け出せます。
  • 固まったライブラリ:Wi-Fi、MQTT、HTTPの接続中にネットワークライブラリがフリーズしたり、応答しないセンサーのドライバがボードを止めたりしても、リセットでクリーンな状態に戻ります。
  • メモリの破損:RAMの断片化やスタックオーバーフローでプログラムがおかしな動きをしてクラッシュしても、ウォッチドッグがボードを立ち上げ直します。
  • 電気的なノイズ:リレーやモーター、長い配線からのノイズでプログラムがでたらめな場所へ飛んでも、フィードが止まることで救われます。
  • 解決できないこと:電源電圧の低下(ブラウンアウト)、固まった外付けセンサー、計算を間違えた値。ウォッチドッグがリセットするのはマイコンだけです。I2Cラインを低く保ったままのセンサーは、そのセンサー自体の電源を切らないと直らないことがよくあります。プログラムが間違った動作でも規則正しく動いていれば、ウォッチドッグはそれに気づけません。
ウォッチドッグはバグの修正ではなく、シートベルトです。ボードが1日に何度もリセットされているなら、本当の原因を探してください。多くの場合、電源の不足、メモリリーク、タイムアウトのない待機ループのどれかです。ランダムなリセットのハードウェア的な原因については「Arduinoがリセットを繰り返すとき」を参考にしてください。

Arduino Unoのウォッチドッグ:avr/wdt.h

AVRベースのボード(Uno、Nano、Mega、Pro Mini)では、ウォッチドッグのために追加のライブラリをインストールする必要はありません。コンパイラに付属するavr/wdt.hのヘッダーファイルだけで使えます。基本の関数は3つです。wdt_enable(時間)でウォッチドッグを開始し、wdt_reset()でカウンターをリセット(フィード)し、wdt_disable()で停止します。時間は下の表の定数のどれかで指定し、約15 msから8秒まで10種類の選択肢があります。8秒より長い時間を直接選ぶことはできませんが、このあと紹介する条件付きフィードの方法を使えば、もっと長い制限を設定できます。

定数おおよその時間主な用途
WDTO_15MS15 msソフトウェアによる即時リセット
WDTO_30MS30 msあまり使わない
WDTO_60MS60 msあまり使わない
WDTO_120MS120 msごく短い制御ループ
WDTO_250MS250 ms素早い反応が必要なループ
WDTO_500MS500 msボタンとLEDの制御
WDTO_1S1秒シンプルな制御ループ
WDTO_2S2秒センサーの読み取りとディスプレイの更新
WDTO_4S4秒遅いセンサー、通信
WDTO_8S8秒ネットワーク処理、長い計算

ステップごとに:初めてのウォッチドッグのテスト

  1. Arduino UnoをUSBでパソコンにつなぎます。内蔵LED(13番ピン)以外に追加の回路は必要ありません。
  2. 下のコードを書き込み、シリアルモニタを9600ボーで開きます。
  3. 画面に「Basladi」(トルコ語で「始まった」)と表示され、LEDが0.5秒ごとに点滅します。
  4. シリアルモニタからkの文字を送ります。プログラムはわざと無限ループに入り、LEDはその状態のまま止まります。
  5. 約2秒後にボードが自動でリセットされ、再び「Basladi」が表示されて、LEDがまた点滅し始めます。
C++ (Arduino IDE)
1#include <avr/wdt.h>
2
3const int LED_PIN = 13;            // dahili LED / onboard LED
4unsigned long sonYanip = 0;
5bool ledDurum = false;
6
7void setup() {
8  MCUSR = 0;                       // reset bayraklarını temizle / clear reset flags
9  wdt_disable();                   // kurulum sırasında kapalı tut / keep off during setup
10  pinMode(LED_PIN, OUTPUT);
11  Serial.begin(9600);
12  Serial.println(F("Basladi / Started"));
13  wdt_enable(WDTO_2S);             // 2 saniyelik watchdog / 2 second watchdog
14}
15
16void loop() {
17  wdt_reset();                     // köpeği besle / feed the dog
18
19  if (millis() - sonYanip >= 500) {
20    sonYanip = millis();
21    ledDurum = !ledDurum;
22    digitalWrite(LED_PIN, ledDurum);
23  }
24
25  if (Serial.available() && Serial.read() == 'k') {
26    Serial.println(F("Kilitlendi / Hanging..."));
27    while (true) { }               // besleme yok: 2 s sonra reset / no feed: reset after 2 s
28  }
29}

setup()の最初にあるMCUSR = 0の行は、リセットフラグをクリアします。ATmega328Pでは、ウォッチドッグのリセットフラグ(WDRF)をクリアしないとウォッチドッグを止められないので、wdt_disable()はそのあとに置きます。ウォッチドッグは初期化の処理が終わったsetup()の最後で有効にしています。こうすることで、時間のかかるセンサーの起動がうっかりリセットを引き起こすことはありません。loop()の1行目にあるwdt_reset()が、周回ごとにカウンターをリセットします。LEDの点滅にdelay()ではなくmillis()を使っているのも意図的です。loop()は待たずに戻り、数ミリ秒の間に何度もウォッチドッグをフィードします。

わざとウォッチドッグを発動させるのは、コードからボードをリセットするいちばんきれいな方法です。wdt_enable(WDTO_15MS); while (true) {}と書くと、ボードはほぼすぐに本物のハードウェアリセットを受けます。よく見かける「アドレス0へジャンプする」方法は、プログラムを最初から実行し直すだけで、ハードウェアの周辺機能はリセットされません。また、表の時間は代表的な値であることも覚えておきましょう。128 kHzの発振器は温度や電源電圧によってずれるので、ウォッチドッグは正確なタイミングのためではなく、安全のためだけに使ってください。

古いブートローダーと無限リセットループ

ウォッチドッグがリセットをかけても、ATmega328Pはウォッチドッグを止めません。それどころか、最も短いタイムアウト(約16 ms)で有効のまま残します。起動時にボードが最初に実行するプログラムであるブートローダーがこれに対処しないと、コードの書き込みを待っている間にウォッチドッグが時間切れになり、ボードは再びリセットされます。その結果、LEDが速く点滅し、コードは始まらず、新しいコードも書き込めない無限リセットループになります。純正品のArduino UnoのOptibootブートローダーは起動時にウォッチドッグを止めるので、この問題は起きません。この問題が見られるのは、主に古いブートローダーを載せたNanoの互換品と、一部の古いMega 2560のボードです。

Arduino IDEでATmega328P (Old Bootloader)を選んでボードに書き込んでいる場合は、ウォッチドッグを試す前に注意してください。ボードがループに入ってしまったら、2台目のArduinoをISP書き込み装置として使い、「ツール」メニューの「ブートローダを書き込む」(Burn Bootloader)で最新のOptibootブートローダーをボードに書き込む必要があります。Optibootのボードでも、setup()の最初にMCUSR = 0とwdt_disable()の行を残しておくのはよい習慣です。

フィード命令はどこに置けばいい?

  • 中心となる1か所を選ぶ:wdt_reset()はloop()の中の、すべての処理が通る1つの場所に置きます。コードのあちこちにフィードをばらまくと、固まったサブループが自分自身をフィードし続け、ウォッチドッグの意味がなくなります。
  • 割り込みの中でフィードしない:タイマー割り込みは、メインのプログラムがフリーズしていても動き続けます。そこにフィードを置くと、ウォッチドッグはどんなフリーズも検知できません。割り込みの仕組みは「Arduinoの割り込み」の記事で確認できます。
  • 最も長い処理に合わせて時間を選ぶ:ウォッチドッグの時間は、loop()の1周にかかる最悪の時間の少なくとも2倍にします。delay(3000)を含むループでWDTO_2Sを使うと、ボードはリセットを繰り返します。
  • 待機ループにタイムアウトを付ける:while (!Serial.available())のようなループの中にフィードを置くのではなく、一定時間後にループを抜けるようにします。そうすればボードはフリーズせず、ウォッチドッグは本当のフリーズに備えて見張り続けます。
  • セットアップのあとでウォッチドッグを有効にする:Wi-Fiへの接続、SDカードの初期化、センサーのキャリブレーションのような時間のかかる処理がsetup()で終わってから有効にします。

もっと賢い方法は、フィードに条件を付けることです。システムが本当に正常なときだけウォッチドッグをフィードします。下の例では、A0につないだセンサーを5秒ごとに読み取り、値が意味のある範囲にあれば、最後に測定に成功した時刻を更新します。60秒間一度も測定に成功しないとフィードが止まり、4秒後にボードがリセットされます。この方法なら、AVRの8秒の制限を超えた分単位の監視ができ、フリーズだけでなく、センサーの配線が切れたような気づきにくい故障も検知できます。

C++ (Arduino IDE)
1#include <avr/wdt.h>
2
3const unsigned long OLCUM_ARALIK = 5000UL;     // 5 s'de bir ölç / measure every 5 s
4const unsigned long MAKS_SESSIZLIK = 60000UL;  // 60 s başarısızlık sınırı / 60 s failure limit
5unsigned long sonOlcum = 0;
6unsigned long sonBasari = 0;
7
8bool olcumYap() {
9  int deger = analogRead(A0);                  // örnek sensör / sample sensor
10  Serial.println(deger);
11  return deger > 10 && deger < 1013;           // uç değer = kopuk kablo / extreme value = broken wire
12}
13
14void setup() {
15  MCUSR = 0;                                   // reset bayraklarını temizle / clear reset flags
16  wdt_disable();
17  Serial.begin(9600);
18  sonBasari = millis();
19  wdt_enable(WDTO_4S);                         // 4 saniyelik watchdog / 4 second watchdog
20}
21
22void loop() {
23  unsigned long simdi = millis();
24
25  if (simdi - sonOlcum >= OLCUM_ARALIK) {
26    sonOlcum = simdi;
27    if (olcumYap()) {
28      sonBasari = simdi;                       // sağlıklı ölçüm / healthy reading
29    }
30  }
31
32  if (simdi - sonBasari < MAKS_SESSIZLIK) {
33    wdt_reset();                               // yalnız sistem sağlıklıysa besle / feed only if healthy
34  }
35}

ESP32のウォッチドッグ:Task WDTとInterrupt WDT

ESP32では、ウォッチドッグは初めから既定で動いています。多くの人は、シリアルモニタに思いがけず「Task watchdog got triggered」というメッセージが表示されたときに初めてその存在に気づきます。ESP32はFreeRTOSというOSで複数のタスクを同時に動かしているので、カウンター1つではなく階層的な仕組みを使っています。Task WDT(TWDT)は、登録されたタスクが決められた時間内にフィードされているかを監視します。Interrupt WDT(IWDT)は、割り込みやタスクスケジューラーが長時間ブロックされた状態を検知します。ArduinoのコアではTWDTはたいてい5秒のタイムアウトで有効になっていて、アイドル(IDLE)タスクを監視しています。loop()を実行するタスクは、自分で追加しない限り監視されません。既定の動作はコアのバージョンによって異なることがあり、設定によってはTWDTが警告を出すだけでボードをリセットしないこともあります。そのため、タイムアウトとリセットの動作をコードで明示的に設定するのがいちばん安全です。

種類監視する対象代表的な時間発動したときのメッセージ
タスクウォッチドッグ(Task WDT、TWDT)登録されたタスクとアイドルタスクが規則正しく動いているか5秒(設定可能)「task_wdt: Task watchdog got triggered」(タスクウォッチドッグの発動)
割り込みウォッチドッグ(Interrupt WDT、IWDT)割り込みとタスクスケジューラーのブロック約300 ms「Guru Meditation Error ... Interrupt wdt timeout on CPU1」(割り込みウォッチドッグのタイムアウト)
RTC WDT起動処理が止まること起動中の短い時間rst:0x10 (RTCWDT_RTC_RESET)
C++ (Arduino IDE)
1#include <esp_task_wdt.h>
2#include <esp_system.h>
3
4#define WDT_SURE_S 10                         // watchdog süresi (s) / watchdog timeout (s)
5
6void wdtKur() {
7#if ESP_ARDUINO_VERSION_MAJOR >= 3
8  esp_task_wdt_config_t cfg = {
9    .timeout_ms = WDT_SURE_S * 1000,
10    .idle_core_mask = 0,                       // idle görevlerini izleme / do not watch idle tasks
11    .trigger_panic = true                      // süre dolunca resetle / reset on timeout
12  };
13  if (esp_task_wdt_reconfigure(&cfg) == ESP_ERR_INVALID_STATE) {
14    esp_task_wdt_init(&cfg);                   // TWDT kapalıysa başlat / start TWDT if not running
15  }
16#else
17  esp_task_wdt_init(WDT_SURE_S, true);         // 2.x: süre (s), panik / 2.x: timeout (s), panic
18#endif
19  esp_task_wdt_add(NULL);                      // bu görevi (loop) izle / watch this task (loop)
20}
21
22void setup() {
23  Serial.begin(115200);
24  esp_reset_reason_t neden = esp_reset_reason();
25  Serial.print("Reset nedeni / Reset reason: ");
26  Serial.println((int)neden);
27  if (neden == ESP_RST_TASK_WDT || neden == ESP_RST_INT_WDT || neden == ESP_RST_WDT) {
28    Serial.println("Watchdog reseti / Watchdog reset");
29  }
30  wdtKur();
31  Serial.println("Hazir / Ready");
32}
33
34void loop() {
35  esp_task_wdt_reset();                        // besle / feed
36
37  // sensör, Wi-Fi ve ekran işleri burada / sensor, Wi-Fi and display work here
38
39  if (Serial.available() && Serial.read() == 'k') {
40    Serial.println("Kilitlendi / Hanging...");
41    while (true) { delay(10); }                // besleme yok: 10 s sonra reset / no feed: reset after 10 s
42  }
43  delay(10);
44}

このコードはESP_ARDUINO_VERSION_MAJORでコアのバージョンを確認しています。バージョン3.x(ESP-IDF 5)では、設定をesp_task_wdt_config_t構造体で渡し、すでに動いているTWDTはesp_task_wdt_reconfigure()で更新します。2.xでは、esp_task_wdt_init()が秒単位のタイムアウトとパニックフラグを直接受け取ります。trigger_panicがtrueのとき、ESP32は時間切れになるとエラーの内容をシリアルポートに出力し、自分自身をリセットします。esp_task_wdt_add(NULL)は、現在実行中のタスク、つまりsetup()とloop()を実行しているタスクを監視の対象にします。起動時にesp_reset_reason()で前回のリセット原因を読み取って記録しておくのが、現場の機器がなぜ再起動したのかを知るいちばん簡単な方法です。設定なしでloop()だけを監視したい場合は、setup()でArduinoコアのenableLoopWDT()関数を呼び出せます。この場合、フィードはloop()の周回の最初に自動で行われます。

ESP32で最もよくあるウォッチドッグの間違いは、自分で作ったFreeRTOSのタスクの中に一度も待たないループを書くことです。たとえば、コア0に固定したタスクでwhile (true) { readSensor(); }と書くと、そのコアのアイドルタスクがまったく動けず、Wi-Fiのスタックが滞り、数秒後に「Task watchdog got triggered ... IDLE (CPU 0)」というメッセージが表示されます。どのループにも最低限vTaskDelay(1)かdelay(1)を入れてください。タスクについて詳しくは「ESP32のFreeRTOSとデュアルコア」、「Guru Meditation」のメッセージの意味については「ESP32のブラウンアウトとGuru Meditation」を参考にしてください。

Raspberry Pi Picoのウォッチドッグ(MicroPython)

RP2040のハードウェアウォッチドッグは、MicroPythonではmachine.WDTクラスで使います。タイムアウトはミリ秒単位で指定し、RP2040では最大8388 msです。大事な違いがあります。Picoでは、ウォッチドッグを一度開始するとコードから止めることはできず、リセットでしか解除されません。そのため、開発中は小さな復旧用の手段を残しておくと助かります。下のコードでは、起動時にGP15ピンがGNDにつながっていると、ウォッチドッグは開始されず、プログラムはREPLに戻ります。machine.reset_cause()を使えば、ボードがウォッチドッグで起動したのか、通常の電源投入で起動したのかもわかります。PicoをMicroPythonではなくArduino IDE(arduino-picoコア)で使う場合は、rp2040.wdt_begin(5000)とrp2040.wdt_reset()の関数で同じことができます。

MicroPython
1import machine
2from machine import Pin, WDT
3import time
4
5led = Pin(25, Pin.OUT)                     # dahili LED (Pico W'da "LED") / onboard LED ("LED" on Pico W)
6kurtarma = Pin(15, Pin.IN, Pin.PULL_UP)   # GND'ye bağlıysa WDT başlamaz / tied to GND = WDT skipped
7
8if machine.reset_cause() == machine.WDT_RESET:
9    print("Watchdog reseti / Watchdog reset")
10
11if kurtarma.value() == 0:
12    print("Kurtarma modu / Recovery mode")
13    raise SystemExit
14
15wdt = WDT(timeout=5000)                    # 5 s, RP2040'ta en fazla 8388 ms / max 8388 ms on RP2040
16son = time.ticks_ms()
17
18while True:
19    wdt.feed()                             # besle / feed
20    if time.ticks_diff(time.ticks_ms(), son) >= 500:
21        son = time.ticks_ms()
22        led.toggle()
23    time.sleep_ms(10)
ウォッチドッグを使うプログラムをThonnyの「停止」ボタンで止めても、ウォッチドッグはカウントを続け、数秒以内にPicoがリセットされて接続が切れます。コードはまずmain.py以外のファイル名で試し、すべて問題なく動いたらmain.pyとして保存してください。ボードがループに入ってしまったら、GP15をGNDにつないでリセットするだけです。MicroPythonが初めてなら、「MicroPythonの基本」の記事から始めるのがおすすめです。

長期間動かすIoTプロジェクトのウォッチドッグ戦略

  • 起動を記録する:起動のたびに、UnoではEEPROMに、ESP32ではPreferences(NVS)にカウンターを書き込みます。ESP32ではesp_reset_reason()で原因も保存します。週に1回のリセットなら許容範囲ですが、1時間に1回のリセットは直すべきバグです。UnoではOptibootがリセットフラグをクリアするので、MCUSRから原因を読み取れないことがよくあります。それでも起動カウンターがあれば、機器がどのくらいの頻度で再起動しているかはわかります。
  • ネットワーク処理にタイムアウトを設ける:Wi-Fiの接続をいつまでも待たないでください。たとえば15秒以内につながらなければループを抜け、しばらくしてから再試行します。HTTPClientのsetTimeout()やAVRのWire.setWireTimeout()などの設定で、固まった処理がウォッチドッグの時間を超えるのを防げます。接続の問題については「ESP32がWi-Fiにつながらないとき」を参考にしてください。
  • OTAアップデートを考慮する:無線での書き込みには数秒かかり、その間loop()が待機状態になることがあります。ArduinoOTAのonProgressコールバックでesp_task_wdt_reset()を呼び出せば、アップデートが途中で切れるのを防げます。これはルールを破る、まれですが正当な例外です。
  • スリープモードを考える:Unoでは、ウォッチドッグを割り込みモードで起床用のタイマーとして使い、8秒ごとにスリープさせることができます。ESP32ではディープスリープ中はプロセッサーが止まっていて、起床するとコードが最初から始まります。詳しくは「ESP32のディープスリープ」を参考にしてください。
  • 外付けセンサーの電源を管理する:ウォッチドッグはセンサーをリセットしません。よく固まるI2Cセンサーの電源をトランジスタやMOSFET経由で供給し、起動時に数百ミリ秒だけ切ってから戻せば、マイコンと一緒にセンサーもクリーンな状態で始まります。I2Cラインが固まる仕組みは「I2Cとは?」の記事で読めます。
  • 重要なシステムには外付けのウォッチドッグ:内蔵のウォッチドッグが検知できるのは、マイコン自身の不具合だけです。回路全体を監視する必要があるなら、GPIOから定期的なパルスを受け取る外付けのウォッチドッグIC、または2つ目の小さなマイコンを使います。

よくある間違いと対処法

症状考えられる原因対処法
ボードが数秒ごとにリセットされるウォッチドッグの時間がloop()の最も長い周回より短い(例:delay(3000)とWDTO_2S)時間を延ばし、delay()ではなくmillis()を使う
LEDが速く点滅し、コードが書き込めない古いブートローダーがウォッチドッグのリセット後にウォッチドッグを止めないISPでOptibootを書き込み、最新のブートローダーの設定でボードに書き込む
ボードがフリーズするのにリセットされないフィードがタイマー割り込みや固まったサブループの中にあるwdt_reset()をloop()の1か所に移す
ESP32で「Task watchdog got triggered」が繰り返されるがリセットされないTWDTがパニックモードになっていないtrigger_panicをtrueにする(2.xでは2番目の引数)
ESP32で「IDLE (CPU 0)」の警告が出るコア0のタスクが一度も待たずにループしているループにvTaskDelay(1)を入れる
esp_task_wdt_reset()が「task not found」(タスクが見つからない)エラーを出すタスクがTWDTに追加されていない先にesp_task_wdt_add(NULL)を呼び出す
Thonnyで停止するとPicoとの接続が切れるmachine.WDTは一度開始すると止められない復旧用のピンを使い、テスト中はmain.py以外の名前でコードを実行する
リセットの瞬間にリレーやモーターが一瞬勝手に動くリセット中はピンが入力に戻り、ドライバの入力がフローティング状態になる出力にプルダウン抵抗を付け、setup()の最初で安全な状態にする

ウォッチドッグタイマーは、数行のコードでプロジェクトを机の上の実験から、何日も自力で動き続ける機器に変えてくれます。まずフリーズの本当の原因を取り除き、それから最後の安全層としてウォッチドッグを加え、フィードは意味のある1か所に置きましょう。BlueGraysアプリでは、ESP32のWi-Fi接続、Webサーバー、OTAアップデート、天気、スマート水やりといった長時間動かすプロジェクトを回路図とコードでステップごとに確認し、自分でウォッチドッグを追加できます。

よくある質問

Arduinoのウォッチドッグタイマーは何に使いますか?

ウォッチドッグは、プログラムが決められた時間内に「まだ動いています」という合図を送らないと、ボードを自動でリセットする内蔵のタイマーです。無限ループに入ったプロジェクトや、センサーを待ったまま止まったプロジェクト、ネットワークライブラリでフリーズしたプロジェクトを数秒で復帰させます。特に、長時間無人で動く水やり、アラーム、IoTの機器には欠かせません。

コードからArduinoをリセットするにはどうすればいいですか?

AVRのボードでいちばんきれいな方法は、最も短いタイムアウトでウォッチドッグを有効にして待つことです。wdt_enable(WDTO_15MS); while (true) {}と書くと、ボードはほぼすぐに本物のハードウェアリセットを受けます。ESP32ではESP.restart()、MicroPythonのRaspberry Pi Picoではmachine.reset()が同じ役割を果たします。古いブートローダーのNanoの互換品では、この方法で無限リセットループになることがあります。

ウォッチドッグのタイムアウトは最長でどのくらいですか?

Arduino Unoやほかの AVRボードでは、最長は8秒(WDTO_8S)です。Raspberry Pi Picoでは上限が8388 msで、ESP32のTask WDTでは時間を自由に設定できます。もっと長い監視が必要なら、システムが正常なときだけウォッチドッグをフィードする条件付きフィードの方法で、分単位の制限を設定できます。

ESP32の「Task watchdog got triggered」エラーはどう直せばいいですか?

このメッセージは、監視しているタスクが決められた時間内にフィードされなかったことを示します。原因はたいてい、待たずに回り続けるwhileループか、アイドルタスクを動けなくするFreeRTOSのタスクです。ループにvTaskDelay(1)かdelay(1)を入れ、長い処理は分割し、自分のタスクをTWDTに追加した場合はesp_task_wdt_reset()を定期的に呼び出してください。メッセージに出てくるタスク名、たとえばIDLE (CPU 0)から、問題がどのコアで起きているかがわかります。

ウォッチドッグを追加したら、Arduinoがリセットを繰り返します。なぜですか?

最もよくある原因は、ウォッチドッグの時間がloop()の最も長い周回より短いことです。たとえば、ループにdelay(3000)があるのにWDTO_2Sを選んでいる場合です。時間を最悪の周回時間の少なくとも2倍にし、長いdelay()の代わりにmillis()を使ってください。LEDが速く点滅してコードが書き込めない場合は、古いブートローダーが原因です。ISPでボードにOptibootを書き込む必要があります。

ウォッチドッグのリセット後も変数は残りますか?

いいえ。ウォッチドッグのリセットでボードは再起動し、setup()が最初から実行されるので、グローバル変数は初期値に戻ります。カウンター、設定、最後の状態など、リセット後も残しておく必要がある情報は、UnoではEEPROM、ESP32ではPreferences(NVS)、Picoではフラッシュ上のファイルに書き込んでください。

全プロジェクトを見る
ESP32でLEDを点滅
ES-1初級

ESP32でLEDを点滅

ESP32のGPIO出力の基本を学びます。デジタルピンからLEDを点灯・消灯させて、点滅させます。Arduino UNOの定番のLED点滅プロジェクトのESP32版です。Arduino環境で使う基本的な点滅コマンドは同じですが、ESP32のピン配置と3.3 VのGPIO電圧レベルはArduino UNOとは異なります。

4.7(37)
108
Raspberry Pi Picoの内蔵LEDを点滅(PicoとPico W)
PI-1初級

Raspberry Pi Picoの内蔵LEDを点滅(PicoとPico W)

Raspberry Pi Picoシリーズの最初のプロジェクトです!ボード上の緑色LEDを点滅させて動作を確認する、定番の「Hello World」に相当する実験です。外付け部品は不要で、PicoとUSBケーブルだけで始められます。コードはMicroPython(Raspberry Pi Foundationが公式にサポートする言語)で書きます。Thonny IDEでmachine.Pinクラス、Pin.OUTモード、led.on()/off()メソッド、time.sleep()を学びます。シリアル(REPL)出力で、切り替わる様子をリアルタイムに確認できます。

5.0(1)
10
ESP32 Wi-Fi STA接続(LCDディスプレイ付き)
ES-25上級

ESP32 Wi-Fi STA接続(LCDディスプレイ付き)

このプロジェクトでは、ESP32をステーション(STA)モードで家庭のWi-Fiネットワークに接続し、安全で障害に強い接続を実現します。SSIDとパスワードを別のsecrets.hファイルに保存してGitへの流出を防ぎ、自動再接続の仕組みを実装します。RSSIによる信号強度とIPアドレスはI2C LCDディスプレイに表示します。内蔵LEDは状態表示に使います。実運用を想定した接続管理の仕組みです。

4.4(21)
38
ESP32非同期Webサーバー(LCDにIPアドレスを表示)
ES-27上級

ESP32非同期Webサーバー(LCDにIPアドレスを表示)

このプロジェクトでは、ESP32を同じWi-Fiネットワーク上のスマートフォンやパソコンから操作できる非同期Webサーバーにします。ESPAsyncWebServerライブラリを使うと、従来のWebServer.hのように1つのリクエストで処理がブロックされず、複数のリクエストを同時に処理できます。ブラウザーでESP32のIPアドレスを開き、ON/OFFボタン(/onと/offのルート)を押すと、GPIO 5に接続したLEDを点灯・消灯できます。

4.8(16)
26
ESP32 OTA更新:無線でファームウェアを書き込み(LCD付き)
ES-30上級
プレミアム

ESP32 OTA更新:無線でファームウェアを書き込み(LCD付き)

このプロジェクトでは、USBケーブルを使わず、Wi-Fi経由でESP32に新しいファームウェアを書き込む方法を学びます。ArduinoOTAライブラリを使うと、ESP32がネットワーク上で検出され、Arduino IDEの「ネットワークポート」タブにbluegrays-otaとして自動表示されます。初回はUSBで書き込み、その後の更新はすべて無線で行えます。設置済みのデバイスにとって非常に重要な機能です。I2C LCDディスプレイには、Wi-Fiの状態、IPアドレス、ホスト名、OTA書き込みの進捗率、エラーメッセージをトルコ語と英語で表示します。

4.6(14)
22
ESP32 HTTPClient+天気API(LCD付き)
ES-31上級
プレミアム

ESP32 HTTPClient+天気API(LCD付き)

このプロジェクトでは、ESP32でHTTPClient.hを使い、インターネット経由で天気API(wttr.in)をREST APIとして呼び出します。返されたJSONレスポンスをArduinoJson v7で解析し、都市名、気温、湿度、天気、風の情報をI2C LCDディスプレイにトルコ語と英語で表示します。wttr.inは無料で、APIキーも不要です。都市名を入力するだけで、その都市の現在の天気を取得できます。30分ごとに自動更新し、表示画面ごとに異なるLEDの光り方で状態を知らせます。

4.7(13)
20
ESP32動体検知アラーム(PIR + ブザー + LED + Telegram)
ES-41上級
プレミアム

ESP32動体検知アラーム(PIR + ブザー + LED + Telegram)

PIRセンサーが動きを検知するとブザーとLEDを作動させ、同時にTelegramで持ち主に即座に通知するスマート防犯アラームです。アラームが繰り返される頻度を抑えるため、30秒のクールダウン(待ち時間)を設けています。この仕組みはPIRの検知が正しいかを確認したり、誤検知をなくしたりするものではありません。家の防犯、ガレージの監視、倉庫や作業部屋などに使えます。ESP32-CAMなら写真付きの通知を追加でき、通常のESP32 DevKit V1ではテキストで通知します。

9