Home Assistant وWLED: أنشئ أتمتة مؤثرات قابلة للاستعادة

نقطة تحقق / 01

امنح كل طبقة وظيفة واحدة

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

• أبقِ بروتوكول البكسلات وخريطة المقاطع والمؤثرات في طبقة جهاز WLED.
• استخدم Home Assistant للسياق والأوامر، لا بديلًا عن وحدة التحكم أو مسار الطاقة.
• سجّل الكيان ومسار التكامل والبرنامج الثابت وسلوك إعادة التشغيل معًا.

نقطة تحقق / 02

اجعل حالة WLED معروفة وقابلة للاستعادة

احفظ حالة preset محلية أو حالة مؤثر مختبرة في WLED قبل إضافة أتمتة معقدة. سجّل المقطع وحد السطوع والمؤثر واللوحة ومعرّف preset عندما يظهر وسلوك الجهاز بعد إعادة تشغيل WLED. الـpreset حالة قابلة للاستعادة لتكوين محدد؛ وليس دليلًا على أن وحدة تحكم أو برنامجًا ثابتًا أو نسخة شريط أخرى ستتصرف بالطريقة نفسها.

• سمِّ الحالة حسب الغرفة والهدف، لا حسب تجربة مؤقتة.
• أبقِ السطوع وسرعة المؤثر ضمن النطاق المقاس للتركيب.
• تحقق من خيارات preset أو المؤثر التي يعرضها كيان Home Assistant المحدد.

نقطة تحقق / 03

ابدأ بأمر واحد يمكن التنبؤ به

شغّل كيانًا واحدًا واستدعِ مؤثرًا أو preset معروفًا وافحص النتيجة من نسخة Home Assistant الفعلية. يستخدم المثال كيان إضاءة وخيار مؤثر ظاهرًا؛ استبدل القيم بالكيانات والخيارات التي اختبرتها فعلًا. أضف الحضور والوسائط والوقت فقط بعد استقرار هذا المسار.

mode: restart
trigger:
  - trigger: state
    entity_id: binary_sensor.media_mode
    to: "on"
action:
  - action: light.turn_on
    target:
      entity_id: light.media_wall
    data:
      effect: "Solid"

نقطة تحقق / 04

اختبر مسار الفشل وإعادة التشغيل

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

• افصل في سجل الاختبار بين إعادة تشغيل جهاز WLED وإعادة تشغيل Home Assistant.
• افحص ما الذي يبلغه الكيان أثناء عدم إتاحة وحدة التحكم.
• احتفظ باستعادة محلية أو يدوية لأعمال الصيانة وفشل الشبكة.

نقطة تحقق / 05

أضف المشاهد والشروط من دون إخفاء ملكية الوظائف

بعد تكرار الأمر الواحد بنجاح، استخدم مشهدًا في Home Assistant أو شروطًا إضافية للتعبير عن هدف الغرفة. أبقِ مؤثر WLED وتعيين المقاطع وحد السطوع ظاهرًا في السجل. وعند وجود مقاطع متعددة، وثّق الكيان الذي يتحكم في كل مقطع واختبر الأوامر المتزامنة؛ فتشغيل كيان واحد لا يعرّف تلقائيًا عرضًا آمنًا متعدد المقاطع.

• أضف شرطًا واحدًا في كل مرة واترك الأمر الأساسي متاحًا للتشخيص.
• احفظ الكيان والمؤثر أو preset ونطاق المقطع والاستعادة المتوقعة في مذكرة البناء.
• اعتبر الحضور والجدول ولوحات التحكم سياقًا اختياريًا حول مسار إضاءة مختبر.

أوضاع الفشل

ما الذي يفشل عادةً

• تعتمد الأتمتة على اسم مؤثر أو preset تغيّر بين إصدارات البرنامج الثابت.
• يفترض المشهد قنوات RGBW أو مقاطع لا يعرضها الكيان المحدد.
• يُتوقع من Home Assistant أن يحل محل توقيت WLED أو وحدة التحكم أو مسار الطاقة.
• ينجح الأمر الأول، لكن لا تُختبر إعادة تشغيل WLED وHome Assistant وفقد الشبكة كل على حدة.
• لا يوجد مسار محلي أو يدوي موثق بعد إعادة تشغيل وحدة التحكم أو توقف التكامل.

الأساس التقني / الإصدار

حافظ على حداثة القرار

يُحافَظ على هذا الدليل كسجل تقني ذي إصدارات. أعد فحص وثائق البروتوكول الحالية ومراجعة المنتج الدقيقة قبل استخدامه في تركيب إنتاجي.