الإلكترونيات والطائرات المسيرة والطباعة ثلاثية الأبعاد الأدلة التقنية

مشروع ري النباتات الآلي بحساس رطوبة التربة

نظام يسقي الأصيص عندما تجف تربته فقط، ويتوقف عند خزان فارغ أو حساس معطل، ويرسل التنبيه إلى جوالك، بمتحكم ESP32 ووسيط MQTT وخادم ntfy.

مشروع ري النباتات الآلي بحساس رطوبة التربة

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

وهذا هو أول مشروع في سلسلة مشاريع إنترنت الأشياء، وقد اخترناه أولاً لأنه صغير في القطع وكامل في الفكرة: حساس واحد يقرأ، ومخرج واحد يتحكم، وقرار في المنتصف، وتنبيه يصل إلى إنسان. وكل مشروع بعده في السلسلة، من غرفة التبريد إلى خزانات المياه، هو هذه الأجزاء الأربعة بقطع مختلفة. وسوف نبني المشروع كاملاً: برنامج المتحكم ESP32 بإطار ESP-IDF، والوسيط Mosquitto، وخدمة صغيرة تحفظ القراءات وترسل التنبيهات إلى الجوال عبر ntfy، ونشغل كل ذلك على جهاز واحد، والمتحكم نفسه يعمل على المحاكي QEMU من Espressif.

وسوف نناقش في هذا المقال ما يلي:

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

القطع

المشروع يحتاج متحكماً يتصل بالشبكة، ولهذا اخترنا ESP32 بدل Arduino Uno، وقد شرحنا الشريحة ونواتيها واستهلاكها للطاقة في مقال ESP32. والصورة التالية للوحة تطوير ESP32 مثبتة فوق لوحة تجارب، وهذا هو الشكل الذي يبدأ به المشروع على الطاولة:

لوحة تطوير ESP32 سوداء عليها وحدة معدنية ومنفذ USB، مثبتة على لوحة بأرجل ذهبية، وتحتها لوحة تجارب بيضاء فارغة
لوحة تطوير ESP32 ولوحة تجارب. الصورة: Edwiyanto، رخصة CC BY-SA 4.0، المصدر: Wikimedia Commons (تم تحويلها إلى WebP).

وحول المتحكم أربع قطع، والشكل التالي يبين كيف تتصل:

رسم توصيل: لوحة ESP32 في الوسط، ومنها سلك أخضر من الرجل GPIO34 إلى حساس رطوبة سعوي أسود مغروس في أصيص فيه نبتة، وسلك أزرق من الرجل GPIO26 إلى وحدة MOSFET زرقاء، ومنها سلك برتقالي إلى مضخة داخل خزان ماء، وسلك بنفسجي من الرجل GPIO27 إلى عوامة في الخزان، وأنبوب ماء أزرق يخرج من الخزان ويمر فوق الرسم إلى الأصيص
حساسان ومخرج واحد: الرطوبة على GPIO34، والعوامة على GPIO27، والمضخة عبر وحدة MOSFET على GPIO26
  • حساس رطوبة التربة السعوي Capacitive Soil Moisture Sensor: شريحة تغرسها في التربة، ومخرجها جهد تماثلي يتغير مع الماء حولها، فنقرؤه بمحول ADC في المتحكم. وصلناه بالرجل GPIO34، وهي من أرجل ADC1، لأن أرجل ADC2 في ESP32 لا تعمل للقراءة التماثلية عندما يكون Wi-Fi شغالاً، فهو يستخدم الوحدة نفسها.
  • المضخة: مضخة ماء صغيرة تغمر في الخزان وتعمل على 5 فولت، وتحتاج تياراً أكبر بكثير مما تعطيه رجل المتحكم، والرقم في ورقة بيانات المضخة التي تشتريها.
  • وحدة MOSFET أو Relay: المفتاح الذي تتحكم فيه رجل المتحكم GPIO26، فيوصل كهرباء المضخة أو يقطعها. وقد شرحنا الترانزستور والـ MOSFET والثنائي الذي يحمي من المحرك في مقال القطع الأساسية.
  • العوامة Float Switch: مفتاح في الخزان يغلق أو يفتح بحسب مستوى الماء، وصلناه بين GPIO27 والأرضي مع المقاومة الرافعة الداخلية.

لماذا الحساس السعوي؟

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

نموذج أولي على طاولة: لوحة Arduino زرقاء ولوحة تجارب صغيرة وأسلاك ملونة كثيرة، تخرج منها أسلاك إلى أصيص بني فيه حساس رطوبة مغروس في التربة
نموذج أولي: حساس رطوبة تربة وحساس DHT11 موصولان بلوحة Arduino. الصورة: Boohyabuddha، رخصة CC BY-SA 4.0، المصدر: Wikimedia Commons (تم تحويلها إلى WebP).

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

