تعلّم

أجهزة Home Assistant وESPHome على ESP32

متوسط

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
ESP32-C3: حساس متعدد لغرفةمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
اضغط على حساس PIR لبدء الحركة وراقب الشاشة التسلسلية. تبويب الويب يقدّم ‎/state‎.

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

الدائرة أعلاه هي حساس متعدد لغرفة على ESP32-C3 في Mokxi: DHT22 للحرارة والرطوبة، وBH1750 للإضاءة، وPIR للحركة. اضغط «تشغيل»، ثم اضغط على PIR، وستعرض الشاشة التسلسلية كل قراءة على شكل الرسالة التي ستنشرها اللوحة. افتح تبويب الويب وستعود القيم نفسها كملف JSON من خادم اللوحة نفسها.

أمران مقدمًا لأنهما مهمان. يشغّل Mokxi كود Arduino لا ESPHome، لذا ينفّذ كل جهاز هنا يدويًا ما كانت مكوّنات ESPHome ستنفّذه، وتعرض صفحة المساعدة ملف YAML المطابق لاستخدامه عند برمجة لوحة حقيقية. والشبكة محاكاة، بلا وسيط MQTT وبلا طريق إلى Home Assistant الحقيقي عندك: تطبع اللوحة ما كانت سترسله بدلًا من إرساله.

تريد النسخة خطوة بخطوة؟ الدرس «ابدأ دورة أجهزة Home Assistant» يشرح هذا بالتفصيل مع نقاط تحقق.

افتح الدرس

خمسة أجهزة يبنيها الناس أولًا

لكل منها قالب في Mokxi: الحساس المتعدد؛ وحساس ممر بالرادار يبقي الضوء مضاء عشر ثوانٍ هادئة ولا يبدّله إلا في الظلام؛ وفاتحة باب كراج بمرحّل عبر زر الحائط ومفتاحين مغناطيسيين؛ ومتحكم شريط WS2812 بتشغيل وإيقاف وسطوع ولون وتأثيرات متلاشية؛ وحساس نبات يحوّل مجس تربة سعويًا إلى نسبة معايَرة مع تنبيه العطش.

كل جهاز موصّل كما ستبنيه فعلًا، فالحساسات التي تتخاطب مع أطراف اللوحة على 3.3 V، والوحدات التي تحتاج 5 V، مثل PIR أو لوحة رادار، على خطها الخاص. مقاومة السحب إلى 5 V على طرف يعمل بجهد 3.3 V من أسهل الطرق لإتلاف ESP32، ولوحة التجارب في المحاكي مكان آمن لتعلّم وجهة كل سلك.

الحركة ليست وجودًا

سؤال شائع في منتديات Home Assistant هو لماذا يطفئ حساس الحركة الأضواء على شخص يقرأ على الأريكة. كل من PIR ورادار الميكروويف RCWL-0516 يرصد الحركة لا الأشخاص. أما لوحات mmWave بتردد 24 GHz المباعة لكشف الوجود، مثل LD2410، فترصد أيضًا شخصًا يجلس ساكنًا، وتتخاطب عبر اتصال تسلسلي.

يمثّل Mokxi الرادار RCWL-0516، لذا يستخدم قالب الرادار الحيلة التي يستخدمها الجميع مع حساس الحركة: تأخير الإطفاء. يُحتسب الممر مشغولًا لحظة تحرك أي شيء، ولا يُصفّى إلا بعد عشر ثوانٍ هادئة. تسمّي ESPHome الفكرة نفسها مرشّح delayed_off. والقالب صريح حول الحد: اجلس ساكنًا تمامًا وقتًا كافيًا فينطفئ الضوء.

باب الكراج بأمان

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

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

ضغطة واحدة على زر الحائط، من كود باب الكراج
digitalWrite(RELAY_PIN, HIGH);   // the relay closes across the button
pressedAt = millis();
// ...and in loop(), half a second later:
if (pressing && millis() - pressedAt >= PRESS_MS) {
  digitalWrite(RELAY_PIN, LOW);
}

من المحاكي إلى ESPHome

عندما تعمل الدائرة كما ينبغي، تكون الخطوة التالية إلى العتاد الحقيقي غالبًا عبر ESPHome. تعرض صفحة المساعدة في كل قالب ملف YAML الذي يؤدي المهمة نفسها: حساس dht وحساس bh1750 وحساسًا ثنائيًا gpio للجهاز متعدد الحساسات، وغطاء template مع device_class garage للباب، وإضاءة esp32_rmt_led_strip للشريط، وحساس adc مع calibrate_linear لمجس النبتة. قراءة الكود جنبًا إلى جنب مع YAML طريقة جيدة لفهم ما يفعله كل مكوّن في الأساس، وهذا ما تحتاجه في اليوم الذي تسوء فيه إحدى القراءات.

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

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

افتح الدائرة

الأسئلة

هل يشغّل Mokxi نظام ESPHome؟

لا. يشغّل Mokxi كود Arduino على ESP32-C3 محاكى. يقوم كل قالب يدويًا بما تفعله مكوّنات ESPHome، وتعرض صفحة المساعدة الخاصة به ملف YAML المطابق لحين برمجة لوحة حقيقية.

هل تستطيع اللوحة المحاكاة التواصل مع Home Assistant الخاص بي؟

لا. الشبكة محاكاة وتبقى داخل تبويب المتصفح، دون خادم MQTT. تطبع الأكواد الرسائل التي كانت ستنشرها وتقدّم حالتها بصيغة JSON إلى تبويب الويب.

هل RCWL-0516 حساس حضور بموجات mmWave؟

لا. إنه حساس دوبلر بالموجات الدقيقة يرصد الحركة. أما لوحات mmWave مثل LD2410 فتستطيع أيضًا رصد شخص جالس بلا حركة، وMokxi لا يحاكيها.

كيف ينبغي توصيل فتّاحة باب الجراج؟

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

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.