ガイド · 読了まで16分

ESP32のFreeRTOS:デュアルコア、タスク、キュー、セマフォ

ESP32のFreeRTOSでxTaskCreatePinnedToCore、優先度、delayとvTaskDelayの違い、キュー、セマフォ、スタック、ウォッチドッグを解説します。LED、センサー、Webサーバーを同時に動かします。

ESP32のFreeRTOSは、ESP32の内部ですでに動いているリアルタイムOSで、複数の処理を同時に実行できます。Arduino IDEで書くESP32のスケッチは、実際にはすべてFreeRTOS上で動きます。setup()とloop()は、ESP32の2つのコアのどちらかで動くloopTaskというタスクの中で実行されます。独自のタスクを作れば、LEDを点滅させながらセンサーを読み取り、同時にWebサーバーへのリクエストに応答でき、それぞれがほかの処理を待たせることもありません。Arduino Unoでmillis()を使って実現する「複数の処理を同時に行う」仕組みを、ESP32ではずっとすっきりした構造にできます。

このガイドでは、ESP32の2つのコアをどう使い分けるか、Wi-Fiがどのコアで動くかを学びます。続いてxTaskCreatePinnedToCoreでタスクを作成し、特定のコアに固定して優先度を設定し、delay()とvTaskDelay()の違いを確認します。タスク間で安全にデータを共有するためにキューを、ボタンの割り込みからタスクを起こすためにセマフォを、共有するシリアルモニタを保護するためにミューテックスを使います。スタックサイズとウォッチドッグのエラーも取り上げたあと、LED、センサー、Webサーバーを同時に動かす完全な作例を作ります。最後に、Raspberry Pi Picoの2つのコアとも簡単に比較します。

ESP32開発ボード
従来のESP32はXtensa LX6コアを2つ搭載し、FreeRTOSでそれぞれのコアに別のタスクを実行させることができます。

ESP32のFreeRTOSとは?2つのコアはどう動く?

FreeRTOSでは、個々の処理をタスクと呼びます。タスクは専用のスタックメモリと優先度を持つ通常のC関数で、一般に無限ループを含みます。FreeRTOSのスケジューラは各コアで、実行可能なタスクの中から最も優先度の高いものを選びます。タスクがvTaskDelay()で待機したり、キューのデータやセマフォを待ったりすると、コアはすぐに別のタスクへ渡されます。同じ優先度のタスクは、ティックごとに交代して動きます。ESP32のArduinoコアでは1ティックが1 ms(1秒に1000ティック)なので、vTaskDelay(100)は約100 ms待機します。従来のESP32には、コア0(PRO_CPU)とコア1(APP_CPU)の2つのコアがあります。Espressifは無線通信をコア0に、スケッチをコア1に配置しているため、Wi-Fiの処理がloopの実行を中断しません。Arduinoの初期設定では、それぞれのコアで次の処理が動きます。

タスクコア優先度役割
loopTask(setupとloop)11Arduinoのスケッチ、8192バイトのスタック
Wi-Fiドライバ023無線とWi-Fiプロトコル
lwIP(tcpip)018TCP/IPスタック、WebとMQTTのパケット
Bluetooth(BT/BLE)0高BluetoothコントローラーとBluedroid
esp_timer022ソフトウェアタイマー
IDLE0とIDLE10と10アイドルタスク。ウォッチドッグをリセットし、削除したタスクのメモリを解放します

この表には重要なポイントが2つあります。まず、Wi-FiとTCP/IPのタスクは優先度が非常に高いため、コア0に独自の重いタスクを配置すると、ネットワーク通信が発生するたびにそれらのタスクが割り込みます。逆に、独自のタスクが長時間処理を占有すると、Wi-Fiに支障が出ます。次に、loopTaskの優先度はわずか1です。コア1にそれより優先度の高いタスクを配置し、そのタスクが一度も待機しなければ、loop()はまったく実行されません。ESP32-S3もデュアルコアです。ESP32-S2、ESP32-C3、ESP32-C6はシングルコアです。これらのボードでもタスクは作成できますが、すべてが同じコアを共有します。

配線図

この記事の作例には、ESP32 DevKit、LED2個、ポテンショメーター、押しボタンが必要です。ボード上の青いLEDはGPIO 2につながっています。2個目のLEDは220 Ωの抵抗を介してGPIO 4に接続します。Wi-Fiが有効な間はADC2のピンを読み取れないため、ポテンショメーターはADC1のチャンネルであるGPIO 34につなぎます。

部品ESP32のピン注意点
オンボードLEDGPIO 2多くのDevKitに搭載されています
2個目のLEDGPIO 4220 Ωの抵抗を直列に接続し、短い足をGNDへ
ポテンショメーターの中央の足GPIO 34入力専用、ADC1。両端の足は3V3とGNDへ
ボタンGPIO 27もう一方の足はGNDへ。INPUT_PULLUPで使用します
ポテンショメーターの端の足は3V3に接続し、5Vには接続しないでください。ESP32のピンは3.3 Vで動作し、5 Vには対応していません。Wi-Fiを使うプロジェクトでは、アナログセンサーをADC1のピンであるGPIO 32〜39につないでください。ADC2のピン(GPIO 0、2、4、12〜15、25〜27)は、Wi-Fiが有効な間はanalogRead()で読み取れません。ピンの選択はピン配置ツールで確認できます。