العوامة: الحساس الذي يحمي المضخة

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

صورتان لعوامة صفراء مفتوحة من الداخل: فيها مفتاح صغير أسود بذراع معدني وكرة فولاذية، في الصورة اليمنى الكرة بعيدة عن الذراع، وفي اليسرى الكرة على الذراع تضغطه
عوامة من الداخل: كرة فولاذية تتدحرج عندما تميل العوامة فتضغط ذراع المفتاح. الصورتان: Martin Meise، رخصة CC BY 3.0، المصدر: Wikimedia Commons وWikimedia Commons (تم جمعهما وتحويلهما إلى WebP).

وفي مشروعنا العوامة أصغر بكثير، عادة أنبوب بلاستيكي فيه مغناطيس يطفو حول مفتاح Reed، ولكن الفكرة واحدة: مفتاح يغلق ويفتح مع مستوى الماء، والمتحكم يقرؤه كما يقرأ زراً. والمهم أن تختبره يدوياً قبل التركيب: ارفعه وأنزله والمقياس على صوت الاتصال، كما في مقال المقياس المتعدد، لتعرف أي وضع يغلق.

وحدة التشغيل

رجل ESP32 تعطي 3.3 فولت وتيارها محدود، ولا تشغل مضخة مباشرة، ولهذا نحتاج مفتاحاً إلكترونياً بينهما. والخياران الشائعان وحدة Relay، وهي مفتاح ميكانيكي يحركه مغناطيس كهربائي، ووحدة MOSFET، وهي مفتاح إلكتروني دون أجزاء متحركة. والصورة التالية لـ Relay من النوع الذي تجده في هذه الوحدات:

Relay مكعب أزرق صغير مكتوب عليه SONGLE وأرقام الجهد والتيار، وأرجله المعدنية من الأسفل
Relay من سلسلة Songle SMIH. الصورة: Retired electrician، رخصة CC0، المصدر: Wikimedia Commons (تم تحويلها إلى WebP).

ولمضخة 5 فولت صغيرة نفضل وحدة MOSFET: صامتة، ولا تتآكل نقاط تلامسها مع التشغيل المتكرر، وتستهلك أقل. والـ Relay يناسب عندما تتحكم في جهاز بكهرباء منفصلة تماماً، وفي كل الحالات لا يوصل هذا المشروع بكهرباء المنزل، فكل ما فيه 5 فولت من محول USB. وتأكد أن الوحدة التي تشتريها تعمل بإشارة 3.3 فولت، وأن فيها ثنائياً على أطراف المضخة، أو أضفه أنت، لأن المحرك عندما يفصل يولد ارتفاعاً مفاجئاً Spike في الجهد يضر المفتاح.

المعايرة: من رقم إلى نسبة

المحول ADC في ESP32 يعطي رقماً من 0 إلى 4095، والحساس السعوي يعطي رقماً أعلى كلما جفت التربة. ولكن هذا الرقم لا يعني شيئاً قبل المعايرة، لأنه يختلف من حساس لآخر، ومن تربة لأخرى، ولهذا نقيس نقطتين بأنفسنا:

  1. نقطة الجفاف: اغرس الحساس في تربة جافة من الأصيص نفسه، واقرأ الرقم، وفي برنامجنا وضعنا 2800.
  2. نقطة الماء: ضع الحساس في كوب ماء حتى الخط المطبوع عليه، دون أن يغمر الدارة في أعلاه، واقرأ الرقم، وفي برنامجنا 1300.

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

البرنامج على المتحكم

قسمنا البرنامج إلى ملفين: sensor.c فيه كل ما يلمس القطع، وmain.c فيه القرار والشبكة. والسبب أن المحاكي QEMU يشغل الشريحة والشبكة، ولكن لا يوجد فيه حساس تربة ولا مضخة، فوضعنا في sensor.c نسختين: الحقيقية التي تقرأ ADC وتشغل الرجل، ونسخة محاكاة تعمل عندما نبني بالخيار SENSOR_SIM، فيها أصيص يجف وخزان يفرغ، والوقت فيها أسرع بستين مرة، فكل دقيقة من حياة النبتة ثانية واحدة. والملف sensor.h كما يلي:

#pragma once
#include <stdbool.h>
// The two inputs of the project and the one output. sensor.c has the real drivers (ADC, GPIO) and, with SENSOR_SIM,
// a simulated pot of soil and a water tank so the same firmware runs in QEMU.
void sensor_init(void);
int  soil_raw(void);        // ADC reading of the capacitive soil sensor, 0..4095 (higher = drier)
bool tank_has_water(void);  // float switch in the water tank
void pump_set(bool on);     // relay/MOSFET driving the pump

