اندماج Ajax Home Assistant: أخيرًا مكون إضافي كامل حقيقي لجرس الإنذار الخاص بك!

عندما قمت بكتابة الدليل الأول لربط إنذار Ajax بـ Home Assistant، كان يجب التلاعب بين SIA و Jeedom و MQTT والمواضيع المتعددة… كانت النتيجة تعمل بشكل مثالي، لكن يجب أن تحب المصانع المعقدة. اليوم، تغير كل شيء تماماً: قام المطورون بتطوير تكامل Ajax Home Assistant الأصلي، القابل للتثبيت عبر HACS، والذي يتحدث مباشرة إلى واجهة برمجة التطبيقات السحابية الرسمية لـ Ajax. التسليح، التفكيك، الإشعارات، المستشعرات، المرحلات… كل شيء يُرسل إلى Home Assistant، في الوقت (تقريباً) الحقيقي!

تم تثبيته في منزلي منذ عدة أيام الآن، وأرغب في أن أقدم لكم عرضًا أكثر تفصيلاً عن هذا الملحق المنتظر…

تذكير سريع بالطرق القديمة

حتى الآن، للحديث عن Ajax Home Assistant، كانت هناك طريقتان.

الأولى كانت تمر عبر تكامل SIA Alarm Systems في Home Assistant. كان إنذار Ajax مُعدًا كما لو أن Home Assistant هو مركز مراقبة. كنا نسترجع حالة النظام، وبعض المعلومات حول الحريق / الفيضانات، وهذا كل شيء. لم يكن من الممكن التحكم في الإنذار، لا توجد تفاصيل عن كل مستشعر. كان ذلك مفيدًا بشكل أساسي لتفعيل بعض السيناريوهات بناءً على الحالة العامة للإنذار، مثل تمرير السخان إلى وضع الاقتصاد عند تنشيط الإنذار عند مغادرة المنزل.

الطريقة الثانية، الموضحة في دليلي السابق، كانت تتكون من استخدام ملحق Ajax في Jeedom، ثم إعادة نشر جميع المعلومات في Home Assistant عبر MQTT. كانت أكثر اكتمالًا، مع استرجاع تقريبًا جميع مستشعرات Ajax، ولكن بتكلفة خادم أتمتة ثاني، ووسيط MQTT، وتخطيط لعشرات المواضيع… باختصار، قوي جدًا، لكن بالتأكيد ليس في متناول الجميع.

تغير الملحق الجديد اللعبة تمامًا: أصبح Ajax Home Assistant ثنائيًا أسهل بكثير في الإعداد.

ما يتيحه ملحق Ajax Home Assistant الجديد

التكامل ajax-hass هو مكون مخصص لـ Home Assistant يتصل مباشرة بـ Cloud Ajax عبر واجهة برمجة التطبيقات الرسمية وتدفق gRPC، تمامًا مثل تطبيق Ajax المحمول. بشكل فعلي، يصبح محور Ajax الخاص بك “مواطنًا من الدرجة الأولى” في Home Assistant، مع لوحة تحكم إنذار حقيقية وكيانات للمستشعرات، وأبواق الإنذار، والمر relays، والمقابس، إلخ.

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

فيما يخص استرجاع المعلومات، يعرض الملحق أحداث التسليح / التفكيك مع اسم المستخدم Ajax، وإشعارات الإنذار، وكشف الحركة، وفتح الأبواب والنوافذ، وإنذارات الحريق أو الفيضانات، بالإضافة إلى مستشعرات “تقنية” مثل مستوى البطارية، جودة الإشارة، درجة الحرارة أو حالة الاتصال. إنه شامل جدًا.

يدير التكامل عدة محاور Ajax في نفس Home Assistant إذا لزم الأمر، والواجهة مترجمة بالفعل إلى الفرنسية. في ما يتعلق بنطاق المعدات، يختبر المطور بشكل أساسي محور 2 Plus و MotionCam، لكن التصميم يعتمد على واجهة برمجة التطبيقات الرسمية لـ Ajax وقد تحقق المجتمع من عدد جيد من لوحات المفاتيح، وأبواق الإنذار، وأجهزة الاتصال، وكاشفات الحريق، إلخ.

