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

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

وقد يتساءل البعض: لماذا لا نضع كاميرا صغيرة ونعد الوجوه بنموذج ذكاء اصطناعي؟ والإجابة أن المطلوب هنا رقم، وليس صورة، والكاميرا تجمع ما لا تحتاجه: وجوه الزبائن، وأوقات دخولهم، ومن كان مع من. وهذه بيانات شخصية تخضع لأنظمة حماية البيانات الشخصية، ومنها في المملكة نظام حماية البيانات الشخصية الذي تشرف عليه الهيئة السعودية للبيانات والذكاء الاصطناعي، فتحتاج لوحات تنبه الزبائن، وسياسة لمدة الحفظ، وحماية لملفات الفيديو، وكل هذا لكي تحصل على رقم تستطيع أن تحصل عليه دون أن تعرف من هو صاحبه. والشعاع لا يرى إلا أن شيئاً قطعه، ولا يحفظ شيئاً عن أحد، فإذا سرق الجهاز أو اخترق فكل ما فيه أرقام. والقاعدة التي نعمل بها في هذا المشروع: لا تجمع بيانات لا تحتاجها، والسبب أن البيانات التي لم تجمعها لا يمكن أن تتسرب.
ولكن الشعاع أقل دقة من الكاميرا الجيدة، ولن نخفي ذلك، ففي آخر المقال سوف نرى بالأرقام كم يخطئ، وأين، ولماذا.
الشعاعان: للتجربة وللباب الحقيقي
الحساس هنا زوج: مرسل Emitter يخرج ضوءاً تحت أحمر لا تراه العين، ومستقبل Receiver في الجهة المقابلة يخبرك هل يصله الضوء أم أن شيئاً يقطعه. وللتجربة على الطاولة تجد أزواجاً صغيرة للهواة، ومن أشهرها زوج Adafruit بمؤشر 5 ملم، ومواصفاته كما في صفحة المنتج:
- جهد التشغيل: من 3.3 إلى 5.5 فولت، والصفحة تنصح بخمسة فولت لمدى أطول.
- المدى: قرابة 50 سم، وللنسخة الأصغر بمؤشر 3 ملم قرابة 25 سم.
- المخرج: ترانزستور مفتوح المجمع Open Collector، أي أنه يسحب السلك إلى الأرضي فقط، ويحتاج مقاومة رافعة Pull-up لكي يصبح HIGH، وفي دليلهم يصبح المخرج LOW عندما ينقطع الشعاع.
- زمن الاستجابة: أقل من 2 ملي ثانية، وهذا أسرع بكثير مما نحتاجه لشخص يمشي.
وخمسون سنتيمتراً تكفي لممر ضيق أو لتجربة على الطاولة، ولا تكفي لباب محل عرضه متر أو أكثر، ولهذا يستخدم الباب الحقيقي حساساً كهروضوئياً Photoelectric Sensor من نوع المصانع، والصورة التالية لواحد منها من النوع العاكس Reflex، وفيه المرسل والمستقبل في علبة واحدة على جهة من الباب، وعاكس صغير في الجهة الأخرى يعيد الضوء:

لاحظ على الملصق أن هذا الحساس يعمل من 10 إلى 30 فولت، ومخرجه بجهد التشغيل نفسه، ورجل ESP32 لا تتحمل أكثر من 3.3 فولت، ولهذا لا تصله بالمتحكم مباشرة، وإنما عبر عازل ضوئي Optocoupler أو دارة تحويل مستوى Level Shifter، وتغذيه من مزود 12 أو 24 فولت مستقل. والبرنامج لا يتغير بين الحساسين، فكلاهما في النهاية رجل رقمية تصبح LOW أو HIGH، وهذا ما يجعل التجربة على الطاولة بالزوج الصغير صادقة: الكود نفسه سيعمل على الباب.
والتوصيل نفسه بسيط: مستقبل الشعاع A على الرجل GPIO32، ومستقبل الشعاع B على الرجل GPIO33، مع المقاومة الرافعة الداخلية في الشريحة، ولهاتين الرجلين مقاومة رافعة داخلية بخلاف الأرجل من 34 إلى 39 التي لا تملكها، كما ذكرنا في مقال الأرجل الرقمية. والمقاومة الداخلية ضعيفة، فإذا كان السلك من الباب إلى المتحكم طويلاً فأضف مقاومة 10 كيلو أوم إلى 3.3 فولت لكل مستقبل، لأن السلك الطويل يلتقط التشويش، والمقاومة الأقوى تثبت المستوى.
وأين تضع الشعاعين؟ الشكل التالي يبين المدخل من الأعلى: الشعاع A في جهة الشارع، والشعاع B في جهة المحل، وبينهما عشرة سنتيمترات:

- المسافة بين الشعاعين: أقل من عمق جسم الإنسان، وهو قرابة 25 إلى 40 سم من الأمام إلى الخلف، لكي يقطع الجسم الواحد الشعاعين معاً في لحظة ما، وأكبر من أن ينقطعا في اللحظة نفسها. وعشرة سنتيمترات لشخص يمشي بسرعة 1.5 متر في الثانية تعطي قرابة 67 ملي ثانية بين انقطاع A وانقطاع B، وهذا وقت كاف ليعرف المتحكم أيهما سبق.
- الارتفاع: قرار تتخذه أنت، فالشعاع على ارتفاع الصدر لا يقطعه طفل صغير، والشعاع المنخفض تقطعه الحقائب المتدلية والأرجل المتباعدة أكثر من مرة. واختر ارتفاعاً واحداً للشعاعين، واكتب في التقرير ما الذي يعده، لأن الرقم الذي لا تعرف ماذا يعد لا تستطيع أن تقارنه بشيء.
- الضوء والزجاج: ضوء الشمس فيه أشعة تحت حمراء قد تصل المستقبل، والباب الزجاجي قد يعكس الشعاع، فلا توجه المستقبل نحو الشارع المشمس، واختبر الشعاع عند الظهر قبل أن تعتمد على أرقامه.
لماذا لا يكفي شعاع واحد؟
الحل البسيط الذي يبدأ به الجميع شعاع واحد وعداد يزيد مع كل انقطاع، وهو ما تجده في أغلب أمثلة الإنترنت. ولكن هذا العداد يعد انقطاعات، وليس أشخاصاً، والفرق بينهما كبير:
- الخارج يعد مثل الداخل: كل زبون يقطع الشعاع مرتين، مرة عند الدخول ومرة عند الخروج، فيتضاعف الرقم.
- الواقف عند الباب يعد: من نظر من الباب ثم مشى قطع الشعاع ولم يدخل.
- عربة التسوق تعد عدة مرات: شبك العربة، كالتي في الصورة التالية، يقطع الشعاع ويتركه كلما مر سلك من أسلاكه، فيرى العداد عدة انقطاعات قصيرة متتالية.

