Home Assistant
مضمّن في Macro Deckشغّل الأضواء وأطفئها، وفعّل المشاهد والنصوص البرمجية، واعرض الحالات المباشرة من Home Assistant على لوحتك.
نافذة الاتصال بـ Home Assistant مع حقلي العنوان ورمز الوصول طويل الأمد
- تشغيل الكيانات أو إطفاؤها أو تبديلها، بأزرار تعرض حالتها
- ضبط الأضواء والأغطية ومنظّمات الحرارة ومشغّلات الوسائط
- تفعيل المشاهد والنصوص البرمجية والأتمتة، أو استدعاء أي خدمة
- متغيرات مباشرة لحالة أي كيان أو أي سمة من سماته
- مشغّلات عند تغيّر الحالات وعند الأحداث في ناقل الأحداث
يربط تكامل Home Assistant بين Macro Deck وHome Assistant الخاص بك عبر واجهة WebSocket API. يُبقي Macro Deck اتصالًا واحدًا مفتوحًا، فتصل الحالات لحظة تغيّرها في Home Assistant، وتُنفَّذ الإجراءات فورًا. يمكن أن يعمل Home Assistant في أي مكان يستطيع Macro Deck الوصول إليه: على الحاسوب نفسه، أو على Raspberry Pi أو خادم في شبكتك، أو على عنوان بعيد.
ما يمكنك فعله
- تشغيل كيان واحد أو أكثر أو إطفاؤه أو تبديله. يضيء الزر الذي يحمل تبديل ما دام الكيان يعمل.
- ضبط حالة مصباح وسطوعه ولونه ودرجة حرارة لونه والانتقال باستخدام ضبط المصباح.
- فتح غطاء أو إغلاقه أو إيقافه أو تحديد موضعه، وضبط درجة حرارة منظّم الحرارة ووضعه ووضع المروحة والإعداد المسبق، والتحكم في تشغيل مشغّل وسائط ومستوى صوته.
- تفعيل مشهد، وتشغيل نص برمجي مع متغيرات، وإطلاق أتمتة أو تفعيلها أو تعطيلها.
- استدعاء أي خدمة باستخدام استدعاء الخدمة، مع كيانات أو أجهزة أو مناطق كهدف وبيانات بصيغة JSON.
- قراءة حالة كيان أو سمة من سماته في متغير من متغيرات Macro Deck باستخدام الحصول على حالة الكيان.
بعض الأمثلة على الإعدادات:
- زر مع تبديل لمصباح مكتبك يعرض ما إذا كان المصباح مضاءً.
- زر فيلم يفعّل مشهد الأفلام ويوقف الموسيقى مؤقتًا على مشغّل وسائط.
- منزلق مربوط بسطوع مصباح، فتخفّض إضاءته من اللوحة وترى التغييرات التي تُجرى في Home Assistant.
- زر تعرض تسميته درجة حرارة مستشعر، وتدفق على تغيّرت حالة الكيان يعرض إشعارًا عند فتح الباب الأمامي.
المتغيرات والتحديثات المباشرة
يوفر Home Assistant قيمًا أكثر بكثير مما يعرضه Macro Deck مسبقًا. تجد كل كيان في المجموعة المطوية متغيرات غير مرتبطة ضمن متغيرات التكامل، في صفحة المتغيرات وفي كل منتقي متغيرات. افتح كيانًا لترى حالته وسماته، واختر ربط على ما تحتاج إليه: فيصبح متغيرًا عاديًا يتحدّث مباشرة. بهذه الطريقة يستطيع منزلق التحكم في سطوع مصباح، أو سرعة مروحة، أو موضع غطاء، أو مستوى صوت مشغّل وسائط، أو درجة حرارة منظّم حرارة.
عندما ينقطع الاتصال، يعيد Macro Deck الاتصال تلقائيًا، منتظرًا مدة أطول قليلًا بعد كل محاولة فاشلة، حتى دقيقة واحدة. ينطلق المشغّلان متصل وغير متصل عند حدوث ذلك، وتفشل الإجراءات برسالة ما دام Home Assistant غير متصل. يمكنك ربط Home Assistant واحد.
ما تحتاج إليه
- Home Assistant يعمل ويمكن لـ Macro Deck الوصول إليه، مثل
http://homeassistant.local:8123. - حساب مستخدم في Home Assistant لإنشاء رمز وصول طويل الأمد به.
- لعنوان
https://: شهادة يثق بها حاسوبك.
خطوات الإعداد
الخطوة 1: أنشئ رمز وصول طويل الأمد
في Home Assistant، افتح ملفك الشخصي وانتقل إلى علامة التبويب Security. مرّر إلى Long-lived access tokens، وأنشئ رمزًا، وسمّه
Macro Deckوانسخه. لا يعرضه Home Assistant إلا مرة واحدة.الخطوة 2: افتح تكامل Home Assistant
في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر Home Assistant. في علامة التبويب نظرة عامة، انقر إعداد في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها، ويُفعَّل التكامل بعد اكتمال الإعداد.
الخطوة 3: أدخل العنوان والرمز
في نافذة الاتصال بـ Home Assistant، أدخل:
- العنوان: العنوان الذي تفتح به Home Assistant، بما في ذلك المنفذ، مثل
http://homeassistant.local:8123. - رمز الوصول طويل الأمد: الرمز الذي نسخته للتو.
عند النقر على متابعة، يختبر Macro Deck الاتصال ويحفظه باسم Home Assistant مع اسم منزلك بين قوسين.
- العنوان: العنوان الذي تفتح به Home Assistant، بما في ذلك المنفذ، مثل
الخطوة 4: أضف إجراءً إلى زر
في صفحة اللوحة، انقر زرًا. يجب أن تكون اللوحة غير مقفلة: إذا ظهر الزر قفل في أعلى اليسار، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر Home Assistant على يمين نافذة إضافة إجراء، ثم اختر تبديل وحدّد كيانًا واحدًا أو أكثر في الكيانات، مثل مصباح.
الخطوة 5: اضغط الزر
اضغط الزر على لوحتك. يتبدّل المصباح في Home Assistant، ويعرض الزر ما إذا كان مضاءً.
الخطوة 6: اربط قيمة لعرضها على زر
لعرض قيمة، افتح علامة التبويب المتغيرات في صفحة Home Assistant وافتح المجموعة متغيرات غير مرتبطة. افتح كيانًا وانقر ربط على حالته أو على إحدى سماته. استخدم المتغير الجديد في تسمية، مثل
{{ vars.ha_sensor_living_room_temperature }}.
الإجراءات12
ضعها على زر أو شغّلها من تدفق.
- استدعاء الخدمة
- يستدعي أي خدمة في Home Assistant مع كيانات وأجهزة ومناطق اختيارية وبيانات بصيغة JSON.
- تشغيل
- يشغّل كيانًا واحدًا أو أكثر.
- إطفاء
- يطفئ كيانًا واحدًا أو أكثر.
- تبديل
- يبدّل حالة كيان واحد أو أكثر، ويعرض على الزر ما إذا كانت تعمل.
- ضبط المصباح
- يشغّل مصباحًا أو يطفئه ويضبط سطوعه ولونه ودرجة حرارة لونه والانتقال.
- التحكم في الغطاء
- يفتح غطاءً أو يغلقه أو يوقفه، أو يضبط موضعه أو موضع إمالته.
- التحكم في مشغّل الوسائط
- يشغّل مشغّل وسائط أو يوقفه مؤقتًا أو يوقفه أو يتخطى أو يكتم صوته أو يضبط مستوى صوته.
- ضبط منظّم الحرارة
- يضبط درجة الحرارة المستهدفة ووضع منظّم الحرارة ووضع المروحة والإعداد المسبق.
- تفعيل المشهد
- يفعّل مشهدًا، مع انتقال اختياري.
- تشغيل النص البرمجي
- يشغّل نصًا برمجيًا، مع متغيرات اختيارية ككائن JSON.
- التحكم في الأتمتة
- يطلق أتمتة أو يفعّلها أو يعطّلها أو يبدّلها، مع إمكانية تجاهل شروطها.
- الحصول على حالة الكيان
- يقرأ حالة كيان أو إحدى سماته في متغير من متغيرات Macro Deck.
المشغّلات4
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- متصل
- اتصل Macro Deck بـ Home Assistant.
- غير متصل
- انقطع الاتصال بـ Home Assistant.
- تغيّرت حالة الكيان
- تغيّرت حالة كيان، ويمكن قصره على نطاق أو كيان، أو على التغيّر من حالة معيّنة أو إليها.
- حدث Home Assistant
- أي شيء في ناقل أحداث Home Assistant، مثل الأتمتة والنصوص البرمجية وضغطات أزرار ZHA وdeCONZ والأحداث المخصّصة، ويمكن قصره على نوع حدث واحد.
المتغيرات5
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
homeassistant_is_connected- ما إذا كان Macro Deck متصلًا بـ Home Assistant.
homeassistant_version- إصدار Home Assistant الخاص بك.
homeassistant_location_name- اسم منزلك.
homeassistant_entity_count- عدد الكيانات في Home Assistant الخاص بك.
ha_<entity>,ha_<entity>_<attribute>- حالة كيان أو أي سمة من سماته، بعد أن تربطها من متغيرات غير مرتبطة. يُقترح الاسم من معرّف الكيان، مثل
ha_light_office_lampأوha_light_office_lamp_brightness_pct. ويمكن ضبط كثير منها أيضًا، مثلbrightness_pctلمصباح.
الأسئلة الشائعة
هل يجب أن يعمل Home Assistant على الحاسوب نفسه؟
لا. يتصل Macro Deck عبر الشبكة، لذا يمكن أن يعمل Home Assistant على Raspberry Pi أو خادم أو عنوان بعيد، ما دام Macro Deck يستطيع الوصول إليه.
هل يمكنني ربط أكثر من Home Assistant؟
لا. يدعم التكامل Home Assistant واحدًا. تشغيل الإعداد مجددًا يستبدل الاتصال، وتستمر أزرارك في العمل.
يقول الإعداد إنه تعذّر التحقق من الشهادة. ماذا أفعل؟
لا يثق حاسوبك بشهادة عنوان https:// الخاص بك. اجعلها موثوقة في مخزن الشهادات في نظام التشغيل، أو اتصل عبر http:// في شبكتك المحلية.
لا يتصل Home Assistant الموجود خلف وكيل عكسي. لماذا؟
تحظر بعض الوكلاء الطلبات التي تعدّها حركة مرور آلية. افتح الإعدادات > متقدم > HTTP وأدخل قيمة يقبلها الوكيل في HTTP User-Agent.
ماذا يحدث عندما ينقطع الاتصال؟
يعيد Macro Deck الاتصال تلقائيًا ويُطلق المشغّلين غير متصل ومتصل. عندما يتعذّر عليه الوصول إلى Home Assistant لفترة، يعرض التكامل Home Assistant غير قابل للوصول ويواصل المحاولة في الخلفية.
أين يُخزَّن رمز الوصول الخاص بي؟
يُخزَّن الرمز مشفّرًا على حاسوبك ولا يغادره أبدًا إلا للتواصل مع Home Assistant الخاص بك. عندما يرفضه Home Assistant، يعرض التكامل مشكلة: أنشئ رمزًا جديدًا وشغّل الإعداد مجددًا.
المزيد في المنزل الذكي والويب
AdGuard Home
مضمّن في Macro Deckشغّل حماية AdGuard Home أو أوقفها أو أوقفها مؤقتًا، واعرض إحصاءاتها على لوحتك.
خلاصات RSS
مضمّن في Macro Deckتابع خلاصات RSS وAtom، واعرض أحدث مقالاتها في الأدوات، واستجب عند وصول مقالات جديدة.
HTTP
مضمّن في Macro Deckأرسل طلبات HTTP من زر واحفظ قيمًا من الاستجابة في متغيرات.
الطقس
مضمّن في Macro Deckاعرض الطقس الحالي والتوقعات لمواقعك على لوحتك، دون مفتاح API.