xTaskCreatePinnedToCoreで最初のタスクを作る

最初の作例では、2つの独立したタスクを使い、異なるコアで2個のLEDをそれぞれ別の速さで点滅させます。タスク関数はすべてvoid function(void *parameter)という形式で、無限ループを含みます。タスクを開始するxTaskCreatePinnedToCore()では、実行するコアも指定します。同じタスク関数を2回使い、それぞれに異なる設定用の構造体を渡す点に注目してください。パラメータによって、1つの関数で2個のLEDを独立して制御できます。

C++ (Arduino IDE)
1// İki LED, iki görev, iki çekirdek / two LEDs, two tasks, two cores
2struct LedAyari {
3  int pin;          // LED pini / LED pin
4  int beklemeMs;    // yarım periyot / half period
5};
6
7LedAyari led1 = {2, 250};   // dahili LED, hızlı / onboard LED, fast
8LedAyari led2 = {4, 700};   // harici LED, yavaş / external LED, slow
9
10void ledGorevi(void *parametre) {
11  LedAyari *ayar = (LedAyari *)parametre;
12  pinMode(ayar->pin, OUTPUT);
13  for (;;) {                                         // görev asla bitmez / a task never returns
14    digitalWrite(ayar->pin, !digitalRead(ayar->pin));
15    vTaskDelay(pdMS_TO_TICKS(ayar->beklemeMs));      // çekirdeği bırak / give the core away
16  }
17}
18
19void setup() {
20  Serial.begin(115200);
21  // fonksiyon, ad, yığın (bayt), parametre, öncelik, tutamaç, çekirdek
22  // function, name, stack (bytes), parameter, priority, handle, core
23  xTaskCreatePinnedToCore(ledGorevi, "LED1", 2048, &led1, 1, NULL, 0);
24  xTaskCreatePinnedToCore(ledGorevi, "LED2", 2048, &led2, 1, NULL, 1);
25}
26
27void loop() {
28  Serial.printf("loop() cekirdek / core: %d\n", xPortGetCoreID());
29  delay(1000);                                       // ESP32'de delay de çekirdeği bırakır / delay yields on ESP32 too
30}

コードを書き込むと2個のLEDが独立して点滅し、シリアルモニタにはloop()がコア1で動いていることが表示されます。この関数のパラメータは次のとおりです。

パラメータ作例の値意味
pvTaskCodeledGoreviタスクで実行する関数
pcName"LED1"デバッグ時に表示される名前。最大16文字
usStackDepth2048スタックサイズ。ESP32ではバイト単位
pvParameters&led1タスクに渡すポインタ。グローバル変数または静的変数を指す必要があります
uxPriority1優先度。0(最低)から24まで
pvCreatedTaskNULLあとでタスクを停止したり監視したりするためのハンドル
xCoreID0または1実行するコア。tskNO_AFFINITYを指定すると空いているほうのコアで動きます
タスク関数は絶対にreturnで終了してはいけません。終了するとESP32がエラーを報告して再起動します。処理が終わったタスクは、最後の行でvTaskDelete(NULL)を呼び出して削除してください。また、setup()内のローカル変数のアドレスをタスクのパラメータとして渡さないでください。setup()が終わると変数が消え、タスクが無効なアドレスを読み取ってしまいます。シングルコアのESP32-C3、S2、C6では、コア番号に使えるのは0またはtskNO_AFFINITYだけです。最も移植性が高いのは、コアを指定しないxTaskCreate()です。

delay()、vTaskDelay()、vTaskDelayUntil()の比較

Arduino Unoのdelay()はプロセッサを完全に占有するため、待機中はほかの処理が動きません。ESP32では事情が異なり、Arduinoコアのdelay()は実際にはvTaskDelay()を呼び出します。そのため、delay(100)と書くとタスクは100 ms休止し、その間はほかのタスクがコアを使います。タスク内でdelay()を使っても動くのはこのためです。ただし、FreeRTOSのコードではvTaskDelay(pdMS_TO_TICKS(100))と書くほうが意図が明確になります。実際に違いが出るのは、プロセッサを占有したまま待つ方法です。delayMicroseconds()やwhile (millis() - t < 500) {}のような空のループは、コアを解放しません。Arduinoでmillis()を使う方法は、millis()とdelay()の違いで詳しく解説しています。

方法コアを解放する?使いどころ
delay(ms)はい(ESP32ではvTaskDelayを呼び出します)単純な待機、loop()内
vTaskDelay(pdMS_TO_TICKS(ms))はいタスク内での待機。処理時間に待機時間が加わります
vTaskDelayUntil(&last, period)はい一定周期のサンプリング。処理時間にかかわらず正確な周期を保ちます
delayMicroseconds(us)いいえセンサーのプロトコルで必要なマイクロ秒単位の待機
while (millis() - t < ms) {}いいえほかのタスクが実行できなくなるため、FreeRTOSのタスクでは使わないでください

vTaskDelay(100)を使うループで処理に15 msかかると、ループは115 msごとに繰り返され、時間とともにずれが蓄積します。センサーを正確に100 msごとに読み取りたい場合は、vTaskDelayUntil()を使います。この関数は前回の起床時刻を記録し、毎回ちょうど1周期後にタスクを起こします。次の節のセンサータスクでは、この方法を使います。