#ifdef SENSOR_SIM
#define SCALE 60            // simulated time runs 60x faster: 1 minute of the plant = 1 s
int sim_minute(void);
#else
#define SCALE 1
#endif

والملف sensor.c:

#include "sensor.h"
#include "driver/gpio.h"
#include "esp_timer.h"

#define PIN_PUMP   GPIO_NUM_26   // relay or MOSFET module input, HIGH = pump on
#define PIN_FLOAT  GPIO_NUM_27   // float switch to GND, closed (LOW) while the tank has water

#ifndef SENSOR_SIM
#include "esp_adc/adc_oneshot.h"
static adc_oneshot_unit_handle_t adc;   // soil sensor AOUT on GPIO34 = ADC1 channel 6

void sensor_init(void) {
    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_6, &ch);
    gpio_set_direction(PIN_PUMP, GPIO_MODE_OUTPUT);
    gpio_set_level(PIN_PUMP, 0);
    gpio_set_direction(PIN_FLOAT, GPIO_MODE_INPUT);
    gpio_set_pull_mode(PIN_FLOAT, GPIO_PULLUP_ONLY);
}
int soil_raw(void) {
    int sum = 0, v;
    for (int i = 0; i < 8; i++) { adc_oneshot_read(adc, ADC_CHANNEL_6, &v); sum += v; }   // average 8 readings
    return sum / 8;
}
bool tank_has_water(void) { return gpio_get_level(PIN_FLOAT) == 0; }
void pump_set(bool on) { gpio_set_level(PIN_PUMP, on); }

#else
// Simulated pot and tank. Time runs 60 times faster (SCALE in sensor.h): one minute of the plant's life is one second.
//  - the soil dries by 20 ADC steps a minute; each second of pumping wets it by 60 steps
//  - the tank holds 25 seconds of pumping (five 5 s pulses)
//  - at minute 70 the sensor wire comes loose and the ADC pin reads full scale (4095)
static int64_t t0, last;
static double soil = 2200, tank_s = 25;
static bool pump;
static void step(void) {
    int64_t now = esp_timer_get_time();
    double dt = (now - last) * (double)SCALE / 1e6;   // simulated seconds since the last call
    last = now;
    soil += 20.0 * dt / 60;
    if (pump && tank_s > 0) { soil -= 60.0 * dt; tank_s -= dt; }
    if (soil < 1300) soil = 1300;
}
int sim_minute(void) { return (int)((esp_timer_get_time() - t0) * SCALE / 60000000); }
void sensor_init(void) { t0 = last = esp_timer_get_time(); }
int soil_raw(void) { step(); return sim_minute() >= 70 ? 4095 : (int)soil; }
bool tank_has_water(void) { step(); return tank_s > 0; }
void pump_set(bool on) { step(); pump = on; }
#endif

في الملف أعلاه لاحظ التالي:

  • في النسخة الحقيقية يقرأ البرنامج المحول ثماني مرات ويأخذ المتوسط، لأن قراءة ADC في ESP32 فيها تذبذب، ومتوسط عدة قراءات أهدأ من قراءة واحدة.
  • التوهين ADC_ATTEN_DB_12 هو أوسع مدى للمحول في ESP32، ودونه لا يقرأ المحول إلا جهوداً صغيرة، ومخرج الحساس يتجاوزها.
  • في نسخة المحاكاة كتبنا عطلاً مقصوداً: في الدقيقة 70 يفصل سلك الحساس، فتقرأ الرجل 4095. وسنرى ماذا يفعل البرنامج عندها.

ثم main.c، وهو قلب المشروع:

// Automatic plant watering on an ESP32.
//  - reads a capacitive soil moisture sensor every minute and turns it into a percentage with two calibration points
//  - when the soil is below 35%: one short pump pulse, then waits for the water to soak in before it reads again
//  - never pumps when the tank is empty, when the sensor reading is impossible, or after 8 pulses in a day
//  - publishes readings and events over MQTT, and accepts a "water" command for one manual pulse
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_event.h"
#include "esp_netif.h"
#include "nvs_flash.h"
#include "mqtt_client.h"
#include "esp_timer.h"
#include "protocol_examples_common.h"
#include "sensor.h"

static const char *TAG = "plant";

#define DEVICE      "balcony-1"
#define BROKER_URI  "mqtt://10.0.2.2:1883"   // under QEMU: the machine running it; on a real board your broker's address

