README_ar.md

ha-xsense-component_test

## نظرة عامة

تتيح لك هذه التكاملية مع Home Assistant استخدام أجهزة Xsense داخل نظام المنزل الذكي. تم إنشاؤها استنادًا إلى الكود الأصلي لـ

Theo Snel ونُشرت بإذنه وبالتعاون معه.

حتى يتم إصدار تكامل رسمي لـ Home Assistant من قبل Theo، سيتم استخدام هذا التكامل من HACS، والذي يتم تحديثه بانتظام لإضافة ميزات جديدة وحل المشاكل الحالية. يتيح هذا التكامل للمستخدمين دمج أجهزة Xsense بسهولة في Home Assistant واستخدامها في مختلف عمليات الأتمتة والمراقبة.

## الميزات - تكامل مختلف أجهزة Xsense مع Home Assistant. - دعم الأتمتة بناءً على بيانات أجهزة الاستشعار من Xsense. - دعم للأنواع التالية من الأجهزة: محطات القاعدة، أجهزة كشف الدخان، أجهزة كشف أول أكسيد الكربون، أجهزة الكشف الحراري، أجهزة كشف تسرب المياه ومقاييس الرطوبة. - إعداد سهل من خلال HACS (Home Assistant Community Store).

المتطلبات

• خادم Home Assistant فعال (يوصى بأحدث إصدار).
• حساب Xsense مع الأجهزة المدعومة.
• يجب تثبيت HACS في Home Assistant لتمكين تثبيت التكامل.

فيديو تعليمي

للحصول على دليل تفصيلي حول التثبيت والتكوين، يمكنك مشاهدة الفيديو التالي:

---

التحضير

قبل تثبيت التكامل، من الضروري القيام ببعض التحضيرات:

• إنشاء حساب ثاني في تطبيق X-Sense (للاستخدام مع Home Assistant): نظرًا لأنك لا تستطيع تسجيل الدخول في التطبيق وHome Assistant بنفس الحساب في آن واحد، ننصح باستخدام حساب منفصل لـ Home Assistant. هذا يمنعك من فصل الاتصال بشكل متكرر بين التطبيق وHome Assistant. الحساب الإضافي يتيح تكامل سلس دون انقطاعات.

• مشاركة الأجهزة المدعومة من الحساب الرئيسي إلى حساب Home Assistant: استخدم تطبيق X-Sense لمشاركة فقط الأجهزة المدعومة مع الحساب الجديد الذي أنشأته. بهذه الطريقة، يمكنك استخدام التكامل بسهولة في Home Assistant، بينما تستمر في إدارة الأجهزة من حسابك الرئيسي.

---

التثبيت عبر HACS

1. افتح HACS في Home Assistant: HACS هو امتداد مهم لـ Home Assistant، يتيح لك تثبيت التكاملات المخصصة بسهولة.

   

2. اذهب إلى المستودعات المخصصة: انتقل إلى الإعدادات في لوحة HACS وأضف هذا المستودع كمصدر مخصص.

3. أضف المستودع: أدخل عنوان URL للمستودع: https://github.com/Jarnsen/ha-xsense-component_test

   

4. قم بتنزيل التكامل وتثبيته: ابحث عن التكامل في HACS، قم بتنزيله وتثبيته. بعد التثبيت، يمكنك إعداد التكامل من خلال واجهة Home Assistant.

   

   

---

الإعداد

بعد التثبيت، يلزم إجراء إعداد أساسي لكي يعمل التكامل بشكل صحيح:

• اسم المستخدم وكلمة المرور: استخدم بيانات الاعتماد الخاصة بحساب X-Sense الجديد الذي أنشأته لتكوين الاتصال.

  

• نظرة عامة على الأجهزة: بعد الإعداد بنجاح، ستكون الأجهزة المشتركة متاحة في Home Assistant ويمكن استخدامها للأتمتة.

  

العرض في Home Assistant

بعد التثبيت والإعداد بنجاح، سيكون التكامل مرئيًا في Home Assistant. ستكون الأجهزة مرئية على لوحة التحكم ويمكن استخدامها للأتمتة والإشعارات وحالات الاستخدام الأخرى.

---

الأجهزة المدعومة

هذا التكامل يدعم مجموعة متنوعة من أجهزة Xsense. فيما يلي قائمة بالأجهزة التي تم التأكد منها واختبارها حاليًا:

• محطة القاعدة (SBS50): المحور المركزي لأجهزة Xsense.
• كاشف حراري (XH02-M): الكشف عن درجات الحرارة غير العادية.
• كاشف أول أكسيد الكربون (XC01-M; XC04-WX): الكشف عن تركيزات خطيرة من أول أكسيد الكربون.
• كاشف الدخان (XS01-M, WX; XS03-WX; XS0B-MR): الكشف المبكر عن الدخان.
• كاشف مدمج لأول أكسيد الكربون والدخان (SC07-WX; XP0A-MR (مدعوم جزئيًا)): أجهزة مدمجة للكشف عن أول أكسيد الكربون والدخان.
• كاشف تسرب المياه (SWS51): الكشف عن وجود الماء في أماكن غير مرغوب فيها.
• مقياس الرطوبة-الحرارة (STH51): مراقبة درجة الحرارة والرطوبة.

يمكن استخدام هذه الأجهزة لإنشاء الأتمتة والإشعارات بعد تكاملها في Home Assistant.

---

أمثلة على الأتمتة

باستخدام هذا التكامل، يمكنك إنشاء مجموعة متنوعة من الأتمتة. فيما يلي بعض الأمثلة:

المثال 1: تحذير درجة الحرارة

عندما تكون درجة الحرارة من مقياس حرارة Xsense أعلى من 30 درجة مئوية، يتم إرسال إشعار:

automation:
  - alias: "تحذير درجة الحرارة Xsense"
    trigger:
      platform: numeric_state
      entity_id: sensor.xsense_temperature
      above: 30
    action:
      service: notify.notify
      data:
        message: "درجة الحرارة تجاوزت 30 درجة!"

المثال 2: إنذار كاشف تسرب المياه

عندما يكتشف كاشف تسرب المياه وجود ماء، يتم تفعيل إشعار:

automation:
  - alias: "إنذار تسرب المياه"
    trigger:
      platform: state
      entity_id: binary_sensor.xsense_waterleak
      to: "on"
    action:
      service: notify.notify
      data:
        message: "تم اكتشاف تسرب مياه!"

---

نحن بحاجة إلى مساعدتك

نحن نبحث دائمًا عن دعم لتحسين وتطوير هذا التكامل. هناك العديد من الطرق التي يمكنك المساعدة بها:

1. اختبار الأجهزة: إذا كنت تملك جهاز Xsense يعمل مع التكامل، أبلغنا بذلك لنضيفه إلى قائمة الأجهزة المدعومة.

2. الإبلاغ عن الأجهزة غير المدعومة: إذا كان هناك جهاز لا يعمل، أبلغنا بذلك لنقدم الدعم أو ندمج الجهاز في الإصدارات المستقبلية.

3. مشاركة الأجهزة للاختبار: أفضل طريقة لاختبار أجهزة جديدة هي مشاركة الجهاز عبر تطبيق X-Sense لضمان دعم أكبر عدد ممكن من الأجهزة.

4. دعم المجتمع: شارك في النقاشات في مجتمعنا. سواء كانت لديك اقتراحات للتحسين أو تقدم المساعدة للمستخدمين الآخرين في إعداداتهم، فإن كل مساعدة مرحب بها!

للنقاشات والدعم، يمكنك العثور علينا على خادمنا في Discord أو في منتدى Home Assistant:

Discord

منتدى