ガイド · 読了まで13分

ESP32 Firebaseガイド:センサーデータの書き込みとLEDの制御

ESP32とFirebase Realtime Databaseの使い方を解説します。プロジェクトの作成、メールアドレス認証、DHT22のデータの書き込み、ストリームによるLED制御、Pico WのREST例まで紹介します。

ESP32とFirebaseの組み合わせは、センサーデータをインターネットに載せ、世界中どこからでもデバイスを操作するための最も手早い方法の一つです。GoogleのFirebaseのRealtime Databaseは、データをJSONツリーとして保存し、すべての変更を接続中のすべてのクライアントへ、たいてい1秒未満で届けるクラウドデータベースです。ESP32が温度と湿度の測定値をここに書き込むと、スマホのWebページやアプリがすぐに同じデータを見られます。逆方向も同じです。データベースのledの値をtrueにすると、ESP32につないだLEDがすぐに点灯します。

このガイドでは、Firebaseプロジェクトをゼロから作成し、メールアドレスとパスワードによる認証を有効にし、セキュリティルールを正しく書き、Arduino IDEにFirebase ESP Clientライブラリをインストールします。続いて、DHT22センサーのデータを30秒ごとにデータベースへ書き込むコードと、データベースの変更をストリームで受け取ってLEDをすぐに点灯させる2つ目の例を、ステップごとに見ていきます。最後のセクションでは、同じ処理をRaspberry Pi Pico WとMicroPythonでREST API経由で行い、FirebaseとGoogleスプレッドシートを比較し、よくあるエラーメッセージの対処法をまとめます。ESP32が初めての場合は、まず「ESP32とは?」をご覧ください。

Firebaseプロジェクト用のESP32開発ボード
ESP32開発ボード:Wi-Fiを内蔵しているので、追加のモジュールなしでFirebase Realtime Databaseに接続できます。

Firebase Realtime Databaseとは?どのように動作する?

Realtime Databaseは、従来の表形式(SQL)のデータベースとは異なり、データを1つの大きなJSONツリーとして保持します。各データはパスで指定します。たとえば/cihazlar/UID/son/sicaklikというパスには数値を、/cihazlar/UID/ledというパスにはtrueかfalseを入れられます(cihazlarはトルコ語で「デバイス」、sonは「最新」、sicaklikは「温度」の意味です)。ESP32は、暗号化されたHTTPS接続でこれらのパスに書き込み、読み取ります。本当の強みはストリーム(監視)機能です。デバイスがあるパスを購読すると接続が開いたままになり、そのパスの値が変わった瞬間にサーバーが新しいデータを自動で送ってきます。毎秒問い合わせるループが不要になるので、遅延もデータ通信量も減ります。

特徴値/説明
データモデルJSONツリー(NoSQL)、パスによるアクセス
接続HTTPS(TLS)、ストリームでは開いたままのHTTP接続
無料のSparkプランストレージ1 GB、ダウンロード月10 GB、同時接続100
遅延変更はたいてい1秒未満で届く
認証メールアドレス/パスワード、匿名ログイン、Googleアカウントなど
セキュリティサーバー側で動作するJSONのセキュリティルール
対応ボードESP32とESP8266(ライブラリを使用)、Pico W(REST API経由)

Firebaseプロジェクトの作成手順

  1. GoogleアカウントでFirebaseコンソールにログインし、Create a project(プロジェクトを作成)をクリックします。esp32-seraのような名前を付けます(seraはトルコ語で「温室」)。このプロジェクトにGoogleアナリティクスは不要なので、オフにしてかまいません。
  2. 左のメニューからBuild > Realtime Databaseを開き、Create Database(データベースを作成)を押します。
  3. データベースのロケーションを選びます。ヨーロッパにいる場合はeurope-west1(ベルギー)のほうが遅延が少なくなります。米国のロケーションでは、アドレスの末尾が-default-rtdb.firebaseio.comになります。ヨーロッパの場合、アドレスは次のような形になります:https://your-project-default-rtdb.europe-west1.firebasedatabase.app
  4. セキュリティモードにはLocked mode(ロックモード)を選びます。ルールはこのあと自分で書きます。開いたページの上部にあるアドレスをコピーします。これがDATABASE_URLの値です。
  5. Build > Authenticationを開き、Get started(始める)をクリックして、Sign-in method(ログイン方法)タブでEmail/Passwordプロバイダを有効にします。
  6. Users(ユーザー)タブで、Add user(ユーザーを追加)からESP32用のユーザーを作成します(たとえば[email protected]と6文字以上のパスワード)。作成された行のUser UIDの値をメモしておきます。
  7. 左上の歯車アイコンからProject settings > Generalを開き、Web API Keyをコピーします。これがAPI_KEYの値です。
