تشغّل أصلاً Zigbee2MQTT أو ZHA على عصاتك الخاصة؟ اربطها بـ FairGrow في أربع خطوات. عتادك يبقى لك، ولا حاجة لفتح أي شيء في جدارك الناري، وقراءاتك تحط في منصة تحمل أصلاً بيانات الأقمار الصناعية والطقس والمحصول التي يعيش عليها المشتل.
هل تشغّل Home Assistant بالفعل؟ اربطه، ولا حاجة لتثبيت أي شيء آخر
لا جهاز ثانٍ ولا جسر. تبقى أجهزتك في Home Assistant، مع ZHA أو Zigbee2MQTT أو أي تكامل آخر. أنت تحدد المستشعرات التي يمكن لـ FairGrow رؤيتها، وهي وحدها تخرج من منزلك.
أضف FairGrow إلى Home Assistant
نزّل التكامل وفك ضغط المجلد fairgrow داخل config/custom_components في Home Assistant الخاص بك (باستخدام الإضافة File editor أو Samba). ثم أعد تشغيل Home Assistant. بمجرد ظهور FairGrow في قائمة HACS، تصبح هذه الخطوة نقرة واحدة.
نزّل التكاملاحصل على رمز الربط
يعمل الرمز مرة واحدة ويبقى صالحًا لمدة خمس عشرة دقيقة.
سجّل الدخول لإنشاء رمز ربطالصق الرمز في Home Assistant
Settings، Devices & services، Add integration، FairGrow. الصق الرمز وستكون متصلًا.
أضف FairGrow في Home Assistant الخاص بياختر ما تشاركه
حدّد المستشعرات التي يمكن لـ FairGrow رؤيتها: درجة الحرارة، والرطوبة، ورطوبة التربة، والضوء، والقدرة الكهربائية وغير ذلك. يمكنك تغيير ذلك لاحقًا عبر Configure. تصل القراءات كل دقيقة؛ وإذا انقطع الإنترنت، يحتفظ بها Home Assistant ويرسلها لاحقًا.
أوقف المشاركة متى شئت: احذف التكامل في Home Assistant، أو افصله ضمن منسّقاتك. يبقى سجلك على FairGrow محفوظًا.
للمستخدمين المتقدمين: الجسر المنفصل
هل تشغّل Zigbee2MQTT أو ZHA وتريد أن يدير FairGrow شبكة Zigbee بنفسه (نافذة الإقران، الحجر، فحص الشبكة)؟ إذن الجسر أدناه مناسب لك. يعمل على جهاز خاص بك بجانب المنسّق.
أربع خطوات، مرة واحدة
بعدها يظهر منسّقك بطاقةً في FairGrow، مثل أي جهاز آخر.
نزّل الجسر
مثبّت لجهازك العامل بنظام Windows أو macOS أو Raspberry Pi. تجده في الأسفل مباشرة ويتكفّل بالباقي بنفسه.احصل على رمز اقتران
رمز من ثمانية أحرف تحصل عليه من لوحة إظهار الأجهزة، يُستخدم مرة واحدة ويصلح لربع ساعة. ترى الطريقة في الأسفل.أدخل الرمز مرة واحدة
يستبدله الجسر بمفتاح يبقى على جهازك أنت، وتنتهي صلاحية الرمز فورًا بعد ذلك.
اقرن أول جهاز لك
افتح الشبكة في المنسّق لديك. ستجد هناك افتح نافذة الاقتران لجهاز جديد وتبنّي الأجهزة للأجهزة الموجودة أصلاً.
التثبيت يستغرق دقيقة
اختر نظامك وشغّل المثبّت. يجهّز كل شيء، ويطلب رمز الاقتران، ويضمن أن يعمل الجسر تلقائيًا من الآن فصاعدًا.
FairGrow-brug
يعمل مع Zigbee2MQTT لديك أو مباشرة مع ZHA في Home Assistant، ولا يتواصل إلا مع منسّقك ومع FairGrow.
curl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shcurl -fsSL https://fairgrow.eu/wp-json/fg-zb/v1/brug/fairgrow-brug.sh -o fairgrow-brug.sh && sh fairgrow-brug.shانتبه: لا يُثبَّت الجسر على جهاز Home Assistant نفسه، فهو ليس تكاملًا ولا إضافة، ولا يمكنك إضافة Python إلى Home Assistant OS. ثبّته على جهاز آخر في الشبكة نفسها يبقى قيد التشغيل: حاسوبك، أو Raspberry Pi، أو NAS، أو جهاز افتراضي. ومع ZHA يتصل الجسر من هناك بـ Home Assistant عبر الشبكة.
ما الذي يفعله المثبّت بالضبط
- يتحقق من وجود Python 3 على جهازك، وإن لم يجده أخبرك من أين تنزّله.
- ينشئ مجلدًا مستقلًا فيه بيئة Python خاصة، بمعزل عن نظامك.
- ينزّل الجسر ويطابق بصمته مع ما تعلنه المنصة، وإن لم تتطابقا فلا يبدأ شيء.
- يطلب رمز الاقتران ويسألك أين يعمل Zigbee2MQTT أو Home Assistant.
- يُجري الاقتران مرة واحدة ويضمن أن يبدأ الجسر مع تشغيل الجهاز.
يبقى كل شيء في مجلد مستقل، ولا يُمسّ Python الخاص بنظامك. لإزالته استخدم fairgrow-brug.bat /verwijderen أو sh fairgrow-brug.sh --verwijderen؛ أما الاقتران نفسه فتلغيه من بطاقة منسّقك. تفضّل التثبيت اليدوي؟ الجسر متاح وحده أيضًا: fgzb_brug.py.
للتحديث إلى إصدار أحدث استخدم fairgrow-brug.bat /bijwerken أو sh fairgrow-brug.sh --bijwerken. يبقى الاقتران والإعدادات كما هي، فلا تحتاج إلى رمز اقتران جديد.
هكذا تحصل على رمز الاقتران
ثلاث نقرات في FairGrow. يُستخدم الرمز مرة واحدة ويصلح لربع ساعة.
1. لوحة إظهار الأجهزة
2. اختر منسّقك
3. رمزك
الطريق الذي تسلكه قياساتك
كل اتصال يبدأ من جهتك متجهًا إلى الخارج، ولا يدخل شيء.
كل الأسهم تشير إلى الخارج، ويبقى منسّقك وأجهزتك داخل شبكتك أنت.
ثلاثة أشياء
منسّق مدعوم
أي محوّل يدعمه Zigbee2MQTT: SONOFF ZBDongle-E أو P، SLZB-06، ConBee III.
Zigbee2MQTT يعمل
الإصدار 2.x مع خادم MQTT في شبكتك. ويواصل نظامك الحالي عمله كما هو.
جهاز يبقى مشغّلاً
الجسر برنامج Python صغير. يكفي Raspberry Pi بجانب منسّقك.
جهاز Zigbee جديد ينتظرك
لا يظهر شيء على لوحتك من تلقاء نفسه.
يوضع أولًا في الحجر
ينتظر الجهاز: لا قياسات ولا لوحة، ولا شيء بعد.
نسأله عن هويته
العلامة التجارية والطراز وقدراته. وتبيّن البطاقة ما قسناه بأنفسنا وما استقيناه من البحث.
أنت تقرّر
إضافته أو رفضه. والرفض يزيل الجهاز ويمنعه من العودة.
ما يستطيعه منسّق Zigbee لديك هنا
المنسّق من علامة أخرى ليس أدنى مستوى، بل مبنيّ بطريقة مختلفة فحسب.
يعمل
- فتح نافذة الاقتران من داخل FairGrow
- قراءة العلامة التجارية والطراز وقدرات الجهاز
- معرفة ما إذا كان الجهاز قادرًا على تمرير بيانات الأجهزة الأخرى
- إزالة جهاز ومنعه من العودة
- تشغيل مسح للشبكة: أي الأجهزة تمر عبر أيها، وبأي قوة
- التعرف على محوّلك وبرنامجه الثابت، والتحذير من تركيبة نعرف أنها معطوبة
لا يعمل
- لا يستطيع Zigbee2MQTT أن يستخرج من الجهاز ما لا يُفصح عنه، لذلك نعتمد على مكتبة أجهزتنا.
- لا يوفّر كل جهاز عبر Zigbee2MQTT خاصية الوميض للتعرّف عليه.
وما لم نستطع قياسه بأنفسنا تذكره البطاقة صراحة، ولا نقدّم أبدًا قيمة مستعارة على أنها قياس.
اطّلع على حال شبكة Zigbee لديك
Zigbee شبكة متشابكة: تتواصل أجهزتك عبر بعضها بعضًا. ومن منسّقك تطلب مسحًا للشبكة، فترى أي جهاز يمر عبر أي جهاز.
المخطط
كل جهاز وكل وصلة وقوتها، فترى الحلقة الضعيفة قبل أن ينقطع مستشعر.
مواطن الضعف
جهاز ليس له سوى جار واحد، أو وصلة أضعف من اللازم، أو جهاز بعيد أكثر من اللازم عن المنسّق. ومع كل ملاحظة القاعدة التي استندنا إليها.
المسار الزمني
نحتفظ بكل مسح، فترى وصلة تضعف تدريجيًا أو جهازًا يغيّر جاره مرة بعد أخرى، بدل أن تنتبه فقط حين يتوقف عن الإرسال.
يطلب المسح من كل موجّه جدول جيرانه ويستهلك وقت بث، لذلك لا يبدأ تلقائيًا أبدًا. والموجّه الذي لا يجيب لا نصفه ضمنيًا بأنه معزول، بل نكتب صراحة أننا لا نعرف.
إذا لم ينجح الأمر، نرى السبب
يفحص التثبيت نظامك ويسجّل ما يجري.
القياس أولًا، ثم الاقتران
المنافذ والصلاحيات وبرامج التشغيل ومهمة بدء التشغيل. فكل الأعطال تقريبًا تقع خارج الجسر.
لدينا نصف القصة من جهتنا
تحصل كل محاولة على رقم مرجعي نحفظ تحته ما وصلنا من جهتك، حتى لو لم ينجح الاقتران أبدًا.
الإرسال بضغطة زر
ضمن قسم منسّقاتك تجد زر إرسال السجل، وتُحجب كلمات المرور فور وصولها.
ما عتاد Zigbee الذي يعمل؟ ما الذي يتعطل مع محوّلات المتاجر وعلاماتها، وما الذي نتداركه نحن. شاهد ما الذي يعمل
رُبط منسّق Zigbee لديك؟ إليك الخطوات التالية. إضافة جهاز، والموافقة عليه، ومعرفة أين ينتهي به المطاف. وما الذي نراقبه لك بعد ذلك. أضف جهازك الأول
أتمتتك يمكنها أن تأتي أيضاً
ربط المنسّق ينقل القراءات. ليس من الضروري أن يتوقف الأمر هنا.
يستطيع FairGrow أن يسأل Home Assistant لديك عن الأتمتة التي يشغّلها وأن ينسخها إلى محرر سير العمل، والأصول دون مساس وكل نسخة مطفأة حتى تقول غير ذلك. المسألة ليست أن Home Assistant يؤدي ذلك بشكل سيئ. المسألة أن الأتمتة نفسها هنا تستطيع أيضاً النظر إلى صورة Sentinel-2، أو إلى رقم تبخر من FAO-56، أو إلى نموذج آفة، دون أن تبني ذلك بنفسك أولاً.
ما يسألنا عنه المستخدمون
هل عليّ التخلي عن Home Assistant؟
لا، ولا نطلب ذلك. شبكة Zigbee تبقى حيث هي وبيتك يواصل العمل عليها. ما نقوله شيء آخر: بالنسبة للأرض، FairGrow مكان أفضل لقراءاتك. Copernicus وNASA POWER وFAO-56 ووقاية النبات برموز EPPO موجودة هنا منذ البداية، في حين أن كل واحد منها في Home Assistant مشروع تصونه أنت. أتمتتك الحالية يمكنها أن تأتي بنقرة واحدة.
ما المنسّقات التي يمكنني ربطها؟
Zigbee2MQTT وHome Assistant ZHA، وكلاهما متاح اليوم وتربطه بنفسك: نزّل الجسر، واختر أثناء التثبيت أيهما لديك، واحصل على رمز اقتران، وانتهى الأمر. إن كنت تشغّل ZHA فلا تحتاج إلى تثبيت Zigbee2MQTT إطلاقًا ولا يتغيّر شيء في تركيبك. وما زلنا نستكمل اختبار الاثنين على عتاد حقيقي، فأخبرنا إن واجهت أي مشكلة. ويليهما deCONZ / Phoscon، ولا يمكنك اختياره بعد. لا تجد منسّقك في القائمة؟ أخبرنا بما لديك.
ما الذي يغادر شبكتي؟
بيانات منسّقك وبيانات الأجهزة التي تقرنها خلال الجلسة: العنوان والعلامة التجارية والطراز وقياساتها. أما الأجهزة الموجودة أصلًا في Zigbee2MQTT لديك ولم تقرنها، فلا يغادر شيء منها.
هل عليّ فتح منفذ؟
لا. ينشئ الجسر اتصالات صادرة فقط، ولا يدخل شيء من جهتنا إلى شبكتك.
كيف أوقف الربط؟
افصل المنسّق في FairGrow، فيفقد المفتاح صلاحيته في الحال. تبقى أجهزتك في القائمة، لكن لا تصلها قياسات جديدة.
وماذا لو بقي جسري مطفأً فترة؟
لا يتلف شيء. تتوقف القياسات، ثم تُستأنف حالما يعود الجسر للعمل. وترى على البطاقة الوقت المنقضي منذ آخر رسالة وهو يزداد.
ماذا يحدث إذا انقطع جهاز؟
يُبلغ جسرك كل خمس دقائق بما يراه منسّقك. فإذا توقف جهاز عن الإرسال، ظهر ذلك عند منسّقك مع السبب: الجهاز نفسه، أو الموجّه الذي كان متصلًا به. وإذا توقف الجسر نفسه عن الإبلاغ، نبّهناك إلى ذلك أولًا، لأن كل الأجهزة تبدو عندئذ مفقودة، في حين أن المتوقف هو الجسر وحده.
اربط منسّقك الخاص
أخبرنا بالمحوّل الذي تستخدمه وبما تريد قياسه، وسنرافقك خطوة بخطوة في الاقتران.