タスクの優先度:どのタスクが先に動く?

1つのコアで複数のタスクが実行可能な場合、常に優先度が最も高いタスクが動きます。優先度の低いタスクがコアを使えるのは、それより優先度の高いタスクが待機しているときだけです。これをプリエンプティブな優先度ベースのスケジューリングと呼びます。優先度の高いタスクが待っていたデータが届くと、すぐに優先度の低いタスクの実行が中断されます。これによって素早い応答が必要な処理を高い優先度にできますが、落とし穴もあります。優先度の高いタスクが一度も待機しなければ、それより下のタスクはまったく動きません。実用上は、次のような割り当てが適しています。

  • 優先度1:ディスプレイの更新、シリアルモニタへの出力、Webサーバーなど、急ぐ必要のない処理。loop()もこの優先度です。
  • 優先度2〜3:定期的なセンサーの読み取り、制御ループ、ボタンの処理など、時間どおりに行う必要がある処理。
  • 優先度4〜5:割り込みで起こされ、すぐに応答する必要がある短いタスク。
  • 避けること:独自のタスクに18以上の優先度を付けないでください。これらの優先度はWi-Fi、TCP/IP、システムタイマーが使います。

キューでタスク間のデータを安全に共有する

タスク間でデータを渡すとき、最初に思い浮かぶのはグローバル変数ですが、2つのタスクが同じ変数に同時にアクセスする可能性があります。一方のタスクが複数バイトの構造体を書き込んでいる間にもう一方が読み取ると、古い値と新しい値が混ざってしまいます。この種の不具合はまれに不規則に起きるため、原因の特定が非常に困難です。FreeRTOSではキューで解決できます。キューは固定サイズの項目を並べたもので、コピーによってデータを受け渡します。送信側のタスクがxQueueSend()でコピーを置き、受信側のタスクがxQueueReceive()でそのコピーを取り出します。キューが空なら受信側のタスクは休止し、CPU時間を使いません。データが届くとすぐに起きます。次の作例では、一方のタスクが正確に100 msごとにポテンショメーターを読み取り、タイムスタンプとともにキューへ入れます。もう一方のタスクは、キューから取り出した読み取り値を1つずつ処理します。

C++ (Arduino IDE)
1// Sensör görevi -> kuyruk -> işleyici görev / sensor task -> queue -> consumer task
2const int POT_PIN = 34;                 // ADC1 pini / ADC1 pin
3
4struct Olcum {
5  uint16_t ham;                         // 0-4095 ham değer / raw value
6  float volt;                           // gerilim / voltage
7  uint32_t zaman;                       // ms cinsinden zaman / timestamp in ms
8};
9
10QueueHandle_t olcumKuyrugu;
11
12void sensorGorevi(void *parametre) {
13  TickType_t sonUyanma = xTaskGetTickCount();
14  for (;;) {
15    Olcum o;
16    o.ham = analogRead(POT_PIN);
17    o.volt = analogReadMilliVolts(POT_PIN) / 1000.0f;
18    o.zaman = millis();
19    if (xQueueSend(olcumKuyrugu, &o, 0) != pdPASS) {   // kuyruk doluysa bekleme / don't wait if full
20      Serial.println("Kuyruk dolu / Queue full");
21    }
22    vTaskDelayUntil(&sonUyanma, pdMS_TO_TICKS(100));   // tam 100 ms periyot / exact 100 ms period
23  }
24}
25
26void isleyiciGorev(void *parametre) {
27  Olcum o;
28  for (;;) {
29    // veri gelene kadar uyu / sleep until data arrives
30    if (xQueueReceive(olcumKuyrugu, &o, portMAX_DELAY) == pdPASS) {
31      Serial.printf("%lu ms  ham/raw: %4u  %.2f V  bekleyen/waiting: %u\n",
32                    (unsigned long)o.zaman, o.ham, o.volt,
33                    (unsigned)uxQueueMessagesWaiting(olcumKuyrugu));
34    }
35  }
36}
37
38void setup() {
39  Serial.begin(115200);
40  olcumKuyrugu = xQueueCreate(10, sizeof(Olcum));      // 10 ölçümlük kuyruk / queue of 10 readings
41  if (olcumKuyrugu == NULL) {
42    Serial.println("Kuyruk olusturulamadi / Queue creation failed");
43    return;
44  }
45  xTaskCreatePinnedToCore(sensorGorevi, "Sensor", 3072, NULL, 2, NULL, 1);
46  xTaskCreatePinnedToCore(isleyiciGorev, "Isleyici", 3072, NULL, 1, NULL, 1);
47}
48
49void loop() {
50  vTaskDelay(pdMS_TO_TICKS(1000));     // loop'un burada işi yok / loop has nothing to do here
51}

センサータスクの優先度(2)は受信側のタスク(1)より高いため、読み取りは常に時間どおりに行われます。受信側がSDカードへの書き込みなどで一時的に遅くなっても、読み取り値は失われず、10項目分のキューで順番を待ちます。キューがいっぱいになると、xQueueSend()は待機せずにエラーを返すため、満杯になったことを検出できます。現在の温度をディスプレイに表示する場合のように、最新の値だけが必要なら、1項目のキューを作り、xQueueOverwrite()で書き込み、xQueuePeek()で値を取り除かずに読み取れます。最後の作例ではこの方法を使います。