データベースをTest mode(テストモード)で作成すると、ルールは30日間すべての人に読み書きを許可します。期限が切れるとすべてのリクエストがPermission denied(アクセス拒否)エラーで拒否され、ある日突然プロジェクトが動かなくなります。さらに悪いことに、この30日間はデータベースのアドレスを知っている人なら誰でもデータを読んだり削除したりできます。Locked modeで始めてルールを認証に結び付けるのが、安全で長く使える解決策です。

認証とセキュリティルール

Web APIキーは、それだけでは秘密のパスワードではありません。リクエストがどのFirebaseプロジェクトのものかを伝えるだけです。本当の保護は、Firebaseのサーバーで動作するセキュリティルールです。ESP32がメールアドレスとパスワードでログインすると、Firebaseは1時間有効なIDトークンを発行します。ライブラリは期限が切れる前に自動でトークンを更新します。ルールの中では、auth.uidという式でリクエストを送ったユーザーのIDを取得できます。下の表は、Realtime Database > Rulesタブに書ける3種類のルールとその意味です。おすすめは3つ目の構成です。各デバイスは自分のUIDの下の枝にしかアクセスできないので、あるデバイスのパスワードが盗まれても、ほかのデバイスのデータは安全です。

ルール(Rulesタブ)意味
{"rules": {".read": true, ".write": true}}(全員が読み書き可能)誰でも読み書きできます。数分間のテスト専用で、絶対に開けたままにしないでください。
{"rules": {".read": "auth != null", ".write": "auth != null"}}(ログイン済みなら可能)ログインしたすべてのユーザーがデータベース全体にアクセスできます。1人で使う小さなプロジェクトなら十分です。
{"rules": {"cihazlar": {"$uid": {".read": "$uid === auth.uid", ".write": "$uid === auth.uid"}}}}(自分のUIDの枝だけ)各ユーザーは/cihazlar/自分のUIDの枝だけを読み書きできます。この記事のコードはこの構成に合わせて書いています。

ライブラリのインストールと設定

  1. Arduino IDEにESP32のボードパッケージがインストールされていることを確認します(「ツール」>「ボード」>「esp32」)。この記事のコードは、コアのバージョン2.xと3.xのどちらでも動作します。
  2. ライブラリマネージャでFirebase ESP Clientを検索し、Mobizt氏のFirebase Arduino Client Library for ESP8266 and ESP32をインストールします。コードはこのライブラリのFirebase_ESP_Client.hのインターフェースを使います。同じ開発者による新しいライブラリFirebaseClientはインターフェースが異なるので、混同しないでください。
  3. 同じライブラリマネージャから、AdafruitのDHT sensor libraryをインストールします。依存ライブラリとしてAdafruit Unified Sensorを求められたら、それも追加します。
  4. コードの先頭にある6つの設定(Wi-Fiの名前とパスワード、APIキー、データベースのアドレス、ユーザーのメールアドレスとパスワード)を自分の値に書き換えます。
設定取得場所例
API_KEYProject settings(プロジェクトの設定)> General > Web API KeyAIzaで始まる39文字の文字列
DATABASE_URLRealtime Databaseのページ上部例:https://your-project-default-rtdb.europe-west1.firebasedatabase.app
USER_EMAILAuthentication > Users(ユーザー)[email protected]など
USER_PASSWORDユーザーを追加したときに設定したパスワード6文字以上
WIFI_SSID / WIFI_PASSWORDルーターの設定2.4 GHzのネットワークのみ(ESP32は5 GHz非対応)