#define CAL_DRY     2800    // raw reading with the sensor in dry soil (measure yours)
#define CAL_WET     1300    // raw reading with the sensor in a glass of water (measure yours)
#define WATER_BELOW 35      // % moisture that starts a pulse
#define PUMP_S      5       // one pulse, seconds
#define SOAK_MIN    10      // minutes to wait after a pulse before reading again
#define MAX_PULSES  8       // per day
#define REPORT_MIN  5       // minutes between telemetry messages

#define MINUTES(m)  pdMS_TO_TICKS((m) * 60000 / SCALE)
#define SECONDS(s)  pdMS_TO_TICKS((s) * 1000 / SCALE)

static esp_mqtt_client_handle_t mq;
static volatile bool manual_request, connected;
static int pulses_today, seq;

static void publish(const char *kind, const char *json, int qos, int retain) {
    char topic[64];
    snprintf(topic, sizeof topic, "home/plants/" DEVICE "/%s", kind);
    esp_mqtt_client_publish(mq, topic, json, 0, qos, retain);
}

static void event(const char *what, int moist) {
    char j[96];
    snprintf(j, sizeof j, "{\"event\":\"%s\",\"moist\":%d,\"pulses\":%d}", what, moist, pulses_today);
    ESP_LOGW(TAG, "%s", j);
    publish("event", j, 1, 0);
}

static void on_mqtt(void *arg, esp_event_base_t base, int32_t id, void *data) {
    esp_mqtt_event_handle_t e = data;
    if (id == MQTT_EVENT_CONNECTED) {
        ESP_LOGI(TAG, "connected to the broker");
        connected = true;
        publish("status", "online", 1, 1);
        esp_mqtt_client_subscribe(mq, "home/plants/" DEVICE "/cmd", 1);
    } else if (id == MQTT_EVENT_DATA && e->data_len == 5 && memcmp(e->data, "water", 5) == 0) {
        ESP_LOGI(TAG, "command: water");
        manual_request = true;
    }
}

static int moisture_pct(int raw) {
    int p = (CAL_DRY - raw) * 100 / (CAL_DRY - CAL_WET);
    return p < 0 ? 0 : p > 100 ? 100 : p;
}

// One pulse; stops early if the tank runs dry while pumping. Returns the seconds the pump really ran.
static int pulse(void) {
    int64_t start = esp_timer_get_time(), len = (int64_t)PUMP_S * 1000000 / SCALE, ran;
    pump_set(true);
    while ((ran = esp_timer_get_time() - start) < len && tank_has_water())   // check the float switch all the time
        vTaskDelay(1);
    pump_set(false);
    pulses_today++;
    return (int)(ran * SCALE / 1000000);
}

void app_main(void) {
    ESP_ERROR_CHECK(nvs_flash_init());
    ESP_ERROR_CHECK(esp_netif_init());
    ESP_ERROR_CHECK(esp_event_loop_create_default());
    sensor_init();
    pump_set(false);                                   // the pump is off before anything else happens
    ESP_ERROR_CHECK(example_connect());

    esp_mqtt_client_config_t cfg = {
        .broker.address.uri = BROKER_URI,
        .credentials.client_id = "plant-" DEVICE,
        .session.last_will = { .topic = "home/plants/" 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));   // up to 10 s, then work offline anyway

    bool tank_warned = false, fault_warned = false, limit_warned = false;
    int day = 0;
    for (int minute = 0;; minute++) {
        if (minute / 1440 != day) { day = minute / 1440; pulses_today = 0; limit_warned = false; }
        int raw = soil_raw();
        bool fault = raw >= 4000 || raw <= 200;       // a loose wire floats to full scale, a short reads near 0
        int moist = fault ? -1 : moisture_pct(raw);
        bool tank = tank_has_water();

        if (minute % REPORT_MIN == 0) {
            char j[128];
            snprintf(j, sizeof j, "{\"seq\":%d,\"min\":%d,\"raw\":%d,\"moist\":%d,\"tank\":%s,\"pulses\":%d}",
                     seq++, minute, raw, moist, tank ? "true" : "false", pulses_today);
            ESP_LOGI(TAG, "%s", j);
            publish("telemetry", j, 0, 0);
        }

        bool want = manual_request || (!fault && moist < WATER_BELOW);
        if (fault) {
            if (!fault_warned) { event("sensor_fault", moist); fault_warned = true; }
            manual_request = false;                    // no blind watering: without a reading we cannot stop in time
        } else if (want && !tank) {
            if (!tank_warned) { event("tank_empty", moist); tank_warned = true; }
            manual_request = false;
        } else if (want && pulses_today >= MAX_PULSES) {
            if (!limit_warned) { event("daily_limit", moist); limit_warned = true; }
            manual_request = false;
        } else if (want) {
            bool manual = manual_request;
            manual_request = false;
            int ran = pulse();
            char what[40];
            snprintf(what, sizeof what, "%s_%ds", manual ? "manual_pulse" : "pulse", ran);
            event(what, moist);
            vTaskDelay(MINUTES(SOAK_MIN));             // let the water reach the sensor before the next decision
            minute += SOAK_MIN;
            continue;
        }
#ifdef SENSOR_SIM
        if (minute >= 95) { ESP_LOGI(TAG, "simulation done"); vTaskDelay(portMAX_DELAY); }   // QEMU lab: the script stops here
#endif
        if (tank) tank_warned = false;
        vTaskDelay(MINUTES(1));
    }
}

