يوفّر 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.