回路:DHT22とLEDの配線

接続ESP32Raspberry Pi Pico W
DHT22 VCC3V33V3(OUT)
DHT22 DATAGPIO 4GP15
DHT22 GNDGNDGND
LEDのアノード(220 Ωの抵抗経由)GPIO 26GP14
LEDのカソードGNDGND
DHT22センサー単体を使う場合は、DATAと3V3の間に10 kΩのプルアップ抵抗を入れる必要があります。モジュール版では、この抵抗はすでに基板に載っています。3.3 Vの出力では、220 Ωで赤色LEDに約6 mAが流れます。ほかの色の場合はLED抵抗計算ツールで値を確認できます。プロジェクトにアナログセンサーを追加する場合は、Wi-Fiがオンの間、ESP32のADC2のピン(GPIO 0、2、4、12〜15、25〜27)はanalogReadで使えないことを覚えておいてください。アナログ入力にはADC1のピン(GPIO 32〜39)を選びます。

センサーデータをFirebaseに書き込む

下のコードはWi-Fiに接続し、メールアドレスとパスワードでFirebaseにログインして、DHT22の測定値を30秒ごとに2か所に書き込みます。/cihazlar/UID/sonノードには毎回上書きされる最新の測定値が、/cihazlar/UID/kayitノード(kayitはトルコ語で「記録」)にはpushで追加される履歴が入ります。UIDはログイン後にライブラリから自動で取得されるので、手で入力する必要はありません。

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <Firebase_ESP_Client.h>
3#include "addons/TokenHelper.h"   // token durumunu Seri Monitör'e yazar / prints token status to Serial
4#include <DHT.h>
5
6// Kendi bilgilerinle değiştir / Replace with your own values
7#define WIFI_SSID      "WIFI_ADIN"
8#define WIFI_PASSWORD  "WIFI_SIFREN"
9#define API_KEY        "WEB_API_KEY"
10#define DATABASE_URL   "https://proje-adin-default-rtdb.europe-west1.firebasedatabase.app"
11#define USER_EMAIL     "[email protected]"
12#define USER_PASSWORD  "sifre123"
13
14#define DHT_PIN 4
15
16DHT dht(DHT_PIN, DHT22);
17FirebaseData fbdo;        // istek nesnesi / request object
18FirebaseAuth auth;        // kullanıcı bilgisi / user credentials
19FirebaseConfig config;    // proje ayarları / project settings
20
21unsigned long sonGonderim = 0;
22const unsigned long ARALIK = 30000;   // 30 saniye / 30 seconds
23
24void setup() {
25  Serial.begin(115200);
26  dht.begin();
27
28  WiFi.mode(WIFI_STA);
29  WiFi.setAutoReconnect(true);         // kopunca yeniden bağlan / reconnect on drop
30  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
31  Serial.print("Wi-Fi baglaniyor");
32  while (WiFi.status() != WL_CONNECTED) {
33    delay(300);
34    Serial.print(".");
35  }
36  Serial.println();
37  Serial.print("IP: ");
38  Serial.println(WiFi.localIP());
39
40  config.api_key = API_KEY;
41  config.database_url = DATABASE_URL;
42  auth.user.email = USER_EMAIL;
43  auth.user.password = USER_PASSWORD;
44  config.token_status_callback = tokenStatusCallback;   // giriş durumunu izle / watch sign-in status
45
46  Firebase.begin(&config, &auth);      // arka planda giriş yapar / signs in in the background
47}
48
49void loop() {
50  if (!Firebase.ready()) return;               // token hazır değil / token not ready
51  if (millis() - sonGonderim < ARALIK) return;
52  sonGonderim = millis();
53
54  float t = dht.readTemperature();
55  float h = dht.readHumidity();
56  if (isnan(t) || isnan(h)) {
57    Serial.println("DHT22 okunamadi / read failed");
58    return;
59  }
60
61  FirebaseJson json;
62  json.set("sicaklik", t);
63  json.set("nem", h);
64  json.set("zaman/.sv", "timestamp");          // sunucu saati / server timestamp
65
66  String kok = String("/cihazlar/") + auth.token.uid.c_str();
67  String yolSon = kok + "/son";
68  String yolKayit = kok + "/kayit";
69
70  if (Firebase.RTDB.setJSON(&fbdo, yolSon.c_str(), &json)) {       // son ölçümü güncelle / update latest
71    Serial.printf("Yazildi: %.1f C, %.0f %%\n", t, h);
72  } else {
73    Serial.println(fbdo.errorReason());
74  }
75
76  if (!Firebase.RTDB.pushJSON(&fbdo, yolKayit.c_str(), &json)) {   // geçmişe ekle / append to history
77    Serial.println(fbdo.errorReason());
78  }
79}
行/関数役割
Firebase.begin(&config, &auth)(初期化とログイン)設定を読み込み、バックグラウンドでログインしてトークンを取得します。
Firebase.ready()(準備完了の確認)トークンが準備済みで有効ならtrueを返します。期限が近ければ更新します。リクエストのたびに事前に呼び出す必要があります。
Firebase.RTDB.setJSON()(上書き)指定したパスの内容を新しいJSONで完全に置き換えます。
Firebase.RTDB.pushJSON()(追加)パスの下に、時刻順に並ぶ一意のキーを持つ新しい記録を追加します。
json.set("zaman/.sv", "timestamp")(サーバー時刻、zamanはトルコ語で「時間」)サーバー自身の時刻(ミリ秒単位のUnix時間)を書き込ませます。ESP32で時計を設定する必要はありません。
fbdo.errorReason()(エラーの理由)リクエストが失敗した場合、エラーの理由を文字列で返します。