وهذه قرارات التصميم التي يقوم عليها البرنامج:

  • نبضة ثم انتظار: البرنامج لا يشغل المضخة حتى تصل الرطوبة إلى الحد، لأن الماء يحتاج دقائق ليصل من سطح التربة إلى الحساس، والبرنامج الذي يسقي حتى يقرأ «رطب» سيكون قد أغرق الأصيص قبل أن يصل الماء إلى الحساس. ولهذا يعطي نبضة 5 ثوان، ثم ينتظر 10 دقائق، ثم يقرأ من جديد ويقرر.
  • ثلاث حالات يرفض فيها السقي: الخزان فارغ، والقراءة مستحيلة، وثماني نبضات في اليوم. والحالة الأخيرة شبكة أمان: إذا سقى البرنامج ثماني مرات والتربة ما زالت جافة فهناك مشكلة لا يحلها مزيد من الماء، كأنبوب مفصول يسقي الأرض بدل الأصيص.
  • القراءة المستحيلة: السلك المفصول يجعل الرجل عائمة فتقرأ قرب 4095، أي «جاف جداً»، وبرنامج لا يفحص هذا سيسقي حتى يفرغ الخزان. ولهذا نعتبر القراءة فوق 4000 أو تحت 200 عطلاً، ونتوقف عن السقي، حتى الطلب اليدوي، لأننا دون قراءة لا نعرف متى نتوقف.
  • العوامة أثناء الضخ: البرنامج يفحص العوامة طوال النبضة، لا قبلها فقط، فإذا فرغ الخزان في منتصفها توقفت المضخة فوراً.
  • المضخة مطفأة أولاً: أول ما يفعله البرنامج إطفاء المضخة، قبل الشبكة وقبل أي شيء، لأن الرجل قد تكون في حالة غير معروفة لحظة التشغيل.

الرسائل

المتحكم يتكلم مع الوسيط بالبروتوكول MQTT الذي شرحناه في مقال MQTT، وكل الرسائل تحت home/plants/balcony-1/:

الموضوع Topicالاتجاهالمحتوى
telemetryمن المتحكمالقراءة كل 5 دقائق: الرقم الخام والنسبة والخزان وعدد النبضات
eventمن المتحكمما يحدث: نبضة، أو خزان فارغ، أو عطل حساس، أو حد يومي
statusمن المتحكم أو الوسيطonline عند الاتصال، وoffline من الوصية عند الانقطاع، والاثنتان محفوظتان Retained
cmdإلى المتحكمالأمر water لنبضة يدوية

والوصية Last Will هي ما يجعل النظام يعرف أن الجهاز انقطع: المتحكم يعطيها للوسيط عند الاتصال، والوسيط ينشرها إذا انقطع الاتصال دون أن يودعه المتحكم، كأن تنقطع الكهرباء أو الشبكة، أو تمر مدة keepalive مرة ونصف دون أي رسالة. ولهذا لا يحتاج المتحكم أن «يخبر» بانقطاعه، وهو لا يستطيع ذلك أصلاً بعد أن ينقطع.

الخادم: الاستقبال والتنبيهات

في الطرف الآخر خدمة صغيرة بلغة Python تشترك في كل رسائل النباتات، وتحفظ القراءات والأحداث في SQLite، وترسل إلى الجوال الأحداث التي تحتاج إنساناً فقط. والشكل التالي يبين المسار كله:

خمس بطاقات من اليمين إلى اليسار: ESP32 ثم الوسيط Mosquitto ثم خدمة الاستقبال ingest.py مع SQLite ثم خادم التنبيهات ntfy ثم الجوال بتطبيق ntfy، وأسهم بينها مكتوب عليها telemetry وhome/plants/# وevent وpush، وسهم معاكس cmd من الوسيط إلى ESP32، وتحتها شريط: القراءات تحفظ كلها والتنبيه فقط لما يحتاج إنساناً، وأمر السقي اليدوي في الاتجاه المعاكس
مسار القراءة والتنبيه من المتحكم إلى الجوال

