CatHand Blog

製氷機タンクの水位低下通知を作りました

#ESP32-C3 #電子工作 #水位センサー #XKC-Y25-NPN #Discord #PlatformIO #Webhook #冷蔵庫 #自作ツール

【ESP32】冷蔵庫の自動製氷機の水タンクの水位低下通知システムを作る【電子工作】

冷蔵庫の自動製氷機の水がなくなったら通知されるようにしました。

water-level

製氷機タンクの水位を非接触の液面センサーで見張って、水が減ったら Discord に通知するやつです。冷蔵庫に設置して、USB 充電器から給電して動かしてます。

使ったもの

センサーには型番の刻印がありませんでした。商品ページの関連商品、付属 PDF のスペック(DC5V / <15mA / NPN 出力)、外観から XKC-Y25-NPN の互換品と判断して、XKC-Y25-NPN のデータシートを見ながら進めてます。

センサーのしくみ

XKC-Y25 は静電容量式のセンサーで、容器の外側に貼るだけで、プラスチックやガラス越しに中の液面を検知できます。液体に触れないので、汚れや腐食の心配がありません。感知できる壁の厚さは 0〜13mm です。

出力は NPN オープンコレクタで、水を検知すると信号線を GND に引き下げ、水がないときはオープンになります。なので ESP32 側でプルアップしてやる必要があります。

配線はこうしました。

GPIO4 は INPUT_PULLUP にして、内蔵プルアップで 3.3V に持ち上げてます。センサーの電源は 5V ですが、トランジスタは信号線を GND に引くことしかしないので、GPIO にかかる電圧は 3.3V と 0V の間で振れるだけです。5V が入ることはないので、抵抗などの追加部品はいりません。GPIO4 は水があれば LOW、なければ HIGH になります。

ちなみに動作温度は 0〜105°C なので、冷蔵庫の中だとギリギリです。凍る場所は避けたほうがよさそうです。

まずブレッドボードで確認

いきなり冷蔵庫に付ける前に、買ったセンサーがちゃんと動くかをブレッドボードで確かめる手順をまとめました。水を入れたペットボトルの側面にセンサーを当てて、水を検知したらオンボード LED(GPIO8、アクティブ LOW)が点くだけのスケッチを書き込みます。

void loop() {
  int v = digitalRead(SENSOR_PIN);
  bool water = (v == LOW);
  digitalWrite(LED_PIN, water ? LOW : HIGH);  // 水検知で点灯
  Serial.printf("sensor=%s (%d) led=%s\n",
                water ? "WATER" : "----", v, water ? "ON" : "off");
  delay(200);
}

確認する項目はこんなかんじです。

センサーの検知面を手で握ると、人体も導電体なので点く可能性があります(仕様どおり)。

通知

本番のファームウェアは PlatformIO でビルドしてます。センサーは 1 秒ごとに読んでいて、水なしが 5 分続いたら Webhook で通知します。一度通知したら、水が補充されるまでは再通知しません。

送り先は WEBHOOK_TYPE で、Discord、Slack、汎用 JSON({"text":"..."} を POST)を切り替えられます。

Wi-Fi の設定や Webhook の URL は secrets.h に書きます。リポジトリには secrets.example.h だけ入れてあるので、これをコピーして使います。送信に失敗したときは 3 回までリトライします。

通知はデフォルトで OFF です。Web UI から ON にして、はじめて通知が飛ぶようになります。ON/OFF は NVS(Preferences)に保存するので、リセットしても最後の状態のままです。

Web UI と API

同じ ESP32 で HTTP サーバも動かしていて、mDNS で名前を公開してます。同じ Wi-Fi の中からなら、ブラウザで水位の状態を見たり、通知の ON/OFF を切り替えたりできます。

画面には「水あり」「水なし」の表示と通知のトグルがあって、「詳細」を開くとテスト送信のボタンと、こんな情報がでてます。

画面は 3 秒ごとに更新します。中身は次の API を叩いているだけです。

認証はないので、LAN の中だけで使う前提です。

あと、Web UI を PC で確認するためのモックサーバ(tools/mock_server.py)も入れてます。webui.h に埋め込んだ HTML をそのまま返して、API はダミーの状態を返します。20 秒ごとに水あり / 水なしが入れ替わるので、ESP32 に書き込まなくても画面の動きが見られます。

2026-10 より前の記事は Tumblr にあります。