セマフォとミューテックス:割り込みからタスクを起こし、共有リソースを保護する

バイナリセマフォは、タスクがイベントを待つためのフラグのようなものです。最もよく使う場面は割り込みです。ボタンの割り込み処理(ISR)は非常に短くする必要があるため、実際の処理は行わず、セマフォを渡すだけにします。そのセマフォを待っているタスクが起きて、処理を実行します。割り込みの基本はArduinoの割り込みの記事で解説しています。ミューテックスは、シリアルポート、I2Cバス、ディスプレイなどの共有リソースを、一度に1つのタスクだけが使うことを保証します。2つのタスクが同時にSerial.printf()を呼び出すと出力行が混ざることがありますが、ミューテックスを使えば各タスクが書き込む前にロックを取得し、終わったら解放できます。次のコードでは、ボタンを押すたびに2個目のLEDの状態が切り替わり、2つのタスクが同じシリアルモニタに、出力を混ぜずに書き込みます。

C++ (Arduino IDE)
1const int BUTON_PIN = 27;              // butonun diğer ucu GND / other leg to GND
2const int LED_PIN   = 4;
3
4SemaphoreHandle_t butonSemaforu;       // kesme -> görev sinyali / ISR -> task signal
5SemaphoreHandle_t seriKilit;           // Serial için mutex / mutex for Serial
6
7void IRAM_ATTR butonKesmesi() {
8  BaseType_t uyandir = pdFALSE;
9  xSemaphoreGiveFromISR(butonSemaforu, &uyandir);   // ISR'de FromISR sürümü / FromISR version in ISR
10  if (uyandir == pdTRUE) {
11    portYIELD_FROM_ISR();              // bekleyen görevi hemen çalıştır / run the waiting task now
12  }
13}
14
15void guvenliYaz(const char *metin) {
16  if (xSemaphoreTake(seriKilit, pdMS_TO_TICKS(100)) == pdTRUE) {
17    Serial.println(metin);
18    xSemaphoreGive(seriKilit);         // kilidi mutlaka bırak / always release the lock
19  }
20}
21
22void butonGorevi(void *parametre) {
23  uint32_t sonBasma = 0;
24  for (;;) {
25    xSemaphoreTake(butonSemaforu, portMAX_DELAY);    // basılana kadar uyu / sleep until pressed
26    if (millis() - sonBasma > 200) {                 // 200 ms ark önleme / 200 ms debounce
27      sonBasma = millis();
28      digitalWrite(LED_PIN, !digitalRead(LED_PIN));
29      guvenliYaz("Butona basildi / Button pressed");
30    }
31  }
32}
33
34void raporGorevi(void *parametre) {
35  char satir[64];
36  for (;;) {
37    snprintf(satir, sizeof(satir), "Calisma suresi / Uptime: %lu s", (unsigned long)(millis() / 1000));
38    guvenliYaz(satir);
39    vTaskDelay(pdMS_TO_TICKS(2000));
40  }
41}
42
43void setup() {
44  Serial.begin(115200);
45  pinMode(LED_PIN, OUTPUT);
46  pinMode(BUTON_PIN, INPUT_PULLUP);
47  butonSemaforu = xSemaphoreCreateBinary();
48  seriKilit = xSemaphoreCreateMutex();
49  xTaskCreatePinnedToCore(butonGorevi, "Buton", 2048, NULL, 3, NULL, 1);
50  xTaskCreatePinnedToCore(raporGorevi, "Rapor", 2048, NULL, 1, NULL, 1);
51  attachInterrupt(digitalPinToInterrupt(BUTON_PIN), butonKesmesi, FALLING);
52}
53
54void loop() {
55  vTaskDelay(pdMS_TO_TICKS(1000));
56}
割り込み処理の中では、名前の末尾がFromISRのFreeRTOS関数だけを使ってください(xSemaphoreGiveFromISR、xQueueSendFromISRなど)。割り込みの中でSerial.print()、delay()、その他の待機する関数を呼び出すと、ESP32がクラッシュします。割り込み関数の前にはIRAM_ATTRを付けてください。これにより、関数をフラッシュではなく高速なRAMに配置できます。ミューテックスを取得したら、どの実行経路でも必ず返してください。エラー時の分岐でxSemaphoreGive()を呼び忘れると、そのリソースを待つすべてのタスクが永久に停止してしまいます。

Wi-Fiはどのコアで動く?独自のタスクはどこに置く?

Arduinoコアでは、Wi-Fiドライバ、TCP/IPスタック、Bluetoothがコア0に固定され、loop()とArduinoのイベントはコア1で動きます。初期設定では、ESP32のタスクウォッチドッグもコア0のアイドルタスク(IDLE0)を監視しています。コア0に優先度を持つタスクを配置し、そのタスクが一度も待機しないと、IDLE0が5秒間動けなくなり、シリアルモニタにTask watchdog got triggeredと表示されてボードが再起動します。同じタスクによってネットワークパケットの処理も遅れます。次の簡単な方針に従うと、配置を決めやすくなります。