وبالتالي نجد أنفسنا مع ثنائي حقيقي Ajax Home Assistant، قادر على التحكم ورصد نظام الإنذار بدقة، من دون الحاجة إلى التوجه عبر طرق ملتوية.

تحضير تثبيت Ajax و Home Assistant

قبل البدء، من الأفضل التحقق من بعض المتطلبات الأساسية.

يجب أن يكون نظام Ajax الخاص بك جاهزًا، مع محور مُعد في التطبيق الرسمي، وجميع الكاشفات مضمنة بشكل صحيح ومدمجة، وإذا أمكن، المجموعات معرّفة مسبقًا (الدور الأرضي، الطابق، المرآب، إلخ.). كلما كانت إعدادات Ajax نظيفة، كانت قسم Home Assistant أكثر راحة للتعامل.

على صعيد الأتمتة، تحتاج إلى Home Assistant محدث، مع HACS مثبتًا وجاهزًا، لأن ملحق Ajax Home Assistant يتم توزيعه كتكامل مخصص. تحقق أيضًا من أن نسخة Home Assistant الخاصة بك لديها وصول إلى الإنترنت إلى خوادم Ajax، نظرًا لأن الاتصال يمر عبر السحابة عبر HTTPS و gRPC.

وأخيرًا، تأكد من أن تثبيت Home Assistant الخاص بك آمن بشكل صحيح: كلمة مرور قوية، وصول بعيد محمي (عبر البروكسي العكسي، المصادقة، شهادة TLS)، والنسخ الاحتياطية بانتظام. يعد دمج نظام الإنذار الخاص بك في أتمتتك أمرًا مريحًا للغاية، لكنه يتطلب أن تكون أكثر دقة بشأن الأمان العام للبنية التحتية.

تثبيت تكامل Ajax عبر HACS

لننتقل إلى الجزء العملي. هل HACS موجود بالفعل على Home Assistant الخاص بك؟ رائع، يمكننا أن نبدأ تثبيت ملحق Ajax Home Assistant.

تتمثل الخطوة الأولى في إدخال مستودع GitHub للملحق في HACS. في واجهة Home Assistant، افتح HACS، ثم قسم التكاملات المخصصة. في الزاوية العلوية اليمنى، يتيح لك زر به ثلاث نقاط الوصول إلى قائمة الخيارات المتقدمة. عند اختيار الإدخال “مستودعات مخصصة”، يمكنك إضافة مستودع جديد.

في حقل URL، أدخل عنوان المستودع https://github.com/foXaCe/ajax-hass، واختر “تكامل” كفئة. ثم أكد، وأغلق النافذة. في المرة القادمة التي تبحث فيها عن تكامل في HACS، سيظهر “نظام أمن Ajax” في القائمة.

لا تزال في HACS، قم ببحث عن “نظام أمن Ajax”، وافتح الصفحة المقابلة، ثم قم بتثبيتها.

ستقوم HACS بتنزيل المكون ajax-hass ووضعه في مجلد custom_components/ajax من تثبيت Home Assistant الخاص بك.

بمجرد انتهاء التثبيت، هناك حاجة لإعادة تشغيل Home Assistant لتحميل التكامل الجديد.

إضافة تكامل Ajax Home Assistant في Home Assistant

بمجرد إعادة تشغيل Home Assistant، يمكننا الانتقال إلى التكوين. يتم كل شيء من خلال الواجهة، دون الحاجة إلى YAML، وهذا رائع!

افتح قائمة “الإعدادات”، ثم “الأجهزة والخدمات”. في أسفل الصفحة، استخدم زر “إضافة تكامل”. في مربع البحث، اكتب “Ajax”. يجب أن ترى “نظام أمن Ajax” يظهر مع الرمز المناسب. اخترها لبدء معالج التكوين.

