لنفرض أنك مسؤول عن مبنى تجاري صغير: عيادات في الطابق الأول ومكاتب فوقها، وفي الأسفل خزان أرضي كبير يملؤه الماء من الشبكة أو من صهريج، وعلى السطح خزان علوي يغذي المبنى، وبينهما مضخة يشغلها عامل الصيانة عندما يتذكر، أو عوامة قديمة تشغلها وحدها. وفي يوم عادي، عند الظهر، يتصل بك أحد المستأجرين: لا يوجد ماء في الحمامات. تصعد إلى السطح فتجد الخزان العلوي فارغاً، وتنزل إلى الخزان الأرضي فتجده فارغاً أيضاً، والمضخة كانت تعمل عليه دون ماء منذ ساعات حتى سخنت وتلف مانع التسرب فيها. ولم يكن أحد يعرف أن الخزان الأرضي ينخفض منذ ثلاثة أيام، لأن أحداً لا ينزل لينظر فيه.
وبعد شهر من ذلك تأتيك فاتورة ماء أعلى من المعتاد، أو تلاحظ أنك تطلب الصهريج أكثر من قبل، ولا تعرف السبب، لأن تسرباً صغيراً من عوامة في خزان أو أنبوب في الجدار يأخذ ثلاثين لتراً في الساعة، ليلاً ونهاراً، ولا يراه أحد. وهذه ليست قصة نادرة، فكل من أدار مبنى فيه خزانات ومضخة يعرف المشكلتين: الماء الذي ينتهي فجأة، والماء الذي يختفي بهدوء.
وفي هذا المقال سوف نبني نظاماً يجيب عن ثلاثة أسئلة في أي لحظة: كم لتراً في كل خزان الآن، وهل المضخة تعمل كما يجب، وهل يضيع ماء لا نستخدمه. وسوف نقيس المستوى بحساس موجات فوق صوتية مقاوم للماء من نوع JSN-SR04T فوق كل خزان، ونتحكم بالمضخة بقواعد تحميها من التشغيل على خزان فارغ، ونرسل القراءات عبر MQTT إلى خدمة تحفظها وتفحص التسرب كل ليلة وترسل التنبيه إلى الجوال. والمختبر يشغل البرنامج الحقيقي للمتحكم ESP32 على المحاكي QEMU، أمام مبنى محاكى ليومين كاملين، فيه صهريج يصل، وخزان أرضي ينخفض، وتسرب يبدأ في اليوم الثاني، وأصداء خاطئة من الحساس كما يحدث في الخزانات الحقيقية. ثم نكسر النظام عن قصد لنرى لماذا يحتاج الحساس إلى مرشح، ولماذا تحتاج المضخة إلى حدين لا حد واحد.
وسوف نناقش في هذا المقال ما يلي:
- كيف يصل الماء إلى المبنى، وما الذي نريد أن نعرفه عنه.
- القطع، والحد الفاصل بين ما تركبه أنت وما يركبه الكهربائي.
- قياس المستوى بالموجات فوق الصوتية: المنطقة العمياء، وتحويل زمن الصدى إلى لترات، وأثر الحرارة.
- منطق المضخة: حدان للتشغيل والإيقاف، وحماية من التشغيل دون ماء، وحد لزمن التشغيل، وفحص ارتفاع المستوى.
- المختبر كاملاً: البرنامج في QEMU، والوسيط Mosquitto، وخدمة الاستقبال، والتنبيهات عبر ntfy، ويومان من عمر المبنى.
- فحص التسرب الليلي، والتقرير اليومي.
- اكسرها: أصداء خاطئة تشغل المضخة وتطفئها، ونفس الأصداء بعد المرشح.
وهذا المقال من سلسلة مشاريع إنترنت الأشياء، ويبني على ما شرحناه في مقال مسار البيانات من الحساس إلى لوحة المتابعة ومقال MQTT مع Mosquitto، ويستخدم القالب نفسه الذي بنيناه في مشروع ري النباتات: برنامج ESP32 حقيقي في QEMU، ووسيط، وخدمة استقبال، وتنبيه على الجوال. والفرق هنا أن الخطأ أغلى، فالنبتة التي لم تسق يوماً تعيش، والمضخة التي عملت ساعتين دون ماء قد لا تعيش.
كيف يصل الماء إلى المبنى؟
أغلب المباني في منطقتنا فيها النظام نفسه بأحجام مختلفة: خزان أرضي كبير يستقبل الماء عندما يصل، وخزانات علوية على السطح يخرج منها الماء إلى الحنفيات بالجاذبية، ومضخة نقل ترفع الماء من الأسفل إلى الأعلى. والصورة التالية لخزانات علوية من البلاستيك على سطح مبنى، وهي الأشهر لأنها خفيفة ورخيصة ولا تصدأ:

والشكل التالي يبين المبنى الذي سنبنيه في المختبر، بالأرقام التي سنستخدمها في الكود:

- الخزان الأرضي: في المختبر 4 أمتار في 3 أمتار، وارتفاع الماء فيه عند الامتلاء مترين، أي 24 ألف لتر. ويصله الماء من الشبكة عندما تصل، أو من صهريج نطلبه.
- الخزان العلوي: أسطوانة قطرها متر ونصف، وارتفاع الماء فيها عند الامتلاء متر ونصف، أي قرابة 2650 لتراً. وهو الذي يغذي المبنى، فإذا فرغ انقطع الماء ولو كان الخزان الأرضي ممتلئاً.
- مضخة النقل: في المختبر 40 لتراً في الدقيقة، أي 2.4 متر مكعب في الساعة، فتملأ الخزان العلوي من 30% إلى 90% في قرابة 40 دقيقة.
- الاستهلاك: قرابة 6000 لتر في اليوم، موزعة على ساعات الدوام: ذروة في الصباح، وأخرى عند الظهر، وثالثة في المساء، وقرابة 10 لترات في الساعة في الليل.
وهذه أرقام مثال، والأرقام الحقيقية لمبناك تقيسها مرة واحدة عند التركيب: أبعاد كل خزان، وارتفاع الحساس فوق قاعه، وتدفق المضخة. وكلها في ملف واحد في الكود سنراه بعد قليل.
القطع، ومن يركب ماذا
قبل القطع، الحد الذي لا نتجاوزه في هذا المقال: المضخة تعمل على كهرباء المنزل، 220 أو 380 فولت بحسب حجمها، وهذا الجهد يقتل. ولهذا لا يوصل المتحكم بالمضخة مباشرة أبداً، وإنما يشغل مرحلاً صغيراً Relay على جهد منخفض، والمرحل يشغل ملف كونتاكتور Contactor في لوحة الكهرباء، والكونتاكتور هو الذي يوصل الكهرباء إلى المحرك، ومعه قاطع حماية للمحرك من زيادة التيار Overload. واختيار الكونتاكتور بحسب قدرة المحرك، وتركيبه في اللوحة، وتوصيل جانب الكهرباء كله، عمل كهربائي مرخص، ولن تجد في هذا المقال أي تعليمات لتوصيل جهة الكهرباء. والصورة التالية لكونتاكتور على قضيب تثبيت في لوحة:

وفي أغلب المباني توجد لوحة للمضخة فيها كونتاكتور ومفتاح يدوي، وأحياناً عوامة كهربائية، وما يفعله مشروعنا أنه يضيف إلى هذه اللوحة نقطة تحكم واحدة: تلامس مرحل يغلق دائرة ملف الكونتاكتور أو يفتحها، تماماً كما يفعل المفتاح اليدوي أو العوامة. ويبقى المفتاح اليدوي في اللوحة، فإذا تعطل المتحكم شغل العامل المضخة بيده كما كان يفعل.
أما القطع التي على الطرف المنخفض الجهد، وهي التي سنتعامل معها، فهي:
- لوحة ESP32: فيها Wi-Fi، وتكفي أرجلها لحساسين ومرحل. وقد شرحناها في مقال ESP32.
- حساسا مستوى JSN-SR04T: حساس موجات فوق صوتية مقاوم للماء، رأسه على سلك طويل يثبت في غطاء الخزان، ولوحته الإلكترونية تبقى في صندوق جاف.
- وحدة مرحل Relay Module: مرحل صغير بملف 5 فولت أو 3.3 فولت ومعه ترانزستور يشغله من رجل المتحكم، وتلامسه يناسب تيار ملف الكونتاكتور، لا تيار المحرك.
- مزود طاقة 5 فولت: يغذي المتحكم والحساسين، ويركب في اللوحة بيد الكهربائي، أو تستخدم شاحن جوال جيداً في مقبس قريب.
- صندوق مقاوم للماء والغبار: بفئة حماية IP مناسبة، لأن السطح فيه شمس وغبار ومطر، وأسلاك الحساسين تدخله من فتحات بجلبات محكمة.
والمضخة نفسها ليست جزءاً من المشروع، فهي موجودة في المبنى أصلاً، والصورة التالية لمضخة طرد مركزي Centrifugal Pump مع محركها، وهي النوع الأشهر في نقل الماء، وفي المباني الصغيرة تكون أصغر من هذه بكثير:

ومضخة الطرد المركزي تحتاج الماء لتبرد، فمانع التسرب الميكانيكي Mechanical Seal بين المحور وجسم المضخة يعتمد على الماء الذي يمر فيه، وإذا عملت المضخة دون ماء سخن هذا الجزء وتلف، ثم بدأ الماء يتسرب منها في التشغيل التالي. ولهذا كانت الحماية من التشغيل دون ماء Dry Run أول قاعدة في منطق المضخة، وسنراها بعد قليل.
قياس المستوى بالموجات فوق الصوتية
الفكرة بسيطة: الحساس فوق الماء ينظر إلى الأسفل، يرسل نبضة صوت بتردد 40 كيلو هيرتز، وهو أعلى مما تسمعه الأذن، فتصل النبضة إلى سطح الماء وترتد، ويحسب الحساس الزمن بين الإرسال ورجوع الصدى. والصوت يقطع في الهواء قرابة 343 متراً في الثانية عند 20 درجة، فإذا عرفنا الزمن عرفنا المسافة، وإذا عرفنا المسافة من الحساس إلى الماء، وعرفنا ارتفاع الحساس فوق قاع الخزان، عرفنا ارتفاع الماء. والصورة التالية للحساس الأشهر في المشاريع الصغيرة HC-SR04، وفيه عنصران، واحد يرسل وآخر يستقبل:

ولكن HC-SR04 لا يصلح داخل خزان، لأن لوحته وعناصره مكشوفة، والرطوبة فوق الماء تتلفها. والحساس JSN-SR04T يعمل بالطريقة نفسها وبأرجل التحكم نفسها، ولكن بعنصر واحد مقاوم للماء يرسل ويستقبل، على سلك يفصله عن اللوحة، فيثبت الرأس في غطاء الخزان وتبقى اللوحة في الصندوق. ومن أوراق بياناته وتجارب المستخدمين نأخذ هذه الأرقام، مع ملاحظة أنها تختلف قليلاً بين نسخ الحساس:
- الجهد: 5 فولت، وتيار السكون بضعة ملي أمبير.
- المدى: من قرابة 25 سم إلى قرابة 4.5 متر.
- المنطقة العمياء Blind Zone: قرابة 25 سم أمام الحساس لا يقيس فيها شيئاً، لأن العنصر نفسه يرسل ويستقبل، ويحتاج وقتاً بعد الإرسال ليهدأ ويسمع الصدى. وتذكر بعض المصادر أن هذه المسافة تغيرت بين النسخة 2.0 والنسخة 3.0.
- التشغيل: نبضة على رجل TRIG مدتها 10 ميكرو ثانية على الأقل، ثم ترتفع رجل ECHO طوال زمن ذهاب الصوت ورجوعه. وكثير من المستخدمين وجدوا أن 10 ميكرو ثانية لا تكفي دائماً، فنستخدم 20.
والمنطقة العمياء أهم رقم في التركيب، فإذا ثبت الحساس على ارتفاع 10 سم فوق مستوى الامتلاء، فعندما يمتلئ الخزان يصبح الماء داخل المنطقة العمياء، ويقرأ الحساس قراءات عشوائية في أهم لحظة، لحظة إيقاف المضخة. ولهذا نضع الحساس بحيث يبقى أعلى مستوى ممكن للماء، وهو مستوى أنبوب الفائض Overflow، أبعد من المنطقة العمياء بهامش. وفي المختبر الحساس العلوي على ارتفاع 1800 ملم فوق القاع، والامتلاء عند 1500 ملم، أي 30 سم بين الحساس والماء عند الامتلاء. والشكل التالي يبين الحساب كله بقراءة واحدة:

والرقم 1.767 هو مساحة مقطع الخزان باللتر لكل ملم: الأسطوانة قطرها 1.5 متر، فنصف قطرها 0.75 متر، ومساحتها π في 0.75 في 0.75، أي 1.767 متر مربع، وكل ملم من الارتفاع في متر مربع يساوي لتراً واحداً. وفي الخزان المستطيل الحساب أسهل: الطول في العرض، فالخزان الأرضي 4 في 3 أي 12 متراً مربعاً، و12 لتراً في كل ملم. وانتبه إلى أن هذا الحساب يصح في الخزان الذي جدرانه رأسية، أما الخزان الأسطواني الملقى على جنبه، أو الخزان الذي قاعه مخروطي، فاللترات فيه لا تتغير بالارتفاع بشكل خطي، وتحتاج جدولاً يحول الارتفاع إلى لترات، تحصل عليه من الشركة المصنعة أو تبنيه بنفسك وأنت تملأ الخزان بعداد ماء.
وبقيت الحرارة. سرعة الصوت في الهواء تزيد قرابة 0.6 متر في الثانية مع كل درجة، والكود يفترض 343 متراً في الثانية، أي 20 درجة. وفي خزان على سطح في الصيف قد يصل الهواء فوق الماء إلى 45 درجة، فتصبح سرعة الصوت قرابة 358 متراً في الثانية، ويحسب الكود مسافة أقصر من الحقيقية بقرابة 4%. وعلى مسافة 900 ملم هذا قرابة 39 ملم، أي أن الخزان يبدو أعلى بنحو 2.6% مما هو عليه. وهذا الخطأ لا يضر مضخة ولا يطلق تنبيهاً كاذباً، ولكنه يظهر في التقرير اليومي كتغير صغير في اللترات بين الليل والنهار، وإذا احتجت دقة أعلى فأضف حساس حرارة في الصندوق وصحح السرعة به.
قراءة الحساس في الكود
والآن نترجم ما سبق إلى كود. المشروع مكتوب على ESP-IDF، إطار العمل الرسمي من Espressif، والكود مقسوم إلى ملفات صغيرة لكل منها عمل واحد، وأولها sensor.c: فيه قراءة الحساسين وتشغيل المرحل على اللوحة الحقيقية، وفيه في الجزء الثاني نسخة المحاكاة التي يستخدمها المختبر:
#include "sensor.h"
#include "driver/gpio.h"
#include "esp_timer.h"
#define PIN_PUMP GPIO_NUM_26 // HIGH = relay on = contactor coil on = pump runs
#ifndef SENSOR_SIM
#include "esp_rom_sys.h"
// JSN-SR04T, one per tank. TRIG: a pulse of at least 10 us starts a ping (20 us here, a margin that many users
// need). ECHO: goes HIGH for as long as the sound took to go and come back. At 5 V supply ECHO is a 5 V signal:
// it reaches the ESP32 through a divider (for example 1k and 2k) to stay under 3.3 V.
static const gpio_num_t TRIG[2] = { GPIO_NUM_18, GPIO_NUM_21 };
static const gpio_num_t ECHO[2] = { GPIO_NUM_19, GPIO_NUM_22 };
#define SOUND_MM_PER_US 0.343 // 343 m/s at 20 C; about 0.6 m/s more for every degree warmer
void io_init(void) {
for (int i = 0; i < 2; i++) {
gpio_set_direction(TRIG[i], GPIO_MODE_OUTPUT);
gpio_set_level(TRIG[i], 0);
gpio_set_direction(ECHO[i], GPIO_MODE_INPUT);
}
gpio_set_direction(PIN_PUMP, GPIO_MODE_OUTPUT);
gpio_set_level(PIN_PUMP, 0);
}
int ping_mm(int tank) {
gpio_set_level(TRIG[tank], 1);
esp_rom_delay_us(20);
gpio_set_level(TRIG[tank], 0);
int64_t t = esp_timer_get_time();
while (!gpio_get_level(ECHO[tank])) // wait for the echo line to rise
if (esp_timer_get_time() - t > 60000) return -1;
int64_t rise = esp_timer_get_time();
while (gpio_get_level(ECHO[tank])) // and measure how long it stays HIGH
if (esp_timer_get_time() - rise > 30000) return -1; // 30 ms: farther than the sensor's 4.5 m
int us = (int)(esp_timer_get_time() - rise);
return (int)(us * SOUND_MM_PER_US / 2); // there and back: half the time
}
void pump_out(bool on) { gpio_set_level(PIN_PUMP, on); }
int now_min(void) { return 6 * 60 + (int)(esp_timer_get_time() / 60000000); } // a real build takes the time from SNTP
void clock_start(void) {}
#else
#include "world.h"
static world_t W;
static int64_t t0;
static double sim_min(void) { return 6 * 60 + (esp_timer_get_time() - t0) * (double)SCALE / 60e6; }
void io_init(void) { t0 = esp_timer_get_time(); world_init(&W, 6 * 60, 12345); }
void clock_start(void) { t0 = esp_timer_get_time(); } // the building starts at day 1 06:00 when the network is up
int ping_mm(int tank) { world_advance(&W, sim_min()); return world_ping(&W, tank == ROOF_TANK ? &ROOF : &GROUND); }
void pump_out(bool on) { world_advance(&W, sim_min()); W.pump = on; }
int now_min(void) { return (int)sim_min(); }
#endifفي الكود أعلاه لاحظ التالي:
- الدالة
ping_mmترسل نبضة 20 ميكرو ثانية على TRIG، ثم تنتظر ارتفاع ECHO، ثم تقيس كم بقي مرتفعاً، وتقسم الزمن على 2 لأن الصوت ذهب ورجع. وإذا لم يأت الصدى خلال المهلة ترجع-1، ولا ترجع صفراً، والفرق بين الاثنين سنراه في قسم الكسر: الصفر رقم يبدو صحيحاً ويعني «الخزان ممتلئ»، أما-1فيقول صراحة إنه لا توجد قراءة. - رجل ECHO في الحساس تخرج 5 فولت عندما يعمل على 5 فولت، وأرجل ESP32 تعمل على 3.3 فولت ولا تتحمل 5 فولت، ولهذا يمر ECHO بمقسم جهد من مقاومتين قبل أن يصل إلى المتحكم، وقس الجهد بعد المقسم بالمقياس المتعدد قبل أن توصله، كما شرحنا في مقال لوحة التجارب والمقياس المتعدد.
- القياس بالانتظار في حلقة طريقة بسيطة ومفهومة، ولكنها تشغل المعالج حتى 30 ملي ثانية في كل نبضة، وهذا مقبول هنا لأن المتحكم لا يفعل شيئاً آخر. وفي مشروع أكبر تقيس عرض النبضة بالمقاطعات أو بوحدة RMT في ESP32 فيبقى المعالج حراً.
- في نسخة المحاكاة ترجع
ping_mmقراءة من مبنى محاكى في الملفworld.c، والوقت فيه يجري أسرع بـ 900 مرة، فكل ثانية في QEMU ربع ساعة في المبنى.
وأبعاد الخزانين في ملف مستقل، لأنها الشيء الوحيد الذي يتغير من مبنى إلى آخر:
#include "site.h"
// Sensor faces 300 mm above the full roof level and 350 mm above the full ground level: both more than the
// JSN-SR04T blind zone (about 250 mm), so a full tank is still measured.
const tank_t ROOF = { .sensor_mm = 1800, .full_mm = 1500, .litres_per_mm = 1.767 }; // cylinder 1.5 m across: pi * 0.75^2 m2
const tank_t GROUND = { .sensor_mm = 2350, .full_mm = 2000, .litres_per_mm = 12.0 }; // 4 m * 3 mمنطق المضخة: حدان لا حد واحد
قبل أن نكتب منطق المضخة نسأل: ما الطريقة الأبسط؟ أن نقول: إذا كان الخزان العلوي أقل من 90% فشغل المضخة، وإذا وصل 90% فأوقفها. وهذا يبدو صحيحاً، ولكن فكر فيما يحدث بعد الإيقاف: المبنى يستهلك، فينزل الخزان إلى 89% بعد دقيقة، فتعمل المضخة دقيقة، فيصل 90%، فتقف، وهكذا طوال اليوم. والمحرك الكهربائي يسخن أكثر ما يسخن عند بدء التشغيل، لأن تيار البدء أضعاف تيار التشغيل العادي، والكونتاكتور يتآكل مع كل تشغيل، ولهذا تحدد الشركات المصنعة للمحركات عدداً أقصى لمرات التشغيل في الساعة. والحل المعروف في كل أنظمة التحكم هو الحدان Hysteresis: تبدأ المضخة عندما ينزل الخزان تحت 30%، ولا تقف حتى يصل 90%، وبين الحدين لا تغير حالتها. فتعمل مرة طويلة كل بضع ساعات، بدل مئات المرات القصيرة.
ثم نضيف القواعد التي تحمي المضخة، وكل قاعدة منها جاءت من عطل حقيقي يعرفه من أدار مبنى:
- لا تشغيل والخزان الأرضي تحت 15%: وهي الحماية من التشغيل دون ماء. والرقم ليس صفراً، لأن فتحة سحب المضخة فوق قاع الخزان، وقبل أن يفرغ الخزان تبدأ المضخة تسحب هواء مع الماء.
- لا تشغيل أكثر من 90 دقيقة: الملء الطبيعي يأخذ قرابة 40 دقيقة، فإذا مرت 90 دقيقة فهناك شيء خطأ: أنبوب مكسور يفرغ الماء قبل أن يصل، أو حساس علوي عالق على قراءة منخفضة.
- بعد 10 دقائق يجب أن يرتفع الخزان العلوي 2% على الأقل: إذا كانت المضخة تعمل والخزان لا يرتفع فالماء لا يصل: هواء في الأنبوب، أو صمام مغلق، أو مضخة تدور ولا تدفع. وهذه القاعدة تكتشف ما لا تكتشفه حماية الخزان الأرضي، فقد يكون الخزان الأرضي ممتلئاً والمضخة تعمل دون ماء لأن صمام السحب مغلق.
- القفل Lockout: عندما تقف المضخة بسبب القاعدتين الأخيرتين لا تعود وحدها، وإنما تنتظر إنساناً يفحصها ثم يرسل أمر
reset. والسبب أن المشكلة هنا ليست مؤقتة كانخفاض الخزان الأرضي، والمضخة التي تحاول كل ساعة على مشكلة لم تحل تزيد الضرر. - دون قراءة تقف المضخة: إذا فقدنا قراءة أي خزان فلا نعرف متى نقف، والحالة الآمنة للمضخة هي الإيقاف.
وكل هذه القرارات في ملف واحد بلغة C العادية، دون أي شيء من ESP-IDF، والسبب أننا سنترجم الملف نفسه على الحاسوب في قسم الكسر لنقارن عدة طرق على اليوم نفسه:
#include "control.h"
int level_pct(const tank_t *t, int dist_mm) {
if (dist_mm < 0) return -1;
int water = t->sensor_mm - dist_mm; // the sensor looks down: shorter distance = more water
int p = water * 100 / t->full_mm;
return p < 0 ? 0 : p > 100 ? 100 : p;
}
int level_litres(const tank_t *t, int dist_mm) {
if (dist_mm < 0) return -1;
int water = t->sensor_mm - dist_mm;
if (water < 0) water = 0;
if (water > t->full_mm) water = t->full_mm;
return (int)(water * t->litres_per_mm);
}
int median5(const int ping_mm[5]) {
int v[5], n = 0;
for (int i = 0; i < 5; i++)
if (ping_mm[i] >= 0) v[n++] = ping_mm[i];
if (n < 3) return -1;
for (int i = 1; i < n; i++) // insertion sort, n <= 5
for (int j = i; j > 0 && v[j] < v[j - 1]; j--) { int x = v[j]; v[j] = v[j - 1]; v[j - 1] = x; }
return v[n / 2];
}
static int stop(pump_t *p, int reason) {
p->on = false;
p->off_reason = reason;
if (reason == OFF_MAX_RUN || reason == OFF_NO_RISE) p->locked = true;
return EV_STOPPED;
}
int ctl_step(const ctl_cfg_t *c, pump_t *p, int roof_pct, int ground_pct) {
if (p->on) {
p->run_min++;
if (roof_pct < 0 || ground_pct < 0) return stop(p, OFF_SENSOR); // blind: the safe state is off
if (ground_pct < c->ground_min_pct) return stop(p, OFF_GROUND_LOW);
if (roof_pct >= c->stop_pct) return stop(p, OFF_FULL);
if (p->run_min >= c->max_run_min) return stop(p, OFF_MAX_RUN);
if (p->run_min == c->check_rise_min && roof_pct - p->start_pct < c->min_rise_pct)
return stop(p, OFF_NO_RISE); // running, but no water arrives
return EV_NONE;
}
if (p->locked || roof_pct < 0 || ground_pct < 0) return EV_NONE;
int start_below = c->hysteresis ? c->start_pct : c->stop_pct;
if (roof_pct >= start_below) return EV_NONE;
if (ground_pct < c->ground_min_pct) return EV_BLOCKED;
p->on = true;
p->run_min = 0;
p->start_pct = roof_pct;
p->off_reason = OFF_NONE;
return EV_STARTED;
}
const char *off_reason_name(int r) {
static const char *n[] = { "none", "full", "ground_low", "max_run", "no_rise", "sensor" };
return r >= 0 && r <= OFF_SENSOR ? n[r] : "?";
}في الكود أعلاه لاحظ التالي:
- الدالة
median5تأخذ خمس قراءات وترجع الوسيط Median، أي القيمة التي في المنتصف بعد الترتيب، وتتجاهل القراءات المفقودة، وإذا بقي أقل من ثلاث قراءات صالحة ترجع-1. والوسيط يختلف عن المتوسط Average في أن قراءة شاذة واحدة لا تحركه، فلو كانت القراءات 900 و902 و899 و300 و901 فالمتوسط 780 وهو خطأ، والوسيط 900. - الدالة
ctl_stepتستدعى مرة في الدقيقة، وترجع ما حدث: بدأت المضخة، أو وقفت، أو أرادت أن تبدأ ومنعتها حماية الخزان الأرضي. وسبب الإيقاف فيoff_reason، ليكتبه البرنامج في الحدث الذي يرسله. - الخيار
hysteresisموجود لنقارن به فقط، والبرنامج على اللوحة يستخدمه دائماً.
والبرنامج الرئيسي main.c يربط كل ذلك: يتصل بالشبكة والوسيط، ثم يقرأ كل دقيقة خمس نبضات لكل خزان، ويحسب الوسيط والنسبة واللترات، ويستدعي منطق المضخة، ويرسل الأحداث فوراً والقراءات كل ربع ساعة:
// Water tanks and the transfer pump of a building, on an ESP32.
// - every minute: five pings per tank, the median, then level in % and litres
// - pump from the ground tank to the roof tank: start below 30%, stop at 90% (hysteresis)
// - never with the ground tank below 15% (dry run), never longer than 90 minutes, and stop if the roof tank has not
// risen 2% after 10 minutes of running (no water arrives: air in the pipe, a closed valve, a dead pump)
// - publishes levels every 15 minutes and every event over MQTT; "reset" on the cmd topic clears a lockout
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_event.h"
#include "esp_netif.h"
#include "esp_timer.h"
#include "nvs_flash.h"
#include "mqtt_client.h"
#include "protocol_examples_common.h"
#include "control.h"
#include "site.h"
#include "sensor.h"
static const char *TAG = "tank";
#define SITE "building-1"
#define BROKER_URI "mqtt://10.0.2.2:1883" // under QEMU: the machine running it; on a real board your broker
#define REPORT_MIN 15
static const ctl_cfg_t CFG = { .start_pct = 30, .stop_pct = 90, .hysteresis = true, .ground_min_pct = 15,
.max_run_min = 90, .check_rise_min = 10, .min_rise_pct = 2 };
static esp_mqtt_client_handle_t mq;
static volatile bool connected, reset_request;
static void publish(const char *kind, const char *json, int qos, int retain) {
char topic[64];
snprintf(topic, sizeof topic, "building/tanks/" SITE "/%s", kind);
esp_mqtt_client_publish(mq, topic, json, 0, qos, retain);
}
static void event(int t, const char *what, const char *extra) {
char j[200];
snprintf(j, sizeof j, "{\"t\":%d,\"event\":\"%s\"%s}", t, what, extra);
ESP_LOGW(TAG, "day %d %02d:%02d %s", t / 1440 + 1, t / 60 % 24, t % 60, j);
publish("event", j, 1, 0);
}
static void on_mqtt(void *arg, esp_event_base_t base, int32_t id, void *data) {
esp_mqtt_event_handle_t e = data;
if (id == MQTT_EVENT_CONNECTED) {
connected = true;
publish("status", "online", 1, 1);
esp_mqtt_client_subscribe(mq, "building/tanks/" SITE "/cmd", 1);
} else if (id == MQTT_EVENT_DATA && e->data_len == 5 && memcmp(e->data, "reset", 5) == 0) {
reset_request = true;
}
}
// Five pings, about 60 ms apart so one ping does not hear the echo of the one before, then the median.
static int read_tank(int tank) {
int v[5];
for (int i = 0; i < 5; i++) {
v[i] = ping_mm(tank);
if (SCALE == 1) vTaskDelay(pdMS_TO_TICKS(60));
}
return median5(v);
}
void app_main(void) {
io_init();
pump_out(false); // the pump is off before anything else happens
ESP_ERROR_CHECK(nvs_flash_init());
ESP_ERROR_CHECK(esp_netif_init());
ESP_ERROR_CHECK(esp_event_loop_create_default());
ESP_ERROR_CHECK(example_connect());
esp_mqtt_client_config_t cfg = {
.broker.address.uri = BROKER_URI,
.credentials.client_id = "tank-" SITE,
.session.last_will = { .topic = "building/tanks/" SITE "/status", .msg = "offline", .qos = 1, .retain = 1 },
.session.keepalive = 30,
};
mq = esp_mqtt_client_init(&cfg);
esp_mqtt_client_register_event(mq, ESP_EVENT_ANY_ID, on_mqtt, NULL);
esp_mqtt_client_start(mq);
for (int i = 0; i < 100 && !connected; i++) vTaskDelay(pdMS_TO_TICKS(100));
clock_start();
ESP_LOGI(TAG, "connected=%d, control starts at day 1 %02d:%02d", connected, now_min() / 60, now_min() % 60);
pump_t p = { 0 };
int start_roof_l = 0, start_ground_l = 0, bad_minutes = 0;
bool ground_warned = false, roof_warned = false, fault_warned = false;
for (int t = now_min() + 1;; t++) {
while (now_min() < t) vTaskDelay(1); // once a minute
int rd = read_tank(ROOF_TANK), gd = read_tank(GROUND_TANK);
int roof = level_pct(&ROOF, rd), ground = level_pct(&GROUND, gd);
int roof_l = level_litres(&ROOF, rd), ground_l = level_litres(&GROUND, gd);
char x[128];
bad_minutes = (rd < 0 || gd < 0) ? bad_minutes + 1 : 0;
if (bad_minutes == 3 && !fault_warned) { event(t, "sensor_fault", ""); fault_warned = true; }
if (bad_minutes == 0) fault_warned = false;
if (reset_request) { p.locked = false; reset_request = false; event(t, "reset", ""); }
int ev = ctl_step(&CFG, &p, roof, ground);
pump_out(p.on);
if (ev == EV_STARTED) {
start_roof_l = roof_l;
start_ground_l = ground_l;
snprintf(x, sizeof x, ",\"roof_pct\":%d,\"ground_pct\":%d", roof, ground);
event(t, "pump_on", x);
} else if (ev == EV_STOPPED) {
// into_roof: what the roof tank gained. from_ground: what the pump really moved (the building kept using
// water during the run, so from_ground is larger). Their difference is the water used while pumping.
snprintf(x, sizeof x, ",\"reason\":\"%s\",\"run_min\":%d,\"roof_pct\":%d,\"into_roof\":%d,\"from_ground\":%d",
off_reason_name(p.off_reason), p.run_min, roof, roof_l - start_roof_l, start_ground_l - ground_l);
event(t, "pump_off", x);
if (p.off_reason == OFF_GROUND_LOW && !ground_warned) {
snprintf(x, sizeof x, ",\"roof_pct\":%d,\"ground_pct\":%d", roof, ground);
event(t, "ground_low", x);
ground_warned = true;
}
} else if (ev == EV_BLOCKED && !ground_warned) {
snprintf(x, sizeof x, ",\"roof_pct\":%d,\"ground_pct\":%d", roof, ground);
event(t, "ground_low", x);
ground_warned = true;
}
if (ground >= CFG.ground_min_pct + 5) ground_warned = false;
if (roof >= 0 && roof < 10 && !roof_warned) { snprintf(x, sizeof x, ",\"roof_pct\":%d", roof); event(t, "roof_low", x); roof_warned = true; }
if (roof >= 20) roof_warned = false;
if (t % REPORT_MIN == 0) {
char j[160];
snprintf(j, sizeof j, "{\"t\":%d,\"roof_pct\":%d,\"roof_l\":%d,\"ground_pct\":%d,\"ground_l\":%d,\"pump\":%d}",
t, roof, roof_l, ground, ground_l, p.on);
publish("telemetry", j, 0, 0);
if (t % 360 == 0) ESP_LOGI(TAG, "day %d %02d:%02d %s", t / 1440 + 1, t / 60 % 24, t % 60, j);
}
}
}في البرنامج أعلاه لاحظ التالي:
- أول ما يفعله
app_mainأن يطفئ المضخة، قبل الشبكة وقبل أي شيء، لأن المتحكم قد يعيد تشغيل نفسه والمضخة تعمل، فلا نريدها أن تبقى تعمل بانتظار اتصال قد يتأخر. - النبضات الخمس بينها 60 ملي ثانية على اللوحة الحقيقية، حتى لا تسمع نبضة صدى النبضة التي قبلها وهو يرتد بين جدران الخزان.
- الحدث
pump_offيحمل سبب الإيقاف ومدة التشغيل وعدد اللترات التي دخلت الخزان العلوي، ومن هذه الأحداث سيبني الخادم التقرير اليومي. - الوصية الأخيرة Last Will على الموضوع
statusبالقيمةoffline، فإذا انقطع المتحكم أرسلها الوسيط نيابة عنه، كما شرحنا في مقال MQTT. - الوقت هنا دقائق منذ بداية اليوم الأول، لأن المحاكاة تبدأ من الساعة 6 صباحاً. وعلى اللوحة الحقيقية تأخذ الوقت من الإنترنت بالبروتوكول SNTP، لأن فحص التسرب الليلي يحتاج أن يعرف متى الليل.
الخادم: الحفظ وفحص التسرب والتنبيه
المتحكم يعرف الآن، والخادم يتذكر. والشكل التالي يبين مسار القراءة والتنبيه، وهو المسار نفسه الذي بنيناه في مشروع ري النباتات:

وخدمة الاستقبال ingest.py برنامج Python صغير بالمكتبة paho-mqtt، يشترك في كل مواضيع المبنى، ويحفظ في SQLite، ويقرر ما يستحق تنبيهاً:
"""Ingest for the water tanks project.
- subscribes to building/tanks/# and keeps every level reading and event in SQLite (/data/tanks.db)
- sends the events that need a person to the phone through ntfy (topic "tanks")
- the night check: at 05:00 it looks at 01:00..05:00. If the pump did not run and the roof tank still lost more than
80 litres (20 litres an hour, while the building uses about 10), something is leaking
- notices when the controller goes offline (its last will)"""
import json, sqlite3, time, urllib.request
import paho.mqtt.client as mqtt
DB = sqlite3.connect("/data/tanks.db")
DB.executescript("""
CREATE TABLE IF NOT EXISTS level(site TEXT, t INT, roof_pct INT, roof_l INT, ground_pct INT, ground_l INT, pump INT);
CREATE TABLE IF NOT EXISTS event(site TEXT, t INT, what TEXT, data TEXT);
""")
LEAK_L = 80 # litres lost in the 4 night hours with the pump off
NOTIFY = { # title, ntfy priority (1 min .. 5 max)
"ground_low": ("Ground tank low", 4),
"roof_low": ("Roof tank almost empty", 4),
"sensor_fault": ("Level sensor fault", 5),
"pump_stopped": ("Pump stopped and locked", 5),
"leak": ("Possible leak", 4),
"offline": ("Tank controller offline", 3),
}
def notify(site, kind, text):
title, prio = NOTIFY[kind]
req = urllib.request.Request("http://ntfy/tanks", data=f"{site}: {text}".encode(),
headers={"Title": title, "Priority": str(prio), "Tags": "droplet"})
urllib.request.urlopen(req, timeout=5).read()
print(f"notify {kind}: {text}", flush=True)
def clock(t):
return f"day {t // 1440 + 1} {t // 60 % 24:02d}:{t % 60:02d}"
def night_check(site, t):
rows = DB.execute("SELECT roof_l, pump FROM level WHERE site=? AND t BETWEEN ? AND ? ORDER BY t",
(site, t - 240, t)).fetchall()
if len(rows) < 15:
return
drop = rows[0][0] - rows[-1][0]
pumped = any(p for _, p in rows)
print(f"night check {clock(t)}: roof lost {drop} L in 4 h ({drop / 4:.0f} L/h), pump ran: {pumped}", flush=True)
if not pumped and drop > LEAK_L:
notify(site, "leak", f"roof tank lost {drop} L between 01:00 and 05:00 with the pump off ({drop / 4:.0f} L/h)")
def on_message(c, u, m):
_, _, site, kind = m.topic.split("/") # building/tanks/<site>/<kind>
if kind == "status":
print(f"status {site} = {m.payload.decode()}", flush=True)
if m.payload == b"offline":
notify(site, "offline", "no connection from the tank controller")
return
if kind == "cmd":
return
r = json.loads(m.payload)
if kind == "telemetry":
DB.execute("INSERT INTO level VALUES(?,?,?,?,?,?,?)",
(site, r["t"], r["roof_pct"], r["roof_l"], r["ground_pct"], r["ground_l"], r["pump"]))
DB.commit()
if r["t"] % 1440 == 5 * 60:
night_check(site, r["t"])
elif kind == "event":
DB.execute("INSERT INTO event VALUES(?,?,?,?)", (site, r["t"], r["event"], m.payload.decode()))
DB.commit()
print(f"event {clock(r['t'])} {r['event']} {m.payload.decode()}", flush=True)
what = r["event"]
if what in ("ground_low", "roof_low", "sensor_fault"):
notify(site, what, f"{what} at {clock(r['t'])}: {m.payload.decode()}")
elif what == "pump_off" and r["reason"] in ("max_run", "no_rise", "sensor"):
notify(site, "pump_stopped", f"reason {r['reason']} after {r['run_min']} min, send someone to check")
c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="tank-ingest")
c.on_connect = lambda c, u, f, rc, p: c.subscribe("building/tanks/#", qos=1)
c.on_message = on_message
while True:
try:
c.connect("broker", 1883)
break
except OSError:
time.sleep(1)
c.loop_forever()في البرنامج أعلاه لاحظ التالي:
- ليس كل حدث تنبيهاً. تشغيل المضخة وإيقافها الطبيعي عند الامتلاء يحفظان فقط، والتنبيه لما يحتاج إنساناً: خزان أرضي منخفض يحتاج صهريجاً، وخزان علوي يكاد يفرغ، وحساس معطل، ومضخة مقفلة تحتاج فحصاً، وتسرب، وجهاز انقطع. وقد فصلنا هذه القاعدة في مقال التنبيهات: التنبيه الذي لا يتطلب فعلاً يعلم الناس تجاهل التنبيهات.
- أولوية التنبيه في ntfy من 1 إلى 5، والحساس المعطل والمضخة المقفلة 5 لأنهما يعنيان أن المبنى سيبقى دون ماء إذا لم يتحرك أحد، والانقطاع 3 لأن المتحكم قد يعود وحده.
- فحص التسرب يجري في الخادم وليس في المتحكم، لأنه يحتاج أن ينظر إلى أربع ساعات من القراءات معاً، والخادم هو الذي يحفظها.
وفكرة فحص التسرب تستحق شرحاً، لأنها أذكى جزء في المشروع وأبسطه في الوقت نفسه. في النهار لا تستطيع أن تفرق بين الماء المستخدم والماء المتسرب، فكلاهما ينقص الخزان. ولكن بين الساعة الواحدة والخامسة فجراً المبنى التجاري مغلق، والاستهلاك قرابة 10 لترات في الساعة من أشياء صغيرة، فإذا كانت المضخة متوقفة طوال هذه الساعات الأربع، ونقص الخزان العلوي أكثر من 80 لتراً، أي أكثر من 20 لتراً في الساعة، فهناك ماء يخرج ولا يستخدمه أحد. وهذه هي الفكرة نفسها التي تستخدمها شركات المياه لكشف التسرب في الشبكات، بمراقبة أقل تدفق في الليل Minimum Night Flow. وحدودها واضحة: إذا عملت المضخة في الليل فالفحص لا يحكم، لأن الماء الداخل يخفي الخارج، وإذا كان المبنى يعمل في الليل، كمستشفى أو مخبز، فتحتاج نافذة أخرى أو حداً أعلى.
وتقرير اليوم في report.py: كم مرة عملت المضخة، وكم دقيقة، وكم لتراً رفعت، وكم استهلك المبنى. والاستهلاك يحسب من أن كل ما دخل الخزان العلوي ولم يبق فيه خرج منه، إما استخداماً وإما تسرباً:
"""The daily report the building manager reads, and the notifications that reached the phone topic.
Water used in a day = what the pump took from the ground tank - what the roof tank gained over the day
(the roof tank feeds the building, so whatever went in and did not stay was used, or leaked)."""
import json, sqlite3, urllib.request
db = sqlite3.connect("/data/tanks.db")
print("day from to pump starts run min pumped L roof start L roof end L used L ground min %")
for (day,) in db.execute("SELECT DISTINCT t / 1440 FROM level ORDER BY 1"):
lo, hi = day * 1440, day * 1440 + 1439
first = db.execute("SELECT t, roof_l FROM level WHERE t BETWEEN ? AND ? ORDER BY t LIMIT 1", (lo, hi)).fetchone()
last = db.execute("SELECT t, roof_l FROM level WHERE t BETWEEN ? AND ? ORDER BY t DESC LIMIT 1", (lo, hi)).fetchone()
gmin = db.execute("SELECT MIN(ground_pct) FROM level WHERE t BETWEEN ? AND ?", (lo, hi)).fetchone()[0]
offs = [json.loads(d) for (d,) in db.execute(
"SELECT data FROM event WHERE what='pump_off' AND t BETWEEN ? AND ?", (lo, hi))]
starts = db.execute("SELECT COUNT(*) FROM event WHERE what='pump_on' AND t BETWEEN ? AND ?", (lo, hi)).fetchone()[0]
pumped = sum(o["from_ground"] for o in offs)
used = pumped - (last[1] - first[1])
hm = lambda t: f"{t // 60 % 24:02d}:{t % 60:02d}"
print(f"{day + 1:3d} {hm(first[0])} {hm(last[0])} {starts:11d} {sum(o['run_min'] for o in offs):7d}"
f" {pumped:8d} {first[1]:12d} {last[1]:10d} {used:6d} {gmin:12d}")
print("### notifications on ntfy topic 'tanks'")
with urllib.request.urlopen("http://ntfy/tanks/json?poll=1&since=all", timeout=5) as r:
for line in r:
n = json.loads(line)
print(f"[priority {n.get('priority', 3)}] {n.get('title')}: {n['message']}")والمختبر كله في ملف Docker Compose واحد: الوسيط، وخادم التنبيهات ntfy، وخدمة الاستقبال، والبرنامج نفسه في QEMU على صورة ESP-IDF الرسمية، والأخير يشارك الوسيط شبكته، فيصل إليه من داخل QEMU على العنوان 10.0.2.2:1883:
# Water tanks lab: the ESP32 firmware in QEMU, the broker, ntfy for phone notifications, and the ingest service.
name: tanks
services:
broker:
image: eclipse-mosquitto:2.1.2-alpine
volumes: [ "./mosquitto.conf:/mosquitto/config/mosquitto.conf:ro" ]
ntfy:
image: binwiederhier/ntfy:v2.11.0
command: serve
environment: { NTFY_BASE_URL: "http://ntfy" }
ingest:
build: { context: ., dockerfile: Dockerfile.ingest }
image: tank-ingest:1
command: python -u ingest.py
volumes: [ "./data:/data" ]
depends_on: [ broker, ntfy ]
firmware:
image: espressif/idf:v5.4.1
# shares the broker's network: inside QEMU, 10.0.2.2:1883 is this namespace's port 1883, the broker
network_mode: "service:broker"
working_dir: /lab
volumes: [ "./:/lab" ]
command: bash ./fw.sh
profiles: [ firmware ]والملف fw.sh يعمل داخل صورة ESP-IDF، فيترجم أولاً برنامج المقارنة على الحاسوب، ثم يبني البرنامج مرتين: مرة للوحة الحقيقية بمشغل الحساس والمرحل وWi-Fi، ليثبت أن الكود الحقيقي يترجم، ومرة للمحاكاة، ثم يشغل الثانية في QEMU:
#!/bin/bash
# Inside espressif/idf:
# 0) host/replay.c: control.c and world.c compiled with the laptop's gcc, four strategies on the same two days
# 1) build-hw : the real board (JSN-SR04T driver, pump output, Wi-Fi), compiled only, to prove it builds
# 2) build-sim: SENSOR_SIM=1 (simulated building, time x900) run in QEMU over the emulated Ethernet for $RUN_S s
set -e
. "$IDF_PATH/export.sh" > /dev/null
python "$IDF_PATH/tools/idf_tools.py" install qemu-xtensa > /dev/null
. "$IDF_PATH/export.sh" > /dev/null
echo "### replay"
gcc -O2 -Wall -Ifirmware/main host/replay.c firmware/main/control.c firmware/main/site.c firmware/main/world.c -o /tmp/replay
/tmp/replay
cd firmware
idf.py -B build-hw set-target esp32 > /dev/null
idf.py -B build-hw build 2>&1 | grep -E "binary size|error"
idf.py -B build-sim -DSENSOR_SIM=1 -DSDKCONFIG=build-sim/sdkconfig \
-DSDKCONFIG_DEFAULTS="sdkconfig.defaults;sdkconfig.qemu" set-target esp32 > /dev/null
idf.py -B build-sim -DSENSOR_SIM=1 -DSDKCONFIG=build-sim/sdkconfig \
-DSDKCONFIG_DEFAULTS="sdkconfig.defaults;sdkconfig.qemu" build 2>&1 | grep -E "binary size|error"
(cd build-sim && esptool.py --chip esp32 merge_bin --fill-flash-size 4MB -o flash.bin @flash_args > /dev/null)
echo "### qemu"
touch ../data/qemu-started
timeout "${RUN_S:-215}" qemu-system-xtensa -nographic -machine esp32 \
-drive file=build-sim/flash.bin,if=mtd,format=raw -nic user,model=open_eth 2>&1 \
| grep --line-buffered -E "^[IWE] \([0-9]+\) (tank|example_connect):|Guru" || trueوالملف run.sh يشغل كل شيء بالترتيب ويكتب المخرجات:
#!/bin/bash
# Run the whole project on one machine. From this folder: bash run.sh
# About 215 s of QEMU = two days of the building (06:00 day 1 to about 06:00 day 3), after the builds.
set -e
rm -rf data && mkdir -p data
docker compose up -d --build --quiet-pull broker ntfy ingest 2>/dev/null
docker compose run --rm firmware 2>&1 | grep -E "binary size|error:|^### |^[IWE] \(|^two days|^[1-4]\) " | tee out-01-firmware.txt
sleep 3 # the broker sends the last will once the connection is gone
docker compose logs --no-log-prefix ingest | tee out-02-ingest.txt
docker compose run --rm --no-deps ingest python report.py | tee out-03-report.txt
docker compose down 2>/dev/nullونشغل المختبر من مجلد lab بالأمر التالي، والبناء الأول يأخذ عدة دقائق:
bash run.shيومان من عمر المبنى
بعد البناء يبدأ البرنامج في QEMU، ويتصل بالوسيط، ثم تبدأ ساعة المبنى من الساعة 6 صباحاً في اليوم الأول، والخزان العلوي فيه 1500 لتر، والخزان الأرضي 7500 لتر فقط، أي 31%، وهذا مقصود لنرى حماية الخزان الأرضي تعمل. والبرنامج يكتب كل حدث، وقراءة كل ست ساعات، والمخرج سوف يكون كما يلي:
I (8991) tank: connected=1, control starts at day 1 06:00
W (16731) tank: day 1 07:56 {"t":476,"event":"pump_on","roof_pct":29,"ground_pct":31}
W (20261) tank: day 1 08:49 {"t":529,"event":"pump_off","reason":"full","run_min":53,"roof_pct":90,"into_roof":1602,"from_ground":2148}
I (33001) tank: day 1 12:00 {"t":720,"roof_pct":46,"roof_l":1228,"ground_pct":22,"ground_l":5400,"pump":0}
W (36531) tank: day 1 12:53 {"t":773,"event":"pump_on","roof_pct":29,"ground_pct":22}
W (39461) tank: day 1 13:37 {"t":817,"event":"pump_off","reason":"ground_low","run_min":44,"roof_pct":82,"into_roof":1388,"from_ground":1800}
W (39461) tank: day 1 13:37 {"t":817,"event":"ground_low","roof_pct":82,"ground_pct":14}
W (55731) tank: day 1 17:41 {"t":1061,"event":"pump_on","roof_pct":29,"ground_pct":81}
I (57001) tank: day 1 18:00 {"t":1080,"roof_pct":53,"roof_l":1408,"ground_pct":78,"ground_l":18912,"pump":1}
W (59001) tank: day 1 18:30 {"t":1110,"event":"pump_off","reason":"full","run_min":49,"roof_pct":90,"into_roof":1594,"from_ground":1944}
I (80991) tank: day 2 00:00 {"t":1440,"roof_pct":50,"roof_l":1334,"ground_pct":73,"ground_l":17640,"pump":0}
I (104991) tank: day 2 06:00 {"t":1800,"roof_pct":48,"roof_l":1282,"ground_pct":73,"ground_l":17664,"pump":0}
W (111261) tank: day 2 07:34 {"t":1894,"event":"pump_on","roof_pct":29,"ground_pct":73}
W (114861) tank: day 2 08:28 {"t":1948,"event":"pump_off","reason":"full","run_min":54,"roof_pct":91,"into_roof":1622,"from_ground":2100}
I (129001) tank: day 2 12:00 {"t":2160,"roof_pct":39,"roof_l":1047,"ground_pct":64,"ground_l":15516,"pump":0}
W (130931) tank: day 2 12:29 {"t":2189,"event":"pump_on","roof_pct":29,"ground_pct":64}
W (134401) tank: day 2 13:21 {"t":2241,"event":"pump_off","reason":"full","run_min":52,"roof_pct":90,"into_roof":1622,"from_ground":2124}
W (151261) tank: day 2 17:34 {"t":2494,"event":"pump_on","roof_pct":29,"ground_pct":55}
I (153001) tank: day 2 18:00 {"t":2520,"roof_pct":61,"roof_l":1625,"ground_pct":51,"ground_l":12420,"pump":1}
W (154601) tank: day 2 18:24 {"t":2544,"event":"pump_off","reason":"full","run_min":50,"roof_pct":90,"into_roof":1612,"from_ground":2016}
I (177001) tank: day 3 00:00 {"t":2880,"roof_pct":43,"roof_l":1141,"ground_pct":47,"ground_l":11424,"pump":0}
I (201001) tank: day 3 06:00 {"t":3240,"roof_pct":34,"roof_l":908,"ground_pct":47,"ground_l":11460,"pump":0}
W (203401) tank: day 3 06:36 {"t":3276,"event":"pump_on","roof_pct":29,"ground_pct":47}
W (206601) tank: day 3 07:24 {"t":3324,"event":"pump_off","reason":"full","run_min":48,"roof_pct":90,"into_roof":1598,"from_ground":1908}ولنقرأ اليومين كما يقرؤهما مسؤول المبنى:
- الساعة 7:56 من اليوم الأول: نزل الخزان العلوي إلى 29% مع ذروة الصباح، فبدأت المضخة، ووقفت بعد 53 دقيقة عند 90%. ولاحظ الرقمين في الحدث: الخزان العلوي ربح 1602 لتر، والخزان الأرضي خسر 2148 لتراً، والفرق 546 لتراً استهلكها المبنى من الخزان العلوي والمضخة تملؤه، أي قرابة 10 لترات في الدقيقة، وهو استهلاك ساعة الذروة في الصباح.
- الساعة 12:53: الخزان العلوي تحت 30% مرة أخرى، والخزان الأرضي 22%، فبدأت المضخة. وبعد 44 دقيقة وصل الخزان الأرضي إلى 14%، تحت حد الحماية، فأوقفت المضخة نفسها والخزان العلوي عند 82%، وأرسلت حدث
ground_low. وهذه هي اللحظة التي احترقت فيها المضخة في القصة التي بدأنا بها. - الساعة 17:00: وصل الصهريج، والخزان الأرضي صار 81%، وعند 17:41 بدأت المضخة كالعادة. ولم يحتج أحد أن يتذكر أن يعيد تشغيلها، لأن حماية الخزان الأرضي تمنع التشغيل ما دام الخزان منخفضاً، ولا تقفل المضخة.
- اليوم الثاني: ثلاث دورات، في الصباح والظهر والمساء، كل منها بين 50 و54 دقيقة، والخزان الأرضي ينزل من 73% إلى 47% دون أن يصل إلى الحد. ومن الساعة 12 بدأ التسرب في المحاكاة، 30 لتراً في الساعة، ولم يلاحظه شيء في البرنامج، لأن المتحكم لا يعرف ما الطبيعي وما ليس طبيعياً.
- بعد العاشرة صباح اليوم الثالث: أوقف
timeoutالمحاكي QEMU بعد 215 ثانية، أي انقطع المتحكم فجأة كما ينقطع عند انقطاع الكهرباء.
وفي الطرف الآخر، هذا ما رأته خدمة الاستقبال من ظهر اليوم الأول إلى نهاية المختبر:
event day 1 12:53 pump_on {"t":773,"event":"pump_on","roof_pct":29,"ground_pct":22}
event day 1 13:37 pump_off {"t":817,"event":"pump_off","reason":"ground_low","run_min":44,"roof_pct":82,"into_roof":1388,"from_ground":1800}
event day 1 13:37 ground_low {"t":817,"event":"ground_low","roof_pct":82,"ground_pct":14}
notify ground_low: ground_low at day 1 13:37: {"t":817,"event":"ground_low","roof_pct":82,"ground_pct":14}
event day 1 17:41 pump_on {"t":1061,"event":"pump_on","roof_pct":29,"ground_pct":81}
event day 1 18:30 pump_off {"t":1110,"event":"pump_off","reason":"full","run_min":49,"roof_pct":90,"into_roof":1594,"from_ground":1944}
night check day 2 05:00: roof lost 46 L in 4 h (12 L/h), pump ran: False
event day 2 07:34 pump_on {"t":1894,"event":"pump_on","roof_pct":29,"ground_pct":73}
event day 2 08:28 pump_off {"t":1948,"event":"pump_off","reason":"full","run_min":54,"roof_pct":91,"into_roof":1622,"from_ground":2100}
event day 2 12:29 pump_on {"t":2189,"event":"pump_on","roof_pct":29,"ground_pct":64}
event day 2 13:21 pump_off {"t":2241,"event":"pump_off","reason":"full","run_min":52,"roof_pct":90,"into_roof":1622,"from_ground":2124}
event day 2 17:34 pump_on {"t":2494,"event":"pump_on","roof_pct":29,"ground_pct":55}
event day 2 18:24 pump_off {"t":2544,"event":"pump_off","reason":"full","run_min":50,"roof_pct":90,"into_roof":1612,"from_ground":2016}
night check day 3 05:00: roof lost 163 L in 4 h (41 L/h), pump ran: False
notify leak: roof tank lost 163 L between 01:00 and 05:00 with the pump off (41 L/h)
event day 3 06:36 pump_on {"t":3276,"event":"pump_on","roof_pct":29,"ground_pct":47}
event day 3 07:24 pump_off {"t":3324,"event":"pump_off","reason":"full","run_min":48,"roof_pct":90,"into_roof":1598,"from_ground":1908}
status building-1 = offline
notify offline: no connection from the tank controllerوفي هذا المخرج ثلاثة أشياء أرسلت إلى الجوال: الخزان الأرضي المنخفض في اليوم الأول عند 13:37، ثم فحص الليلة الأولى الذي وجد 46 لتراً في أربع ساعات، أي 12 لتراً في الساعة، وهو استهلاك الليل الطبيعي فلم ينبه، ثم فحص الليلة الثانية الذي وجد 163 لتراً، أي 41 لتراً في الساعة والمضخة متوقفة، فأرسل تنبيه التسرب. والرقم قريب مما وضعناه في المحاكاة: 30 لتراً تسرب و10 لترات استهلاك ليلي تقريباً. وفي النهاية رسالة offline، ولم يرسلها المتحكم، وإنما أرسلها الوسيط نيابة عنه عندما انقطع الاتصال، لأنها وصيته الأخيرة.
ثم التقرير اليومي، ومعه التنبيهات التي وصلت إلى موضوع الجوال في ntfy:
day from to pump starts run min pumped L roof start L roof end L used L ground min %
1 06:15 23:45 3 146 5892 1463 1348 6007 14
2 00:00 23:45 3 156 6240 1334 1160 6414 47
3 00:00 10:15 1 48 1908 1141 929 2120 39
### notifications on ntfy topic 'tanks'
[priority 4] Ground tank low: building-1: ground_low at day 1 13:37: {"t":817,"event":"ground_low","roof_pct":82,"ground_pct":14}
[priority 4] Possible leak: building-1: roof tank lost 163 L between 01:00 and 05:00 with the pump off (41 L/h)
[priority 3] Tank controller offline: building-1: no connection from the tank controllerواليوم الثاني هو اليوم الوحيد الكامل في المختبر، وفيه رفعت المضخة 6240 لتراً في 3 دورات و156 دقيقة، والخزان العلوي انتهى أقل مما بدأ بـ 174 لتراً، فالمبنى استهلك 6414 لتراً. والمحاكاة فيها قرابة 6070 لتراً في اليوم، ومن الظهر 12 ساعة من التسرب بـ 30 لتراً، أي 360 لتراً، والمجموع قرابة 6430 لتراً، وهذا قريب جداً مما حسبه التقرير من القراءات وحدها. واليوم الأول يبدأ من السادسة صباحاً، واليوم الثالث ينتهي قبل الظهر، فلا تقارن أرقامهما باليوم الثاني. وعمود أقل مستوى للخزان الأرضي يقول للمسؤول متى كان المبنى قريباً من الخطر: 14% في اليوم الأول، فإذا تكرر هذا الرقم فهو يحتاج صهريجاً أبكر، أو خزاناً أرضياً أكبر.
ولاحظ أن التقرير يحسب الماء المرفوع من نقص الخزان الأرضي، لا من زيادة الخزان العلوي، والفرق بينهما رأيناه في الحدث الأول: المبنى يستهلك والمضخة تعمل، فزيادة الخزان العلوي أقل من الماء الذي مر في المضخة. ولو حسبنا من الخزان العلوي لنقص الاستهلاك اليومي أكثر من ألف لتر، وقد وقعنا في هذا الخطأ في أول نسخة من المختبر.
اكسرها: أصداء خاطئة ومضخة لا تهدأ
الحساس في المختبر لا يكذب كثيراً، ولكنه يكذب: من كل ألف نبضة 20 لا يرجع صداها، و15 ترتد عن قطرة ماء على وجه الحساس فتقرأ مسافة بين 28 و42 سم، و15 ترتد عن جدار الخزان فتقرأ مسافة أطول من الحقيقة بين 30 و90 سم. وهذه نسب افتراضية، ولكن الأنواع الثلاثة حقيقية، ويعرفها كل من ركب حساساً فوق ماء: التكثف على الحساس في الصباح، والموج عند دخول الماء، والجدار القريب. والسؤال: ماذا يحدث لو قرأنا نبضة واحدة كل دقيقة ووثقنا بها، كما تفعل أغلب الأمثلة على الإنترنت؟
ولكي تكون المقارنة عادلة، يترجم fw.sh قبل كل شيء البرنامج host/replay.c على الحاسوب، وهو يستخدم control.c وworld.c نفسيهما، فيعيش المبنى نفسه يومين أربع مرات: الاستهلاك نفسه دقيقة بدقيقة، والأصداء الخاطئة نفسها، والفرق فقط في طريقة القراءة والقرار:
// Break it on the laptop: the same control.c and the same simulated building (world.c) as the firmware, for two
// days, four times. Each run sees the same water use and the same bad echoes; only the reading and the rule change:
// 1) one ping a minute, one threshold (start below 90%, stop at 90%)
// 2) one ping a minute, hysteresis (start below 30%, stop at 90%)
// 3) median of 5 pings, one threshold
// 4) median of 5 pings, hysteresis <- what the firmware does
// A missing echo in the one-ping runs is read the way a quick sketch reads it: as distance 0 (pulseIn() style).
// build: gcc -O2 -I../firmware/main replay.c ../firmware/main/control.c ../firmware/main/site.c ../firmware/main/world.c -o replay
#include <stdio.h>
#include "control.h"
#include "world.h"
static void run(const char *name, bool use_median, bool hysteresis) {
ctl_cfg_t c = { .start_pct = 30, .stop_pct = 90, .hysteresis = hysteresis, .ground_min_pct = 15,
.max_run_min = 90, .check_rise_min = 10, .min_rise_pct = 2 };
pump_t p = { 0 };
world_t w;
world_init(&w, 6 * 60, 12345);
int starts = 0, short_runs = 0, early_stops = 0, run_minutes = 0, shortest = 1 << 30, locked = 0;
for (int m = 6 * 60; m < 2 * 1440 + 6 * 60; m++) {
world_advance(&w, m);
int r[5], g[5];
for (int i = 0; i < 5; i++) { r[i] = world_ping(&w, &ROOF); g[i] = world_ping(&w, &GROUND); }
int rd = use_median ? median5(r) : (r[0] < 0 ? 0 : r[0]);
int gd = use_median ? median5(g) : (g[0] < 0 ? 0 : g[0]);
int ev = ctl_step(&c, &p, level_pct(&ROOF, rd), level_pct(&GROUND, gd));
if (ev == EV_STARTED) starts++;
if (ev == EV_STOPPED) {
if (p.run_min < shortest) shortest = p.run_min;
if (p.run_min < 5) short_runs++;
if (p.off_reason == OFF_FULL && world_true_pct(&w, &ROOF) < c.stop_pct - 5) early_stops++;
if (p.locked) locked++;
}
if (p.on) run_minutes++;
w.pump = p.on;
}
printf("%-34s starts %4d runs under 5 min %4d stopped 'full' too early %3d pump minutes %4d shortest run %2d min%s\n",
name, starts, short_runs, early_stops, run_minutes, shortest, locked ? " LOCKED" : "");
}
int main(void) {
printf("two days, same water use, same echoes (seed 12345)\n");
run("1) one ping, one threshold", false, false);
run("2) one ping, hysteresis 30/90", false, true);
run("3) median of 5, one threshold", true, false);
run("4) median of 5, hysteresis 30/90", true, true);
return 0;
}ولاحظ في الطريقتين الأولى والثانية أن الصدى المفقود يقرأ صفراً، كما تفعل الدالة pulseIn في Arduino عندما تنتهي مهلتها، وهذا ما يفعله أغلب الكود المنسوخ. والمخرج سوف يكون كما يلي:
two days, same water use, same echoes (seed 12345)
1) one ping, one threshold starts 287 runs under 5 min 284 stopped 'full' too early 1 pump minutes 344 shortest run 1 min
2) one ping, hysteresis 30/90 starts 21 runs under 5 min 3 stopped 'full' too early 7 pump minutes 334 shortest run 1 min
3) median of 5, one threshold starts 281 runs under 5 min 279 stopped 'full' too early 0 pump minutes 340 shortest run 1 min
4) median of 5, hysteresis 30/90 starts 6 runs under 5 min 0 stopped 'full' too early 0 pump minutes 303 shortest run 45 minوالشكل التالي يضع عدد مرات تشغيل المضخة في الطرق الأربع جنباً إلى جنب:

- نبضة واحدة وحد واحد: 287 تشغيلاً في يومين، منها 284 أقل من 5 دقائق. والمضخة هنا لا تهدأ: كل دقيقة ينزل الخزان تحت 90% تعمل، وكل دقيقة يصل تقف، وهذا وحده يكفي ليحرق كونتاكتوراً أو محركاً في أشهر.
- الوسيط من خمس وحد واحد: 281 تشغيلاً، أي أن المرشح وحده لم يغير شيئاً تقريباً. والسبب أن المشكلة هنا ليست في الحساس، وإنما في القاعدة نفسها: الحد الواحد يتقلب حوله الخزان الحقيقي، لا القراءة الخاطئة.
- نبضة واحدة وحدان: 21 تشغيلاً، وهو تحسن كبير، ولكن انظر إلى ما بقي: 7 مرات وقفت فيها المضخة على «ممتلئ» والخزان الحقيقي أقل من 85%، لأن قطرة على الحساس أو صدى مفقوداً قرئ صفراً فبدا الخزان ممتلئاً، ثم بقي الخزان نصف ممتلئ حتى نزل تحت 30% مرة أخرى. وكل إيقاف مبكر يعني تشغيلاً إضافياً بعده، فالمضخة تبدأ 21 مرة لتنقل تقريباً ما تنقله الطريقة الرابعة في 6.
- الوسيط وحدان: 6 تشغيلات في يومين، أي ثلاث في اليوم كما يجب، وأقصر تشغيل 45 دقيقة، ولا إيقاف مبكر واحد. وهذه الطريقة هي التي في البرنامج، وهي التي رأيناها في QEMU.
والدرس هنا أن المشكلتين مختلفتان وتحتاجان حلين مختلفين: الحدان يعالجان تقلب الماء الحقيقي حول حد واحد، والوسيط يعالج القراءات الكاذبة، ولا يغني أحدهما عن الآخر. وفي الحالتين لم نغير الحساس، ولم نشتر حساساً أغلى، وإنما غيرنا سطرين من الكود.
وقد يتساءل البعض: لماذا لا نستخدم المتوسط من خمس قراءات بدل الوسيط؟ والإجابة أن المتوسط يأخذ القراءة الكاذبة معه، فقطرة واحدة تقرأ 30 سم بين أربع قراءات 90 سم تجعل المتوسط 78 سم، أي أن الخزان ارتفع فجأة 12 سم، أما الوسيط فيبقى 90 سم. ولهذا الوسيط هو الأداة المعتادة لهذا النوع من الأخطاء: قيم قليلة شاذة جداً بين قيم صحيحة كثيرة.
من المختبر إلى المبنى
المختبر يثبت أن المنطق صحيح، والتركيب في المبنى له مشاكله الخاصة، وأهمها ما يلي:
- موضع الحساس: في منتصف غطاء الخزان قدر الإمكان، بعيداً عن الجدران وعن أنبوب الدخول، لأن الماء الداخل يصنع أمواجاً ورذاذاً، والجدار القريب يعطي أصداء متأخرة. وبعيداً عن السلم الداخلي إن وجد، لأن درجاته ترد الصوت قبل الماء.
- المسافة من أعلى مستوى: قس مستوى أنبوب الفائض، فهو أعلى ما يصل إليه الماء، وضع الحساس فوقه بأكثر من المنطقة العمياء بهامش، 30 سم مثلاً.
- المعايرة مرة واحدة: بعد التركيب قس بشريط القياس المسافة من الحساس إلى الماء، وقارنها بما يقرؤه البرنامج، ثم قس الخزان وهو ممتلئ وهو منخفض، فإذا كان الفرق ثابتاً فهو خطأ في ارتفاع الحساس في
site.c، وإذا كان يكبر مع المسافة فهو سرعة الصوت أو مساحة الخزان. - الصندوق والأسلاك: الصندوق في الظل إن أمكن، وأسلاك الحساسين تدخله من الأسفل بجلبات محكمة، حتى لا يجري المطر على السلك إلى داخله. وسلك الخزان الأرضي قد يكون طويلاً، فإذا زاد على طول سلك الحساس نفسه فضع لوحة الحساس قرب الخزان وأطل أسلاك الإشارة والتغذية، لا سلك العنصر نفسه.
- Wi-Fi على السطح: الإشارة على السطح أو في غرفة المضخة تحت الأرض قد تكون ضعيفة، فاختبرها بالجوال قبل التركيب، والمتحكم يعمل دون شبكة على كل حال: منطق المضخة كله على اللوحة، والشبكة للتقارير والتنبيهات فقط.
- التحديث والأمان: متحكم يشغل مضخة في مبنى جهاز يستحق ما شرحناه في مقال أمن إنترنت الأشياء: وسيط بكلمة مرور وTLS وصلاحيات لكل جهاز، فلا يستطيع أي جهاز على الشبكة أن يرسل
reset، وتحديث عن بعد كما في مقال OTA.
والصورة التالية للحظة التي تجعل هذا المشروع يستحق تكلفته: الصهريج. فعندما يصلك تنبيه الخزان الأرضي قبل يوم من فراغه، تطلب الصهريج في وقت عادي، بدل أن تطلبه مستعجلاً والمستأجرون دون ماء:

الأخطاء الشائعة
- الحساس داخل المنطقة العمياء عند الامتلاء: يقرأ جيداً والخزان نصف ممتلئ، ويقرأ عشوائياً عند الامتلاء، أي في اللحظة التي يجب أن تقف فيها المضخة.
- اعتبار الصدى المفقود صفراً: الصفر مسافة تعني خزاناً ممتلئاً، فتقف المضخة والخزان نصف فارغ. الصدى المفقود يجب أن يبقى «لا قراءة».
- حد واحد للتشغيل والإيقاف: المضخة تعمل وتقف مئات المرات في اليوم، وقد رأينا الرقم في المختبر.
- الوثوق بقراءة واحدة: قطرة على رأس الحساس أو صدى من الجدار تكفي لتشغيل المضخة أو إيقافها، والحل الوسيط من عدة قراءات.
- توصيل ECHO مباشرة بالمتحكم: 5 فولت على رجل لا تتحمل إلا 3.3 فولت، والمقسم مقاومتان.
- توصيل المرحل بالمحرك مباشرة: مرحل وحدات التطوير مصمم لتيار صغير، وتيار بدء المحرك أضعاف تياره العادي، وجهة الكهرباء كلها للكهربائي عبر كونتاكتور وحماية.
- تنبيه على كل حدث: رسالة عند كل تشغيل للمضخة، فيتعلم المسؤول أن يتجاهل الرسائل، ثم يتجاهل رسالة الخزان الأرضي.
- الوقت دون مزامنة: فحص الليل يحتاج ساعة صحيحة، ولوحة دون SNTP تبدأ عدها من لحظة التشغيل، فتظن الظهر ليلاً.
تطبيق عملي
- في
host/replay.cأضف تشكيلة خامسة: الوسيط من ثلاث نبضات بدل خمس، مع الحدين، وقارن عدد مرات التشغيل والإيقاف المبكر بالتشكيلة الرابعة. - في
world.cغير أبعاد الخزان العلوي إلى خزانين متصلين كل منهما 2000 لتر، وعدلsite.cبالمساحة الجديدة، وشغل المختبر وتأكد أن التقرير يعطي الاستهلاك نفسه تقريباً. - أضف إلى
ingest.pyقاعدة جديدة: إذا تجاوز استهلاك اليوم ضعف متوسط آخر سبعة أيام أرسل تنبيهاً بأولوية 3. - أضف إلى البرنامج حدثاً عند وصول الماء إلى الخزان الأرضي، أي ارتفاعه أكثر من 5% في ربع ساعة والمضخة متوقفة، ليعرف المسؤول أن الصهريج وصل وفرغ.
- اكسر الحماية: غير صمام السحب في
world.cليصبح مغلقاً من اليوم الثاني الساعة 10، بحيث تعمل المضخة ولا يصل الماء، وتوقع قبل التشغيل أي قاعدة ستوقفها، وبعد كم دقيقة، وما التنبيه الذي سيصل.
حذف المختبر Cleanup
docker compose down -v
docker image rm tank-ingest:1
rm -rf data firmware/build-hw firmware/build-sim firmware/sdkconfigالأوامر تحذف الحاويات وصورة خدمة الاستقبال وملفات البناء، وتبقى صورة ESP-IDF وصور Mosquitto وntfy لأنها مشتركة مع مشاريع السلسلة الأخرى، فاحذفها إذا انتهيت من السلسلة كلها.
الخلاصة Summary
- حساس موجات فوق صوتية مقاوم للماء فوق كل خزان يحول زمن الصدى إلى مسافة، ثم إلى ارتفاع ونسبة ولترات، بشرط أن يبقى أعلى مستوى للماء خارج المنطقة العمياء.
- جهة الكهرباء للكهربائي: المتحكم يشغل مرحلاً صغيراً، والمرحل يشغل ملف الكونتاكتور، والكونتاكتور مع حماية المحرك يشغل المضخة.
- المضخة تبدأ تحت 30% وتقف عند 90%، ولا تعمل والخزان الأرضي تحت 15%، ولا أكثر من 90 دقيقة، وتقف وتقفل إذا لم يرتفع الخزان العلوي بعد 10 دقائق.
- في المختبر أوقفت حماية الخزان الأرضي المضخة عند 14% في اليوم الأول، ووصل التنبيه، وعادت المضخة وحدها بعد الصهريج.
- فحص الليل يجد التسرب بمقارنة نقص الخزان بين الواحدة والخامسة فجراً والمضخة متوقفة: 12 لتراً في الساعة في الليلة الأولى، و41 في الليلة الثانية بعد التسرب.
- الأصداء الخاطئة نفسها أعطت 287 تشغيلاً في يومين بنبضة واحدة وحد واحد، و6 تشغيلات بالوسيط من خمس نبضات والحدين: الحدان لتقلب الماء، والوسيط للقراءات الكاذبة.
وفي المشاريع القادمة من هذه السلسلة بإذن الله سوف ننتقل إلى مراقبة غرف التبريد والثلاجات الدوائية، حيث لا يكفي أن تعرف القراءة الحالية، وإنما يجب أن تثبت للمفتش أن السلسلة لم تنقطع.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتشغيل البرنامج على ESP-IDF v5.4.1 في Espressif QEMU، مع Mosquitto 2.1.2 وntfy v2.11.0 وPython 3.13 مع paho-mqtt 2.2.0، وبرنامج المقارنة على gcc 13.3.0، في Docker Engine 29.8.0.