処理推奨コア理由
高速で周期的な制御、センサーのサンプリング、モーター制御1Wi-Fiによる割り込みでタイミングが乱れません
Webサーバー、MQTT、HTTPリクエスト0または1、低い優先度ネットワークスタックはすでにコア0にあります。独自のタスクはこまめに待機する必要があります
ディスプレイの更新、ログ記録1、優先度1緊急ではないため、空き時間を使います
長い計算(FFT、暗号化)1、または低い優先度で0。途中にvTaskDelay(1)を入れますウォッチドッグやほかのタスクの実行時間を確保するためです

スタックサイズとウォッチドッグのエラー

各タスクは専用のスタックメモリを持ち、ローカル変数、関数呼び出し、printfなどのライブラリ関数がこの領域を使います。ESP32のスタックサイズはバイト単位で指定します。標準のFreeRTOSドキュメントにある「ワード」単位は、ESP32には当てはまりません。単純なLEDタスクなら2048バイトで十分です。Serial.printf()、Stringの操作、浮動小数点数の出力を使うタスクには3072〜4096バイトを割り当ててください。HTTPClient、TLS(HTTPS)、JSONを扱うタスクでは8192バイト以上が必要になることもあります。スタックがあふれると、ESP32はStack canary watchpoint triggeredまたはA stack overflow in task ... has been detectedを報告して再起動します。uxTaskGetStackHighWaterMark()を使うと、そのタスクのスタックの空き容量がこれまでに最も少なくなったときの値を確認できます。値はバイト単位で、500バイトを下回る場合はスタックを増やしてください。予期しない再起動の原因となるエラーメッセージの読み方は、ESP32のブラウンアウトとGuru Meditationで解説しています。

エラーメッセージ意味対処法
Task watchdog got triggered ... IDLE (CPU 0)(ウォッチドッグの発動)コア0のタスクが5 s間待機しませんでしたループにvTaskDelay(1)を追加するか、優先度を下げるか、タスクをコア1に移します
Stack canary watchpoint triggered (task name)(指定タスクのスタックオーバーフロー)表示されたタスクのスタックがあふれましたxTaskCreatePinnedToCoreのスタックの値を増やします
Guru Meditation Error: LoadProhibited(無効なアドレスの読み取り)無効なアドレスが読み取られましたタスクに渡したポインタがローカル変数を指していないか確認します
Interrupt wdt timeout on CPU1(割り込みウォッチドッグのタイムアウト)割り込み処理に時間がかかりすぎたか、割り込みが無効のままでしたISRを短くし、セマフォでタスクに処理を引き渡します
FreeRTOS Task "Gorev" should not return, Aborting now!(タスクがreturnで終了しています)タスク関数がreturnで終了しました無限ループを使うか、最後にvTaskDelete(NULL)を呼び出します

プロジェクト:LED、センサー、Webサーバーを同時に動かす

