Infrastructure

家のセンサーの値をためる仕組み

自宅の温湿度センサーの値を、クラウドのBigQueryまで、毎分とどくようにつなぎました。家のIoTですが、やっていることはお客様の計測基盤と同じです。センサーが測った値を家のサーバーが受け、クラウドへ送ってBigQueryにためています。この経路のどこか一か所で詰まると、その時間の行がまるごと抜けます。

2026.10.11 公開読むのに約 7分約 4,000字
この記事の内容
  1. コンポーネントは五つ
  2. 見る場所とためる場所
  3. 値を一か所で受ける設計
  4. 送る間隔の決め方
  5. 偽の『成功』表示
  6. OTAを投げる前の電波の確認
  7. 落ちても自動で復帰する仕組み
  8. とどいた件数の確認
  9. 空の列の意味
  10. 夜間の画面の消灯

センサーはESP32というマイコンで寝室に設置していて、構成はお客様向けに作る計測基盤とほとんど変わりません。センサーが測った値は無線で家のサーバーに届き、クラウドに蓄積されていきます。途中で行が抜けても画面の上では普通に動いて見えるので気づきにくいのです。コンポーネントの順に書いていきます。

コンポーネントは五つ

全体は五つのコンポーネントでできています。センサー、家のなかの小さなサーバー、手元のディスプレイ、クラウドのキュー、BigQueryです。センサーは ESP32-WROOM-32 に温湿度センサーの SHT31 をアドレス 0x44 でつないだもので、ESPHomeで書いたファームウェアが30秒ごとにWi-Fiで値を送ります。受けるサーバーは、手のひらサイズの Raspberry Pi Zero 2W です。届いた値はここで二手に分かれます。HUB75 のLEDマトリクスに今の値を出す表示用と、sht31_bq_bridge というブリッジが Cloud Pub/Sub の sht31-sensors トピックへ流し、BigQuery の sensors.readings テーブルに積んでいく保存用です。センサー本体にも SSD1306 のOLEDを付けてあるので、温度と湿度はその場でも読めます。

コンポーネント役割
センサー温度と湿度を測り、30秒ごとに送る
家の小さなサーバー届いた値をまとめて受ける
手元のディスプレイいまの値を見る
クラウドのキュー値をBigQueryへ渡す
BigQueryためて、後から振り返る
コンポーネントごとの役割。手元のディスプレイとクラウドのキューは、家のサーバーから二手に分かれた先にある。

見る場所とためる場所

LEDマトリクスやOLEDだけでも今の温度と湿度は分かりますが、それでもBigQueryに蓄積するのはあとから出てくる問いに答えるためです。夜のあいだに湿度が下がりすぎていなかったか、去年の冬と今年で昼の気温がどれだけ違うか、といった問いは測っている最中には思いつきません。画面が見せるのは今この瞬間の値だけで、BigQueryのテーブルには timestamp・temperature・humidity などの列で1行ずつ残してあるので、気になった日にその期間の行をSQLで引いて確かめられます。全段がつながったのを確認した2026年10月10日の未明には、いちばん新しい行が温度24.9℃、湿度53.2%でした。センサーの電波の強さ(RSSI)はそのとき-52dBmでした。

値を一か所で受ける設計

センサーとサーバーの間をつなぐのは、トピック単位でメッセージを配るpub/sub型のプロトコル、MQTTです。センサーは、測った値を『部屋名/sensor/…』という階層のトピックへ publish し、サブスクライバーがいてもいなくても送り続けます。サーバー側にはMosquittoというMQTTブローカーを一つ置いて、届いた値をまとめて受けます。こうしておくと、あとから表示を足したり、別の保存先へ流したりするときも、センサー側はいじらずに済みました。トピックの階層は、部屋と値の種類で分けています。温度と湿度でトピックを分けてあるので、湿度だけを拾う表示も後から作れます。部屋を増やすときも、トピックを一本足すだけです。届いているかは、Macから mosquitto_sub で部屋のトピックを # のワイルドカードで購読し、-v -W 40 を付けて40秒ぶんの生のメッセージを読めば確かめられます。

送る間隔の決め方

送る間隔は30秒です。温度や湿度は秒単位で急に変わるものではないので、部屋の様子の変わり目はこの間隔で追えています。送る回数が決まれば1日にたまるはずの行数も決まり、この「あるべき行数」があとで欠損を見つける基準になりました。間隔を変えたら、あるべき行数の計算もすぐ直します。この計算がずれると、抜けていないのに抜けたと誤検知してしまいます。

偽の『成功』表示