各記録はキーを含めて約100バイトを使います。30秒ごとに1件なら1日に2,880件、およそ0.3 MBです。無料プランの1 GBのストレージは、このペースなら何年たってもいっぱいになりません。間隔を1秒に縮めると、1日に86,400件、約8.6 MBになります。さらに、このデータを読み取るクライアントはそれぞれ、月10 GBのダウンロード枠を消費します。そのため、ライブ表示では最新のノードだけを読み、履歴はグラフを描くときだけ取得するのがよい習慣です。

データベースからLEDを制御する:ストリームですぐに反応

LEDを遠隔操作する方法は2つあります。1つ目はloopの中で数秒ごとに値を問い合わせる方法です。簡単ですが、問い合わせのたびに新しいHTTPSリクエストが発生し、反応は最大で問い合わせ間隔の分だけ遅れます。2つ目がストリームです。ESP32が/cihazlar/UID/ledのパスを一度だけ購読すると接続が開いたままになり、コンソールで値を変えた瞬間に新しい値がESP32に届きます。下のコードはこの方法を使います。ESP32ではストリームのコールバックが別のタスクで動作するので、そこで直接LEDを変えるのではなく、フラグを使ってloopの中で変えます。これにより、時間のかかる処理がストリームを止めてしまうことも防げます。