ここまで学んだことを1つのプロジェクトにまとめましょう。タスクは3つです。センサータスクは200 msごとにポテンショメーターを読み取り、直近8回の読み取り値の平均を1項目のキューに書き込みます。LEDタスクは、Webページで設定した速さでオンボードLEDを点滅させます。Webタスクは、スマホで開いたページに現在のセンサー値を表示し、LEDの速さを変えるリンクを提供します。タスクはグローバル変数ではなく、xQueueOverwrite()とxQueuePeek()でデータを共有します。loop()は10秒ごとに各タスクの空きスタック容量と空きRAM容量を出力するため、実際の動作中にスタックが足りているか確認できます。Wi-Fiのネットワーク名とパスワードは、使用するものに置き換えてください。

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <WebServer.h>
3
4const char* WIFI_ADI   = "EvAgi_2G";       // Wi-Fi adı / network name
5const char* WIFI_SIFRE = "sifre1234";      // Wi-Fi şifresi / Wi-Fi password
6
7const int LED_PIN = 2;                     // dahili LED / onboard LED
8const int POT_PIN = 34;                    // ADC1, Wi-Fi ile çalışır / ADC1, works with Wi-Fi
9
10WebServer sunucu(80);
11QueueHandle_t sensorKutusu;                // tek öğe: son ortalama / one item: latest average
12QueueHandle_t hizKutusu;                   // tek öğe: LED yarım periyodu / one item: LED half period
13TaskHandle_t ledTutamac, sensorTutamac, webTutamac;
14
15void sensorGorevi(void *p) {
16  uint16_t son[8] = {0};
17  uint8_t sira = 0;
18  TickType_t sonUyanma = xTaskGetTickCount();
19  for (;;) {
20    son[sira] = analogRead(POT_PIN);
21    sira = (sira + 1) % 8;
22    uint32_t toplam = 0;
23    for (int i = 0; i < 8; i++) toplam += son[i];
24    uint16_t ortalama = toplam / 8;
25    xQueueOverwrite(sensorKutusu, &ortalama);       // eskisinin üzerine yaz / overwrite the old one
26    vTaskDelayUntil(&sonUyanma, pdMS_TO_TICKS(200));
27  }
28}
29
30void ledGorevi(void *p) {
31  pinMode(LED_PIN, OUTPUT);
32  uint32_t beklemeMs = 500;
33  for (;;) {
34    xQueuePeek(hizKutusu, &beklemeMs, 0);           // yeni hız varsa al / take a new speed if any
35    digitalWrite(LED_PIN, !digitalRead(LED_PIN));
36    vTaskDelay(pdMS_TO_TICKS(beklemeMs));
37  }
38}
39
40void anaSayfa() {
41  uint16_t deger = 0;
42  uint32_t hiz = 0;
43  xQueuePeek(sensorKutusu, &deger, 0);              // okur ama silmez / reads without removing
44  xQueuePeek(hizKutusu, &hiz, 0);
45  String html = "<!DOCTYPE html><html><head><meta charset='utf-8'>"
46                "<meta http-equiv='refresh' content='2'>"
47                "<meta name='viewport' content='width=device-width'></head><body>"
48                "<h2>ESP32 FreeRTOS</h2>";
49  html += "<p>Sensor: " + String(deger) + " / 4095</p>";
50  html += "<p>LED: " + String(hiz) + " ms</p>";
51  html += "<p><a href='/hiz?ms=100'>100 ms</a> | <a href='/hiz?ms=500'>500 ms</a> | "
52          "<a href='/hiz?ms=1000'>1000 ms</a></p></body></html>";
53  sunucu.send(200, "text/html", html);
54}
55
56void hizAyarla() {
57  uint32_t ms = sunucu.arg("ms").toInt();
58  if (ms >= 50 && ms <= 5000) {
59    xQueueOverwrite(hizKutusu, &ms);
60  }
61  sunucu.sendHeader("Location", "/");
62  sunucu.send(303);
63}
64
65void webGorevi(void *p) {
66  WiFi.mode(WIFI_STA);
67  WiFi.begin(WIFI_ADI, WIFI_SIFRE);
68  while (WiFi.status() != WL_CONNECTED) {
69    vTaskDelay(pdMS_TO_TICKS(500));                 // beklerken çekirdeği bırak / yield while waiting
70  }
71  Serial.print("Adres / Address: http://");
72  Serial.println(WiFi.localIP());
73  sunucu.on("/", anaSayfa);
74  sunucu.on("/hiz", hizAyarla);
75  sunucu.begin();
76  for (;;) {
77    sunucu.handleClient();
78    vTaskDelay(pdMS_TO_TICKS(2));                   // IDLE görevine nefes aldır / let the idle task run
79  }
80}
81
82void setup() {
83  Serial.begin(115200);
84  sensorKutusu = xQueueCreate(1, sizeof(uint16_t));
85  hizKutusu = xQueueCreate(1, sizeof(uint32_t));
86  uint32_t ilkHiz = 500;
87  xQueueOverwrite(hizKutusu, &ilkHiz);
88
89  xTaskCreatePinnedToCore(sensorGorevi, "Sensor", 2048, NULL, 2, &sensorTutamac, 1);
90  xTaskCreatePinnedToCore(ledGorevi, "LED", 2048, NULL, 1, &ledTutamac, 1);
91  xTaskCreatePinnedToCore(webGorevi, "Web", 6144, NULL, 1, &webTutamac, 0);
92}
93
94void loop() {
95  // boş yığın (bayt) ve boş RAM / free stack (bytes) and free heap
96  Serial.printf("Bos yigin / Free stack  Sensor: %u  LED: %u  Web: %u  |  Heap: %u\n",
97                (unsigned)uxTaskGetStackHighWaterMark(sensorTutamac),
98                (unsigned)uxTaskGetStackHighWaterMark(ledTutamac),
99                (unsigned)uxTaskGetStackHighWaterMark(webTutamac),
100                (unsigned)ESP.getFreeHeap());
101  vTaskDelay(pdMS_TO_TICKS(10000));
102}

書き込み後、シリアルモニタに表示されたアドレスをスマホで開きます。ページは2秒ごとに更新され、ポテンショメーターを回すと値が変わります。リンクをタップするとLEDの点滅速度がすぐに変わりますが、センサーの読み取り周期は乱れません。それぞれの処理が専用のタスクで、自分のペースで動くためです。Webタスクは、ネットワークスタックと同じコア0で低い優先度で動きます。ループのたびに2 ms待つため、IDLE0タスクが実行でき、ウォッチドッグは発動しません。LEDとセンサーのタスクはコア1にあり、Wi-Fi通信の影響を受けません。この構造は簡単に拡張できます。ページを再読み込みせずに値を即座に更新するには、ESP32のWebサーバーとWebSocketの記事のWebSocketの方法を追加してください。ノイズのあるセンサー値を滑らかにするには、センサータスクの平均処理を中央値フィルタや指数フィルタに置き換えます。

Raspberry Pi Picoとの比較:MicroPythonで2つのコアを使う

Raspberry Pi Picoに搭載されているRP2040もデュアルコアですが、OSはありません。MicroPythonでは_threadモジュールで2つ目のコアを起動し、2つのコアで動くスレッドは2つだけです。Arduinoでは、arduino-picoコアが2つ目のコア用にsetup1()とloop1()を提供しています。次のMicroPythonコードは、最初のコアでポテンショメーターを読み取りながら、2つ目のコアでLEDを点滅させます。共有カウンターは、ESP32のミューテックスと同じようにロックで保護します。PicoのコアとPIOについては、PicoのPIOとデュアルコアの記事で詳しく解説しています。