センサーのファームウェアを無線で書き換えるOTAアップデートに、いちばん手こずりました。esphome run が exit 0 で終わったのにアップロードは失敗していて、センサーのファームウェアは古いバージョンのままだったことがあります。前にシェルで踏んだのと同様に、終了コードや「成功」の表示は処理が最後まで完了したかどうかまでは保証しません。そのためOTAのあとはログ末尾の OTA successful の行を読み、さらにセンサーが新しい動作をしているかを実機で確かめます。一度この罠を踏んでからは旧バージョンと新バージョンで動作の変わる箇所を一つ決め、OTAのあとは当該箇所が変わったかで成否を判定しています。消灯を足した更新では、SNTPの Synchronized time: のログが出たことを新しいファームウェアが動いている確証にしました。

OTAを投げる前の電波の確認

OTAが失敗するときは、失敗の前からセンサーまでの電波が不安定になっていました。esphomeのアップロードは receiving version response: timed out で止まり、pingで応答時間を見ると成功したときは7ミリ秒なのに失敗したときは331〜430ミリ秒まで伸びていました。そのためOTAを投げる前にpingを何回か打って安定しているかを見て、遅かったりばらついていたりするときは投げずに落ち着くまで待ちます。いちばん通りやすいのは再起動した直後で電波も安定しているときで、5.38秒で書き込みが終わったこともありました。失敗するとセンサーが11分あまり落ちたこともあるので、少し待つほうが結局早く済みます。

落ちても自動で復帰する仕組み

それでも、OTAに失敗することはあります。失敗すると、センサーはいったんオフラインになりました。ここで、接続が切れたら自動で復帰する作りにしておいたことが役に立ちました。ESPHomeの設定で mqtt に reboot_timeout: 10min を入れてあり、つながらない状態が続くと、センサー自身が再起動して再接続しにいきます。ある晩の失敗では、約11.5分落ちたあと、こちらが何もしないうちに復帰しました。ただし、落ちているあいだはBigQueryの記録が抜けます。抜けた行は、次の節のように、あるべき行数との突き合わせで数えています。

とどいた件数の確認

つないだあとは本当にとどいているかを確認します。センサーは30秒ごとに送るので、1時間なら120行がBigQueryに積もるはずで、直近の1時間と1日ぶんの行数をあるべき数と突き合わせました。直近1時間は120行中120行で欠損は0、いちばん新しい行は3秒前に入っていました。1日なら2,880行そろって満点のところ、実際は2,875行で99.83% です。行数をあるべき数と突き合わせるのは「だいたい動いている」で済ませず、何行とどいて何行抜けたかまで出すためです。なお前の節の約11.5分の停止は、この集計をとった少しあとに発生していて、足りない5行とは関係がありません。

数えたもの値
1時間にあるべき行数120行
1日にあるべき行数2,880行
実際にとどいた行数(1日)2,875行(約99.8%)
欠けた行5行
ある1日の行数。

空の列の意味

保存先のテーブルは RS-WFIREX4 という別の機器と共用しています。WFIREX4 は illuminance(照度)・stability・stable の後半3列も埋めますが、温湿度センサーの行ではこの3列が NULL になります。

逆に WFIREX4 の行は source 列が NULL になっていて、行の出どころはこの列で見分けられます。どちらの NULL も、その機器が該当する列を持っていないだけで欠損ではありません。共用のテーブルでは、どの機器がどの列を埋めるかを先に決め、埋めない列は NULL でよいことにしています。BigQuery で行数を数えるときも、温湿度の行で照度の列が NULL なのは欠損に数えず、本当に抜けた行だけを数えました。

夜間の画面の消灯

寝室に設置しているので、夜中に OLED が光るとまぶしく、途中で消灯の設定を追加しました。ESPHome の設定に time: sntp(Asia/Tokyo)を追加し、display の lambda の冒頭で深夜から朝までの時間帯は return して何も描かないようにしています。ESPHome は毎フレーム画面をクリアするので、何も描かなければ黒のままで光りません。計測と MQTT への publish、BigQuery への書き込みには手を入れていないので、消えるのは OLED だけです。

ESP32開発ボードの赤い電源LEDだけは3.3Vに直結していてソフトウェアでは消せないので、消すならビニールテープや調光シールで物理的に覆うしかありません。

お客様の計測基盤を作るときも、確かめることは同じだと考えています。

経路は、人が張りつかなくても止まらず、どこかで抜けたらすぐ気づける形にします。『成功』の表示はうのみにせず、OTAならログ末尾の行と実機の動作で、届いたデータならあるべき行数との突き合わせで確かめるのが前提です。失敗したら機器が自動で復帰するようにし、抜けた行はあとで数えます。同じテーブルに書き込む WFIREX4 の収集エージェントでは、公開後の11月に、電源の差し直しで DHCP のIPが変わるたびに旧IPを叩き続け、ハブに何も届かなくなる故障が続きました。いまは2分ごとの systemd timer が、向き先が応答しないときだけ LAN を TCP 60001 でスキャンし、向き先を書き換えてエージェントを再起動しています。