ثم يطلب التكامل منك بيانات اعتماد حسابك في Ajax، وهي عنوان البريد الإلكتروني وكلمة المرور المستخدمة في التطبيق الرسمي. لا يحتاج الملحق إلى عنوان IP محلي للمحور، ولا موانئ غريبة، كل شيء يمر عبر سحابة Ajax.

يأتي بعد ذلك إعداد مفيد جدًا: فلتر الإشعارات. يمكنك اختيار عدم استرجاع أي إشعار في Home Assistant، أو فقط إنذارات الاقتحام، أو أحداث الأمان (التسليح / التفكيك، إنذارات تقنية)، أو كل شيء، بما في ذلك أحداث المستشعرات بشكل دوري. إذا كان من المتوقع إنشاء الكثير من الأتمتة في Ajax Home Assistant، فإن من الجيد بدءًا على الأقل مع أحداث الأمان، ثم الضبط.

أكد، وانتظر بضع ثوانٍ: يتصل التكامل بسحابة Ajax، ويسترجع قائمة محاورك. هنا لدي على سبيل المثال 3 أنظمة Ajax مختلفة: يمكنني إضافتها جميعًا أو اختيار فقط ذلك الذي يهمني، مثل “المنزل” فقط هنا.

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

ما الذي نجده في Home Assistant بعد التكامل

بمجرد أن يتم إعداد تكامل Ajax Home Assistant، جولة سريعة في “الأجهزة والخدمات” يسمح برؤية النتيجة. يظهر كل محور Ajax كجهاز، مع لوحة إنذار رئيسية ومجموعة من المستشعرات والمشغلات.

تسمح لوحة الإنذار، المُعروضة ككيان alarm_control_panel، بتسليح المنزل بالكامل، والتحويل إلى وضع الليل، والتفكيك، واستخدام التسليح الجزئي حسب المجموعة إذا قمت بإعداده في تطبيق Ajax. تصبح هذه الكيان المركز الرئيسي لسيناريوهات الأمان الخاصة بك.

تُعرض كاشفات الحركة كـ binary_sensor عادية، التي تتحول إلى الحالة “تشغيل” عند الكشف وتعود إلى “إيقاف” بعد فترة الراحة. كما تُعرض اتصالات الأبواب والنوافذ أيضًا على شكل مستشعرات ثنائية، وهو مثالي لإطلاق سيناريو من نوع إيقاف التدفئة إذا ظلت نافذة مفتوحة لفترة طويلة جدًا.

تتحول كاشفات الدخان، وأول أكسيد الكربون أو الفيضانات أيضًا إلى كيانات قابلة للاستخدام مباشرة.

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

للمهتمين، تظهر أيضًا مجموعة من المستشعرات “التقنية”: مستوى البطارية، قوة الإشارة الراديوية، درجة الحرارة، حالة الاتصال، إلخ. هذه هي أساسيات جيدة لإنشاء لوحة تحكم “صحة نظام Ajax” في Home Assistant.

أمثلة على سيناريوهات Ajax Home Assistant في الوضع العملي

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

تتمثل أول سيناريو مفيد للغاية في تسليح الإنذار تلقائيًا عندما يغادر الجميع المنزل. نستخدم وجود الأشخاص عبر تطبيق Home Assistant المحمول أو نظام وجود آخر، ونبدأ تسليحًا كاملًا بمجرد مغادرة آخر شخص ويصبح “غير موجود في المنزل”.

يمكن أن يبدو مثال بسيط في YAML كما يلي:

automation:
  - alias: "تسليح Ajax عندما يغادر الجميع"
    trigger:
      - platform: state
        entity_id: group.famille
        to: "not_home"
    action:
      - service: alarm_control_panel.alarm_arm_away
        target:
          entity_id: alarm_control_panel.ajax_alarm_home

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

هناك حالة استخدام شائعة أخرى تتعلق بالتدفئة. يسمح مستشعرات فتح Ajax المعادة في Home Assistant بقطع التدفئة الكهربائية أو التكييف عندما تبقى نافذة مفتوحة لأكثر من خمس دقائق، ثم إعادة تفعيل النظام عندما يتم إغلاق النافذة. لم تعد بحاجة إلى توسيع المستشعرات Zigbee أو Z-Wave للعمل بشكل نظيف على الفتحات.

