تسافر أسبوعاً وتترك البيت مغلقاً، وفي اليوم الثالث يتصل بك الجار يسألك هل رجعت؟ لأنه رأى الباب مفتوحاً. أو تنام وأحد أبنائك خرج إلى الحديقة ونسي باب المطبخ مفتوحاً حتى الصباح. وفي الحالتين السؤال واحد: هل فتح هذا الباب؟ ومتى؟ وهل ما زال مفتوحاً؟ وهذا من أبسط مشاريع إنترنت الأشياء في البيت، وأكثرها فائدة، وأيضاً من أكثرها إزعاجاً عندما يبنى بطريقة خاطئة، فالحساس الذي يرسل لك عشرة تنبيهات كلما فتحت الباب ستكتمه في اليوم الثاني، والحساس الذي يحتاج شحناً كل أسبوع ستنزعه في الشهر الأول.
وفي هذا المقال سوف نبني حساس باب بمفتاح ريد Reed Switch ولوحة ESP32 تعمل على بطارية، تنام نوماً عميقاً Deep Sleep بين كل فتح وآخر، وتستيقظ عندما يتحرك المغناطيس، فترسل حالة الباب عبر MQTT، وخدمة صغيرة على السيرفر تقرر هل يستحق هذا التغيير تنبيهاً على الجوال، وبأي أولوية، عبر ntfy. وسوف نشغل البرنامج نفسه على المحاكي QEMU مع الوسيط وخدمة التنبيهات في Docker، مرة بالطريقة البسيطة لنرى سيل التنبيهات الذي يسببه ارتداد التلامس، ومرة بعد الإصلاح، ثم نحسب عمر البطارية بأرقام ورقة البيانات.
وسوف نناقش في هذا المقال ما يلي:
- ماذا نريد من حساس الباب، ولماذا البطارية هي التي تقرر التصميم.
- القطع: مفتاح الريد والمغناطيس، ولوحة ESP32، والبطارية.
- التوصيل، ولماذا لا نستخدم المقاومة الرافعة الداخلية.
- النوم العميق والاستيقاظ بالرجل ext0، والبرنامج كاملاً.
- المختبر: البرنامج في QEMU مع Mosquitto وntfy وخدمة الاستقبال.
- اكسرها: سيل التنبيهات من ارتداد التلامس، ثم الإصلاح في الجهاز وفي السيرفر.
- الجهاز الذي انقطع: الوصية الأخيرة Last Will والجهاز النائم.
- عمر البطارية بالحساب، والأخطاء الشائعة.
ماذا نريد من الحساس؟
قبل القطع والكود، اكتب ما تريده من الحساس بجمل يفهمها أهل البيت، لأن كل قرار تقني بعد ذلك يرجع إلى هذه الجمل:
- يعمل شهوراً على بطارية: لا يوجد مقبس كهرباء بجانب إطار الباب في أغلب البيوت، والسلك الممتد من الباب إلى أقرب مقبس لن يقبله أحد.
- يصل التنبيه خلال ثوان: التنبيه الذي يصل بعد دقيقة من فتح الباب وأنت مسافر مقبول، ولكن بعد ساعة لا قيمة له.
- لا يزعج: وأنت في البيت لا تريد تنبيهاً كلما خرج أحد إلى الحديقة، وفي الليل تريد أن تعرف، وأنت مسافر تريد كل فتح بأعلى صوت.
- يخبرك عندما يتعطل: الحساس الصامت أخطر من عدم وجود حساس، لأنك تظن أن الباب مغلق لأن أحداً لم يخبرك بعكس ذلك.
والجملة الأولى هي التي تقرر أغلب التصميم، كما سنرى، فالشريحة التي تتصل بالشبكة طوال الوقت تستهلك عشرات الملي أمبير، والبطارية الصغيرة لا تحتمل ذلك أكثر من أيام. ولهذا يقضي الحساس أكثر من 99% من وقته نائماً، ويستيقظ ثوان قليلة فقط عندما يحدث شيء.
القطع
مفتاح الريد والمغناطيس
قلب المشروع قطعة صغيرة جداً: مفتاح الريد، وهو أنبوب زجاجي مغلق في داخله شريحتان معدنيتان رفيعتان من مادة تتأثر بالمغناطيس، متقابلتان وبينهما مسافة صغيرة. وعندما تقرب مغناطيساً من الأنبوب تنجذب الشريحتان إلى بعضهما فتتلامسان ويمر التيار، وعندما تبعده تعودان إلى مكانهما. والصورة التالية لمفتاح ريد مكبر، وتظهر فيه الشريحتان داخل الزجاج:

والمفتاح في هذه الصورة من النوع المفتوح عادة Normally Open، أي أن الشريحتين متباعدتان دون مغناطيس، وهو النوع الأشهر. ونضعه على إطار الباب الثابت، والمغناطيس على الباب نفسه، فعندما يكون الباب مغلقاً يكون المغناطيس بجانب المفتاح فيغلقه، وعندما يفتح الباب يبتعد المغناطيس فيفتح المفتاح. وحساسات الأبواب التجارية هي هذه الفكرة نفسها في علبتين بلاستيكيتين، كما في الصورة التالية لتركيب حساس لاسلكي على باب:

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

ولوحة التطوير هذه ممتازة لتجربة المشروع على الطاولة، ولكنها ليست ما تضعه على الباب بعد ذلك. والسبب أن عليها قطعاً غير الشريحة: منظم جهد Regulator، وشريحة تحويل USB إلى تسلسلي، ومؤشر ضوئي للكهرباء، وكلها تستهلك تياراً والشريحة نائمة، وقد يكون استهلاكها أضعاف استهلاك الشريحة. ولا نكتب هنا رقماً للوحتك، لأنه يختلف من لوحة إلى أخرى، وإنما تقيسه بنفسك بالمقياس المتعدد في مدى المايكرو أمبير، كما شرحنا في مقال لوحة التجارب والمقياس المتعدد. وللحساس النهائي تستخدم وحدة ESP32 وحدها، أو لوحة مصممة للبطارية يذكر صانعها تيار النوم.
البطارية
ورقة بيانات ESP32 تقول إن الشريحة تعمل من 2.3 إلى 3.6 فولت، وفي الوحدات التي فيها ذاكرة فلاش 3.3 فولت يصبح الحد الأدنى 3.0 فولت، وتوصي بمصدر يعطي 500 ملي أمبير أو أكثر، لأن الراديو يسحب تياراً عالياً للحظات عند الإرسال. ولهذا نستخدم خلية ليثيوم أيون Li-ion واحدة، جهدها من قرابة 4.2 فولت وهي مشحونة إلى قرابة 3.0 فولت وهي فارغة، ومعها منظم جهد إلى 3.3 فولت تياره في السكون Quiescent Current صغير، والرقم الذي تبحث عنه في ورقة بياناته بالمايكرو أمبير لا بالملي أمبير. والصورة التالية لخلايا من حجمين شائعين:

ولاحظ كلمة unprotected على الخلية السوداء، أي أنها دون دائرة حماية، فإذا استنزفتها إلى جهد منخفض جداً أو قصرت طرفيها فقد تتلف أو تسخن. فإما أن تشتري خلية محمية، أو تضع في التصميم دائرة حماية، وإما أن يتوقف برنامجك نفسه عن العمل عندما ينخفض الجهد، وهذا سبب أننا نقيس جهد البطارية ونرسله مع كل رسالة. ولاحظ أيضاً أن السعة المكتوبة على الخلايا الرخيصة ليست دائماً حقيقية، ولهذا نحسب عمر البطارية بعد قليل بسعة متحفظة.
التوصيل