C++ (Arduino IDE)
1#include <WiFi.h>
2#include <Firebase_ESP_Client.h>
3#include "addons/TokenHelper.h"
4
5// Kendi bilgilerinle değiştir / Replace with your own values
6#define WIFI_SSID      "WIFI_ADIN"
7#define WIFI_PASSWORD  "WIFI_SIFREN"
8#define API_KEY        "WEB_API_KEY"
9#define DATABASE_URL   "https://proje-adin-default-rtdb.europe-west1.firebasedatabase.app"
10#define USER_EMAIL     "[email protected]"
11#define USER_PASSWORD  "sifre123"
12
13#define LED_PIN 26
14
15FirebaseData stream;      // yalnızca dinleme için / for listening only
16FirebaseAuth auth;
17FirebaseConfig config;
18
19volatile bool yeniVeri = false;
20volatile bool ledDurum = false;
21bool streamAcik = false;
22
23// Değer değişince çağrılır / Called when the value changes
24void streamCallback(FirebaseStream data) {
25  if (data.dataType() == "boolean") {
26    ledDurum = data.boolData();
27    yeniVeri = true;
28  } else if (data.dataType() == "int") {
29    ledDurum = (data.intData() != 0);           // 1 ve 0 da kabul / 1 and 0 also accepted
30    yeniVeri = true;
31  }
32}
33
34// Bağlantı zaman aşımında çağrılır / Called on stream timeout
35void streamTimeoutCallback(bool timeout) {
36  if (timeout) Serial.println("Stream zaman asimi, devam ediliyor / timeout, resuming");
37  if (!stream.httpConnected()) Serial.println(stream.errorReason());
38}
39
40void setup() {
41  Serial.begin(115200);
42  pinMode(LED_PIN, OUTPUT);
43  digitalWrite(LED_PIN, LOW);
44
45  WiFi.mode(WIFI_STA);
46  WiFi.setAutoReconnect(true);
47  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
48  while (WiFi.status() != WL_CONNECTED) {
49    delay(300);
50    Serial.print(".");
51  }
52  Serial.println();
53
54  config.api_key = API_KEY;
55  config.database_url = DATABASE_URL;
56  auth.user.email = USER_EMAIL;
57  auth.user.password = USER_PASSWORD;
58  config.token_status_callback = tokenStatusCallback;
59  Firebase.begin(&config, &auth);
60}
61
62void loop() {
63  // Giriş tamamlanınca stream'i bir kez başlat / Start the stream once after sign-in
64  if (Firebase.ready() && !streamAcik) {
65    String yol = String("/cihazlar/") + auth.token.uid.c_str() + "/led";
66    if (Firebase.RTDB.beginStream(&stream, yol.c_str())) {
67      Firebase.RTDB.setStreamCallback(&stream, streamCallback, streamTimeoutCallback);
68      streamAcik = true;
69      Serial.println("Dinleniyor / Listening: " + yol);
70    } else {
71      Serial.println(stream.errorReason());
72      delay(2000);
73    }
74  }
75
76  // Yeni değer geldiyse LED'i güncelle / Update the LED when new data arrives
77  if (yeniVeri) {
78    yeniVeri = false;
79    digitalWrite(LED_PIN, ledDurum ? HIGH : LOW);
80    Serial.println(ledDurum ? "LED ACIK / ON" : "LED KAPALI / OFF");
81  }
82}

コードを書き込んだら、FirebaseコンソールでRealtime Databaseのページを開き、cihazlarノードの下の自分のUIDの中にledというキーを追加し、値の型にbooleanを選んでtrueを入力します。ストリームが開くと、Firebaseはまずパスにある現在の値を送り、その後は変更のたびに送ってきます。そのため、ESP32が再起動しても、LEDは最後に保存された状態に戻ります。同じ構成をリレーモジュールに応用すれば、電灯や扇風機、ウォーターポンプをインターネット経由でオン・オフできます。

コンソールで値を入力するときは型に注意してください。引用符付きで"true"と入力すると文字列になり、コードはbooleanとして認識しません。コードは1や0のような整数も受け付けます。センサーの書き込みとLEDの監視を1枚のボードでまとめて行う場合は、FirebaseDataオブジェクトを2つに分けます。1つはストリーム専用、もう1つは書き込みリクエスト用です。TLS接続は1本ごとに数十KBのRAMを使います。ESP32なら問題ありませんが、オブジェクトの数をむやみに増やさないでください。

Raspberry Pi Pico WでFirebase(MicroPython)

Pico Wには、ESP32のような広く使われているFirebaseライブラリはありませんが、それがなくても大丈夫です。Realtime DatabaseはすべてのパスをRESTのアドレスとしても公開しています。パスの末尾に.jsonを付け、PUTで書き込み、GETで読み取ります。認証では、まずFirebaseのログインサービスにメールアドレスとパスワードを送ってidTokenとユーザーIDのlocalIdを受け取り、その後のリクエストすべてに?auth=パラメーターでトークンを付けます。トークンは1時間有効なので、コードは50分ごとにログインし直します。この方法はストリームほど速くありません。LEDの状態は10秒ごとのループで問い合わせます。Pico WのWi-Fiの設定については、「Pico WのWi-FiとWebサーバー」の記事をご覧ください。

