RisalDash RisalDash

دليل · ESPHome · بلا كود

ESPHome: صِفه، لا تبرمجه

إن كان هدفك «هذا الطرف مرحّل، وذاك حسّاس حرارة، ضعهما في Home Assistant»، فلا تحتاج كتابة برنامج ثابت إطلاقًا. يأخذ ESPHome ملفّ YAML قصيرًا، ويترجمه إلى ثنائيّ ESP، ويحرقه — فيظهر الجهاز في Home Assistant، مع التحديثات. إليك الفكرة كاملة، وإعدادًا حقيقيًّا، وأين حدوده.

ESPHomeHome AssistantYAMLبلا كودESP32
إعداد ESPHome بصيغة YAML يُترجَم إلى ESP32 يظهر في Home Assistant
أسطر YAML قليلة تصير برنامجًا ثابتًا — يظهر الحسّاس في Home Assistant وحده.

بلا كود، لكن ليس بلا قوّة

يقلب ESPHome الترتيب المعتاد: بدل كتابة C++ وإعداد تكامل، أنت تصف الجهاز وتدع سلسلة الأدوات تولّد البرنامج الثابت — مع Wi-Fi وتحديثات OTA واكتشاف Home Assistant الأصليّ. إنه الطرف بلا كود من حِزم ESP32، ولعقد الأتمتة المنزلية القياسية يحوّل عطلة أسبوع إلى عشر دقائق.

الجهاز ملفّ YAML

الإعداد هو الجهاز. تُعلن اللوحة وWi-Fi والمكوّنات التي وصّلتها:

esphome:
  name: porch
esp32:
  board: esp32dev

sensor:
  - platform: dht
    pin: GPIO4
    temperature:
      name: "Porch temp"

switch:
  - platform: gpio
    pin: GPIO26
    name: "Porch light"

احرق مرّة عبر USB، ومن ثمّ يتحدّث عبر الأثير: تحرّر الـ YAML، تضغط install، بلا كابل. ذلك الـ DHT وذلك المرحّل كيانان حيّان في Home Assistant، جاهزان للوحات والأتمتة.

حين تحتاج أكثر: رشّة C++

السقف هو قائمة المكوّنات بالضبط. تحتاج ما لا يمثّله ESPHome — رقاقة I²C غريبة، أو حسابًا خاصًّا؟ يمكنك إسقاط lambda صغيرة (C++ مضمّن) داخل الـ YAML، أو كتابة مكوّن مخصّص كامل — فنادرًا ما تصطدم بجدار، إنما ترجع إلى الكود للجزء الصعب الواحد. للشاشة، اختر العرض أولًا في دليل الشاشات؛ يقود ESPHome معظمها من YAML.

ESPHome مقابل بنائه يدويًّا

الأسلوبالجهدالمرونةالأفضل لـ
ESPHome (YAML)ضئيلضمن المكوّناتحسّاسات ومفاتيح HA القياسية
Arduino + MQTTمتوسّطكاملةمنطق خاصّ، مواضيعك
RisalDashأسطر قليلةعناصرهلوحة مُقدَّمة، لا HA

القاعدة: عقدة Home Assistant قياسية → ESPHome؛ منطق خاصّ أو وسيطك → Arduino + MQTT؛ جهاز يقدّم واجهته → مكتبة لوحة. تتعايش بسلام — بيوت كثيرة تشغّل الثلاثة.

تريد أن يقدّم الجهاز واجهته بدلًا من ذلك؟ لوحة من أسطر C++ قليلة.