والإصلاح المشهور أن تقسم الرقم على اثنين، على افتراض أن كل زائر دخل وخرج، وسوف نرى في المختبر أن هذا الإصلاح يقرب الرقم اليومي أحياناً، ولكنه لا يعطيك أهم ما تريد: من في المحل الآن، ومتى دخل الناس ومتى خرجوا. ولهذا نحتاج شعاعين.
آلة الحالات: من الانقطاع إلى الدخول
الشكل السابق يبين الفكرة: الداخل يقطع A أولاً، ثم يقطع الشعاعين معاً، ثم يبقى في B وحده، ثم يتركهما، والخارج يمر بالترتيب المعاكس. وأنسب طريقة لكتابة هذا المنطق آلة حالات State Machine، أي متغير واحد يحفظ أين وصل الشخص في التسلسل، وكل تغير في الشعاعين ينقله إلى حالة أخرى، أو يعيده خطوة إلى الخلف، أو يعد دخولاً عندما يكتمل التسلسل. والملف counter.h يعرف الواجهة:
#pragma once
#include <stdint.h>
#include <stdbool.h>
// Direction counter with two beams: A on the street side, B on the shop side, 10 cm apart.
// Someone walking in breaks A, then A and B, then only B, then neither: one "in". Walking out is the mirror.
#define FILTER_US 30000 // a beam change must last 30 ms to be accepted; shorter changes are glitches
typedef struct {
int in, out, occ; // the two-beam counter: entries, exits, people inside now
int naive_breaks; // what a one-beam counter sees: every break of beam A, unfiltered
int glitches, tailgates, abandoned, underflow;
} counts_t;
void counter_edge(int beam, bool broken, int64_t t_us); // raw change from a beam (0 = A, 1 = B)
void counter_advance(int64_t now_us); // accept the changes that have lasted FILTER_US
const counts_t *counter_get(void);
bool counter_busy_since(int64_t *since_us); // is a beam broken now, and since when
int counter_close(void); // closing time: returns occupancy before the reset to 0والملف counter.c فيه المنطق كله، دون أي سطر يعرف شيئاً عن الشبكة أو عن نوع الحساس:
#include "counter.h"
typedef enum { IDLE, IN1, IN2, IN3, OUT1, OUT2, OUT3, UNKNOWN } state_t;
static state_t st = IDLE;
static counts_t c;
static bool lvl[2]; // accepted level of each beam: true = broken
static struct { bool level, pending; int64_t t; } p[2]; // a change waiting to last FILTER_US
static int64_t last_change[2]; // when each beam last changed
static void enter(void) { c.in++; c.occ++; }
static void leave(void) { c.out++; if (c.occ > 0) c.occ--; else c.underflow++; }
// The state machine, called after every accepted change with the two levels (a = beam A broken, b = beam B broken).
static void step(bool a, bool b) {
switch (st) {
case IDLE: st = a && !b ? IN1 : !a && b ? OUT1 : a && b ? UNKNOWN : IDLE;
break;
case IN1: if (!a && !b) { c.abandoned++; st = IDLE; } // broke A and stepped back: no entry
else if (a && b) st = IN2; else if (!a && b) st = IN3;
break;
case IN2: if (a && !b) st = IN1; else if (!a && b) st = IN3; // one step back, or on
else if (!a && !b) { c.abandoned++; st = IDLE; }
break;
case IN3: if (!a && !b) { enter(); st = IDLE; } // left B last: one person in
else if (a && b) { enter(); c.tailgates++; st = IN2; } // A broken again: a second body behind
break;
case OUT1: if (!a && !b) { c.abandoned++; st = IDLE; }
else if (a && b) st = OUT2; else if (a && !b) st = OUT3;
break;
case OUT2: if (!a && b) st = OUT1; else if (a && !b) st = OUT3;
else if (!a && !b) { c.abandoned++; st = IDLE; }
break;
case OUT3: if (!a && !b) { leave(); st = IDLE; }
else if (a && b) { leave(); c.tailgates++; st = OUT2; }
break;
case UNKNOWN: if (!a && !b) st = IDLE; break; // both at once: no direction, no count
}
}
void counter_advance(int64_t now) {
for (;;) { // accept the pending changes in time order, oldest first
int k = -1;
for (int b = 0; b < 2; b++)
if (p[b].pending && now - p[b].t >= FILTER_US && (k < 0 || p[b].t < p[k].t)) k = b;
if (k < 0) return;
p[k].pending = false;
if (lvl[k] != p[k].level) { lvl[k] = p[k].level; last_change[k] = p[k].t; step(lvl[0], lvl[1]); }
}
}
void counter_edge(int beam, bool broken, int64_t t) {
if (beam == 0 && broken) c.naive_breaks++; // the one-beam counter counts every raw break of A
counter_advance(t);
if (p[beam].pending) { p[beam].pending = false; c.glitches++; return; } // two changes within 30 ms: drop both
p[beam].level = broken; p[beam].t = t; p[beam].pending = true;
}
const counts_t *counter_get(void) { return &c; }
bool counter_busy_since(int64_t *since) { // the beam that has been broken the longest, if any
if (lvl[0] && (!lvl[1] || last_change[0] <= last_change[1])) { *since = last_change[0]; return true; }
if (lvl[1]) { *since = last_change[1]; return true; }
return false;
}
int counter_close(void) { int drift = c.occ; c.occ = 0; return drift; }في الكود أعلاه لاحظ التالي:
- الحالات:
IN1وIN2وIN3هي الخطوات الثلاث للدخول، وOUT1إلىOUT3للخروج، وفي كل حالة لا تتحرك الآلة إلا إلى الأمام أو خطوة إلى الخلف، فمن تقدم ثم تراجع قليلاً لا يضيع ولا يعد مرتين. - من تراجع إلى الشارع: إذا ترك A وهو في
IN1قبل أن يصل B فهو لم يدخل، ويزيد العدادabandonedفقط، وهذا من نظر من الباب ومشى. - من وقف في الباب: لا يوجد في الآلة وقت انتهاء Timeout، فمن وقف عند A عشرين ثانية يبقى في
IN1حتى يتحرك، ثم يعد إذا دخل ولا يعد إذا رجع. والوقت الوحيد الذي نراقبه هو الشعاع المقطوع أكثر من دقيقة، وسنراه فيmain.c. - شخصان متتاليان: إذا كانت الآلة في
IN3، أي أن الأول ترك A وما زال في B، ثم انقطع A من جديد، فهذا جسم ثان خلفه، فيعد الأول ويبدأ الثاني منIN2. وهذه القاعدة هي ما يفرق بين شخصين يمشي أحدهما خلف الآخر. - الحالة
UNKNOWN: إذا انقطع الشعاعان في اللحظة نفسها فلا يوجد اتجاه، والآلة تنتظر حتى يفرغ الباب ولا تعد شيئاً، والسبب أن العد الخطأ أسوأ من عدم العد، لأنه لا يظهر في أي مكان. - المرشح Filter: أي تغير في الشعاع لا يقبل إلا بعد أن يستمر 30 ملي ثانية، فإذا جاء تغير ثان قبل ذلك ألغي الاثنان، وهذا ما يحمي العد من ومضات شبك العربة. واختيار الرقم 30 ليس عشوائياً: فجوة الشبك في نموذجنا 15 ملي ثانية، والفرق بين انقطاع A وانقطاع B لأسرع ماش في النموذج 67 ملي ثانية كما حسبنا، فالرقم بينهما، وأي فجوة بين شخصين متتاليين أقصر منه تعد ظلاً واحداً.
- العداد البسيط داخل الملف نفسه:
naive_breaksيزيد مع كل انقطاع خام للشعاع A قبل المرشح، وهو العداد البسيط بشعاع واحد، وبهذا نقارن الطريقتين على الأحداث نفسها بالضبط.
والشكل التالي يبين ما يراه الشعاعان في أربع حالات من نموذج المختبر، بسرعة مشي 1.2 متر في الثانية وعمق جسم 30 سم:

لاحظ الحالة الثالثة: شخصان بينهما 0.12 ثانية، أي يكاد الثاني يلتصق بالأول، فيرى كل شعاع انقطاعاً واحداً طويلاً، ولا توجد طريقة في الدنيا يعرف بها شعاعان أن هذا الظل لشخصين. وهذا حد حقيقي للطريقة، ومثله الطفل الذي يمشي بجانب أمه في الصف نفسه، وسوف نرى أثرهما في أرقام اليوم.
بقية الكود: الأرجل، واليوم المحاكى، والشبكة
الملف beams.c له نسختان. نسخة اللوحة الحقيقية تسجل مقاطعة Interrupt على كل تغير في الرجلين، وتضع التغير مع وقته في طابور Queue، ومهمة FreeRTOS تأخذ من الطابور وتغذي العداد، وتنادي الدالة on_minute مع بداية كل دقيقة من ساعة الجهاز التي يضبطها SNTP. ونسخة المحاكاة، عند تعريف SENSOR_SIM، تصنع يوماً كاملاً لمحل من التاسعة صباحاً إلى الحادية عشرة مساءً، لأن QEMU لا يحتوي شعاعاً يقطعه أحد:
#include "beams.h"
#include "counter.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#ifndef SENSOR_SIM
#include <time.h>
#include "freertos/queue.h"
#include "driver/gpio.h"
#include "esp_timer.h"
#define PIN_A GPIO_NUM_32 // receiver of beam A (street side), open collector: LOW while the beam is broken
#define PIN_B GPIO_NUM_33 // receiver of beam B (shop side)
typedef struct { int beam; bool broken; int64_t t; } edge_t;
static QueueHandle_t q;
static minute_cb cb;
static void IRAM_ATTR on_edge(void *arg) {
int beam = (int)arg;
edge_t e = { beam, gpio_get_level(beam ? PIN_B : PIN_A) == 0, esp_timer_get_time() };
xQueueSendFromISR(q, &e, NULL);
}
static void beams_task(void *arg) {
edge_t e;
int last_min = -1;
for (;;) {
if (xQueueReceive(q, &e, pdMS_TO_TICKS(10))) counter_edge(e.beam, e.broken, e.t);
int64_t now = esp_timer_get_time();
counter_advance(now);
time_t t = time(NULL);
struct tm tm;
localtime_r(&t, &tm);
int m = tm.tm_hour * 60 + tm.tm_min;
if (m != last_min && tm.tm_year > 120) { last_min = m; cb(m, now); } // only once SNTP has set the clock
}
}
void beams_start(minute_cb on_minute) {
cb = on_minute;
q = xQueueCreate(64, sizeof(edge_t));
gpio_config_t io = { .pin_bit_mask = (1ULL << PIN_A) | (1ULL << PIN_B), .mode = GPIO_MODE_INPUT,
.pull_up_en = GPIO_PULLUP_ENABLE, .intr_type = GPIO_INTR_ANYEDGE };
gpio_config(&io); // internal pull-ups are weak: on long cables add 10k to 3.3 V
gpio_install_isr_service(0);
gpio_isr_handler_add(PIN_A, on_edge, (void *)0);
gpio_isr_handler_add(PIN_B, on_edge, (void *)1);
xTaskCreate(beams_task, "beams", 4096, NULL, 10, NULL);
}
bool beams_truth(int *in, int *out) { return false; }
#else
// ---------------------------------------------------------------------------------------------------------------
// A simulated shop day, 09:00 to 23:00, from a fixed seed so every run is the same day. Each visitor group walks
// through the two beams on the way in and on the way out. The kinds of groups:
// 0 single person, 1 single who stops in the doorway 5-20 s, 2 two people 0.29-0.6 s apart,
// 3 two people 0.12 s apart (their bodies overlap in the beams), 4 a child beside an adult (one shadow for two),
// 5 a trolley pushed by a person (wire mesh: four 15 ms gaps), 6 a passer-by who breaks beam A and walks away.
// Plus at 15:00 a delivery box left in beam A for 3 minutes.
#include <stdlib.h>
#include <string.h>
#define US(s) ((int64_t)((s) * 1e6))
#define OPEN (9 * 60)
#define CLOSE (23 * 60)
#define SPACING 0.10 // m between beam A and beam B
typedef struct { int64_t s, e; int beam; } iv_t;
typedef struct { int64_t t; int persons, dir; } pass_t;
typedef struct { int64_t t; int beam; bool broken; } ev_t;
static iv_t *iv; static int niv, cap_iv;
static pass_t *ps; static int nps, cap_ps;
static int truth_in, truth_out;
static uint32_t seed = 20261111;
static double rnd(void) { seed ^= seed << 13; seed ^= seed >> 17; seed ^= seed << 5; return (seed % 1000000) / 1e6; }
static double uni(double a, double b) { return a + (b - a) * rnd(); }
static void add_iv(int beam, int64_t s, int64_t e) {
if (niv == cap_iv) iv = realloc(iv, (cap_iv = cap_iv ? cap_iv * 2 : 1024) * sizeof *iv);
iv[niv++] = (iv_t){ s, e, beam };
}
static void add_pass(int64_t t, int persons, int dir) {
if (nps == cap_ps) ps = realloc(ps, (cap_ps = cap_ps ? cap_ps * 2 : 512) * sizeof *ps);
ps[nps++] = (pass_t){ t, persons, dir };
}
// One body through both beams. dir 1 = in (A first), -1 = out (B first). stand: seconds stopped at the first beam.
static void body(double t, int dir, double depth, double stand, bool mesh, int persons) {
double v = uni(0.8, 1.5); // walking speed, m/s
int first = dir > 0 ? 0 : 1;
double t2 = t + stand + SPACING / v; // the second beam is reached here
for (int k = 0; k < 2; k++) {
double s = k ? t2 : t, e = (k ? t2 : t + stand) + depth / v;
int beam = k ? 1 - first : first;
if (mesh) { // a trolley basket: the beam sees through the mesh 4 times
double m = s + 0.6 / v;
double step = (m - s) / 5;
for (int g = 1; g <= 4; g++) { double gt = s + step; add_iv(beam, US(s), US(gt)); s = gt + 0.015; }
}
add_iv(beam, US(s), US(e));
}
if (persons) add_pass(US(t2 + depth / v), persons, dir);
}
static void group(double t, int kind, int dir) {
switch (kind) {
case 0: body(t, dir, uni(0.25, 0.40), 0, false, 1); break;
case 1: body(t, dir, uni(0.25, 0.40), dir > 0 ? uni(5, 20) : 0, false, 1); break;
case 2: { double o = uni(0.29, 0.6); body(t, dir, 0.3, 0, false, 1); body(t + o, dir, 0.3, 0, false, 1); } break;
case 3: body(t, dir, 0.3, 0, false, 1); body(t + 0.12, dir, 0.3, 0, false, 1); break;
case 4: body(t, dir, 0.35, 0, false, 2); break;
case 5: body(t, dir, 0.9, 0, true, 1); break;
case 6: if (dir > 0) add_iv(0, US(t), US(t + uni(2, 6)));
break;
}
}
static const int rate[24] = { [9] = 4, 8, 12, 18, 20, 12, 10, 12, 18, 24, 30, 30, 20, 8 }; // groups per hour
static int cmp_iv(const void *a, const void *b) {
const iv_t *x = a, *y = b;
return x->beam != y->beam ? x->beam - y->beam : (x->s > y->s) - (x->s < y->s);
}
static int cmp_ev(const void *a, const void *b) { const ev_t *x = a, *y = b; return (x->t > y->t) - (x->t < y->t); }
static int cmp_ps(const void *a, const void *b) { const pass_t *x = a, *y = b; return (x->t > y->t) - (x->t < y->t); }
static ev_t *make_day(int *n) {
for (int m = OPEN; m < CLOSE - 30; m++) // no new visitors in the last half hour
for (int slot = 0; slot < 10; slot++) {
if (rnd() >= rate[m / 60] / 600.0) continue;
double t = m * 60.0 + slot * 6 + uni(0, 6), r = rnd();
int kind = r < .66 ? 0 : r < .71 ? 1 : r < .81 ? 2 : r < .85 ? 3 : r < .89 ? 4 : r < .95 ? 5 : 6;
group(t, kind, 1);
if (kind == 6) continue;
double out = t + uni(5, 35) * 60;
if (out > (CLOSE - 5) * 60) out = (CLOSE - 5) * 60 - uni(0, 600);
group(out, kind == 1 ? 0 : kind, -1);
}
add_iv(0, US(15 * 3600), US(15 * 3600 + 180)); // the delivery box
qsort(iv, niv, sizeof *iv, cmp_iv);
qsort(ps, nps, sizeof *ps, cmp_ps);
ev_t *ev = malloc(2 * niv * sizeof *ev);
int k = 0;
for (int i = 0; i < niv;) { // a beam is broken while any body is in it: merge overlaps
int64_t s = iv[i].s, e = iv[i].e; int beam = iv[i].beam;
for (i++; i < niv && iv[i].beam == beam && iv[i].s <= e; i++) if (iv[i].e > e) e = iv[i].e;
ev[k++] = (ev_t){ s, beam, true };
ev[k++] = (ev_t){ e, beam, false };
}
qsort(ev, k, sizeof *ev, cmp_ev);
free(iv);
*n = k;
return ev;
}
static minute_cb cb;
static void day_task(void *arg) {
int n, i = 0, j = 0;
ev_t *ev = make_day(&n);
for (int m = OPEN; m <= CLOSE + 10; m++) {
int64_t end = (int64_t)(m + 1) * 60000000;
for (; i < n && ev[i].t < end; i++) counter_edge(ev[i].beam, ev[i].broken, ev[i].t);
counter_advance(end);
for (; j < nps && ps[j].t < end; j++) { if (ps[j].dir > 0) truth_in += ps[j].persons; else truth_out += ps[j].persons; }
cb(m, end);
vTaskDelay(pdMS_TO_TICKS(100)); // one simulated minute every 0.1 s
}
vTaskDelete(NULL);
}
void beams_start(minute_cb on_minute) { cb = on_minute; xTaskCreate(day_task, "day", 8192, NULL, 5, NULL); }
bool beams_truth(int *in, int *out) { *in = truth_in; *out = truth_out; return true; }
#endifفي الكود أعلاه لاحظ التالي:
- اليوم المحاكى ثابت: المولد يبدأ من البذرة Seed نفسها في كل تشغيل، فتحصل على اليوم نفسه بالضبط، وتستطيع أن تغير الكود وتقارن.
- أنواع المجموعات: 66% شخص واحد، و5% يقف عند الباب من 5 إلى 20 ثانية، و10% شخصان بينهما 0.29 إلى 0.6 ثانية، و4% شخصان متلاصقان، و4% طفل بجانب كبير، و6% عربة تسوق، و5% مار يقطع A ويمشي. وهذه نسب اخترناها لنختبر كل حالة، وليست قياساً من محل حقيقي.
- الشعاع مقطوع ما دام فيه جسم: المولد يحسب لكل جسم متى يدخل كل شعاع ومتى يخرج منه، ثم يدمج الفترات المتداخلة في الشعاع نفسه، لأن الشعاع لا يعرف كم جسماً يقطعه، وهذا ما يجعل الشخصين المتلاصقين ظلاً واحداً كما في الواقع.
- الحقيقة معروفة: المحاكاة تعرف كم شخصاً دخل فعلاً، فترسلها في الحقلين
truth_inوtruth_out، وبهذا نقيس خطأ العداد، وهذا ما لا تستطيعه على الباب الحقيقي إلا بموظف يعد بيده يوماً كاملاً للمقارنة. - الوقت: كل دقيقة من اليوم تمر في 0.1 ثانية، والعداد لا يرى ساعة الجهاز أصلاً، وإنما أوقات التغيرات نفسها، ولهذا يعمل المرشح بالملي ثانية الصحيحة مهما سرعنا اليوم.
والملف main.c يربط العداد بالشبكة، وفيه القرارات التي تخص المحل:
// Visitor counter at a shop entrance on an ESP32, with two beams across the door.
// - counter.c turns the order in which the beams break into "in" and "out"
// - once a minute: the day's running totals over MQTT (running totals survive a lost message)
// - events: over capacity, a beam blocked for more than a minute, and the drift found at closing time
// - accepts "close" from the server at closing time: reports what the counter thinks is inside, then resets it
#include <stdio.h>
#include <stdlib.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 "nvs_flash.h"
#include "mqtt_client.h"
#include "protocol_examples_common.h"
#include "counter.h"
#include "beams.h"
#ifndef SENSOR_SIM
#include <time.h>
#include "esp_netif_sntp.h"
#endif
static const char *TAG = "counter";
#define DEVICE "shop1-door"
#define BROKER_URI "mqtt://10.0.2.2:1883" // under QEMU: the machine running it; on a real board your broker
#define CAPACITY 15 // people inside at once: your shop's own number
#define BLOCKED_S 60 // a beam broken this long with nothing changing: something is in the way
static esp_mqtt_client_handle_t mq;
static volatile bool connected, close_requested;
static int seq;
static void publish(const char *kind, const char *json, int qos) {
char topic[64];
snprintf(topic, sizeof topic, "shop/counter/" DEVICE "/%s", kind);
esp_mqtt_client_publish(mq, topic, json, 0, qos, 0);
}
static void event(const char *what, int value, int minute) {
char j[96];
snprintf(j, sizeof j, "{\"event\":\"%s\",\"value\":%d,\"t\":\"%02d:%02d\"}", what, value, minute / 60, minute % 60);
ESP_LOGW(TAG, "%s", j);
publish("event", j, 1);
}
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, "shop/counter/" DEVICE "/status", "online", 0, 1, 1);
esp_mqtt_client_subscribe(mq, "shop/counter/" DEVICE "/cmd", 1);
} else if (id == MQTT_EVENT_DATA && e->data_len == 5 && memcmp(e->data, "close", 5) == 0) {
close_requested = true; // handled in on_minute(), in the counting task
}
}
// Called once a minute by beams.c, in the same task that feeds the counter.
static void on_minute(int minute, int64_t now) {
static bool over, blocked;
const counts_t *c = counter_get();
if (close_requested) {
close_requested = false;
event("closing_drift", counter_close(), minute);
}
if (!over && c->occ >= CAPACITY) { over = true; event("over_capacity", c->occ, minute); }
if (over && c->occ < CAPACITY - 3) over = false; // re-arm only after it really drops
int64_t since;
bool busy = counter_busy_since(&since);
if (!blocked && busy && now - since > BLOCKED_S * 1000000LL) { blocked = true; event("beam_blocked", (int)((now - since) / 1000000), minute); }
if (blocked && !busy) blocked = false;
char j[256];
int n = snprintf(j, sizeof j, "{\"seq\":%d,\"t\":\"%02d:%02d\",\"in\":%d,\"out\":%d,\"occ\":%d,\"naive\":%d,"
"\"glitch\":%d,\"tailgate\":%d,\"abandoned\":%d", seq++, minute / 60, minute % 60,
c->in, c->out, c->occ, c->naive_breaks, c->glitches, c->tailgates, c->abandoned);
int tin, tout;
if (beams_truth(&tin, &tout)) n += snprintf(j + n, sizeof j - n, ",\"truth_in\":%d,\"truth_out\":%d", tin, tout);
snprintf(j + n, sizeof j - n, "}");
if (minute % 60 == 0) ESP_LOGI(TAG, "%s", j); // the serial log shows one line an hour
publish("telemetry", j, 0);
}
void app_main(void) {
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());
#ifndef SENSOR_SIM
esp_sntp_config_t sntp = ESP_NETIF_SNTP_DEFAULT_CONFIG("pool.ntp.org");
esp_netif_sntp_init(&sntp);
setenv("TZ", "<+03>-3", 1); // UTC+3; change to your time zone
tzset();
#endif
esp_mqtt_client_config_t cfg = {
.broker.address.uri = BROKER_URI,
.credentials.client_id = "counter-" DEVICE,
.session.last_will = { .topic = "shop/counter/" DEVICE "/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));
ESP_LOGI(TAG, "connected=%d, counting", connected);
beams_start(on_minute);
}في الكود أعلاه لاحظ التالي:
- المجاميع المتراكمة Running Totals: الجهاز لا يرسل «دخل ثلاثة في هذه الدقيقة»، وإنما «دخل 154 منذ الصباح». والسبب أن الرسالة بجودة الخدمة QoS 0 قد تضيع، فإذا ضاعت رسالة الفرق ضاع عدها إلى الأبد، أما إذا ضاعت رسالة المجموع فالرسالة التالية تحمل كل شيء. وسوف نختبر هذا في التقرير.
- السعة CAPACITY: عدد من في الداخل الذي يرسل عنده تنبيه، وهو 15 في المختبر لمحل صغير، وضع رقم محلك أنت. والتنبيه لا يتكرر حتى ينزل العدد ثلاثة تحت الحد، وهذا ما يسمى التخلف Hysteresis، والسبب أن العدد الذي يتأرجح بين 14 و15 سيرسل عشرين تنبيهاً في ساعة.
- الشعاع المسدود: إذا بقي شعاع مقطوعاً دقيقة كاملة دون أي تغير فهناك شيء في الطريق، صندوق أو لافتة أو باب مفتوح على الحساس، والعداد أعمى حتى يزال، فيرسل الجهاز حدثاً
beam_blocked. - الإغلاق: الأمر
closeيأتي من الخادم في موعد الإغلاق، فيرسل الجهاز عدد من يظن أنهم ما زالوا في الداخل، ثم يجعله صفراً. وسنعود إليه في قسم الانحراف. - الوصية الأخيرة Last Will: كما في بقية مشاريع السلسلة، إذا انقطع الجهاز يرسل الوسيط عنه
offline، وقد شرحناها في مقال MQTT.
خدمة الاستقبال وتقرير الساعات
على الخادم خدمة واحدة بلغة Python تستقبل كل ما يأتي على shop/counter/#، وتحفظه في SQLite، وترسل الأحداث التي تحتاج إنساناً إلى خادم التنبيهات ntfy، الذي يوصلها إلى تطبيقه على الجوال، وفي موعد الإغلاق ترسل الأمر close:
"""Ingest for the visitor counter.
- subscribes to shop/counter/# and keeps every minute's running totals and every event in SQLite (/data/counter.db)
- at closing time (23:00 here) sends "close" to the counter: the shop is empty, so whatever it still counts inside
is drift, and the counter starts from 0 again
- events that need a person go to the phone through ntfy (topic "shop")"""
import json, sqlite3, time, urllib.request
import paho.mqtt.client as mqtt
CLOSING = "23:00"
DB = sqlite3.connect("/data/counter.db")
DB.executescript("""
CREATE TABLE IF NOT EXISTS minute(device TEXT, seq INT, t TEXT, cin INT, cout INT, occ INT, naive INT,
glitch INT, tailgate INT, abandoned INT, truth_in INT, truth_out INT);
CREATE TABLE IF NOT EXISTS event(device TEXT, t TEXT, what TEXT, value INT);
""")
NOTIFY = {
"over_capacity": ("Shop over capacity", "{v} people inside", 4),
"beam_blocked": ("Door sensor blocked", "a beam has been blocked for {v} s, check the entrance", 3),
"closing_drift": ("Counter closed for the day", "it still counted {v} inside at closing, reset to 0", 2),
}
closed = set()
def notify(device, what, value):
title, body, prio = NOTIFY[what]
req = urllib.request.Request("http://ntfy/shop", data=f"{device}: {body.format(v=value)}".encode(),
headers={"Title": title, "Priority": str(prio)})
urllib.request.urlopen(req, timeout=5).read()
def on_message(c, u, m):
_, _, device, kind = m.topic.split("/") # shop/counter/<device>/<kind>
if kind == "status":
print(f"status {device} = {m.payload.decode()}", flush=True)
return
if kind == "cmd":
return
r = json.loads(m.payload)
if kind == "telemetry":
DB.execute("INSERT INTO minute VALUES(?,?,?,?,?,?,?,?,?,?,?,?)",
(device, r["seq"], r["t"], r["in"], r["out"], r["occ"], r["naive"], r["glitch"], r["tailgate"],
r["abandoned"], r.get("truth_in"), r.get("truth_out")))
if r["t"] >= CLOSING and device not in closed:
closed.add(device)
c.publish(f"shop/counter/{device}/cmd", "close", qos=1)
print(f"{r['t']} sent close to {device}", flush=True)
elif kind == "event":
DB.execute("INSERT INTO event VALUES(?,?,?,?)", (device, r["t"], r["event"], r["value"]))
print(f"{r['t']} event {device} {r['event']} {r['value']}", flush=True)
if r["event"] in NOTIFY:
notify(device, r["event"], r["value"])
DB.commit()
c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="counter-ingest")
c.on_connect = lambda c, u, f, rc, p: c.subscribe("shop/counter/#", qos=1)
c.on_message = on_message
while True:
try:
c.connect("broker", 1883)
break
except OSError:
time.sleep(1)
c.loop_forever()والتقرير هو ما يراه صاحب المحل في الصباح: الداخلون في كل ساعة، وأكثر الساعات ازدحاماً، ثم مقارنة كل عداد بالحقيقة:
"""The shop owner's day: entries per hour, the busiest hours, and how far each counter was from the truth.
The device sends running totals, so an hour's number is (last total of the hour) - (last total of the hour before)."""
import json, sqlite3, urllib.request
db = sqlite3.connect("/data/counter.db")
rows = db.execute("SELECT seq, t, cin, cout, occ, naive, glitch, tailgate, abandoned, truth_in, truth_out "
"FROM minute ORDER BY seq").fetchall()
def hourly(rows):
last, peak = {}, {}
for seq, t, cin, cout, occ, naive, *_ , tin, tout in rows:
h = int(t[:2])
last[h] = (cin, cout, tin)
peak[h] = max(peak.get(h, 0), occ)
out, prev = {}, (0, 0, 0)
for h in sorted(last):
out[h] = tuple(a - b for a, b in zip(last[h], prev)) + (peak[h],)
prev = last[h]
return out
h = hourly(rows)
print("hour in out peak inside truth in")
for hour, (cin, cout, tin, peak) in h.items():
print(f"{hour:02d}:00 {cin:4d} {cout:4d} {peak:11d} {tin:9d}")
top = sorted(h.items(), key=lambda kv: -kv[1][0])[:3]
print("busiest hours (entries):", ", ".join(f"{k:02d}:00 ({v[0]})" for k, v in top))
# Running totals survive lost messages: drop every 7th minute message and compute the hours again.
kept = [r for r in rows if r[0] % 7 != 3]
hk = hourly(kept)
moved = sum(abs(hk[k][0] - h[k][0]) for k in h)
print(f"lost messages: {len(rows) - len(kept)} of {len(rows)} dropped; entries in the day: "
f"{sum(v[0] for v in hk.values())} (all messages: {sum(v[0] for v in h.values())}), "
f"entries that moved to the next hour: {moved}")
seq, t, cin, cout, occ, naive, glitch, tailgate, abandoned, tin, tout = rows[-1]
err = lambda x: f"{x - tin:+d} ({(x - tin) * 100 / tin:+.1f}%)"
print("### the day against the truth")
print(f"truth: {tin} in, {tout} out")
print(f"two beams: {cin} in, {cout} out entries error {err(cin)}")
print(f"one beam, raw: {naive} breaks of beam A as entries {err(naive)}")
print(f"one beam, /2: {naive // 2} (breaks / 2, the usual fix) as entries {err(naive // 2)}")
print(f"two-beam details: {glitch} glitches filtered, {tailgate} close pairs split, {abandoned} turned back")
print("events:")
for t, what, value in db.execute("SELECT t, what, value FROM event ORDER BY rowid"):
print(f" {t} {what} {value}")
print("### notifications on ntfy topic 'shop'")
with urllib.request.urlopen("http://ntfy/shop/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']}")لاحظ أن الساعة تحسب من فرق المجموع: آخر مجموع في الساعة ناقص آخر مجموع في الساعة التي قبلها، فإذا ضاعت رسائل في منتصف الساعة فلا شيء يتغير. والشكل التالي يبين المسار كاملاً:

ولوحة متابعة Dashboard بالرسوم البيانية لهذه الأرقام موضوع شرحناه في مقال لوحات المتابعة، والجدول minute في SQLite جاهز لها كما هو.
تشغيل المشروع كاملاً
المختبر ملف Compose فيه الوسيط Mosquitto وخادم التنبيهات ntfy وخدمة الاستقبال، وخدمة رابعة تبني الكود بأداة ESP-IDF v5.4.1 وتشغله على المحاكي QEMU من Espressif. والمحاكي لا يملك شبكة لاسلكية، فيستخدم البرنامج متحكم Ethernet المحاكى openeth، ومكدس الشبكة TCP/IP نفسه الذي يستخدمه Wi-Fi، كما شرحنا في مقال ESP32:
# Visitor counter lab: the ESP32 firmware in QEMU, the broker, ntfy for phone notifications, and the ingest service.
name: counter
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: counter-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 يبني الكود مرتين: نسخة اللوحة الحقيقية بمقاطعات الأرجل وSNTP، لنتأكد أنها تبنى دون أخطاء، ونسخة المحاكاة التي تشغل:
#!/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 (GPIO interrupts, SNTP clock, Wi-Fi), compiled only, to prove the real drivers build
# build-sim: SENSOR_SIM=1 (a simulated shop day, 1 minute = 0.1 s) over QEMU's emulated Ethernet
set -eo pipefail # a failed build stops here, even behind a grep
. "$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:-120}" 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]+\) (counter|example_connect):|Guru" || trueوالملف run.sh يشغل كل شيء بالترتيب، ثم يطبع سجل الخدمة والتقرير:
#!/bin/bash
# Run the whole project on one machine. From this folder: bash run.sh
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 --line-buffered -E "binary size|^### |^[IWE] \(" | 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والمخرج من المتحكم سوف يكون كما يلي:
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
counter.bin binary size 0xdbf40 bytes. Smallest app partition is 0x100000 bytes. 0x240c0 bytes (14%) free.
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
counter.bin binary size 0x87a40 bytes. Smallest app partition is 0x100000 bytes. 0x785c0 bytes (47%) free.
### qemu
I (25663) counter: connected=1, counting
I (25763) counter: {"seq":0,"t":"09:00","in":0,"out":0,"occ":0,"naive":0,"glitch":0,"tailgate":0,"abandoned":0,"truth_in":0,"truth_out":0}
I (31863) counter: {"seq":60,"t":"10:00","in":5,"out":5,"occ":0,"naive":18,"glitch":16,"tailgate":0,"abandoned":0,"truth_in":5,"truth_out":5}
I (37933) counter: {"seq":120,"t":"11:00","in":14,"out":10,"occ":4,"naive":33,"glitch":16,"tailgate":0,"abandoned":1,"truth_in":14,"truth_out":10}
I (43973) counter: {"seq":180,"t":"12:00","in":33,"out":27,"occ":6,"naive":74,"glitch":26,"tailgate":2,"abandoned":1,"truth_in":34,"truth_out":28}
I (49973) counter: {"seq":240,"t":"13:00","in":54,"out":45,"occ":9,"naive":126,"glitch":50,"tailgate":4,"abandoned":2,"truth_in":57,"truth_out":48}
I (55983) counter: {"seq":300,"t":"14:00","in":75,"out":67,"occ":8,"naive":171,"glitch":50,"tailgate":4,"abandoned":4,"truth_in":80,"truth_out":73}
I (62083) counter: {"seq":360,"t":"15:00","in":91,"out":81,"occ":10,"naive":206,"glitch":58,"tailgate":4,"abandoned":4,"truth_in":97,"truth_out":89}
W (62183) counter: {"event":"beam_blocked","value":120,"t":"15:01"}
I (68213) counter: {"seq":420,"t":"16:00","in":104,"out":95,"occ":9,"naive":245,"glitch":82,"tailgate":4,"abandoned":5,"truth_in":112,"truth_out":107}
I (74363) counter: {"seq":480,"t":"17:00","in":121,"out":111,"occ":10,"naive":279,"glitch":82,"tailgate":5,"abandoned":6,"truth_in":131,"truth_out":125}
I (80373) counter: {"seq":540,"t":"18:00","in":137,"out":126,"occ":11,"naive":326,"glitch":114,"tailgate":5,"abandoned":6,"truth_in":148,"truth_out":142}
W (85873) counter: {"event":"over_capacity","value":15,"t":"18:55"}
I (86373) counter: {"seq":600,"t":"19:00","in":159,"out":142,"occ":17,"naive":367,"glitch":114,"tailgate":5,"abandoned":9,"truth_in":173,"truth_out":158}
I (92373) counter: {"seq":660,"t":"20:00","in":189,"out":177,"occ":12,"naive":435,"glitch":114,"tailgate":5,"abandoned":12,"truth_in":206,"truth_out":198}
W (92973) counter: {"event":"over_capacity","value":15,"t":"20:06"}
W (95673) counter: {"event":"over_capacity","value":15,"t":"20:33"}
I (98373) counter: {"seq":720,"t":"21:00","in":226,"out":206,"occ":20,"naive":505,"glitch":122,"tailgate":5,"abandoned":12,"truth_in":249,"truth_out":232}
I (104373) counter: {"seq":780,"t":"22:00","in":248,"out":235,"occ":13,"naive":568,"glitch":146,"tailgate":6,"abandoned":12,"truth_in":272,"truth_out":263}
I (110373) counter: {"seq":840,"t":"23:00","in":250,"out":246,"occ":4,"naive":589,"glitch":162,"tailgate":6,"abandoned":12,"truth_in":274,"truth_out":274}
W (110473) counter: {"event":"closing_drift","value":4,"t":"23:01"}والأسطر الأربعة الأولى حجم الكود في النسختين، ونسخة اللوحة الحقيقية أكبر لأن فيها مكتبات Wi-Fi، ثم سطر لكل ساعة من اليوم، والأحداث بينها. ثم سجل خدمة الاستقبال:
status shop1-door = online
15:01 event shop1-door beam_blocked 120
18:55 event shop1-door over_capacity 15
20:06 event shop1-door over_capacity 15
20:33 event shop1-door over_capacity 15
23:00 sent close to shop1-door
23:01 event shop1-door closing_drift 4
status shop1-door = offlineثم التقرير:
hour in out peak inside truth in
09:00 5 5 3 5
10:00 9 5 4 9
11:00 19 17 9 20
12:00 18 18 10 20
13:00 23 22 14 25
14:00 17 14 12 18
15:00 13 14 13 15
16:00 17 16 12 19
17:00 16 15 14 17
18:00 22 16 17 25
19:00 30 34 22 33
20:00 36 30 22 42
21:00 23 28 20 24
22:00 2 12 13 2
23:00 0 0 4 0
busiest hours (entries): 20:00 (36), 19:00 (30), 13:00 (23)
lost messages: 122 of 851 dropped; entries in the day: 250 (all messages: 250), entries that moved to the next hour: 0
### the day against the truth
truth: 274 in, 274 out
two beams: 250 in, 246 out entries error -24 (-8.8%)
one beam, raw: 589 breaks of beam A as entries +315 (+115.0%)
one beam, /2: 294 (breaks / 2, the usual fix) as entries +20 (+7.3%)
two-beam details: 162 glitches filtered, 6 close pairs split, 12 turned back
events:
15:01 beam_blocked 120
18:55 over_capacity 15
20:06 over_capacity 15
20:33 over_capacity 15
23:01 closing_drift 4
### notifications on ntfy topic 'shop'
[priority 3] Door sensor blocked: shop1-door: a beam has been blocked for 120 s, check the entrance
[priority 4] Shop over capacity: shop1-door: 15 people inside
[priority 4] Shop over capacity: shop1-door: 15 people inside
[priority 4] Shop over capacity: shop1-door: 15 people inside
[priority 2] Counter closed for the day: shop1-door: it still counted 4 inside at closing, reset to 0ماذا تقول الأرقام؟
لنبدأ بما يراه صاحب المحل، ثم ننتقل إلى الخطأ:
- أكثر الساعات ازدحاماً: الثامنة مساءً بـ 36 داخلاً، ثم السابعة بـ 30، ثم الواحدة ظهراً بـ 23، وأعلى عدد في الداخل 22 شخصاً في الساعتين السابعة والثامنة. وهذا ما بني عليه اليوم المحاكى، فالمولد يضاعف الزوار في المساء، والتقرير وجده دون أن يعرف شيئاً عن المولد.
- تنبيه السعة: وصل ثلاث مرات، في 18:55 و20:06 و20:33، ولم يتكرر في كل دقيقة تأرجح فيها العدد حول 15، لأنه لا يعود إلا بعد أن ينزل العدد تحت 12.
- الصندوق في الباب: وضعه المولد في الساعة 15:00، ووصل التنبيه في 15:01 بأن الشعاع مقطوع منذ 120 ثانية. ولاحظ أن الفحص يحدث مرة في الدقيقة، فالتنبيه يصل بعد دقيقة إلى دقيقتين من انسداد الشعاع، وهذا كاف لشيء نسيه أحدهم في المدخل.
- الإغلاق: في الساعة 23:00 أرسلت الخدمة الأمر
close، وفي 23:01 رد الجهاز بأنه ما زال يظن أن في الداخل 4 أشخاص، وهو الفرق بين 250 دخولاً و246 خروجاً، مع أن المحل فارغ في الحقيقة. - الرسائل الضائعة: حذف التقرير عن قصد 122 رسالة من 851، أي رسالة من كل سبع، ثم حسب اليوم من جديد، فبقي عدد الداخلين 250، ولم ينتقل أي دخول من ساعته إلى ساعة أخرى، وهذه فائدة المجاميع المتراكمة بالأرقام.
والآن المقارنة التي بنينا المختبر من أجلها، وكل العدادات رأت الأحداث نفسها بالضبط:
| العداد | الداخلون | الخطأ | يعرف من في الداخل؟ |
|---|---|---|---|
| الحقيقة من المحاكاة | 274 | - | نعم |
| شعاعان مع آلة الحالات | 250 | -24، أي 8.8% أقل | نعم، مع انحراف 4 عند الإغلاق |
| شعاع واحد، كل انقطاع زائر | 589 | +315، أي 115% أكثر | لا |
| شعاع واحد مقسوماً على اثنين | 294 | +20، أي 7.3% أكثر | لا |
والرقم الأول الذي يجب أن تلاحظه أن العداد البسيط الخام أعطى أكثر من ضعف الحقيقة، لأنه يعد الخارجين والمارة وكل ومضة في شبك العربات، وهذا العداد هو ما تجده في أغلب الأمثلة. والرقم الثاني قد يفاجئك: القسمة على اثنين أعطت في هذا اليوم رقماً يومياً خطؤه قريب من خطأ الشعاعين، بل أقل قليلاً. ولن نخفي هذا، فإذا كان كل ما تريده رقماً واحداً في آخر اليوم فالشعاع الواحد مع القسمة قد يقترب منه، وبالصدفة أحياناً، لأن خطأه زيادة من العربات والمارة يقابلها نقص من غيرها. ولكن هذا العداد لا يعرف الاتجاه، فلا يستطيع أن يقول لك من في المحل الآن، ولا أن يرسل تنبيه السعة، ولا أن يكتشف انحرافه عند الإغلاق، ولا أن يفرق بين ساعة دخل فيها الناس وساعة خرجوا فيها، وانظر إلى الساعة العاشرة مساءً في التقرير: دخل 2 وخرج 12، وعداد بلا اتجاه يرى في هذه الساعة انقطاعات الداخلين والخارجين معاً، فيقسمها على اثنين ويقول إن قرابة 7 زوار جاؤوا، والحقيقة أن المحل كان يفرغ.
وماذا عن خطأ الشعاعين؟ الأربعة والعشرون الذين لم يعدوا جاؤوا من الحالات التي وضعناها في المولد عن قصد، وقد رأيناها في شكل الحالات الأربع: الشخصان المتلاصقان اللذان يصبحان ظلاً واحداً، والطفل الذي يمشي بجانب الكبير، ومن دخل في الدقائق الثلاث التي سد فيها الصندوق الشعاع A، ومن تقاطع مع شخص يخرج في اللحظة نفسها. ولم نقس نصيب كل حالة من الخطأ في هذا التشغيل، وتستطيع أن تفعل ذلك بنفسك بأن تلغي نوعاً واحداً من المولد وتشغل المختبر من جديد. والمهم هنا أن خطأ الشعاعين نقص في الغالب وليس زيادة، أي أن الرقم الذي تراه حد أدنى لعدد الداخلين، وهذا أسهل في القرار من رقم لا تعرف هل هو زائد أم ناقص.
وفي التفاصيل أيضاً: المرشح ألغى 162 ومضة قصيرة، وقاعدة الشخص الثاني فصلت 6 أزواج متتالية كانت ستعد شخصاً واحداً، و12 مرة قطع أحدهم الشعاع A ثم رجع دون أن يدخل.
الانحراف وإعادة العد عند الإغلاق
عدد من في الداخل هو الفرق بين كل من دخل وكل من خرج منذ الصباح، وأي خطأ في الدخول أو الخروج يبقى في هذا الفرق إلى الأبد، فإذا لم تصفره كل يوم فسوف يكبر الخطأ يوماً بعد يوم، ويصبح في نهاية الشهر رقماً لا معنى له، وقد يصبح سالباً إذا كان العداد يفوت الخارجين أكثر من الداخلين، ولهذا يمنع الكود العدد من النزول تحت الصفر ويعد هذه المرات في underflow. والحل الذي استخدمناه بسيط: في موعد الإغلاق المحل فارغ بالتعريف، فكل ما يظنه العداد في الداخل هو خطأ، والجهاز يرسله ثم يصفر العدد.
وهذا الرقم، 4 في مختبرنا، ليس مجرد تصحيح، وإنما مقياس يومي لصحة العداد. فاحفظه كل يوم وراقبه: إذا كان يتراوح بين صفر وخمسة ثم أصبح فجأة عشرين فهناك شيء تغير عند الباب، كشعاع انحرف عن مكانه، أو باب زجاجي جديد يعكس الضوء، أو عربات من نوع آخر. ولاحظ أن الأمر يأتي من الخادم وليس من ساعة الجهاز، والسبب أن موعد الإغلاق قرار إداري يتغير في المواسم والأعياد، ومكانه الطبيعي الخادم الذي تغيره منه دون أن تحدث كود الجهاز.
من المختبر إلى الباب الحقيقي
المحاكي أثبت أن المنطق يعمل على اليوم الذي صنعناه، ولكن بابك ليس اليوم الذي صنعناه، ولهذا لا تبن أي قرار على العداد قبل أن تمر بالخطوات التالية بالترتيب:
- ثبت الحساسين قبل التوصيل: على ارتفاع واحد، ومتوازيين، وبينهما المسافة نفسها من أعلى الشعاع إلى أسفله، لأن شعاعاً مائلاً يقطعه الجسم في مكانين بوقتين مختلفين، فيتغير الترتيب الذي تعتمد عليه الآلة. وأغلب الحساسات الكهروضوئية فيها مؤشر صغير يضيء عندما يصلها الضوء، فاستخدمه في الضبط قبل أن تفتح الحاسوب.
- اطبع الأحداث الخام يوماً واحداً: أضف سطراً في
beams_taskيطبع كل تغير مع وقته، ومر من الباب بنفسك عشر مرات دخولاً وعشراً خروجاً، بسرعات مختلفة، ومع عربة إن كان في المحل عربات. وإذا رأيت أن الشعاع B ينقطع قبل A وأنت داخل فقد عكست السلكين، وهذا خطأ يحدث أكثر مما تتوقع. - قارن بالعد اليدوي: عد بيدك، أو اطلب من موظف، ساعتين مزدحمتين وساعة هادئة، واكتب الداخلين في كل ساعة، ثم قارن بتقرير الساعات. والخطأ الذي تجده هو خطأ عدادك أنت عند بابك، وليس الرقم الذي رأيناه في المحاكاة، فاكتبه في أعلى التقرير، لأن الرقم الذي لا يرافقه خطؤه يقرأ على أنه دقيق.
- راقب الانحراف أسبوعاً: إذا كان انحراف الإغلاق صغيراً وثابتاً فالعداد مستقر، وإذا كان كبيراً في أيام معينة فابحث عما يحدث فيها، كعربات التوريد في الصباح أو العائلات في عطلة نهاية الأسبوع.
وبعد أن يستقر العداد تبقى أمور التشغيل التي تخص أي جهاز في الشبكة: الجهاز في علبة مغلقة بعيداً عن متناول الزبائن، والتغذية من مصدر ثابت وليس من منفذ USB في جهاز الكاشير، وكلمة مرور على الوسيط وقائمة صلاحيات تسمح للجهاز أن يكتب في موضوعه فقط، كما شرحنا في مقال أمن إنترنت الأشياء، وطريقة لتحديث الكود دون أن تفك العلبة، وقد شرحناها في مقال التحديث عن بعد OTA. ولاحظ أن العداد يستمر في العد إذا انقطعت الشبكة، لأن العد في الجهاز نفسه، والمجموع المتراكم يصل كاملاً مع أول رسالة بعد عودة الاتصال، ولكن إذا انقطعت الكهرباء عن الجهاز فإن العدد في الذاكرة يضيع، والحل أن تحفظ المجموع في ذاكرة NVS كل بضع دقائق، وهذا من التمارين في آخر المقال.
ماذا تفعل بالأرقام؟
العداد ليس الهدف، وإنما القرار الذي يأتي بعده، وهذه أمثلة لما يستطيع صاحب المحل أن يستخرجه من الجدول minute وحده:
- توزيع الموظفين: إذا كانت الساعتان السابعة والثامنة تحملان ربع زوار اليوم كما في مختبرنا، فهذا هو الوقت الذي يحتاج أكبر عدد من الموظفين عند الرفوف والصندوق، وليس الصباح.
- نسبة التحويل Conversion Rate: عدد الفواتير في الساعة مقسوماً على الداخلين فيها، وهو الرقم الذي يخبرك هل المشكلة في جذب الناس إلى المحل أم في ما يحدث بعد دخولهم.
- أثر العروض: قارن الداخلين في أسبوع العرض بالأسبوع الذي قبله في الساعات نفسها، لأن مقارنة يوم الخميس بيوم الأحد لا تخبرك بشيء.
- مدة البقاء: من الفرق بين الداخلين والخارجين على طول اليوم تستطيع أن تقدر متوسط بقاء الزائر في المحل، وهو تقدير وليس قياساً لكل شخص، لأن العداد لا يعرف من هو الخارج، وهذا بالضبط ما أردناه عندما اخترنا الشعاع على الكاميرا.
الأخطاء الشائعة
- شعاع واحد مع القسمة على اثنين: يعطي رقماً يومياً قد يبدو قريباً، ولا يعطي من في الداخل ولا ساعات الدخول الصحيحة، ويعد المارة والعربات.
- الشعاعان متباعدان جداً: إذا كانت المسافة بينهما أكبر من عمق الجسم فلن ينقطعا معاً أبداً، والآلة تتوقع الحالة
A + B. الكود يقبل القفز منIN1إلىIN3مباشرة، ولكن الشخصين المتتاليين يختلطان أكثر. - إرسال الفرق بدل المجموع: كل رسالة ضائعة عدد ضائع، والمجموع المتراكم يحل هذا مجاناً.
- نسيان الإغلاق: العدد في الداخل يتراكم خطؤه من يوم إلى يوم حتى يصبح سالباً أو بالمئات، والتصفير اليومي عند الإغلاق هو ما يبقيه صالحاً.
- توصيل حساس 24 فولت بالمتحكم مباشرة: يحرق الرجل، وربما الشريحة، والحل عازل ضوئي بينهما.
- الوثوق بالرقم دون مقارنة: قبل أن تبني قراراً على العداد، عد بيدك ساعتين مزدحمتين، وقارن، واكتب الخطأ في التقرير.
تطبيق عملي
- غير
FILTER_USفيcounter.hإلى 1000، أي ملي ثانية واحدة، وشغل المختبر، وقارن عدد الداخلين وعددglitchبما رأيناه. - أضف إلى التقرير نسبة التحويل Conversion Rate: اكتب في الملف عدد الفواتير في كل ساعة يدوياً، واقسمه على الداخلين في الساعة نفسها.
- اجعل خدمة الاستقبال ترسل تنبيهاً إذا لم تصل رسالة من الجهاز عشر دقائق في ساعات الدوام، حتى لو لم يرسل الوسيط الوصية الأخيرة.
- احفظ المجاميع في ذاكرة NVS كل خمس دقائق، واقرأها عند التشغيل إذا كان اليوم نفسه، حتى لا يضيع العد إذا انقطعت الكهرباء عن الجهاز.
- غير نسبة الأطفال في
make_dayإلى 10%، وتوقع قبل التشغيل أثرها على خطأ الدخول وعلى الانحراف عند الإغلاق.
حذف المختبر Cleanup
docker compose down
docker image rm counter-ingest:1الأمر الأول يوقف الخدمات ويحذف الشبكة، والثاني يحذف الـ Image الخاصة بخدمة الاستقبال، ويبقى ال Image الخاص بأداة ESP-IDF لمشاريع السلسلة الأخرى، ويبقى الكود ومجلدات البناء في lab/firmware.
الخلاصة Summary
- عداد الزوار يحتاج رقماً وليس صورة، والشعاع لا يجمع أي بيانات شخصية، ولهذا اخترناه على الكاميرا.
- الشعاع الواحد يعد انقطاعات وليس أشخاصاً، وشعاعان بينهما 10 سم يعطيان الاتجاه من ترتيب الانقطاع.
- آلة الحالات مع مرشح 30 ملي ثانية تتعامل مع من يقف في الباب ومن يتراجع وعربات التسوق والأشخاص المتتاليين.
- في يوم محاكى فيه 274 داخلاً عد الشعاعان 250، أي 8.8% أقل، وعد الشعاع الواحد 589 انقطاعاً، والقسمة على اثنين تقرب الرقم اليومي ولكنها لا تعطي من في الداخل ولا تنبيه السعة.
- أرسل المجاميع المتراكمة وليس الفروق، وصفر من في الداخل عند الإغلاق، واحفظ الانحراف لأنه مقياس صحة العداد.
وفي المشاريع القادمة من السلسلة بإذن الله سوف ننتقل إلى مراقبة خزانات المياه والمضخات، حيث يصبح الخطأ في الحساس ماء ضائعاً أو مضخة محترقة.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتشغيل الكود بأداة ESP-IDF v5.4.1 على محاكي QEMU من Espressif، مع Mosquitto 2.1.2 وntfy 2.11.0 وPython 3.13 في Docker Engine 29.8.0.