MicroPython
1import network, time, urequests, dht
2from machine import Pin
3
4# Kendi bilgilerinle değiştir / Replace with your own values
5SSID = "WIFI_ADIN"
6SIFRE_WIFI = "WIFI_SIFREN"
7API_KEY = "WEB_API_KEY"
8DB_URL = "https://proje-adin-default-rtdb.europe-west1.firebasedatabase.app"
9EMAIL = "[email protected]"
10SIFRE = "sifre123"
11
12sensor = dht.DHT22(Pin(15))
13led = Pin(14, Pin.OUT)
14
15wlan = network.WLAN(network.STA_IF)
16wlan.active(True)
17wlan.connect(SSID, SIFRE_WIFI)
18while not wlan.isconnected():          # bağlantıyı bekle / wait for connection
19    time.sleep(0.5)
20print("IP:", wlan.ifconfig()[0])
21
22def giris():
23    # E-posta/şifre ile token al / Get a token with email/password
24    url = "https://identitytoolkit.googleapis.com/v1/accounts:signInWithPassword?key=" + API_KEY
25    r = urequests.post(url, json={"email": EMAIL, "password": SIFRE, "returnSecureToken": True})
26    cevap = r.json()
27    r.close()
28    return cevap["idToken"], cevap["localId"]   # token ve UID / token and UID
29
30token, uid = giris()
31giris_zamani = time.time()
32
33while True:
34    try:
35        if time.time() - giris_zamani > 3000:     # 50 dakikada bir yenile / refresh every 50 min
36            token, uid = giris()
37            giris_zamani = time.time()
38        kok = DB_URL + "/cihazlar/" + uid
39        sensor.measure()
40        veri = {"sicaklik": sensor.temperature(), "nem": sensor.humidity(),
41                "zaman": {".sv": "timestamp"}}    # sunucu saati / server timestamp
42        r = urequests.put(kok + "/son.json?auth=" + token, json=veri)
43        r.close()
44        r = urequests.get(kok + "/led.json?auth=" + token)
45        durum = r.json()                          # true, false ya da None / true, false or None
46        r.close()
47        led.value(1 if durum else 0)
48        print(veri["sicaklik"], veri["nem"], "LED:", durum)
49    except Exception as e:
50        print("Hata / Error:", e)
51    time.sleep(10)

FirebaseとGoogleスプレッドシート、どちらを選ぶ?

観点Firebase Realtime DatabaseGoogleスプレッドシート(Apps Script)
データの方向双方向:書き込み、読み取り、即時の監視たいてい一方向:デバイスからシートへ
遅延変更はたいてい1秒未満リクエストごとに数秒かかることがある
デバイスの制御ストリームでLED、リレー、サーボをすぐに操作不向き。常に問い合わせが必要
グラフと分析自分でWebページやアプリを作る必要がある既製のグラフ、数式、Excelへの書き出し
セキュリティユーザーごとの細かいルール一般公開したスクリプトのアドレスを知っている人なら誰でも書き込める
制限Spark:ストレージ1 GB、ダウンロード月10 GB1ファイルあたり最大1,000万セル、Apps Scriptの割り当て
セットアップ中程度:プロジェクト、認証、ルール簡単:シート1枚と短いスクリプト

まとめると、測定値を記録して週ごとのグラフを描くだけが目的なら、「ESP32とGoogleスプレッドシート」の方法のほうが早くセットアップでき、データをシートで直接確認できます。デバイスを遠隔操作したい、複数のデバイスを同時に監視したい、スマホアプリでライブ表示を作りたいという場合は、Firebaseのほうが適しています。2つを組み合わせることもできます。現在の状態はFirebaseに、1日の集計はスプレッドシートに保存するといった使い方です。家のホームオートメーションシステムにつなぐなら、「MQTTとHome Assistant」も有力な選択肢です。