والتنبيهات تمر بالأداة ntfy، وهي خادم مفتوح المصدر لإرسال التنبيهات إلى الجوال، تنشر فيه رسالة بطلب HTTP بسيط إلى موضوع باسم تختاره، وتطبيق ntfy على الجوال مشترك في الموضوع نفسه فيصله التنبيه. واخترناها لأنها تعمل على خادمك دون حساب في خدمة خارجية، ولأن إرسال تنبيه بها سطر واحد. والملف ingest.py:

"""Ingest for the plant watering project.
- subscribes to home/plants/# and keeps every reading and event in SQLite (/data/plants.db)
- turns the events that need a person into phone notifications through ntfy (topic "plants")
- notices when a device goes offline (its last will) and tells you"""
import json, sqlite3, time, urllib.request
import paho.mqtt.client as mqtt

DB = sqlite3.connect("/data/plants.db")
DB.executescript("""
CREATE TABLE IF NOT EXISTS reading(device TEXT, ts INT, seq INT, minute INT, raw INT, moist INT, tank INT, pulses INT);
CREATE TABLE IF NOT EXISTS event(device TEXT, ts INT, what TEXT, moist INT, pulses INT);
""")

# Events a person must act on: notification title, text, and ntfy priority (1 min .. 5 max)
NOTIFY = {
    "tank_empty":   ("Water tank empty", "refill the tank, watering is paused", 4),
    "sensor_fault": ("Soil sensor fault", "impossible reading, check the sensor wire. Watering is stopped", 5),
    "daily_limit":  ("Daily watering limit", "8 pulses today and the soil is still dry: check for a leak or a dry pump", 4),
    "offline":      ("Device offline", "the controller lost its connection", 3),
}

def notify(device, kind):
    title, body, prio = NOTIFY[kind]
    req = urllib.request.Request("http://ntfy/plants", data=f"{device}: {body}".encode(),
                                 headers={"Title": title, "Priority": str(prio), "Tags": "seedling"})
    urllib.request.urlopen(req, timeout=5).read()
    print(f"notify {device} {kind}", flush=True)

def on_message(c, u, m):
    _, _, device, kind = m.topic.split("/")          # home/plants/<device>/<kind>
    now = int(time.time())
    if kind == "status":
        print(f"status {device} = {m.payload.decode()}", flush=True)
        if m.payload == b"offline":
            notify(device, "offline")
        return
    if kind == "cmd":
        return
    r = json.loads(m.payload)
    if kind == "telemetry":
        DB.execute("INSERT INTO reading VALUES(?,?,?,?,?,?,?,?)",
                   (device, now, r["seq"], r["min"], r["raw"], r["moist"], int(r["tank"]), r["pulses"]))
    elif kind == "event":
        DB.execute("INSERT INTO event VALUES(?,?,?,?,?)", (device, now, r["event"], r["moist"], r["pulses"]))
        print(f"event {device} {r['event']} moist={r['moist']}", flush=True)
        if r["event"] in NOTIFY:
            notify(device, r["event"])
    DB.commit()

c = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="plant-ingest")
c.on_connect = lambda c, u, f, rc, p: c.subscribe("home/plants/#", qos=1)
c.on_message = on_message
while True:
    try:
        c.connect("broker", 1883)
        break
    except OSError:
        time.sleep(1)
c.loop_forever()

في الملف أعلاه لاحظ أن القاموس NOTIFY هو سياسة التنبيه كلها: أربعة أحداث فقط تصل إلى الجوال، ولكل واحد أولوية من 1 إلى 5، والعطل الذي يعني أن النظام أعمى أعلاها. أما النبضات العادية فتحفظ ولا ترسل، لأن تنبيهاً كل ساعة يقول «سقيت النبتة» سيجعلك تكتم التطبيق خلال يومين، ثم لا ترى التنبيه الذي يهم. وقد فصلنا هذه الفكرة في مقال التنبيهات Alerting.

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

تشغيل المشروع كاملاً

والآن نشغل كل شيء على جهاز واحد بـ Docker Compose: الوسيط، وntfy، وخدمة الاستقبال، والمتحكم على المحاكي. والملف compose.yaml:

# Plant watering lab: the ESP32 firmware in QEMU, the broker, ntfy for phone notifications, and the ingest service.
name: plant
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: plant-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 ]

