製氷機タンクの水位低下通知を作りました
冷蔵庫の自動製氷機の水がなくなったら通知されるようにしました。
製氷機タンクの水位を非接触の液面センサーで見張って、水が減ったら Discord に通知するやつです。冷蔵庫に設置して、USB 充電器から給電して動かしてます。
使ったもの
- 非接触液面センサー(Amazon で買った XKC-Y25-NPN 互換品)
- ESP32-C3 SuperMini
- ブレッドボード、ジャンパ線、USB-C ケーブル
センサーには型番の刻印がありませんでした。商品ページの関連商品、付属 PDF のスペック(DC5V / <15mA / NPN 出力)、外観から XKC-Y25-NPN の互換品と判断して、XKC-Y25-NPN のデータシートを見ながら進めてます。
センサーのしくみ
XKC-Y25 は静電容量式のセンサーで、容器の外側に貼るだけで、プラスチックやガラス越しに中の液面を検知できます。液体に触れないので、汚れや腐食の心配がありません。感知できる壁の厚さは 0〜13mm です。
出力は NPN オープンコレクタで、水を検知すると信号線を GND に引き下げ、水がないときはオープンになります。なので ESP32 側でプルアップしてやる必要があります。
配線はこうしました。
- 赤(VCC) → 5V ピン
- 黒(GND) → GND
- 黄(Signal) → GPIO4
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 を切り替えたりできます。
画面には「水あり」「水なし」の表示と通知のトグルがあって、「詳細」を開くとテスト送信のボタンと、こんな情報がでてます。
- 空検知からの経過時間
- 通知済みかどうか
- 最後に送信を試してからの時間、最後に成功してからの時間
- 成功 / 失敗の回数と、最後のエラー
- Wi-Fi の RSSI、稼働時間
画面は 3 秒ごとに更新します。中身は次の API を叩いているだけです。
GET /api/status状態を JSON で返すPOST /api/notify{"enabled": true}のように送って通知の ON/OFF を切り替えるPOST /api/test-notifyテスト通知を送る
認証はないので、LAN の中だけで使う前提です。
あと、Web UI を PC で確認するためのモックサーバ(tools/mock_server.py)も入れてます。webui.h に埋め込んだ HTML をそのまま返して、API はダミーの状態を返します。20 秒ごとに水あり / 水なしが入れ替わるので、ESP32 に書き込まなくても画面の動きが見られます。
