مشاريع الهواة

أجهزة Home Assistant و أجهزة ESPHome

خمسة أجهزة ESP32-C3 لـ Home Assistant، مع كود Arduino الذي تشغّله في Mokxi، وملف YAML الخاص بـ ESPHome الذي سترفعه على الجهاز الحقيقي في المنزل.

يوفّر Mokxi خمسة قوالب للأجهزة التي يبنيها الناس أولًا في المنزل الذكي: حساس متعدد للغرفة، وحساس رادار للممر، ومفتاح باب جراج، ومتحكم شريط LED، وحساس للنباتات. يعمل كل منها على ESP32-C3 مُحاكى، وتتناول دورة أجهزة Home Assistant الخمسة كلها.

ما هو مُحاكى وما ليس مُحاكى

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

The network is simulated, and there is no MQTT broker. The board joins a simulated access point and serves pages to the Web tab (WiFi مُحاكى). لا شيء يصل إلى شبكتك الحقيقية أو إلى Home Assistant حقيقي. يطبع كل كود الموضوع والحمولة التي كان سينشرها، سطر واحد لكل رسالة، مثل publish home/multisensor/temperature 21.5, and serves its state as JSON at /state, which is the shape Home Assistant's RESTful sensor could poll on a real network.

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

الحساس المتعدد

حساس DHT22 لدرجة الحرارة والرطوبة على GPIO 3، وحساس ضوء BH1750 على I2C (GPIO 4 و5)، وحساس PIR على GPIO 18. الحساسات التي تتواصل مع أطراف اللوحة تعمل على 3.3 V، أما PIR فيحتاج 5 V للعمل ويُخرج 3.3 V. تُنشر الحركة لحظة تغيّرها، بينما تُنشر بيانات المناخ كل عشر ثوانٍ.

i2c:
  sda: GPIO4
  scl: GPIO5
sensor:
  - platform: dht
    pin: GPIO3
    model: DHT22
    temperature:
      name: "Temperature"
    humidity:
      name: "Humidity"
    update_interval: 10s
  - platform: bh1750
    name: "Illuminance"
binary_sensor:
  - platform: gpio
    pin: GPIO18
    name: "Motion"
    device_class: motion

حساس الرادار للممر

حساس RCWL-0516 على GPIO 18، ووحدة ضوء LDR على GPIO 0، و LED مصباح على GPIO 19. حساس RCWL-0516 ليس حساس وجود بموجات mmWave. إنه لوحة دوبلر بالموجات الدقيقة ترصد الحركة، حتى عبر البلاستيك والجدران الرقيقة. أما لوحات mmWave بتردد 24 GHz المباعة لرصد الوجود الحقيقي، مثل LD2410، فترصد أيضًا شخصًا يجلس بلا حركة وتتواصل عبر UART، وMokxi لا يحاكيها. يبقي الكود الممر مشغولًا لعشر ثوانٍ بعد آخر حركة، ولا يشغّل الضوء إلا عندما يكون الجو مظلمًا، على الجهاز نفسه.

binary_sensor:
  - platform: gpio
    pin: GPIO18
    name: "Hallway occupancy"
    device_class: occupancy
    filters:
      - delayed_off: 10s

مفتاح باب الجراج

مرحّل على GPIO 18 موصول عبر زر الجدار الخاص بالمفتاح، ومفتاحان مغناطيسيان على GPIO 3 (مغلق) وGPIO 2 (مفتوح)، وزر محلي على GPIO 9. يغلق المرحّل لنصف ثانية، كما لو ضغط إصبع على الزر، ويُبلغ المفتاحان المغناطيسيان عن موقع الباب الحقيقي.

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

switch:
  - platform: gpio
    pin: GPIO18
    id: door_relay
    restore_mode: ALWAYS_OFF
    on_turn_on:
      - delay: 500ms
      - switch.turn_off: door_relay
binary_sensor:
  - platform: gpio
    pin: { number: GPIO3, inverted: true, mode: INPUT_PULLUP }
    id: door_closed
  - platform: gpio
    pin: { number: GPIO2, inverted: true, mode: INPUT_PULLUP }
    id: door_open
cover:
  - platform: template
    name: "Garage door"
    device_class: garage
    lambda: |-
      if (id(door_closed).state) return COVER_CLOSED;
      if (id(door_open).state) return COVER_OPEN;
      return {};
    open_action:
      - switch.turn_on: door_relay
    close_action:
      - switch.turn_on: door_relay

متحكم شريط LED

ستة عشر بكسل WS2812B على GPIO 18، وزر تشغيل على GPIO 9، وزر تأثيرات على GPIO 10، ومقبض سطوع على GPIO 0. كل تغيير يتلاشى خلال نصف ثانية تقريبًا، ويقبل /set في تبويب الويب الحالة والسطوع واللون والتأثير. لشريط حقيقي، استخدم مصدر 5 V خاصًا به بمقاس مناسب، ومدّ الطاقة على طول الامتدادات الطويلة، وشارك الأرضي مع اللوحة، وضع محوّل مستوى على خط البيانات وملائمًا قرب المصدر.

light:
  - platform: esp32_rmt_led_strip
    pin: GPIO18
    num_leds: 16
    chipset: WS2812
    rgb_order: GRB
    name: "Strip"
    default_transition_length: 600ms
    effects:
      - addressable_rainbow:

حساس النبات

حساس تربة سعوي على GPIO 3، ووحدة ضوء LDR على GPIO 4، و LED أحمر على GPIO 19 يضيء عندما يعطش النبات. التربة الأكثر رطوبة تعطي قراءة أقل، وقراءتا المعايرة، الغرسة في الهواء الجاف والغرسة في الماء، تحوّلان كل ما بينهما إلى نسبة من 0 إلى 100 بالمئة. إنه حساس فقط، بلا مضخة.

sensor:
  - platform: adc
    pin: GPIO3
    name: "Soil moisture"
    unit_of_measurement: "%"
    attenuation: 12db
    filters:
      - median:
          window_size: 5
      - calibrate_linear:
          - 2.55 -> 0.0
          - 1.27 -> 100.0

إلى أين تتوجه بعد ذلك

Open a template: الحساس المتعدد لـ Home Assistant، حساس الرادار للممر، مفتاح باب الجراج، LED strip controller or حساس النبات. الحق بالدورة، أجهزة Home Assistant، أو اقرأ الدليل على /learn/home-assistant-esphome-devices.