ولاحظ السطر network_mode: "service:broker": حاوية المتحكم تشارك الوسيط شبكته، فإذا اتصل البرنامج داخل QEMU بالعنوان 10.0.2.2:1883، وهو عنوان الجهاز المضيف في شبكة QEMU، وصل إلى الوسيط مباشرة. وعلى اللوحة الحقيقية تغير هذا العنوان إلى عنوان وسيطك في الشبكة. والملف fw.sh يبني البرنامج مرتين ثم يشغل نسخة المحاكاة:

#!/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 (ADC + GPIO drivers, Wi-Fi), compiled only, to prove the real drivers build
#   build-sim: SENSOR_SIM=1 (simulated soil and tank, time x60) over QEMU's emulated Ethernet
set -eo pipefail   # a failed build must stop the script, not hide behind 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
# run until the firmware prints "simulation done" (95 simulated minutes), at most 10 minutes of wall time
qemu-system-xtensa -nographic -machine esp32 -drive file=build-sim/flash.bin,if=mtd,format=raw \
  -nic user,model=open_eth > /tmp/qemu.log 2>&1 &
QEMU=$!
for i in $(seq 600); do grep -q "simulation done" /tmp/qemu.log && break; sleep 1; done
kill $QEMU
grep -E "^[IWE] \([0-9]+\) (plant|example_connect):|Guru" /tmp/qemu.log

والبناء الأول للوحة الحقيقية، بالمحول ADC والأرجل وWi-Fi، ولا نشغله، وإنما نتأكد أن الكود الحقيقي يترجم دون أخطاء. والثاني نسخة المحاكاة على شبكة Ethernet المحاكاة، لأن QEMU لا يحاكي الراديو، والمكدس نفسه lwIP يعمل فوقها كما يعمل فوق Wi-Fi. ثم 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; } &
FW=$!
until [ -f data/qemu-started ]; do sleep 2; done   # wait for the two builds
until docker compose logs broker 2>/dev/null | grep -q plant-balcony-1; do sleep 2; done   # the device connected
sleep 15                                   # a quarter hour of the plant's time later
docker compose exec -T broker mosquitto_pub -t home/plants/balcony-1/cmd -m water -q 1   # one manual pulse
wait $FW
sleep 3                                    # QEMU was killed: the broker sends the last will
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 بالأمر التالي، والبناء الأول يأخذ دقائق لأنه يترجم ESP-IDF كاملاً:

bash run.sh

والمخرج من المتحكم سوف يكون كما يلي:

Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
plant.bin binary size 0xd8590 bytes. Smallest app partition is 0x100000 bytes. 0x27a70 bytes (15%) free.
Bootloader binary size 0x6580 bytes. 0xa80 bytes (9%) free.
plant.bin binary size 0x86ed0 bytes. Smallest app partition is 0x100000 bytes. 0x79130 bytes (47%) free.
### qemu
I (11913) plant: connected to the broker
I (11963) plant: {"seq":0,"min":0,"raw":2227,"moist":38,"tank":true,"pulses":0}
W (15053) plant: {"event":"pulse_5s","moist":34,"pulses":1}
I (26063) plant: {"seq":1,"min":15,"raw":2185,"moist":41,"tank":true,"pulses":1}
I (27633) plant: command: water
W (28153) plant: {"event":"manual_pulse_5s","moist":38,"pulses":2}
I (40153) plant: {"seq":2,"min":30,"raw":2144,"moist":43,"tank":true,"pulses":2}
I (45153) plant: {"seq":3,"min":35,"raw":2244,"moist":37,"tank":true,"pulses":2}
W (47243) plant: {"event":"pulse_5s","moist":34,"pulses":3}
I (59243) plant: {"seq":4,"min":50,"raw":2201,"moist":39,"tank":true,"pulses":3}
W (63333) plant: {"event":"pulse_5s","moist":34,"pulses":4}
I (73333) plant: {"seq":5,"min":65,"raw":2158,"moist":42,"tank":true,"pulses":4}
I (78333) plant: {"seq":6,"min":70,"raw":2258,"moist":36,"tank":true,"pulses":4}
W (79393) plant: {"event":"pulse_3s","moist":34,"pulses":5}
W (89393) plant: {"event":"sensor_fault","moist":-1,"pulses":5}
I (92393) plant: {"seq":7,"min":85,"raw":4095,"moist":-1,"tank":false,"pulses":5}
I (97393) plant: {"seq":8,"min":90,"raw":4095,"moist":-1,"tank":false,"pulses":5}
I (102393) plant: {"seq":9,"min":95,"raw":4095,"moist":-1,"tank":false,"pulses":5}
I (102393) plant: simulation done