MicroPython
1import _thread, time
2from machine import Pin, ADC
3
4led = Pin(25, Pin.OUT)          # Pico dahili LED (Pico W'da Pin("LED")) / onboard LED (Pin("LED") on Pico W)
5pot = ADC(26)                   # GP26 = ADC0
6kilit = _thread.allocate_lock() # ortak veri kilidi / lock for shared data
7yanma_sayisi = 0
8
9def ikinci_cekirdek():
10    global yanma_sayisi
11    while True:
12        led.toggle()
13        with kilit:             # sayaç güvenle artar / counter updated safely
14            yanma_sayisi += 1
15        time.sleep_ms(300)
16
17_thread.start_new_thread(ikinci_cekirdek, ())   # çekirdek 1'de çalışır / runs on core 1
18
19while True:
20    deger = pot.read_u16()      # 0-65535
21    with kilit:
22        sayac = yanma_sayisi
23    print("Pot:", deger, "LED degisimi / toggles:", sayac)
24    time.sleep(1)

Picoでは、この方法は2つの処理を行うのに適していますが、タスク数、優先度、キュー、スケジューラなどの仕組みは、ESP32のFreeRTOSほど充実していません。多数の処理を同時に行い、ネットワーク接続や正確なタイミングが必要なプロジェクトでは、ESP32とFreeRTOSのほうが扱いやすい基盤になります。PicoでWi-Fiを使うプロジェクトを作りたい場合は、Pico WのWi-FiとWebサーバーの記事を参照してください。

よくある間違いと対処法

症状考えられる原因対処法
タスクを作成するとすぐにボードが再起動するタスク関数がreturnで終了しているか、スタックが小さすぎます無限ループを追加し、スタックを4096バイトに増やします
loop()がまったく動かないコア1の優先度の高いタスクが一度も待機していませんそのタスクにvTaskDelay()を追加するか、優先度を1に下げます
Wi-Fiが有効なときにウォッチドッグエラーが出るコア0のタスクがIDLE0の実行を妨げていますループでvTaskDelay(1)を使うか、タスクをコア1に移します
ときどき値がおかしくなる2つのタスクが同じグローバル構造体を同時に読み書きしていますキューでデータを渡すか、ミューテックスでアクセスを保護します
シリアルモニタの出力行が混ざる2つのタスクが同時にSerialへ書き込んでいます書き込む前にミューテックスを取得し、終わったら解放します
ボタンを押すとボードがクラッシュする割り込み処理の中でSerial.printや通常のFreeRTOS関数を使っていますISR内ではFromISR関数だけを使い、タスクに処理を引き渡します
Wi-Fiが有効なときにanalogRead()が4095または0を返すセンサーがADC2のピンにつながっていますADC1のピンであるGPIO 32〜39のいずれかを使います
ESP32-C3でコンパイルできるが動かないシングルコアのボードでコア1を指定していますコア0かtskNO_AFFINITYを指定するか、xTaskCreate()を使います
FreeRTOSに移行するときは、最初からすべてをタスクに分けないでください。まず動作中のコードから、センサーのサンプリングなど、最もタイミングが重要な処理を専用のタスクに移し、残りはloop()に置いておきます。新しいタスクを追加するたびに、uxTaskGetStackHighWaterMark()でスタックを確認してください。タスク間のデータはすべてキューで受け渡し、共有するハードウェアには必ずミューテックスを介してアクセスすれば、「ときどき動かなくなる」不具合の大半を最初から防げます。

ESP32の2つのコアとFreeRTOSを使うと、millis()の計算でいっぱいの複雑なloop()を、1つの処理に集中する小さく読みやすいタスクへ変えられます。タスクの作成、優先度の設定、キューによるデータの受け渡し、セマフォによる割り込み処理、スタックの測定ができるようになれば、Wi-Fiプロジェクトを滞りなく動かせます。ESP32が初めてなら、ESP32とは?で基本を学べます。BlueGraysアプリでは、非同期Webサーバー、WebSocket、NTP時計、温度データロガー、スマート照明などのESP32プロジェクトも探せます。どのプロジェクトにも、ステップごとの回路図とすぐに使えるコードが用意されています。

よくある質問

ESP32のFreeRTOSとは何ですか?

FreeRTOSはESP32の内部で動くリアルタイムOSで、Arduinoのコードはその上で実行されます。複数の処理を別々のタスクに分け、優先度を付けて2つのコアに振り分けることができます。別途インストールする必要はなく、xTaskCreateなどの関数はESP32のArduinoコアですぐに使えます。

ESP32のloop()はどのコアで動きますか?

Arduinoコアでは、setup()とloop()はコア1のloopTaskというタスク内で、優先度1で動きます。Wi-Fi、TCP/IP、Bluetoothはコア0で動きます。xPortGetCoreID()を出力すれば確認できます。

ESP32のdelay()とvTaskDelay()の違いは何ですか?

ESP32のArduinoコアではdelay()が実際にvTaskDelay()を呼び出すため、どちらも待機中はほかのタスクにコアを譲ります。Arduino Unoで見られるプロセッサを占有した待機は、ESP32ではdelayMicroseconds()や空のwhileループで起きます。一定周期の処理にはvTaskDelayUntil()のほうが正確です。

xTaskCreatePinnedToCoreのスタックサイズはどれくらいにすればよいですか?

ESP32のスタックサイズはバイト単位です。最初の目安として、単純なLEDタスクには2048バイト、Serial.printfやStringを使うタスクには3072〜4096バイト、HTTPSやJSONなどの重い処理には8192バイトが適しています。uxTaskGetStackHighWaterMark()で実際の使用量を測定して調整してください。

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