يمكن أن تساهم كاشفات الحركة Ajax أيضًا في إدارة الإضاءة. يمكننا أن نقرر أنه، فقط في الليل، يجلب المرور أمام كاشف في الممر ضوءًا ليليًا أو شريط LED في قاعدة السرير، بشدة منخفضة، لفترة من الوقت. لا يُفعل الإنذار، لكننا نعيد استخدام البنية التحتية لمزيد من الراحة. هذا جزء من المتعة الموجودة في الأتمتة المتكاملة جيدًا.

وأخيرًا، يمكن وضع زر الطوارئ Ajax المعروض ككيان “زر” على لوحة تحكم مخصصة للبالغين، أو حتى إخفاؤه خلف بطاقة محمية بكلمة مرور، واستخدامه لتفعيل إنذار عام: أبواق الإنذار، إضاءة خارجية بنسبة 100%، إرسال إشعار على الهاتف الذكي، أو حتى إجراء مكالمة تلقائية لأحد الأقارب عبر خدمة ثالثة. في مثل هذه السيناريوهات، من الأفضل بالطبع الاختبار في ظروف حقيقية ولكن مع إبلاغ الجميع مسبقًا…

الأمان والممارسات الجيدة مع Ajax Home Assistant

دمج Ajax في Home Assistant عبر هذا الملحق يعني أن Home Assistant يصبح قطعة إضافية في سلسلة الأمان. اعتنى المطور بجزء الخصوصية: تُخزن بيانات الاعتماد في نظام مشفر Home Assistant، ويُحال كلمة المرور إلى خوادم Ajax بعد تجزئتها، وتتم الاتصالات عبر TLS، ولا تُرسل أي بيانات إلى خدمات خارجية. التكامل مفتوح المصدر وقابل للتدقيق، مما يجعله مريحًا لنظام أمان.

ومع ذلك، يجب المحافظة على بعض العادات. يصبح Home Assistant المعرض لأي شكل من أشكال الضعف على الإنترنت مدخلاً إلى نظام إنذارك. لذا فمن الضروري تأمين الوصول الخارجي، الحفاظ على تحديث Home Assistant مثل تكامل Ajax، وتجنب تضخيم حسابات المديرين. يجب استخدام التسليح الإجباري بحذر، لأنه يسمح بتسليح النظام حتى مع وجود مستشعرات مفتوحة أو معطلة.

النقطة الأخيرة: يستند هذا الملحق إلى سحابة Ajax. إذا تعطلت اتصال الإنترنت الخاص بك أو إذا كانت خوادم Ajax غير متاحة، فإن المحور سيظل يحمي المنزل، لكن الاتصال الفوري مع Home Assistant سينقطع.

في الممارسة العملية، لماذا اعتماد هذا الملحق Ajax Home Assistant

لتلخيص، ننتقل من تكامل “مرتجل”، يعتمد على نظام أتمتة ثاني، إلى ملحق Ajax Home Assistant مخصص، محافظ، ومتعمق جدًا في إدارة المعدات. يتم التثبيت عبر HACS، والتكوين فقط من خلال الواجهة، ونحصل على تحكم كامل في الإنذار، مع استرجاعات أحداث شبه فورية.

في الحياة اليومية، هذا يعني سيناريوهات أكثر ذكاءً، وتناسقًا حقيقيًا بين الأمان والراحة، وأقل تكرار للمستشعرات في جميع أنحاء المنزل. بالنسبة للتركيب، هذا أيضًا حجة قوية لتقديمها للعملاء المجهزين بالفعل بـ Ajax، الذين يحلمون بتحكم شامل في منازلهم مع Home Assistant.

وأكثر ما يثير الإعجاب في القصة هو أنه لمرة واحدة، لا يترافق “الأكثر كمالاً” مع “الأكثر تعقيدًا”.