- المفتاح: بين الرجل 33 والأرضي، ومقاومة رافعة Pull-up بقيمة 1 ميغا أوم من الرجل إلى 3.3 فولت. والباب مغلق يعني المفتاح مغلق، فتقرأ الرجل LOW، والباب مفتوح يعني المفتاح مفتوح، فترفعها المقاومة إلى HIGH.
- لماذا الرجل 33؟ لأن الاستيقاظ من النوم العميق برجل يعمل فقط بالأرجل المتصلة بجزء RTC في الشريحة، وهو الجزء الذي يبقى يعمل والشريحة نائمة، والرجل 33 منها.
- مقسم الجهد: مقاومتان متساويتان من البطارية إلى الأرضي، والمنتصف إلى الرجل 35، فتقرأ الشريحة نصف جهد البطارية، أي 2.1 فولت على الأكثر، وهو داخل مدى محول ADC. واخترنا مقاومتين بقيمة 1 ميغا أوم ليمر فيهما تيار صغير جداً، ومعهما مكثف صغير 100 نانو فاراد على الرجل، لأن مدخل ADC يحتاج أن يأخذ شحنة سريعة عند القراءة لا تعطيها المقاومات الكبيرة وحدها.
وقد يتساءل البعض: لماذا نضع مقاومة رافعة خارجية والشريحة فيها مقاومة رافعة داخلية تفعل الشيء نفسه بسطر واحد في الكود؟ والإجابة في ورقة البيانات: المقاومة الداخلية قيمتها النموذجية 45 كيلو أوم، والباب مغلق أغلب اليوم، أي أن المفتاح مغلق أغلب اليوم، فيمر فيها تيار من 3.3 فولت إلى الأرضي بقانون أوم:
3.3 فولت ÷ 45000 أوم = 73 مايكرو أمبير تقريباً، طوال الوقت.
وهذا أكثر من سبعة أضعاف استهلاك الشريحة نفسها في النوم العميق، وهو 10 مايكرو أمبير في ورقة البيانات. ومع مقاومة 1 ميغا أوم يصبح التيار 3.3 مايكرو أمبير فقط. وهذا مثال لشيء يتكرر في كل مشاريع البطارية: الشريحة ليست وحدها في الدارة، وقطعة صغيرة لا تنتبه لها قد تأكل البطارية أسرع من كل شيء آخر. وسنرى أثرها على عمر البطارية بالأرقام في آخر المقال.
النوم العميق: الجهاز الذي لا يعمل إلا ثوان
في النوم العميق تتوقف النواتان والراديو والذاكرة الرئيسية، ولا يبقى إلا جزء RTC بذاكرته الصغيرة ومؤقته، وأرجله التي يمكن أن توقظ الشريحة. وعندما تستيقظ الشريحة لا تكمل من حيث توقفت، وإنما تبدأ البرنامج من أوله كأنها شغلت من جديد، والشيء الوحيد الذي يبقى من الدورة السابقة ما وضعته في ذاكرة RTC. والشكل التالي يبين استيقاظة واحدة:

وفي ESP32 أكثر من طريقة لإيقاظ الشريحة برجل، ونحتاج منها اثنتين:
- ext0: رجل واحدة من أرجل RTC، وتختار المستوى الذي يوقظ الشريحة، HIGH أو LOW، وهذا ما نستخدمه.
- ext1: عدة أرجل معاً، وفي ESP32 الأصلية تختار بين أن توقظها أي رجل تصبح HIGH، أو أن تصبح كل الأرجل LOW. وتحتاجها إذا وصلت بابين أو باباً ونافذة بالشريحة نفسها.
- المؤقت Timer: يوقظ الشريحة بعد مدة، ونستخدمه لنبضة حياة Heartbeat كل 6 ساعات، فتعرف أن الحساس ما زال يعمل حتى لو لم يفتح الباب يومين.
والنقطة الدقيقة في ext0 أنه يعمل بالمستوى لا بالتغيير، فلا تقول له «أيقظني عندما يتغير الباب»، وإنما «أيقظني عندما تصبح الرجل HIGH»، ولهذا قبل كل نوم نختار المستوى المعاكس لحالة الباب الآن: الباب مغلق فالرجل LOW، فنطلب الاستيقاظ عند HIGH، والعكس. وهذا يحل مشكلة أخرى مجاناً: لو تغير الباب في الثواني التي كان الجهاز فيها مستيقظاً، فالرجل عند النوم تكون في المستوى الذي يوقظ، فيستيقظ الجهاز فوراً ويرسل الحالة الجديدة، ولا يضيع التغيير.
البرنامج
البرنامج مكتوب بـ ESP-IDF v5.4.1، وفي ملفين: door.c للقطع، وmain.c للمنطق. والملف door.c فيه نسختان: النسخة الحقيقية تقرأ المفتاح من رجل RTC والبطارية من ADC، ونسخة المحاكاة تعطي باباً مبرمجاً بجدول زمني، لأن المحاكي QEMU ليس فيه مفتاح ريد ولا بطارية:
#include "door.h"
#include "esp_timer.h"
#define PIN_REED GPIO_NUM_33 // reed switch to GND; an RTC GPIO, so it can wake the chip from deep sleep
#ifndef SENSOR_SIM
#include "driver/rtc_io.h"
#include "esp_adc/adc_oneshot.h"
static adc_oneshot_unit_handle_t adc; // battery through a 1M + 1M divider (and 100 nF) on GPIO35 = ADC1 channel 7
void door_init(void) {
rtc_gpio_init(PIN_REED);
rtc_gpio_set_direction(PIN_REED, RTC_GPIO_MODE_INPUT_ONLY);
// External 1 Mohm pull-up to 3.3 V, not the internal one: the internal pull-up is about 45 kohm, and with the
// door closed (the reed closed) it would draw about 73 uA all day, seven times the chip's own deep sleep current.
rtc_gpio_pullup_dis(PIN_REED);
rtc_gpio_pulldown_dis(PIN_REED);
adc_oneshot_unit_init_cfg_t unit = { .unit_id = ADC_UNIT_1 };
adc_oneshot_new_unit(&unit, &adc);
adc_oneshot_chan_cfg_t ch = { .atten = ADC_ATTEN_DB_12, .bitwidth = ADC_BITWIDTH_12 };
adc_oneshot_config_channel(adc, ADC_CHANNEL_7, &ch);
}
bool door_closed(void) { return rtc_gpio_get_level(PIN_REED) == 0; }
int battery_mv(void) {
int raw;
adc_oneshot_read(adc, ADC_CHANNEL_7, &raw);
return raw * 3300 * 2 / 4095; // rough: calibrate with esp_adc_cal / adc_cali for real numbers
}
#else
// Scripted door, in ms after the device comes online. Each entry: from this time on, the reed reads this level.
// The steps 15 ms apart are chatter: the contact opening and closing several times while the door rattles and the
// reed blades bounce, before it settles. (Bare reed bounce is shorter; a door that shakes as it moves adds more.)
typedef struct { int t_ms; bool closed; } step_t;
static const step_t script[] = {
{0, true},
{3000, false}, {6000, true}, // a normal open and close
{12000, false}, {12015, true}, {12030, false}, {12045, true}, {12060, false}, {12075, true},
{12090, false}, {12105, true}, {12120, false}, {12135, true}, {12150, false}, // opens with chatter
{16000, true}, {16015, false}, {16030, true}, {16045, false}, {16060, true}, // closes with chatter
{26000, false}, {29000, true}, // opened at home (mode "home")
{36000, false}, // opened and left open
};
static int64_t t0 = -1;
void door_init(void) {}
void door_script_start(void) { t0 = esp_timer_get_time(); }
bool door_closed(void) {
if (t0 < 0) return true;
int t = (int)((esp_timer_get_time() - t0) / 1000);
bool closed = true;
for (int i = 0; i < sizeof script / sizeof script[0] && script[i].t_ms <= t; i++) closed = script[i].closed;
return closed;
}
int battery_mv(void) { return 3950 - (int)(esp_timer_get_time() / 20000000); } // one Li-ion cell, slowly falling
#endifولاحظ في جدول المحاكاة الخطوات التي بينها 15 ملي ثانية، فهذه ليست أخطاء في الجدول، وإنما محاكاة لارتداد التلامس Contact Bounce: الشريحتان المعدنيتان في مفتاح الريد ترتدان عندما تتلامسان أو تنفصلان، كما ترتد الكرة على الأرض، والباب نفسه يهتز عندما يفتح بقوة أو يغلق بقوة فيقترب المغناطيس ويبتعد، فيرى المتحكم المفتاح يفتح ويغلق عدة مرات قبل أن يستقر. وقد رأينا الشيء نفسه مع الزر في المشروع الأول مع Arduino. وارتداد الشريحتين وحدهما أقصر من هذا عادة، ولكننا جعلنا الخطوات 15 ملي ثانية لسبب سنعود إليه في المختبر. ثم main.c:
// Door sensor on an ESP32 with a reed switch, on a battery.
// - real board: sleeps in deep sleep, wakes when the reed changes (ext0) or every 6 hours (heartbeat), connects,
// publishes the door state and the battery voltage, waits for the broker to confirm, and sleeps again
// - SENSOR_SIM (QEMU): the same reporting code, but the device stays awake and polls a scripted door
// - debounce: a change counts only after the reed keeps the same level for debounce_ms (default 50 ms)
// - mode ("away" or "home") and debounce_ms come from retained MQTT messages, so a sleeping device gets them at wake
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_event.h"
#include "esp_netif.h"
#include "esp_sleep.h"
#include "esp_timer.h"
#include "nvs_flash.h"
#include "mqtt_client.h"
#include "protocol_examples_common.h"
#include "door.h"
static const char *TAG = "door";
#define DEVICE "front"
#define BASE "home/door/" DEVICE "/"
#define BROKER_URI "mqtt://10.0.2.2:1883" // under QEMU: the machine running it; on a real board your broker's address
#define HEARTBEAT_S (6 * 3600) // a sleeping device says "still alive" every 6 hours
RTC_DATA_ATTR static int seq; // RTC memory: kept across deep sleep
RTC_DATA_ATTR static int last_closed = -1; // the last state we reported (-1 = never)
static esp_mqtt_client_handle_t mq;
static volatile bool connected, acked;
static volatile int debounce_ms = 50;
static char mode[8] = "away";
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;
esp_mqtt_client_publish(mq, BASE "status", "online", 0, 1, 1);
esp_mqtt_client_subscribe(mq, BASE "mode", 1);
esp_mqtt_client_subscribe(mq, BASE "config", 1);
} else if (id == MQTT_EVENT_PUBLISHED) {
acked = true; // the broker has our QoS 1 message
} else if (id == MQTT_EVENT_DATA && e->topic_len > 0) {
char val[64] = {0};
memcpy(val, e->data, e->data_len < 63 ? e->data_len : 63);
if (e->topic_len >= 4 && memcmp(e->topic + e->topic_len - 4, "mode", 4) == 0) {
snprintf(mode, sizeof mode, "%.7s", val);
ESP_LOGI(TAG, "mode = %s", mode);
} else if (strstr(val, "debounce_ms")) {
debounce_ms = atoi(strchr(val, ':') + 1);
ESP_LOGI(TAG, "debounce_ms = %d", debounce_ms);
}
}
}
// Wait until the reed keeps one level for debounce_ms; count the level changes seen meanwhile.
static bool settle(int *changes) {
bool level = door_closed();
for (int stable = 0; stable < debounce_ms; ) {
vTaskDelay(pdMS_TO_TICKS(1));
bool now = door_closed();
if (now != level) { level = now; stable = 0; (*changes)++; } else stable++;
}
return level;
}
static void report(const char *kind, bool closed, int changes) {
char j[160];
snprintf(j, sizeof j, "{\"seq\":%d,\"kind\":\"%s\",\"state\":\"%s\",\"changes\":%d,\"batt_mv\":%d,\"mode\":\"%s\"}",
++seq, kind, closed ? "closed" : "open", changes, battery_mv(), mode);
ESP_LOGI(TAG, "%s", j);
acked = false;
esp_mqtt_client_publish(mq, BASE "event", j, 0, 1, 0);
esp_mqtt_client_publish(mq, BASE "state", closed ? "closed" : "open", 0, 1, 1); // retained: the current state
last_closed = closed;
}
static void mqtt_start(void) {
esp_mqtt_client_config_t cfg = {
.broker.address.uri = BROKER_URI,
.credentials.client_id = "door-" DEVICE,
.session.last_will = { .topic = BASE "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));
vTaskDelay(pdMS_TO_TICKS(300)); // the retained mode and config arrive right after subscribing
}
void app_main(void) {
ESP_ERROR_CHECK(nvs_flash_init());
ESP_ERROR_CHECK(esp_netif_init());
ESP_ERROR_CHECK(esp_event_loop_create_default());
door_init();
#ifndef SENSOR_SIM
// Real board: one short wake, then deep sleep again.
esp_sleep_wakeup_cause_t cause = esp_sleep_get_wakeup_cause();
int changes = 0;
bool closed = settle(&changes); // read the reed before the radio starts
ESP_ERROR_CHECK(example_connect()); // Wi-Fi: the expensive part of every wake
mqtt_start();
if (cause == ESP_SLEEP_WAKEUP_TIMER && closed == last_closed) report("heartbeat", closed, 0);
else report("change", closed, changes);
for (int i = 0; i < 30 && !acked; i++) vTaskDelay(pdMS_TO_TICKS(100)); // do not sleep before the broker has it
esp_mqtt_client_disconnect(mq); // a clean disconnect: the broker does NOT send the last will
example_disconnect();
esp_sleep_enable_ext0_wakeup(GPIO_NUM_33, closed ? 1 : 0); // wake when the reed leaves the level it has now
esp_sleep_enable_timer_wakeup((uint64_t)HEARTBEAT_S * 1000000);
esp_deep_sleep_start();
#else
// QEMU: stay awake and poll the scripted door every millisecond (a real always-on device would use a GPIO interrupt).
ESP_ERROR_CHECK(example_connect());
mqtt_start();
door_script_start();
bool last = door_closed();
report("boot", last, 0);
int64_t beat = esp_timer_get_time();
for (;;) {
vTaskDelay(pdMS_TO_TICKS(1));
if (door_closed() != last) {
int changes = 1;
bool now = settle(&changes);
if (now != last) { last = now; report("change", now, changes); }
}
if (esp_timer_get_time() - beat > 30 * 1000000LL) { beat = esp_timer_get_time(); report("heartbeat", last, 0); }
}
#endif
}في البرنامج أعلاه لاحظ التالي:
- ذاكرة RTC: المتغيران
seqوlast_closedمعرفان بالكلمةRTC_DATA_ATTR، فيبقيان بين نوم وآخر، وبهما يعرف الجهاز رقم رسالته التالية، وهل تغيرت حالة الباب منذ آخر مرة. - إزالة الارتداد Debounce: الدالة
settleلا تقبل الحالة الجديدة إلا بعد أن تبقى الرجل على المستوى نفسه 50 ملي ثانية متصلة، وتعد الحواف التي رأتها في الطريق، وترسل العدد مع الرسالة، فترى في السيرفر كم يرتد مفتاحك. - رسالتان لكل تغيير: حدث Event على الموضوع
eventفيه الرقم والحالة والبطارية، وحالة محفوظة Retained على الموضوعstate، فأي برنامج يشترك بعد ساعة يعرف حالة الباب الآن دون أن ينتظر التغيير التالي. - الوضع والإعدادات من الوسيط: الجهاز يشترك في الموضوعين
modeوconfig، وكلاهما رسالة محفوظة، والوسيط يرسل الرسالة المحفوظة فور الاشتراك، فالجهاز النائم يستلم آخر وضع كلما استيقظ، دون أن يحتاج أحد أن يرسل له في اللحظة التي يكون فيها مستيقظاً. وقد شرحنا الرسائل المحفوظة في مقال MQTT مع Mosquitto. - لا ينام قبل التأكيد: الرسالة بمستوى الخدمة QoS 1، والجهاز ينتظر الحدث
MQTT_EVENT_PUBLISHEDالذي يعني أن الوسيط استلمها، ثم ينام، ولو نام مباشرة بعد النشر لضاعت الرسالة أحياناً وهي في الطريق. - قطع الاتصال النظيف: قبل النوم يقطع الجهاز الاتصال بنفسه، وسنرى بعد قليل لماذا هذا مهم مع الوصية الأخيرة.
هل ينام المحاكي؟
قبل أن نبني المختبر على QEMU أردنا أن نعرف: هل يحاكي QEMU من Espressif النوم العميق والاستيقاظ منه؟ فكتبنا برنامجاً صغيراً من عشرين سطراً يطبع رقم التشغيل وسبب الاستيقاظ، ثم ينام ثانيتين بالمؤقت:
// Does Espressif's QEMU wake an ESP32 from deep sleep? Boot, print the boot count and the wake cause,
// then sleep for 2 s with the RTC timer and the door pin (ext0) as wake sources.
#include <stdio.h>
#include "esp_sleep.h"
#include "driver/rtc_io.h"
RTC_DATA_ATTR static int boots; // RTC memory: survives deep sleep, cleared by a power-on reset
void app_main(void) {
boots++;
printf("sleeptest: boot %d, wake cause %d (0 = not a wake, 2 = ext0, 4 = timer)\n",
boots, (int)esp_sleep_get_wakeup_cause());
rtc_gpio_pullup_en(GPIO_NUM_33);
rtc_gpio_pulldown_dis(GPIO_NUM_33);
esp_sleep_enable_ext0_wakeup(GPIO_NUM_33, 1); // wake when the door opens (pin goes HIGH)
esp_sleep_enable_timer_wakeup(2 * 1000000ULL); // or after 2 s
printf("sleeptest: going to deep sleep\n");
fflush(stdout);
esp_deep_sleep_start();
}ونشغله بالملف sleeptest.sh خمساً وعشرين ثانية، وعلى شريحة حقيقية سوف يطبع تشغيلاً جديداً كل ثانيتين، والمخرج على المحاكي كما يلي:
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
sleeptest.bin binary size 0x2db30 bytes. Smallest app partition is 0x100000 bytes. 0xd24d0 bytes (82%) free.
rst:0x1 (POWERON_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)
I (14963) app_init: Project name: sleeptest
sleeptest: boot 1, wake cause 0 (0 = not a wake, 2 = ext0, 4 = timer)
sleeptest: going to deep sleep
Guru Meditation Error: Core 0 panic'ed (LoadStorePIFAddrError). Exception was unhandled.
rst:0x7 (TG0WDT_SYS_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)
rst:0x7 (TG0WDT_SYS_RESET),boot:0x12 (SPI_FAST_FLASH_BOOT)البرنامج وصل إلى app_main وطبع التشغيل الأول وسبب الاستيقاظ 0، أي أنه تشغيل عادي، ثم طبع أنه ذاهب إلى النوم، وبعدها مباشرة توقفت النواة بخطأ Guru Meditation من النوع LoadStorePIFAddrError، أي أن الكود حاول أن يقرأ أو يكتب في عنوان لا يجد خلفه المحاكي شيئاً. ثم أعاد مؤقت المراقبة Watchdog تشغيل الشريحة، ولم يصل البرنامج إلى app_main مرة ثانية حتى انتهت الدقيقة. والنتيجة واضحة: QEMU من Espressif في هذه النسخة لا يحاكي النوم العميق، فالأجزاء التي يكتب فيها كود النوم غير موجودة فيه. وهذا ليس عيباً في المحاكي بقدر ما هو حدود معروفة لكل محاك: ما لا يحاكيه لا تختبره عليه.
ولهذا قسمنا البرنامج كما رأيت: النسخة الحقيقية فيها النوم العميق والاستيقاظ بالرجل 33، ونبنيها في المختبر لنتأكد أنها تبنى دون أخطاء، ولكننا لا نشغلها، لأن مكان تشغيلها شريحة حقيقية. ونسخة المحاكاة تبقى مستيقظة وتقرأ الباب المبرمج كل ملي ثانية، وترسل الرسائل نفسها بالدالة نفسها report، فكل ما بعد الجهاز، من الوسيط إلى الجوال، نختبره كما هو.
المختبر: الحساس والوسيط والجوال على جهاز واحد
المختبر مبني على القالب نفسه الذي استخدمناه في مشروع ري النباتات: البرنامج في QEMU يتصل بالوسيط Mosquitto، وخدمة استقبال بلغة Python تحفظ الرسائل في SQLite وترسل التنبيهات إلى خادم ntfy، وهو برنامج مفتوح المصدر يرسل التنبيهات إلى تطبيقه على الجوال، وتستطيع أن تشغله على سيرفرك. والملف compose.yaml كما يلي:
# Door sensor lab: the ESP32 firmware in QEMU, the broker, ntfy for phone notifications, and the ingest service.
name: door
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: door-ingest:1
command: python -u ingest.py
# FIXED=0: the first version (a notification for every message); FIXED=1: dedupe and rate limit
environment: { FIXED: "${FIXED:-1}", AJAR_S: "15", RATE_S: "60", QUIET_HOURS: "23-6" }
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 ]- الخدمة
firmwareتشارك الوسيط شبكته بالخيارnetwork_mode، فالعنوان 10.0.2.2:1883 داخل QEMU هو الوسيط نفسه. - المتغير
FIXEDيختار نسخة خدمة الاستقبال: الأولى البسيطة أو المصلحة. AJAR_Sمدة الباب المفتوح قبل التنبيه، وهي 15 ثانية في المختبر ليظهر التنبيه في دقيقة، وفي البيت اجعلها دقائق.
والملف fw.sh يبني البرنامج مرتين، النسخة الحقيقية بالنوم العميق وWi-Fi للتأكد من أنها تبنى، ونسخة المحاكاة التي يشغلها في QEMU:
#!/bin/bash
# Inside espressif/idf: build the firmware twice and run the simulated build in QEMU for $RUN_S seconds.
# build-hw : the real board (RTC GPIO, ADC, Wi-Fi, deep sleep), compiled only, to prove the real drivers build
# build-sim: SENSOR_SIM=1 (a scripted door, the device stays awake) over QEMU's emulated Ethernet
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
cd firmware
idf.py -B build-hw set-target esp32 > /dev/null
idf.py -B build-hw build 2>&1 | grep -E "binary size"
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"
(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:-95}" 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]+\) (door|example_connect):|Guru" || trueأما قرار التنبيه فمكانه السيرفر لا الجهاز، لأن الجهاز نائم أغلب الوقت ولا يعرف إلا الباب، والسيرفر يعرف الوضع والساعة وما أرسل قبل قليل. ووضعنا القرار في دالة واحدة منفصلة في الملف policy.py لنختبرها دون باب ولا جوال:
"""Who gets woken up, and how loudly. One pure function, so it can be tested without a door or a phone.
mode "away": nobody should be home, every opening is urgent.
mode "home": openings are normal, except at night (QUIET_HOURS), when an opening is worth a quiet notification."""
def in_quiet_hours(hour, quiet="23-6"):
start, end = (int(x) for x in quiet.split("-"))
return start <= hour or hour < end if start > end else start <= hour < end
def decide(mode, state, hour, quiet="23-6"):
"""Returns (title, ntfy priority 1..5) for a door change, or None for no notification."""
if state != "open":
return None # closing never needs a person
if mode == "away":
return ("Door opened while away", 5)
if in_quiet_hours(hour, quiet):
return ("Door opened at night", 3)
return Noneوأولويات ntfy من 1 إلى 5، والأولوية 5 أقواها، وتظهر على الجوال بصوت واهتزاز أطول. ثم خدمة الاستقبال ingest.py:
"""Ingest for the door sensor.
- subscribes to home/door/# and keeps every event in SQLite (/data/door.db)
- FIXED=0: the first version, a phone notification for every event message
- FIXED=1: notifications follow policy.decide(), repeated states are dropped (dedupe), and each kind of notification
is sent at most once per RATE_S seconds (rate limit)
- door left open longer than AJAR_S, device offline (last will), and low battery are notified in both versions"""
import json, os, sqlite3, threading, time, urllib.request
import paho.mqtt.client as mqtt
from policy import decide
FIXED, AJAR_S, RATE_S = os.environ["FIXED"] == "1", int(os.environ["AJAR_S"]), int(os.environ["RATE_S"])
QUIET = os.environ["QUIET_HOURS"]
LOW_BATT_MV = 3500 # one Li-ion cell: little energy left below about 3.5 V
DB = sqlite3.connect("/data/door.db", check_same_thread=False)
DB.execute("CREATE TABLE IF NOT EXISTS event(device TEXT, ts REAL, seq INT, kind TEXT, state TEXT, changes INT, batt_mv INT, mode TEXT)")
LOCK = threading.Lock()
mode = {} # device -> "away" / "home" (retained topic home/door/<dev>/mode)
last_state, open_since, ajar_sent, last_push, batt_sent = {}, {}, set(), {}, set()
def push(device, title, prio, body):
if FIXED:
key = (device, title)
if time.time() - last_push.get(key, 0) < RATE_S:
print(f"rate limit: dropped '{title}'", flush=True)
return
last_push[key] = time.time()
req = urllib.request.Request("http://ntfy/door", data=f"{device}: {body}".encode(),
headers={"Title": title, "Priority": str(prio), "Tags": "door"})
urllib.request.urlopen(req, timeout=5).read()
print(f"PUSH p{prio} {title}", flush=True)
def on_message(c, u, m):
_, _, device, kind = m.topic.split("/") # home/door/<device>/<kind>
text = m.payload.decode()
with LOCK:
if kind == "mode":
mode[device] = text
print(f"mode {device} = {text}", flush=True)
elif kind == "status":
print(f"status {device} = {text}", flush=True)
if text == "offline":
push(device, "Door sensor offline", 3, "no connection from the door sensor")
elif kind == "event":
r = json.loads(text)
DB.execute("INSERT INTO event VALUES(?,?,?,?,?,?,?,?)", (device, time.time(), r["seq"], r["kind"],
r["state"], r["changes"], r["batt_mv"], r["mode"]))
DB.commit()
state, prev = r["state"], last_state.get(device)
last_state[device] = state
print(f"event {device} #{r['seq']} {r['kind']} {state} changes={r['changes']}", flush=True)
if state == "open" and prev != "open":
open_since[device] = time.time()
if state == "closed":
open_since.pop(device, None); ajar_sent.discard(device)
if r["batt_mv"] < LOW_BATT_MV and device not in batt_sent:
batt_sent.add(device); push(device, "Door sensor battery low", 3, f"{r['batt_mv']} mV")
if r["kind"] != "change":
return # boot and heartbeat messages are not door changes
if not FIXED:
push(device, f"Door {state}", 4, f"door {state}")
return
if state == prev:
print("dedupe: same state again, no notification", flush=True)
return
d = decide(mode.get(device, "away"), state, time.localtime().tm_hour, QUIET)
if d:
push(device, d[0], d[1], "the door was opened")
def ajar_watch():
while True:
time.sleep(1)
with LOCK:
for device, since in list(open_since.items()):
if time.time() - since > AJAR_S and device not in ajar_sent:
ajar_sent.add(device)
push(device, "Door left open", 4, f"open for more than {AJAR_S} s")
threading.Thread(target=ajar_watch, daemon=True).start()
c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="door-ingest")
c.on_connect = lambda c, u, f, rc, p: c.subscribe("home/door/#", qos=1)
c.on_message = on_message
while True:
try:
c.connect("broker", 1883)
break
except OSError:
time.sleep(1)
c.loop_forever()والمتغير FIXED هو الفرق بين النسختين: في النسخة الأولى البسيطة كل رسالة تغيير تصبح تنبيهاً، وفي المصلحة تمر الرسالة على ثلاث مصاف قبل أن تصل إلى الجوال، كما في الشكل التالي:

والملف report.py يطبع ما وصل إلى موضوع ntfy، أي ما كان سيظهر على الجوال، ويختبر دالة السياسة في ساعات مختلفة من اليوم:
"""What reached the phone, and a test of the notification policy at a few hours of the day."""
import json, sqlite3, urllib.request
from policy import decide
db = sqlite3.connect("/data/door.db")
n = db.execute("SELECT count(*), sum(kind = 'change') FROM event").fetchone()
print(f"event messages stored: {n[0]} ({n[1]} door changes)")
print("### notifications on ntfy topic 'door'")
count = 0
with urllib.request.urlopen("http://ntfy/door/json?poll=1&since=all", timeout=5) as r:
for line in r:
x = json.loads(line)
count += 1
print(f"[p{x.get('priority', 3)}] {x.get('title')}: {x['message']}")
print(f"total: {count} notifications")
print("### policy.decide(mode, 'open', hour)")
for mode in ("away", "home"):
print(mode, " ".join(f"{h:02d}h={'-' if not decide(mode, 'open', h) else 'p' + str(decide(mode, 'open', h)[1])}"
for h in (8, 14, 22, 23, 2, 5, 6)))والملف run.sh يشغل كل شيء مرتين: المرة الأولى دون إزالة الارتداد في الجهاز وبخدمة الاستقبال البسيطة، والثانية بإزالة الارتداد 50 ملي ثانية وبالخدمة المصلحة. وفي كل مرة يضع الوضع away قبل أن يبدأ الجهاز، ثم يغيره إلى home بعد 22 ثانية من اتصال الجهاز، كأن أهل البيت رجعوا:
#!/bin/bash
# Run the whole project twice on one machine. From this folder: bash run.sh
# run 1 (naive): no debounce in the firmware, a notification for every message
# run 2 (fixed): 50 ms debounce, and the ingest dedupes, rate limits and follows the policy
set -e
one_run() { # $1 = name, $2 = debounce_ms, $3 = FIXED
rm -rf data && mkdir -p data
FIXED=$3 docker compose up -d --build --quiet-pull broker ntfy ingest 2>/dev/null
sleep 2
# retained settings: the device receives them as soon as it subscribes, even after a deep sleep
docker compose exec -T broker mosquitto_pub -r -q 1 -t home/door/front/config -m "{\"debounce_ms\":$2}"
docker compose exec -T broker mosquitto_pub -r -q 1 -t home/door/front/mode -m away
{ docker compose run --rm firmware 2>&1 | grep --line-buffered -E "binary size|^### |^[IWE] \(" | tee out-$1-firmware.txt; } &
FW=$!
docker compose exec -T broker mosquitto_sub -W 1500 -C 1 -t home/door/front/status > /dev/null # waits for "online" (up to 25 min of build)
sleep 22 # the family is back: mode "home"
docker compose exec -T broker mosquitto_pub -r -q 1 -t home/door/front/mode -m home
wait $FW
sleep 3 # the broker sends the last will once the connection is gone
docker compose logs --no-log-prefix ingest | tee out-$1-ingest.txt
docker compose run --rm --no-deps ingest python report.py | tee out-$1-report.txt
docker compose down 2>/dev/null
}
one_run 1-naive 0 0
one_run 2-fixed 50 1
docker run --rm door-ingest:1 python battery.py | tee out-3-battery.txtونشغله من مجلد lab بالأمر التالي، والمرة الأولى تأخذ دقائق لأنها تبني البرنامج:
bash run.shاكسرها: سيل التنبيهات
في التشغيل الأول يضع run.sh الإعداد debounce_ms على صفر، فيقبل الجهاز كل حافة يراها على الرجل، وخدمة الاستقبال بالنسخة الأولى البسيطة، أي أن كل رسالة تغيير تصبح تنبيهاً. ومخرج الجهاز في QEMU كما يلي:
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
door.bin binary size 0xd90a0 bytes. Smallest app partition is 0x100000 bytes. 0x26f60 bytes (15%) free.
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
door.bin binary size 0x86c30 bytes. Smallest app partition is 0x100000 bytes. 0x793d0 bytes (47%) free.
### qemu
I (7704) door: mode = away
I (7719) door: debounce_ms = 0
I (8024) door: {"seq":1,"kind":"boot","state":"closed","changes":0,"batt_mv":3950,"mode":"away"}
I (11025) door: {"seq":2,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (14025) door: {"seq":3,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (20025) door: {"seq":4,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (20041) door: {"seq":5,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (20067) door: {"seq":6,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (20076) door: {"seq":7,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (20114) door: {"seq":8,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (20130) door: {"seq":9,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (20145) door: {"seq":10,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (20161) door: {"seq":11,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (20190) door: {"seq":12,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (24024) door: {"seq":13,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (24041) door: {"seq":14,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (24059) door: {"seq":15,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (24076) door: {"seq":16,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (24085) door: {"seq":17,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (30230) door: mode = home
I (34025) door: {"seq":18,"kind":"change","state":"open","changes":1,"batt_mv":3949,"mode":"home"}
I (37025) door: {"seq":19,"kind":"change","state":"closed","changes":1,"batt_mv":3949,"mode":"home"}
I (38040) door: {"seq":20,"kind":"heartbeat","state":"closed","changes":0,"batt_mv":3949,"mode":"home"}
I (44025) door: {"seq":21,"kind":"change","state":"open","changes":1,"batt_mv":3949,"mode":"home"}
I (68040) door: {"seq":22,"kind":"heartbeat","state":"open","changes":0,"batt_mv":3947,"mode":"home"}الباب في جدول المحاكاة تغير سبع مرات حقيقية: فتح وإغلاق، ثم فتح وإغلاق بارتداد، ثم فتح وإغلاق في الوضع home، ثم فتح بقي مفتوحاً. والجهاز أرسل 19 رسالة تغيير: الفتح الثاني وحده أصبح تسع رسائل، من الرقم 4 إلى الرقم 12، كلها خلال أقل من 200 ملي ثانية، والإغلاق الذي بعده أصبح خمس رسائل. ولم ير الجهاز كل الحواف الإحدى عشرة في الفتح، لأنه يقرأ الرجل كل ملي ثانية، وكل نشر يأخذ من وقته، والمحاكي أبطأ من الشريحة الحقيقية. وهذا هو سبب أننا جعلنا خطوات الارتداد 15 ملي ثانية: في تشغيل سابق بخطوات 2 ملي ثانية رأى الجهاز ثلاث حواف مرة، ولم ير أي حافة في مرة أخرى، فلا يصلح ذلك مختبراً يتكرر. أما الشريحة الحقيقية مع مقاطعة GPIO فترى الحواف كلها، أي أن المشكلة على الباب الحقيقي أسوأ مما رأينا هنا لا أفضل. وما وصل إلى الجوال كما يلي:
event messages stored: 22 (19 door changes)
### notifications on ntfy topic 'door'
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door closed: front: door closed
[p4] Door open: front: door open
[p4] Door left open: front: open for more than 15 s
[p3] Door sensor offline: front: no connection from the door sensor
total: 21 notifications
### policy.decide(mode, 'open', hour)
away 08h=p5 14h=p5 22h=p5 23h=p5 02h=p5 05h=p5 06h=p5
home 08h=- 14h=- 22h=- 23h=p3 02h=p3 05h=p3 06h=-21 تنبيهاً في دقيقة واحدة، 19 منها «Door open» و«Door closed» بالأولوية نفسها، منها ثلاثة بعد أن رجع أهل البيت وأصبح الوضع home، وهي تنبيهات لا يريدها أحد. ولو كان هذا جوالك لكتمت التطبيق قبل نهاية اليوم الأول، ومعه يضيع التنبيه الوحيد المهم في القائمة: «Door left open». ولاحظ أن عندنا مشكلتين منفصلتين لا مشكلة واحدة: الجهاز يرسل تغييرات لم تحدث، وهذه مشكلة إلكترونية حلها في الجهاز، والسيرفر ينبه على كل شيء بالصوت نفسه، وهذه مشكلة قرار حلها في السيرفر. والشكل التالي يبين الحل الأول، إزالة الارتداد:

بعد الإصلاح
في التشغيل الثاني يضع run.sh الإعداد debounce_ms على 50، ويشغل خدمة الاستقبال بالنسخة المصلحة، والباب المبرمج هو نفسه بالارتدادات نفسها. ومخرج الجهاز كما يلي:
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
door.bin binary size 0xd90a0 bytes. Smallest app partition is 0x100000 bytes. 0x26f60 bytes (15%) free.
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
door.bin binary size 0x86c30 bytes. Smallest app partition is 0x100000 bytes. 0x793d0 bytes (47%) free.
### qemu
I (7503) door: mode = away
I (7526) door: debounce_ms = 50
I (7834) door: {"seq":1,"kind":"boot","state":"closed","changes":0,"batt_mv":3950,"mode":"away"}
I (10885) door: {"seq":2,"kind":"change","state":"open","changes":1,"batt_mv":3950,"mode":"away"}
I (13884) door: {"seq":3,"kind":"change","state":"closed","changes":1,"batt_mv":3950,"mode":"away"}
I (20034) door: {"seq":4,"kind":"change","state":"open","changes":11,"batt_mv":3950,"mode":"away"}
I (23944) door: {"seq":5,"kind":"change","state":"closed","changes":5,"batt_mv":3950,"mode":"away"}
I (29959) door: mode = home
I (33884) door: {"seq":6,"kind":"change","state":"open","changes":1,"batt_mv":3949,"mode":"home"}
I (36884) door: {"seq":7,"kind":"change","state":"closed","changes":1,"batt_mv":3949,"mode":"home"}
I (37849) door: {"seq":8,"kind":"heartbeat","state":"closed","changes":0,"batt_mv":3949,"mode":"home"}
I (43885) door: {"seq":9,"kind":"change","state":"open","changes":1,"batt_mv":3949,"mode":"home"}
I (67850) door: {"seq":10,"kind":"heartbeat","state":"open","changes":0,"batt_mv":3947,"mode":"home"}
I (97851) door: {"seq":11,"kind":"heartbeat","state":"open","changes":0,"batt_mv":3946,"mode":"home"}سبع رسائل تغيير لسبعة تغييرات حقيقية. والفتح الذي ارتد أصبح رسالة واحدة فيها changes تساوي 11، أي أن الجهاز رأى الحواف الإحدى عشرة كلها هذه المرة، لأنه وهو ينتظر الاستقرار يقرأ الرجل دون أن ينشر شيئاً، والإغلاق الذي ارتد أصبح رسالة واحدة فيها 5 حواف. وهذا العدد معلومة مفيدة في السيرفر: إذا بدأ يكبر مع الأيام فالمغناطيس ارتخى أو المفتاح بدأ يتلف، وتعرف ذلك قبل أن يتعطل. ثم مخرج خدمة الاستقبال:
mode front = away
status front = online
event front #1 boot closed changes=0
event front #2 change open changes=1
PUSH p5 Door opened while away
event front #3 change closed changes=1
event front #4 change open changes=11
rate limit: dropped 'Door opened while away'
event front #5 change closed changes=5
mode front = home
event front #6 change open changes=1
PUSH p3 Door opened at night
event front #7 change closed changes=1
event front #8 heartbeat closed changes=0
event front #9 change open changes=1
rate limit: dropped 'Door opened at night'
PUSH p4 Door left open
event front #10 heartbeat open changes=0
event front #11 heartbeat open changes=0
status front = offline
PUSH p3 Door sensor offlineولنقرأ قراراتها سطراً سطراً:
- الفتح الأول والوضع away: تنبيه بالأولوية 5، وهو ما نريده بالضبط.
- الفتح الثاني بعد تسع ثوان: لم يرسل، لأن حد الإرسال
RATE_Sستون ثانية لكل نوع من التنبيهات. وهذا قرار تصميم عليك أن تفكر فيه: من وصله تنبيه بأعلى أولوية قبل ثوان لا يحتاج تنبيهاً ثانياً عن الحادثة نفسها، ولكن لو جعلت الحد ساعة فقد يخفي حادثة ثانية حقيقية، فاختر المدة التي تعرف فيها أن التنبيهين حادثة واحدة. - الفتح في الوضع home: وصل تنبيه «Door opened at night» بالأولوية 3، لأن التشغيل كان بعد الساعة 23 بساعة الحاوية، وهي داخل ساعات الليل في السياسة. وانتبه هنا: ساعة الحاوية UTC ما لم تضبط المتغير
TZ، فإذا كانت منطقتك الزمنية بعيدة عن UTC فالليل عند السياسة ليس الليل عندك، فاضبطTZفيcompose.yamlلخدمة الاستقبال قبل أن تثق بساعات الليل. - الفتح الأخير: لم يرسل تنبيه الليل لأنه بعد أقل من دقيقة من سابقه، وبعد 15 ثانية من بقاء الباب مفتوحاً وصل «Door left open» بالأولوية 4.
- الانقطاع: «Door sensor offline» بالأولوية 3، وسنعود إليه في القسم التالي.
ولم يظهر سطر «dedupe» في هذا التشغيل، لأن إزالة الارتداد في الجهاز منعت أن تصل الحالة نفسها مرتين متتاليتين. ومع ذلك نبقيه في السيرفر، لأن الحالة نفسها قد تصل مرتين لأسباب أخرى: جهاز يعيد الإرسال بعد انقطاع الشبكة لأنه لم يستلم التأكيد، أو برنامج حساس فيه خطأ، أو حساس ثان على الباب نفسه. والقاعدة أن السيرفر لا يثق بأن الجهاز مثالي. وما وصل إلى الجوال كما يلي:
event messages stored: 11 (7 door changes)
### notifications on ntfy topic 'door'
[p5] Door opened while away: front: the door was opened
[p3] Door opened at night: front: the door was opened
[p4] Door left open: front: open for more than 15 s
[p3] Door sensor offline: front: no connection from the door sensor
total: 4 notifications
### policy.decide(mode, 'open', hour)
away 08h=p5 14h=p5 22h=p5 23h=p5 02h=p5 05h=p5 06h=p5
home 08h=- 14h=- 22h=- 23h=p3 02h=p3 05h=p3 06h=-أربعة تنبيهات بدل 21، وكل واحد منها يقول شيئاً يحتاج إنساناً، وبأولوية تناسبه. وآخر سطرين في المخرج اختبار دالة السياسة وحدها في ساعات مختلفة من اليوم: في الوضع away كل فتح بالأولوية 5 في أي ساعة، وفي الوضع home لا شيء في النهار، والأولوية 3 من الساعة 23 إلى ما قبل 6. وهذا الاختبار لا يحتاج باباً ولا جوالاً ولا محاكياً، ويستحق أن يكون أول ما تكتبه إذا غيرت السياسة يوماً.
الجهاز الذي انقطع
في آخر سطرين من مخرج خدمة الاستقبال في التشغيلين ظهرت الحالة offline وتنبيه «Door sensor offline». ولم يرسل الجهاز هذه الرسالة، وإنما أرسلها الوسيط نيابة عنه: عندما اتصل الجهاز سجل عند الوسيط وصية أخيرة Last Will، وهي رسالة offline على الموضوع status، والوسيط ينشرها عندما ينقطع اتصال الجهاز دون أن يودع. وفي المختبر انتهت مدة QEMU فأوقفه الأمر timeout، فانقطع الاتصال فجأة كما ينقطع عندما تنفد البطارية أو ينقطع Wi-Fi، فنشر الوسيط الوصية، ووصل التنبيه.
ولكن انتبه إلى ما يعنيه هذا للجهاز الحقيقي الذي ينام، فهو يقطع الاتصال بنفسه قبل كل نوم برسالة DISCONNECT، وفي MQTT الوداع النظيف يلغي الوصية، فلن تصدر وصية لجهاز ينام أبداً، حتى لو نفدت بطاريته وهو نائم. وحتى للجهاز المتصل دائماً، الاتصال الذي يموت بصمت، كجهاز فصلت عنه الكهرباء، لا يكتشفه الوسيط إلا بعد مرة ونصف من مدة Keepalive، وهي 30 ثانية في برنامجنا، أي 45 ثانية تقريباً. ولهذا في الحساس النائم لا تعتمد على الوصية، وإنما على نبضة الحياة كل 6 ساعات، وعلى السيرفر أن يراقب غيابها: إذا لم تصل أي رسالة من الحساس مدة أطول من نبضتين، فهو معطل حتى يثبت العكس، وهذا أول تمرين في آخر المقال. والقاعدة التي تخرج بها: الجهاز الصامت لا يخبرك بشيء، فلا بد أن يكون في النظام طرف يلاحظ الصمت.
كم تعيش البطارية؟
والآن نحسب عمر البطارية، وأكرر أنه تقدير لا قياس: كل رقم في الملف battery.py إما من ورقة بيانات ESP32، وإما افتراض مكتوب بجانبه، وأهم افتراض فيه مدة الاستيقاظ وتيارها، لأن الاتصال بشبكة Wi-Fi يأخذ وقتاً مختلفاً من شبكة إلى أخرى:
"""How long does the battery last? An estimate, not a measurement: every input below is either from the ESP32
datasheet (v5.3) or an assumption that is written next to it. Measure your own board and replace the numbers."""
CAPACITY_MAH = 2500 * 0.8 # assumption: one 18650 Li-ion cell of 2500 mAh, 80% of it usable
CHIP_SLEEP_UA = 10 # datasheet, Table 4-2: Deep-sleep, RTC timer + RTC memory
LDO_UA = 2 # assumption: a regulator with a quiescent current of a few uA (read its datasheet)
DIVIDER_UA = 3.7 / 2.0 # 1 Mohm + 1 Mohm across a 3.7 V cell: 1.85 uA, all the time
WAKE_S, WAKE_MA = 3, 100 # assumption: 3 s awake for Wi-Fi + MQTT at ~100 mA average
# (datasheet: Wi-Fi receive 95-100 mA, transmit up to 240 mA)
def days(sleep_ua, changes_per_day, heartbeats_per_day=4):
sleep_mah = sleep_ua / 1000 * 24
wake_mah = (changes_per_day + heartbeats_per_day) * WAKE_S / 3600 * WAKE_MA
total = sleep_mah + wake_mah
return total, CAPACITY_MAH / total, sleep_mah, wake_mah
cases = [
("internal pull-up 45k, door closed", CHIP_SLEEP_UA + 3.3 / 45 * 1000 + DIVIDER_UA + LDO_UA, 20),
("external pull-up 1M", CHIP_SLEEP_UA + 3.3 + DIVIDER_UA + LDO_UA, 20),
("external pull-up 1M, busy door", CHIP_SLEEP_UA + 3.3 + DIVIDER_UA + LDO_UA, 100),
("dev board drawing 5 mA asleep (example)", 5000, 20),
]
print(f"{'case':42s} {'sleep uA':>9s} {'mAh/day':>8s} {'(sleep+wake)':>14s} {'days':>6s}")
for name, ua, changes in cases:
total, d, s, w = days(ua, changes)
print(f"{name:42s} {ua:9.1f} {total:8.2f} {s:6.2f}+{w:<6.2f} {d:6.0f}")والمخرج سوف يكون كما يلي:
case sleep uA mAh/day (sleep+wake) days
internal pull-up 45k, door closed 87.2 4.09 2.09+2.00 489
external pull-up 1M 17.1 2.41 0.41+2.00 829
external pull-up 1M, busy door 17.1 9.08 0.41+8.67 220
dev board drawing 5 mA asleep (example) 5000.0 122.00 120.00+2.00 16والأرقام تقول عدة أشياء:
- المقاومة الرافعة الداخلية: بها يستهلك الحساس في النوم 87 مايكرو أمبير، فيعيش قرابة 489 يوماً، ومع مقاومة 1 ميغا أوم ينزل النوم إلى 17 مايكرو أمبير فيعيش قرابة 829 يوماً، أي أن مقاومة واحدة تزيد العمر سبعين في المئة تقريباً.
- بعد إصلاح النوم يصبح الاستيقاظ هو المشكلة: في الحالة الثانية النوم 0.41 ملي أمبير ساعة في اليوم، والاستيقاظ 2.00، أي خمسة أضعافه، فكل ثانية تقصرها من الاستيقاظ أهم من أي مايكرو أمبير توفره في النوم.
- الباب المزدحم: مئة فتح وإغلاق في اليوم، كباب مطبخ في بيت فيه أطفال، تنزل العمر إلى 220 يوماً، فالمشروع نفسه يعيش سنتين على باب وأشهراً على آخر.
- لوحة التطوير: لو كانت لوحتك تستهلك 5 ملي أمبير وهي نائمة، وهو رقم مثال لا قياس، فالبطارية نفسها تعيش 16 يوماً، وهذا هو سبب أن تقيس اللوحة التي ستضعها على الباب قبل أن تثق بأي حساب.
وهذه الأرقام أفضل من الواقع، لأنها لا تحسب التفريغ الذاتي للبطارية، ولا أثر الحرارة، ولا أن السعة الحقيقية قد تكون أقل من المكتوبة. ولهذا نرسل جهد البطارية مع كل رسالة، وخدمة الاستقبال ترسل تنبيهاً إذا نزل عن 3500 ملي فولت، فتعرف أن البطارية تقترب من نهايتها قبل أن يصمت الحساس.
ملاحظة على الخصوصية والأمان
حساس الباب يعرف متى يخرج أهل البيت ومتى يرجعون، ومتى يكون البيت فارغاً، وهذه معلومات لا تريدها في يد أحد. ولهذا ثلاثة أمور قبل أن تضع المشروع في بيتك:
- الوسيط: المختبر يقبل أي اتصال دون كلمة مرور لأنه داخل Docker فقط، وفي البيت ضع كلمات مرور وصلاحيات لكل جهاز، وTLS إذا خرجت الرسائل من شبكتك، كما في مقال أمن إنترنت الأشياء.
- خادم التنبيهات: في خدمة ntfy العامة أي شخص يعرف اسم الموضوع يستطيع أن يقرأ رسائله، فإما أن تشغل ntfy على سيرفرك بصلاحيات، وإما أن تختار اسماً طويلاً عشوائياً لا يخمن، ولا تكتب في الرسالة ما لا تريد أن يقرأه غيرك.
- شبكة الأجهزة: ضع أجهزة البيت الذكية في شبكة منفصلة عن أجهزتك الشخصية إن استطعت، فالجهاز الرخيص الذي لا يحدث برنامجه بوابة سهلة إلى الشبكة كلها.
الأخطاء الشائعة
- الاعتماد على المقاومة الرافعة الداخلية في جهاز البطارية: 73 مايكرو أمبير طوال اليوم والباب مغلق، كما حسبنا.
- قياس تيار لوحة التطوير والظن أنه تيار الشريحة: المنظم وشريحة USB على اللوحة يستهلكان والشريحة نائمة، فقس اللوحة التي ستضعها على الباب فعلاً.
- النوم قبل وصول الرسالة: النشر في MQTT لا يعني أن الرسالة وصلت، فانتظر التأكيد في QoS 1 قبل النوم.
- الاعتماد على الوصية الأخيرة مع جهاز ينام: الجهاز الذي يقطع الاتصال بنفسه قبل كل نوم لا تصدر له وصية أبداً، فتحتاج نبضة حياة ومراقبة غيابها في السيرفر.
- تنبيه لكل رسالة: الارتداد، وإعادة الإرسال بعد انقطاع الشبكة، والرسالة المحفوظة عند كل اشتراك، كلها ترسل الحالة نفسها أكثر من مرة، فاحذف التكرار في السيرفر حتى لو أصلحت الجهاز.
- الأولوية نفسها لكل شيء: إذا كان كل تنبيه بأعلى صوت فستكتم التطبيق كله، وتضيع معه التنبيهات المهمة.
- المغناطيس بعيد أو الباب معدني: جرب المسافة والباب مغلق ومفتوح قبل التثبيت، وتأكد أن الحالة تتغير في السيرفر في الاتجاهين.
تطبيق عملي
- أضف إلى
ingest.pyمراقبة الغياب: إذا لم تصل أي رسالة من الجهاز مدة أطول من نبضتي حياة، أرسل تنبيه «Door sensor silent». وجربها بأن تقصر النبضة في المحاكاة وتوقف QEMU قبل موعدها. - في
policy.pyأضف وضعاً ثالثاً اسمهnightيرسل كل فتح بأولوية 4، واكتب له سطراً في اختبارreport.py. - أضف إلى جدول الباب في
door.cباباً يرتد 60 ملي ثانية بدل 20، وتوقع قبل التشغيل كم رسالة سيرسل الجهاز بإزالة ارتداد 50 ملي ثانية، ثم شغله وقارن. - غير في
battery.pyمدة الاستيقاظ من 3 ثوان إلى 6 ثوان، وانظر كم يتغير عمر البطارية، ثم فكر: ما الذي في البرنامج يجعل الاستيقاظ أقصر؟ - إذا كان عندك ESP32 ومفتاح ريد: ابن النسخة الحقيقية وقس تيار النوم بالمقياس المتعدد، مرة بالمقاومة الرافعة الداخلية ومرة بمقاومة 1 ميغا أوم.
حذف المختبر Cleanup
docker compose down
docker image rm door-ingest:1
rm -rf data firmware/build-hw firmware/build-sim sleeptest/buildالأوامر تحذف الحاويات والـ Image الخاصة بخدمة الاستقبال وملفات البناء، وتبقى صورة espressif/idf لأنها مشتركة مع مشاريع ESP32 الأخرى في هذا المسار، فإذا لم تعد تحتاجها فاحذفها بالأمر docker image rm espressif/idf:v5.4.1.
الخلاصة Summary
- حساس الباب مفتاح ريد على الإطار ومغناطيس على الباب، والمتحكم يقرأ المفتاح من رجل RTC ليستيقظ بها من النوم العميق.
- البطارية هي التي تقرر التصميم: نوم عميق بين التغييرات، واستيقاظ ثوان قليلة، ونبضة حياة كل 6 ساعات.
- المقاومة الرافعة الداخلية 45 كيلو أوم تستهلك 73 مايكرو أمبير والباب مغلق، ومقاومة خارجية 1 ميغا أوم تنزلها إلى 3.3، وفي الحساب زاد العمر من 489 يوماً إلى 829.
- QEMU من Espressif لا يحاكي النوم العميق، فاختبرنا النوم بالبناء فقط، وكل ما بعد الجهاز اختبرناه كاملاً.
- قرار التنبيه في السيرفر لا في الجهاز: الوضع، وساعات الليل، وحذف التكرار، وحد الإرسال، وأولوية ntfy المناسبة لكل حالة.
- الوصية الأخيرة لا تصدر لجهاز يودع قبل أن ينام، فراقب غياب نبضة الحياة في السيرفر.
وهذا المشروع جزء من سلسلة مشاريع إنترنت الأشياء، وفيها مشاريع للبيت وأخرى للمحلات والمستودعات، وكلها مبنية على الأساس نفسه: جهاز صغير يقيس، ووسيط، وخدمة تقرر، وتنبيه لا يصل إلا عندما يحتاج إنساناً.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وبناء البرنامج على ESP-IDF v5.4.1 وتشغيله على QEMU من Espressif، مع Mosquitto 2.1.2 وntfy v2.11.0 وpaho-mqtt 2.2.0 في Docker Engine 29.8.0.