このエラーは、コア0のアイドルタスクが5秒間実行できなかったことを意味します。通常は、あるタスクが一度も待機せずにループしていることが原因です。ループ内にvTaskDelay(1)を追加するか、タスクの優先度を下げるか、コア1へ移してください。長い計算を小さな処理に分割することも有効です。

ESP32のタスク間でデータを共有するにはどうすればよいですか?

最も安全なのはFreeRTOSのキューです。xQueueSend()で送信し、xQueueReceive()で受信します。データがコピーされるため、読み取り途中の値が混ざりません。最新の値だけが必要なら、1項目のキューでxQueueOverwrite()とxQueuePeek()を使います。ハードウェアやグローバル構造体を共有する場合は、ミューテックスでアクセスを保護してください。

全プロジェクトを見る
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 WebSocketカウンター(2つのボタン+LCD+Webリアルタイム表示)
ES-28上級
プレミアム

ESP32 WebSocketカウンター(2つのボタン+LCD+Webリアルタイム表示)

このプロジェクトでは、ESP32に接続した2つのボタンでカウンターの値を変更します(GPIO 5で増加、GPIO 4で減少)。値は16x2 I2C LCDに即座に反映され、ESPAsyncWebServerのWebSocket機能により、接続中のすべてのブラウザーでもページを再読み込みせずに更新されます。HTTPポーリングの代わりに1つの接続を維持し、ESP32がws.textAll()で新しい値を全員に送信します。

4.5(14)
23
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と可変抵抗でLEDの明るさを制御(アナログ→PWM)
ES-13中級
プレミアム

ESP32と可変抵抗でLEDの明るさを制御(アナログ→PWM)

可変抵抗を使ってLEDの明るさをアナログ操作で調整します。ESP32のADCピンで可変抵抗からの0-3.3Vの電圧を読み取り、PWM(パルス幅変調)信号に変換してLEDに出力します。可変抵抗を回すと、LEDが徐々に明るくなったり暗くなったりします。Arduino Core 3.0+ではanalogWrite()を直接使えます。ESP32-S2/S3ではADCの分解能を12ビットに固定します。

4.5(19)
32
ESP32 WS2812B NeoPixel LEDテープの制御
ES-24中級
プレミアム

ESP32 WS2812B NeoPixel LEDテープの制御

WS2812B(NeoPixel)は、1本のデータピンで連結したLEDを個別に制御できるスマートなRGB LEDです。このプロジェクトでは、8個のLEDを備えたWS2812BテープをAdafruit_NeoPixelライブラリで制御し、滑らかな虹色のアニメーションを作ります。ESP32の3.3VロジックレベルはほとんどのWS2812Bのロットで問題なく動作しますが、不安定な場合に備え、470Ωの直列抵抗と1000µFのコンデンサを使う対策も紹介します。アニメーションは、HSV色空間の色相(hue)をずらして作ります。

4.9(19)
30
ESP32のディープスリープで節電(OLED + RTC RAMカウンター)
ES-33上級
プレミアム

ESP32のディープスリープで節電(OLED + RTC RAMカウンター)

ESP32のディープスリープモードは、CPUとほとんどの周辺機器を停止し、消費電流を約10 µAまで抑えます。電池で動くIoT機器に欠かせない機能です。このプロジェクトでは、タイマー(15秒)、外部ピン(EXT0、ボタンはGPIO 33)、タッチ(T0/GPIO 4)の3種類の復帰方法を使います。RTC_DATA_ATTRを付けた変数はディープスリープ中も保持され、起動回数、タイマーによる復帰回数、ボタンによる復帰回数を継続して記録できます。復帰するたびにSSD1306 OLEDディスプレイに復帰理由と回数を表示します。

4.3(10)
16
ESP32温度データロガー(DHT22 + DS1307 RTC + microSD + OLED)
ES-40上級
プレミアム

ESP32温度データロガー(DHT22 + DS1307 RTC + microSD + OLED)

ESP32で日時付きの温度・湿度記録システムを作ります!DHT22で1分ごとに温度と湿度を読み取り、DS1307 RTCから取得した日時とともにmicroSDカードへCSV形式で記録します。OLEDには最新の温度を大きな文字で表示し、湿度のパーセント値、日時、総記録数も表示します。SDカードの/temp_log.csvファイルはExcel、Google Sheets、Pythonのpandasで開いて分析できます。温室の監視、家や部屋の温度管理、実験室のデータ収集、食品の保管環境や養蜂箱の監視に適しています。

4.7(7)
12
ESP32スマート照明(PIR + LDR + リレー + OLED)
ES-37上級
プレミアム

ESP32スマート照明(PIR + LDR + リレー + OLED)

ESP32で廊下やトイレ、食品庫の照明をスマート化します!PIRモーションセンサー、LDR光センサー、リレーモジュールを使い、「暗い場所で動きを検知すると点灯する」定番の仕組みを作ります。周囲が明るければ動きを検知しても点灯しないため、日中の無駄な電力消費を抑えられます。照明は30秒間点灯し、動きが続くとタイマーがリセットされて点灯時間が延びます。SSD1306 OLEDには大きな文字で状態(ON / DAYTIME / WAITING)とカウントダウンを表示します。

4.3(6)
11