والوقت في أول كل سطر بالملي ثانية منذ تشغيل الشريحة المحاكاة، أما الحقل min فهو دقائق النبتة في البرنامج. ولنقرأ القصة كما حدثت:

  • البداية: اتصل المتحكم بالوسيط، والتربة على 38 في المئة، ثم جفت إلى 34 فأعطى البرنامج أول نبضة 5 ثوان، وانتظر عشر دقائق، فقرأ 41 في المئة.
  • الأمر اليدوي: وصل الأمر water من الوسيط، فأعطى نبضة يدوية مع أن التربة كانت فوق الحد، لأن الطلب اليدوي قرار إنسان، ولكنه يمر بالفحوص نفسها: الخزان والحساس والحد اليومي.
  • دورة السقي: بعد ذلك تكرر النمط نفسه: تجف التربة إلى 34، نبضة، انتظار، ترتفع إلى قرابة 40، وهكذا. ولم تصل الرطوبة إلى الحد إلا لتعود فوقه بنبضة واحدة، وهذا ما تريده: كمية صغيرة كلما احتاجت النبتة، بدل غمر الأصيص مرة في اليوم.
  • الخزان يفرغ في منتصف النبضة: النبضة الخامسة سجلت pulse_3s لا pulse_5s، لأن الخزان فرغ بعد ثلاث ثوان، والبرنامج يفحص العوامة طوال الضخ فأوقف المضخة فوراً، وصار الحقل tank بعدها false.
  • السلك المفصول: بعد ذلك فصل سلك الحساس عن قصد، فقرأت الرجل 4095، أي «جاف تماماً». والبرنامج لم يصدق، فأرسل الحدث sensor_fault مرة واحدة، وصار يرسل الرطوبة -1، أي «لا أعرف»، ولم يحاول السقي.

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

وفي الطرف الآخر سجل خدمة الاستقبال:

status balcony-1 = online
event balcony-1 pulse_5s moist=34
event balcony-1 manual_pulse_5s moist=38
event balcony-1 pulse_5s moist=34
event balcony-1 pulse_5s moist=34
event balcony-1 pulse_3s moist=34
event balcony-1 sensor_fault moist=-1
notify balcony-1 sensor_fault
status balcony-1 = offline
notify balcony-1 offline

ثم التقرير، وهو ما يراه صاحب النبتة بعد ذلك: القراءات من SQLite، والتنبيهات التي وصلت إلى موضوع الجوال:

minute  raw  moist  tank  pulses
     0 2227    38%   yes       0
    15 2185    41%   yes       1
    30 2144    43%   yes       2
    35 2244    37%   yes       2
    50 2201    39%   yes       3
    65 2158    42%   yes       4
    70 2258    36%   yes       4
    85 4095     ?%   NO        5
    90 4095     ?%   NO        5
    95 4095     ?%   NO        5
events: pulse_5s, manual_pulse_5s, pulse_5s, pulse_5s, pulse_3s, sensor_fault
### notifications on ntfy topic 'plants'
[priority 5] Soil sensor fault: balcony-1: impossible reading, check the sensor wire. Watering is stopped
[priority 3] Device offline: balcony-1: the controller lost its connection

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

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

الأخطاء الشائعة

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

تطبيق عملي

  1. غير MAX_PULSES إلى 3 في main.c، وأعد تشغيل المختبر، وتوقع قبل التشغيل في أي دقيقة سيظهر الحدث daily_limit وتنبيهه.
  2. غير دقيقة العطل في sensor.c من 70 إلى 90، لتجف التربة بعد فراغ الخزان قبل أن يفصل السلك، وتأكد أن الحدث tank_empty وتنبيهه يظهران.
  3. أضف إلى ingest.py قاعدة تنبه إذا لم تصل قراءة من الجهاز خلال 15 دقيقة، دون الاعتماد على الوصية، فهي تغطي حالة لا تغطيها الوصية: وسيط أعيد تشغيله فنسي الجهاز.
  4. أضف أصيصاً ثانياً: جهاز باسم balcony-2 بحساس ومضخة، وتأكد أن التقرير يفصل بين الجهازين.
  5. على اللوحة الحقيقية: عاير حساسك بالنقطتين، واكتب الرقمين، ثم قارن قراءة التربة بعد السقي بساعة وبعد يوم.

حذف المختبر Cleanup

docker compose down
docker image rm plant-ingest:1
rm -rf data firmware/build-hw firmware/build-sim

الأوامر تحذف الحاويات وصورة خدمة الاستقبال وملفات البناء، وتبقى صورة espressif/idf:v5.4.1 لأنها مشتركة مع مشاريع السلسلة الأخرى.

الخلاصة Summary

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

وفي المشروع القادم من السلسلة بإذن الله سوف نأخذ مراقبة حرارة الغرفة ورطوبتها، بحساس على ناقل I2C هذه المرة.

سجل التحديثات 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.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.