ESP32とFirebaseのプロジェクトアイデア

  • 温室の遠隔監視:温度、湿度、土壌水分の値をFirebaseに書き込み、データベースのスイッチで水やり用のポンプを動かします。
  • スマートプラグ:ストリームでリレーを制御し、オンになっていた時間をデータベースに記録します。詳しくは「ESP32のスマートプラグ」の記事をご覧ください。
  • 動きの記録:PIRセンサーが反応するたびに、pushでタイムスタンプ付きの記録を追加し、スマホで履歴を確認します。
  • 複数の部屋の気象ステーション:家の各部屋にESP32を置き、それぞれ自分のUIDの下に書き込ませて、1つのWebページですべてをライブで確認します。
  • 遠隔で設定できるサーモスタット:目標温度をデータベースから読み取り、それに合わせてヒーターを制御します。ロジックについては「Arduinoのサーモスタット」の記事が出発点になります。
  • 電池で動くセンサー:測定値を書き込んだらディープスリープモードに入り、数分ごとに起きて新しい値を送ります。

よくあるエラーと対処法

エラー/症状考えられる原因対処法
エラー:Permission denied(アクセス拒否)ルールがリクエストを許可していない、またはテストモードの期限切れRulesタブを確認し、パスが/cihazlar/UIDで始まっていることを確かめる
EMAIL_NOT_FOUNDやINVALID_PASSWORD、またはINVALID_LOGIN_CREDENTIALSユーザーが存在しない、またはパスワードが間違っているAuthentication > Usersの一覧でメールアドレスとパスワードを確認する
エラー:OPERATION_NOT_ALLOWED(操作が許可されていない)Email/Passwordプロバイダが有効になっていないSign-in methodタブで有効にする
エラー:API key not valid(APIキーが無効)APIキーがない、またはコピーを間違えているProject settingsのページからキーをコピーし直す
エラー:token is not ready(トークンの準備ができていない)ログインが終わる前にリクエストを送ったリクエストのたびに事前にFirebase.ready()を確認し、Wi-Fi接続を確かめる
エラー:connection refused(接続拒否)やsend request failed(送信失敗)DATABASE_URLの誤り、電波が弱い、または5 GHzのネットワークアドレスをコンソールからそのままコピーし、2.4 GHzのネットワークに接続する
ESP32が再起動を繰り返すWi-FiとTLSの処理中の電流の急増(ブラウンアウト)品質のよいUSBケーブルと余裕のある電源を使う
Firebase_ESP_Client.hが見つからない違うライブラリをインストールしている(たとえばFirebaseClient)MobiztのFirebase Arduino Client Library for ESP8266 and ESP32をインストールする
原因を探すときは、シリアルモニタを115200ボーで開きます。tokenStatusCallback関数が、ログインの過程とエラーコードをステップごとに表示します。ボードがWi-Fiにまったくつながらない場合は「ESP32がWi-Fiにつながらないとき」の、勝手にリセットされる場合は「ESP32のブラウンアウトとGuru Meditation」の記事の手順を試してください。

もっと簡単な方法:BlueGrays IoT

Firebaseなら、データベースの構造とセキュリティルールを完全に自分で管理できます。でも、リレーをオン・オフしたい、センサーをスマホで確認したいというだけなら、プロジェクトの作成、Realtime Databaseのルールの記述、Authenticationのユーザーの追加、APIキーとDATABASE_URLのコードへの転記を手作業で行う必要はありません。BlueGraysアプリのBlueGrays IoTは、マイ工房 › マイデバイス › 新しいデバイスを追加から用意されたテンプレートで始められます。Ohmiがデバイスキー入りのコードを用意し、それをBlueGraysIoTライブラリを使ってArduino IDEから一度書き込めば、スイッチ、ライブの値、グラフがスマホで使えるようになります。ESP32とRaspberry Pi Pico Wで、2.4 GHzのWi-Fiで動作し、最初のデバイスは無料です。詳しくは「ESP32をスマホから操作するガイド」をご覧ください。

Firebaseを使えば、ESP32はただ測るだけでなく、インターネットを通じて会話し、命令を受け取るデバイスになります。まずセンサーの書き込みの例を動かし、次にストリームによるLED制御を追加し、ルールは必ず認証に結び付けてください。BlueGraysアプリでは、ESP32のWi-Fi接続、NTP時計、Webサーバー、WebSocket、DHT22温度データロガーのプロジェクトを、回路図とコード付きでステップごとに確認でき、この記事のFirebaseの機能をその上に簡単に追加できます。

よくある質問

ESP32でFirebaseを使うのは無料ですか?

はい、Firebaseの無料のSparkプランでは、Realtime Database用にストレージ1 GB、月10 GBのダウンロード、同時接続100が使えます。数台のESP32が30秒ごとにデータを書き込むような趣味のプロジェクトなら、この制限を大きく下回ります。クレジットカードを登録しなくてもプロジェクトを作成できます。

Firebase Realtime DatabaseとFirestoreの違いは何ですか?

Realtime Databaseはデータを1つのJSONツリーで保持し、セットアップが簡単で、ストリームによる即時の監視はESP32のライブラリで十分に成熟しています。Firestoreはコレクションとドキュメントの構造を使い、複雑なクエリに強いですが、無料プランでは1日の読み取りと書き込みの回数に制限があります。センサーデータとデバイスの制御には、たいていRealtime Databaseのほうが実用的です。

ESP32がFirebaseにつながらないのはなぜですか?

よくある原因は、データベースのアドレスのコピーミス、Email/Passwordのログインが有効になっていないこと、APIキーの誤り、5 GHzのWi-Fiネットワークです。Permission deniedエラーが出る場合は、セキュリティルールがリクエストを許可していません。シリアルモニタでtokenStatusCallbackの出力を読むと、どのステップで問題が起きているかがわかります。

FirebaseのAPIキーをコードに書いておいても安全ですか?

Web APIキーはプロジェクトを識別するだけで、それだけではデータベースへのアクセス権を与えません。本当のセキュリティは、認証とセキュリティルールによって確保されます。ルールにauth != nullやUIDのチェックが含まれていれば、キーを知っている人でもログインせずにデータを読むことはできません。それでも、コードを一般公開するときは、Wi-Fiとユーザーのパスワードを削除するのを忘れないでください。

ESP32はどのくらいの頻度でFirebaseにデータを送れますか?

HTTPSリクエストは接続状況によって1回あたり数百ミリ秒かかるので、技術的には1秒に1回の書き込みも可能です。ただし、温度のようにゆっくり変わるデータなら、10秒から数分の間隔にすると、割り当てとエネルギーの両方を節約できます。すぐに反応する必要がある制御では、問い合わせの代わりにストリームを使うほうが効率的です。

同じコードはESP8266(NodeMCU)でも動きますか?

Firebase ESP ClientライブラリはESP8266にも対応しています。WiFi.hの代わりにESP8266WiFi.hをインクルードするだけです。ESP8266はRAMが少ないため、TLS接続でメモリが厳しくなることがあります。そのため、同時に使うFirebaseDataオブジェクトは1つにし、ストリームと書き込みは慎重に組み合わせる必要があります。新しいプロジェクトを始めるなら、ESP32のほうが余裕のある選択です。

全プロジェクトを見る
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
ESP32 DHT22温湿度計(LCDディスプレイ付き)
ES-15中級

ESP32 DHT22温湿度計(LCDディスプレイ付き)

DHT22センサーで周囲の温度と湿度を測定し、16x2 I2C LCDにリアルタイムで表示するプロジェクトです。Adafruit DHTライブラリを使い、1本の信号線を使うプロトコルでセンサーからデータを読み取ります。IoT気象観測装置やスマートホームの自動化、温室の環境監視システムの基礎となります。ESP32のGPIO 4ピンを介してDHT22と通信します。

4.8(38)
57
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とNTPでインターネットから正確な時刻を取得
ES-26上級
プレミアム

ESP32とNTPでインターネットから正確な時刻を取得

ESP32をWi-Fiに接続し、NTP(Network Time Protocol)サーバーからミリ秒精度の現在時刻を取得します。configTzTime()関数でタイムゾーンを自動適用し、夏時間を採用する国ではPOSIX TZ文字列で夏時間と標準時間の切り替えも自動管理します。時刻はシリアルモニタと、必要に応じて接続するI2C LCDに表示します。configTzTime()がSNTPサービスを開始し、ネットワークにアクセスできる間は定期的に再同期します。

4.5(13)
22
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 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温度データロガー(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