قم بتثبيت Homebridge على Raspberry Pi و Windows: 9 خطوات

2024 مؤلف: John Day | [email protected]. آخر تعديل: 2024-01-30 07:38

هذا البرنامج التعليمي مخصص للأشخاص الذين يرغبون في تثبيت Homebridge على Raspberry Pi و Windows.

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

تم تقسيم هذه التعليمات على النحو التالي:

الخطوة 1: ما هي Homekit؟

الخطوة 2: ما هو Homebridge؟

الخطوة 3: تثبيت Homebridge على Raspberry Pi

الخطوة 4: بدء Homebridge على Raspbian Boot

الخطوة 5: تثبيت Homebridge Config UI X Plugin (Raspberry Pi)

الخطوة 6: تثبيت Homebridge على نظام Windows

الخطوة 7: تثبيت Homebridge Config UI X Plugin (Windows)

الخطوة 8: بدء تشغيل Homebridge مع Windows

الخطوة 9: ربط Homebridge بتطبيق Home

الخطوة 1: ما هو Homekit؟

Homekit عبارة عن حزمة تطوير مقدمة من Apple للمطورين لبناء حلول إنترنت الأشياء (IoT). تمكّن حزمة التطوير هذه الأجهزة المبنية من Apple (iPhone و iPad ، على سبيل المثال) من التحكم في الأجهزة الأخرى ، مثل المصابيح أو معلومات المستشعر. من iOS 9 و Watch OS Homekit أصبحت أداة أصلية ، وبسبب جميع التقنيات التي تنفذها Apple ، من الممكن إنشاء أنظمة أتمتة ببساطة باستخدام هذه المجموعة.

لتحديد الأجهزة المتوافقة مع Homekit والنشطة على الشبكة ولتكوين هذه الأجهزة والتحكم فيها ، يجب أن يكون لديك تطبيق Home مثبتًا على أي جهاز Apple (iPhone أو iPad أو iPod touch أو Apple Watch أو Apple TV أو HomePod أو Mac). يمكن أن تحتوي الأجهزة المراد دمجها مع تطبيق Home على رمز QR يسمح بالاقتران مع تطبيق Home على جهاز Apple الخاص بك.

بعد تكوين الجهاز في تطبيق Home ، يمكن للمستخدم التحكم في الجهاز من خلال اختصار يتم إنشاؤه على الشاشة الرئيسية للتطبيق أو استخدام Siri (المساعد الصوتي المقدم من Apple) وإرسال أوامر صوتية لتشغيل الجهاز.

متطلبات أجهزة Apple وبرامجها لاستخدام Homekit هي:

- iPhone أو iPad أو iPod touch (يعمل بنظام iOS 10 أو أحدث) ؛

- Apple Watch (تعمل بنظام WatchOS 3 أو أحدث) ؛

- Apple TV (الجيل الرابع) ؛

- جهاز Apple HomePod ؛

- أجهزة Mac (تعمل بنظام macOS 10.14 Mojave أو أحدث) ؛

عندما يتعلق الأمر بالأتمتة المنزلية وإنترنت الأشياء ، هناك عدد من الحلول الفعالة من حيث التكلفة في السوق ، ومع ذلك ، فإن الغالبية العظمى ليست معتمدة من Apple وبالتالي فهي غير متوافقة أصلاً مع Homekit. إذا مللت من انتظار تصديق Apple على هذه الحلول للاستخدام مع Homekit ، فيجب عليك استخدام Homebridge.

الخطوة 2: ما هو Homebridge؟

تم تطوير Homebridge بواسطة Nick Farina ، وهو خادم NodeJS يحاكي Homekit API ويجعل من الممكن استخدام الأجهزة غير المعتمدة من Apple مع تطبيق Home و Siri. الخادم خفيف الوزن ويمكن تشغيله على شبكة منزلية وهو معياري ، مما يعني أنه يدعم العديد من المكونات الإضافية التي تم إنشاؤها وإتاحتها من قبل مجتمع نشط للغاية في تقوية الأداة.

يتم تثبيت المكونات الإضافية على Homebridge ويهدف معظمها إلى جعل Homekit متوافقًا مع أي جهاز غير معتمد من Apple. يتم تثبيت المكونات الإضافية للاستخدام مع Homebridge مباشرة من موقع NPM على الويب.

يمكن إجراء تثبيت Homebridge على أنظمة مختلفة ، ومع ذلك ، سيتم استخدام Raspberry Pi 3 Model B + الذي يعمل بنظام التشغيل Raspbian لهذه التعليمات ، وسأشرح أيضًا كيفية التثبيت على Windows.

الخطوة 3: تثبيت Homebridge على Raspberry Pi

من الناحية المثالية ، يجب أن يكون Homebridge متاحًا في أي وقت تحتاج إليه ، لذلك يجب أن تترك الخادم يعمل على مدار الساعة طوال أيام الأسبوع. لهذا يمكنك تثبيت الخادم على Raspberry Pi والاستمرار في العمل باستمرار على شبكتك المنزلية.

إذا لم يكن لديك Raspbian مثبتًا ومهيئًا على بطاقة الذاكرة ، فإنني أوصيك بقراءة Instructable Install and Configure Raspbian على Raspberry Pi ، واتبع الخطوات أدناه ثم العودة للمتابعة.

مع قيام Raspberry Pi بتشغيل Raspbian ، افتح الجهاز في الشاشة الرئيسية للنظام:

في المحطة ، اكتب الأمر الأول أدناه ، واضغط على Enter ، وإذا طُلب منك تأكيد نوع الإجراء Y واضغط على Enter. غالبًا ما يظهر هذا النوع من التأكيد عند إزالة الحزم أو تثبيتها. ثم اكتب الأمر الثاني ، وأدخل ، وأكد الأمر إذا طُلب منك ذلك ، وانتظر. تقوم هذه الأوامر بفحص النظام وتحديثه إذا لزم الأمر:

sudo apt-get update

sudo apt-get ترقية

اكتب الأمر أدناه في المحطة واضغط على Enter:

ifconfig

سيتم إرجاع بعض المعلومات. إذا كنت تستخدم كبل شبكة لتوفير اتصال شبكة بـ Raspberry Pi ، فانتقل إلى جزء المعلومات بعد "eth0:" وابحث عن عنوان MAC لبطاقة الشبكة المكون من ثمانية أرقام وسيكون بعد كلمة "ether" إذا تستخدم اتصال WiFi لتعيين اتصال شبكة ببطاقتك ، انتقل إلى جزء المعلومات بعد "wlan0:" وابحث عن عنوان MAC لبطاقة الشبكة المكونة من ثمانية أرقام والتي ستكون أيضًا بعد كلمة "ether":

انسخ عنوان MAC المكون من ثمانية أرقام لبطاقة الشبكة الخاصة بك واحفظه في Notepad ، حيث سيكون هذا العنوان مطلوبًا لاحقًا.

كما ذكرت سابقًا ، Homebridge هو خادم NodeJS ويتم تثبيت المكونات الإضافية له مباشرة من موقع NPM. عادةً ما يأتي Raspbian مع حزم NodeJS و NPM المثبتة ، ومع ذلك ، قد يكون هناك عدم توافق بين إصدارات كلتا الحزمتين ، لذلك من الأفضل إزالة كلا التثبيتين ثم إعادة التثبيت.

لإزالة NPM ، اكتب الأمر أدناه في المحطة ، وأدخل ، وأكد الأمر إذا طُلب منك ذلك ، وانتظر حتى تكتمل إزالة الحزمة:

sudo apt - إزالة تلقائية تطهير npm

لإزالة NodeJS ، اكتب الأمر أدناه في المحطة ، وأدخل ، وأكد الأمر إذا طُلب منك ذلك ، وانتظر حتى تكتمل إزالة الحزمة:

sudo apt - إزالة عقدة التطهير تلقائيًا

بعد إزالة NodeJS و NPM ، يمكننا المتابعة لتثبيت الحزم المحدثة. لتثبيت NodeJS ، اكتب الأمر أدناه في المحطة ، وأدخل ، وأكد الأمر إذا طُلب منك ذلك ، وانتظر حتى يكتمل تثبيت الحزمة:

sudo apt تثبيت nodejs

لتثبيت NPM ، اكتب الأمر أدناه في الجهاز ، وأدخل ، وأكد الأمر إذا طُلب منك ذلك ، وانتظر حتى يكتمل تثبيت الحزمة:

curl -L https://www.npmjs.com/install.sh | sudo sh

اكتب كل أمر من الأوامر أدناه واضغط على إدخال بعد كل منها لتأكيد نجاح تثبيت الحزمة. تعيد هذه الأوامر إصدار كل حزمة تم تثبيتها للتو:

عقدة الخامس

npm -v

تثبيت Avahi وتوابعها. أدخل الأمر أدناه ، وأدخل ، وأكد الأمر إذا طُلب منك ذلك ، وانتظر حتى يكتمل التثبيت:

sudo apt-get install libavahi-توافق-libdnssd-dev

بعد اكتمال هذه الإجراءات ، يمكننا تثبيت Homebridge. أدخل الأمر أدناه ، وأدخل ، وأكد الأمر إذا طُلب منك ، وانتظر حتى يكتمل التثبيت:

تثبيت sudo npm -g -unsafe-perm homebridge

ثم اكتب الأمر أدناه واضغط على enter لتشغيل Homebridge:

هومبريدج

سيعيد Homebridge بعض المعلومات:

1) لم يتم العثور على ملف config.json بواسطة Homebridge. يوفر هذا الملف الإعدادات الأساسية لتشغيل Homebridge وأي مكونات إضافية مثبتة. سننشئ لاحقًا ملف config.json وإعداداته.

2) لا يوجد مكون إضافي مثبت. Homebridge بدون تثبيت المكونات الإضافية غير مجدية تمامًا.

3) لربط الأجهزة بتطبيق Home ، يمكنك قراءة رمز الاستجابة السريعة الذي يمنحك المعلومات التي تحتاجها للإقران. نظرًا لأن ملف config.json لم يتم إنشاؤه وتهيئته ، ولا يوجد مكون إضافي مثبت ، فإن رمز الاستجابة السريعة هذا ليس جيدًا حاليًا ، على الرغم من أنك ستتمكن بالفعل في تطبيق Home من العثور على Homebridge متاحًا للربط ، لكن لا تفعل ذلك.

4) هناك طريقة أخرى لربط الأجهزة بتطبيق Home وهي من خلال خيار "إضافة ملحق" ، و "ليس لدي رمز أو لا يمكنني المسح" ، وضمن "الملحقات القريبة" ، يتم تحديد الجهاز وسيُطلب منك بعد ذلك رمز الإعداد. لاحظ أن الجهاز يظهر الرمز المكون من ثمانية أرقام ويجب إدخاله لمطابقة التطبيق.

يمكنك لاحقًا استخدام إما رمز الاستجابة السريعة أو الرمز المكون من ثمانية أرقام لربط Homebridge بتطبيق Home على جهاز Apple الخاص بك.

اضغط على مفاتيح CTRL + C على الجهاز لإغلاق Homebridge وستتم إعادة الرسالة "Got SIGINT، shuting down Homebridge …".

لإنشاء ملف config.json ، اكتب الأمر أدناه في Terminal واضغط على Enter. سيتم فتح الملف الفارغ:

sudo nano ~ /.homebridge / config.json

قم بتنزيل الملف أدناه. افتح هذا الملف وانسخ المحتويات والصقها في الملف المفتوح في الجهاز:

ملف 01

1) في "اسم المستخدم" ، احذف التسلسل XX: XX: XX: XX: XX: XX وأدخل عنوان MAC المكون من ثمانية أرقام لبطاقة الشبكة التي لاحظتها سابقًا. يجب أن تكون أحرف العنوان التي تدخلها كلها أحرف كبيرة.

2) في "دبوس" يمكنك الاحتفاظ بالأرقام الثمانية الرقمية أو يمكنك التغيير إلى تسلسل تريده ، مع تذكر الاحتفاظ بنفس تنسيق الفصل مع الشرطات. سيكون هذا هو الرمز الذي يجب إدخاله عند ربط Homebridge بتطبيق Home.

يمكنك الاحتفاظ بمعلومات الملف الأخرى ، حيث يمكنك إدخال المعلومات المطلوبة عند إضافة المكونات الإضافية والملحقات.

لحفظ تعديلات الملف ، اضغط على CTRL + O ، واضغط على Enter ، ثم CTRL + X لإغلاق الملف.

الخطوة 4: بدء Homebridge على Raspbian Boot

إن بدء Homebridge يدويًا في كل مرة تقوم فيها بتشغيل Raspberry Pi الخاص بك ليس عمليًا للغاية ، لذلك من الأفضل تشغيل الخادم فور بدء Raspbian.

اكتب الأمر أدناه في المحطة واضغط على Enter. سيتم فتح الملف الفارغ:

sudo nano / etc / default / homebridge

قم بتنزيل الملف أدناه. افتح هذا الملف وانسخ المحتويات والصقها في الملف المفتوح في الجهاز:

ملف 02

لحفظ تحريرات الملف ، اضغط على CTRL + O ، واضغط على مفتاح الإدخال ثم CTRL + X لإغلاق الملف.

اكتب الأمر أدناه في المحطة واضغط على Enter. سيتم فتح الملف الفارغ:

sudo nano /etc/systemd/system/homebridge.service

قم بتنزيل الملف أدناه. افتح هذا الملف وانسخ المحتويات والصقها في الملف المفتوح في الجهاز:

ملف 03

لحفظ تعديلات الملف ، اضغط على CTRL + O ، واضغط على Enter ، ثم CTRL + X لإغلاق الملف.

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

sudo useradd - جسر منزلي للنظام

sudo mkdir / var / homebridge

sudo cp ~ /.homebridge / config.json / var / homebridge /

sudo cp -r ~ /.homebridge / persist / var / homebridge

sudo chmod -R 0777 / var / homebridge

تحميل برنامج sudo systemctl daemon-reload

sudo systemctl تمكين homebridge

sudo systemctl بدء homebridge

لإعادة تشغيل النظام ، اكتب الأمر أدناه واضغط على Enter:

sudo إعادة التشغيل

بعد إعادة تشغيل النظام ، افتح Terminal مرة أخرى ، واكتب الأمر أدناه واضغط على Enter للتحقق مما إذا كانت الخدمة قيد التشغيل بالفعل:

systemctl حالة homebridge

إذا كان كل شيء على ما يرام ، فسيتم تشغيل الخدمة ويمكنك مشاهدة "نشط (قيد التشغيل)" وتحت الرمز المكون من ثمانية أرقام الذي تم إدخاله مسبقًا في config.json.

اضغط على مفاتيح CTRL + C على الجهاز. اكتب الأمر أدناه واضغط على Enter للتحقق من سجل المعلومات المسجلة:

Journalctl -f -u homebridge

اضغط على مفاتيح CTRL + C على الجهاز.

الخطوة 5: تثبيت Homebridge Config UI X Plugin (Raspberry Pi)

لإثبات تثبيت المكون الإضافي على Homebridge ، اخترت استخدام Homebridge Config UI X. يسمح هذا المكون الإضافي من خلال متصفح بالقدرة على تكوين Homebridge ومراقبته ونسخه احتياطيًا وإعادة تشغيله.

لتثبيت المكون الإضافي ، اكتب الأمر أدناه في المحطة ، أدخل ، وأكد الأمر إذا طُلب منك وانتظر حتى يكتمل التثبيت:

sudo npm install -g --unsafe-perm homebridge-config-ui-x

اكتب الأمر أدناه في المحطة واضغط على Enter. سيتم فتح ملف:

sudo نانو / الخ / sudoers

باستخدام سهم لوحة المفاتيح لأسفل أو لف الماوس ، قم بالتمرير إلى نهاية الملف وأضف السطر التالي:

homebridge ALL = (ALL) NOPASSWD: الكل

لحفظ الملف ، اضغط على CTRL + O ثم CTRL + X لإغلاق الملف.

اكتب الأمر أدناه في المحطة واضغط على Enter. سيتم فتح ملف:

sudo nano / etc / default / homebridge

باستخدام مفاتيح الأسهم ، قم بالتمرير إلى نهاية السطر HOMEBRIDGE_OPTS = -U / var / homebridge ، أعط مسافة وأدخل:

-أنا

لحفظ الملف ، اضغط على CTRL + O ثم CTRL + X لإغلاق الملف.

ستحتاج الآن إلى تعديل config.json وإضافة معلومات البرنامج المساعد المضافة إلى Homebridge.

إذا قمت بالخطوة 4 لتشغيل Homebridge فور بدء Raspbian ، فاكتب الأمر أدناه واضغط على Enter:

sudo nano /var/homebridge/config.json

إذا لم تضع Homebridge لتبدأ بـ Raspbian ، فاكتب الأمر أدناه واضغط على Enter:

sudo nano ~ /.homebridge / config.json

سيفتح ملف config.json:

ضمن بنية "النظام الأساسي" ، يجب إبلاغ جميع المكونات الإضافية التي يتم تثبيتها على Homebridge.

بالنسبة لـ Homebridge Config UI X ، يجب إضافة مقتطف الشفرة التالي الموجود في الملف أدناه. قم بتنزيله وافتحه وانسخ المحتوى والصقه في الملف المفتوح على الجهاز:

ملف 04

باستخدام مفاتيح الأسهم ، انتقل إلى "الأنظمة الأساسية" وأدخل مقتطف الشفرة الذي نسخته من الملف. في الصورة أدناه ، يمكنك رؤية الشكل الذي ستبدو عليه بنية "الأنظمة الأساسية" بعد إضافة المعلومات:

إذا كنت تريد التحقق من صحة بنية الكود الخاص بك بعد التحرير ، فما عليك سوى الانتقال إلى موقع JSONLint ، ولصق كل كود config.json ، والنقر على "Validate JSON" وإذا كان كل شيء على ما يرام ، فسيتم إرجاع الرسالة "Valid JSON". إذا كان الرمز الخاص بك به أي خطأ ، فسيتم الإشارة إلى السطر الذي يحتوي على الخطأ وإرجاع رسالة تصف الخطأ:

jsonlint.com/

لحفظ الملف ، اضغط على CTRL + O ثم CTRL + X لإغلاق الملف.

أعد تشغيل النظام عن طريق كتابة الأمر أدناه ، واضغط على Enter وانتظر إعادة التشغيل:

sudo إعادة التشغيل

لفتح Homebridge Config UI X من خلال المتصفح مباشرة في Raspberry Pi ، يجب عليك الوصول إلى العنوان:

localhost: 8080 /

إذا كنت تريد فتح Homebridge Config UI X في متصفح من كمبيوتر آخر متصل على نفس الشبكة مثل اللوحة ، فما عليك سوى استبدال كلمة المضيف المحلي من العنوان أعلاه بـ Raspberry Pi IP. للتحقق من عنوان IP المخصص لـ Raspberry Pi ، ما عليك سوى الوصول إلى الجهاز ، وإدخال الأمر أدناه وإدخال:

ifconfig

ربما يبدأ عنوان IP المخصص لـ Raspberry Pi بـ "192.168…".

في حالتي ، اللوحة هي IP 192.168.2.129 ، لذا فقط قم بالوصول إلى عنوان URL الموجود أسفل أي جهاز كمبيوتر على شبكتي:

192.168.2.129:8080/

سيتم فتح صفحة مشابهة للصورة أدناه وستتم مطالبتك بتسجيل الدخول وكلمة المرور. لكل من تسجيل الدخول وكلمة المرور ، اكتب admin وأدخل للوصول:

يرجى ملاحظة أنه يظهر على الصفحة الرئيسية رمز الاستجابة السريعة وتحته رقم التعريف الشخصي المكون من 8 أرقام والذي يمكن استخدامه لربط Homebridge بتطبيق Home. في خيار "التهيئة" للأداة ، يمكنك الوصول إلى config.json ، وتحريرها إذا كنت بحاجة إلى ذلك ، ثم الحفظ.

تصفح من خلال الميزات المتوفرة في Homebridge Config UI X وتعرف على الأداة.

لإيقاف تنفيذ Homebridge ، يمكنك استخدام الأمر أدناه في Terminal:

توقف homebridge خدمة sudo

لإعادة تشغيل Homebridge ، يمكنك استخدام الأمر أدناه:

إعادة تشغيل جسر خدمة sudo

لبدء تنفيذ Homebridge ، يمكنك استخدام الأمر أدناه:

بدء homebridge خدمة sudo

مع تشغيل الخادم ، انتقل إلى الخطوة 9 لمواصلة ربط Homebridge بتطبيق Home على جهاز Apple الخاص بك.

الخطوة 6: تثبيت Homebridge على نظام Windows

إذا لم يكن لديك Raspberry Pi أو نظام أساسي مضمن آخر يمكنه تشغيل Homebridge ، فيمكنك ترك خادمك يعمل على Windows.

ستحتاج إلى تثبيت NodeJS ومحرر نصوص بديل لبرنامج Windows Notepad.

قم بتنزيل NodeJS من أحد الروابط أدناه ثم قم بتثبيته:

nodejs.org/en/download/

أثناء التثبيت ، حدد خانة الاختيار التي تسمح لك بتثبيت الأدوات اللازمة تلقائيًا:

NodeJS ليس برنامج واجهة رسومية ، لذلك يتم تنفيذ جميع الإجراءات عليه من موجه الأوامر.

قم بتنزيل Notepad ++ من أحد الروابط أدناه ثم قم بتثبيته:

notepad-plus-plus.org/downloads/

في قائمة خيارات Windows عند النقر بزر الماوس الأيمن على أي ملف ، سيظهر الخيار "تحرير باستخدام Notepad ++" ويمكنك تحديد هذا الخيار متى احتجت إلى تعديل بعض الملفات النصية أو ملف Homebridge.

اذهب إلى قائمة "ابدأ" في Windows ، اكتب وابحث عن "الإعدادات" وعند العثور على الخيار. انقر فوق "الشبكة والإنترنت" ثم انقر فوق "مركز الشبكة والمشاركة". ضمن "نوع الوصول" ، انقر فوق اتصالك النشط ، وانقر فوق "تفاصيل" وانسخ عنوان MAC المكون من ثمانية أرقام لبطاقة الشبكة الخاصة بك واحفظه في المفكرة ، حيث سيكون هذا العنوان مطلوبًا لاحقًا:

في قائمة "ابدأ" في Windows ، اكتب وابحث عن "cmd" (موجه الأوامر) وعندما تجده ، انقر بزر الماوس الأيمن فوقه وحدد "تشغيل كمسؤول":

مع فتح الجهاز الطرفي ، اكتب كل أمر من الأوامر أدناه واضغط على إدخال بعد كل منها لتأكيد نجاح تثبيت NodeJS / NPM. تعيد هذه الأوامر إصدار كل من الحزم التي تم تثبيتها:

عقدة الخامس

npm -v

بعد اكتمال هذه الإجراءات ، يمكننا تثبيت Homebridge. أدخل الأمر أدناه ، أدخل وانتظر حتى يكتمل التثبيت:

npm install -g - unsafe-perm homebridge

ثم اكتب الأمر أدناه واضغط على enter لتشغيل Homebridge:

هومبريدج

سيعيد Homebridge بعض المعلومات:

1) لم يتم العثور على ملف config.json بواسطة Homebridge. يوفر هذا الملف الإعدادات الأساسية لتشغيل Homebridge وأي مكونات إضافية مثبتة. سننشئ لاحقًا ملف config.json وإعداداته.

2) لا يوجد مكون إضافي مثبت. Homebridge بدون تثبيت المكونات الإضافية غير مجدية تمامًا.

3) لربط الأجهزة بتطبيق Home ، يمكنك قراءة رمز الاستجابة السريعة الذي يمنحك المعلومات التي تحتاجها للإقران. نظرًا لأن ملف config.json لم يتم إنشاؤه وتهيئته ، ولا يوجد مكون إضافي مثبت ، فإن رمز الاستجابة السريعة هذا ليس جيدًا حاليًا ، على الرغم من أنك ستتمكن بالفعل في تطبيق Home من العثور على Homebridge متاحًا للربط ، لكن لا تفعل ذلك.

4) هناك طريقة أخرى لربط الأجهزة بتطبيق Home وهي من خلال خيار "إضافة ملحق" ، و "ليس لدي رمز أو لا يمكنني المسح" ، وضمن "الملحقات القريبة" ، يتم تحديد الجهاز وسيُطلب منك بعد ذلك رمز الإعداد. لاحظ أن الجهاز يظهر الرمز المكون من ثمانية أرقام ويجب إدخاله لمطابقة التطبيق.

اضغط على مفاتيح CTRL + C على الجهاز لإغلاق Homebridge. ستتم إعادة الرسالة "Got SIGINT، shuting down Homebridge …" وستتم مطالبتك بالتأكيد ، حيث يجب عليك كتابة الحرف Y والضغط على Enter.

لإنشاء ملف config.json ، افتح برنامج Notepad ++ ، وانقر على القائمة "ملف" ، "جديد" وستفتح نافذة جديدة. انقر على قائمة "اللغة" ، وانتقل إلى الحرف J في القائمة ، وحدد "JSON".

قم بتنزيل الملف أدناه. افتح هذا الملف وانسخ المحتوى والصقه في الملف المفتوح في Notepad ++:

ملف 05

1) في "اسم المستخدم" ، احذف التسلسل XX: XX: XX: XX: XX: XX وأدخل عنوان MAC المكون من ثمانية أرقام لبطاقة الشبكة التي لاحظتها سابقًا. يجب أن تكون أحرف العنوان التي تدخلها كلها أحرف كبيرة.

2) في "دبوس" ، يمكنك الاحتفاظ بالأرقام الثمانية الرقمية أو يمكنك التغيير إلى تسلسل تريده ، مع تذكر الاحتفاظ بنفس تنسيق الفصل مع الشرطات. سيكون هذا هو الرمز الذي يجب إدخاله عند ربط Homebridge بتطبيق Home.

يمكنك الاحتفاظ بمعلومات الملف الأخرى ، حيث يمكنك إدخال المعلومات المطلوبة عند إضافة المكونات الإضافية والملحقات.

انقر فوق القائمة "ملف" ، "حفظ" ، قم بتسمية الملف config.json واحفظه في المسار "C: / Users / YOUR NAME OR DOCUMENTS \.homebridge":

أغلق Notepad ++.

الخطوة 7: تثبيت Homebridge Config UI X Plugin (Windows)

لإثبات تثبيت المكون الإضافي على Homebridge ، اخترت استخدام Homebridge Config UI X. يسمح هذا المكون الإضافي من خلال متصفح بالقدرة على تكوين Homebridge ومراقبته ونسخه احتياطيًا وإعادة تشغيله.

لتثبيت المكون الإضافي ، اكتب الأمر أدناه في الجهاز ، واضغط على Enter وانتظر حتى ينتهي التثبيت:

npm install -g --unsafe-perm homebridge-config-ui-x

ملاحظة: إذا وجدت خطأ أثناء تثبيت المكون الإضافي يحتوي على المصطلحات MSBUILD / VCBuild.exe ، فقم فقط بتشغيل كل من الأوامر التالية بشكل مستقل ثم حاول التثبيت مرة أخرى من الأمر أعلاه:

تثبيت npm -g node-gyp

npm install - global --production windows-build-tools

npm install - global --production windows-build-tools - مقابل 2015

ستحتاج الآن إلى تعديل config.json وإدخال معلومات المكون الإضافي المضافة إلى Homebridge. انتقل إلى المسار "C: / Users / YOUR NAME OR DOCUMENTS \.homebridge" ومن خلال Notepad ++ افتح config.json الذي تم إنشاؤه مسبقًا:

ضمن بنية "النظام الأساسي" ، يجب إبلاغ جميع المكونات الإضافية التي يتم تثبيتها على Homebridge.

بالنسبة لـ Homebridge Config UI X ، يجب إضافة مقتطف الشفرة التالي الموجود في الملف أدناه. قم بتنزيل وفتح ونسخ المحتوى ولصقه في الملف المفتوح في Notepad ++:

ملف 06

انتقل إلى "منصات" وأدخل مقتطف الشفرة الذي نسخته من الملف. في الصورة أدناه ، يمكنك رؤية الشكل الذي ستبدو عليه بنية "الأنظمة الأساسية" بعد إضافة المعلومات:

إذا كنت تريد التحقق من صحة بنية الكود الخاص بك بعد التحرير ، فما عليك سوى الانتقال إلى موقع JSONLint ، ولصق كل كود config.json ، والنقر على "Validate JSON" وإذا كان كل شيء على ما يرام ، فسيتم إرجاع الرسالة "Valid JSON". إذا كان الرمز الخاص بك به أي خطأ ، فسيتم الإشارة إلى السطر الذي يحتوي على الخطأ وإرجاع رسالة تصف الخطأ:

jsonlint.com/

احفظ الملف وأغلق Notepad ++ وأعد تشغيل Windows.

لفتح Homebridge Config UI X من خلال المتصفح ، انتقل إلى:

localhost: 8080 /

سيتم فتح صفحة مشابهة للصورة أدناه وستتم مطالبتك بتسجيل الدخول وكلمة المرور. لكل من تسجيل الدخول وكلمة المرور ، اكتب admin وأدخل للوصول:

يرجى ملاحظة أنه يظهر على الصفحة الرئيسية رمز الاستجابة السريعة وتحته رقم التعريف الشخصي المكون من 8 أرقام والذي يمكن استخدامه لربط Homebridge بتطبيق Home. في خيار "التهيئة" للأداة ، يمكنك الوصول إلى config.json ، وتحريرها إذا كنت بحاجة إلى ذلك ، ثم الحفظ.

تصفح من خلال الميزات المتوفرة في Homebridge Config UI X وتعرف على الأداة.

الخطوة 8: بدء Homebridge مع Windows

يوفر Homebridge Config UI X أمرًا يمكن استخدامه لتكوين Homebridge كخدمة بحيث يمكن تمهيد الخادم مع Windows. في الموجه ، اكتب الأمر أدناه ، أدخل وانتظر حتى يكتمل التثبيت:

تثبيت خدمة hb

ملاحظة: إذا طلب جدار حماية Windows إذنًا للوصول إلى الشبكة الخاصة ، فامنحه

بعد اكتمال التثبيت ، أغلق موجه الأوامر وأعد تشغيل Windows.

بعد بدء تشغيل النظام ، اضغط على CTRL + ALT + DEL لفتح إدارة مهام Windows. انتقل إلى علامة التبويب "الخدمات" ، وابحث عن Homebridge في القائمة ومعرفة ما إذا كانت "الحالة" "قيد التشغيل":

سيؤدي النقر بزر الماوس الأيمن على خدمة Homebridge إلى فتح الخيارات حيث يمكنك إيقاف الخدمة وإعادة التشغيل وإذا توقفت الخدمة ، يمكنك البدء:

إذا كنت تريد إزالة Homebridge من بدء تشغيل Windows ، فما عليك سوى إدخال الأمر أدناه ، ثم أدخل وانتظر حتى تكتمل عملية إلغاء التثبيت:

إلغاء تثبيت خدمة hb

ملاحظة: اعتمادًا على برنامج مكافحة الفيروسات الذي تستخدمه ، قد تواجه صعوبة في العثور على Homebridge من جهازك المحمول. لأغراض الاختبار ، عندما يحين وقت ربط Homebridge بتطبيق Home ، إذا لم يتم العثور على الخادم في غضون دقيقتين ، فقم بتعطيل برنامج مكافحة الفيروسات الخاص بك ، وقم بتعطيل Windows Defender ، وأعد تشغيل خدمة Homebridge من خلال Windows Task Manager ، وحاول مرة أخرى العثور على الخادم من تطبيق Home

الخطوة 9: ربط Homebridge بتطبيق Home

الإرشادات التالية صالحة لكل من Homebridge الذي يعمل على Raspberry Pi و Windows. تأكد من تشغيل الخادم لأن تطبيق Home لن يجد Homebridge إلا إذا كان متصلاً بالإنترنت.

لقد استخدمت iPhone 8 Plus لهذا المنشور ، لذا من هنا ستكون الخطوات على نظام iOS. بالنسبة للأجهزة الأخرى المتوافقة مع Apple Homekit ، أقترح عليك التحقق من القوائم لمعرفة الخيارات التالية.

انتقل إلى الشاشة الرئيسية لجهاز iPhone وابحث عن تطبيق Home من التطبيقات. إذا لم تتمكن من العثور عليه ، فانتقل إلى متجر التطبيقات وقم بتثبيت التطبيق:

مع فتح تطبيق المنزل ، انقر فوق "إضافة ملحق":

في الشاشة التي تفتح ، انقر فوق "ليس لدي رمز أو لا يمكنني المسح؟":

في "الملحقات القريبة" سترى Homebridge. اضغط عليها لفتح شاشة الاقتران:

سيتم فتح رسالة ويجب النقر فوق "إضافة على أي حال":

سيُطلب منك "رمز إعداد Homebridge". املأ الرمز (PIN) الذي قمت بتعيينه في config.json وانتظر:

إذا سارت الأمور على ما يرام ، سترى شاشة توضح أنه تمت إضافة Homebridge وجاهز للاستخدام:

ملاحظة: إذا تلقيت رسالة تفيد بعدم قبول الرمز أو تعذر إضافته ، فأغلق تطبيق Home ، وأعد تشغيل Homebridge ، وجرب الخطوات مرة أخرى

في الشاشة التالية سترى رسالة "يلزم إعداد إضافي" حيث لا يوجد جهاز Homebridge حتى الآن. انقر فوق تم وسيعود التطبيق إلى الشاشة الرئيسية:

في الشاشة الرئيسية ، انقر فوق رمز المنزل ، وفي الشاشة التالية ، انقر فوق "Hubs & Bridges" ، وانقر فوق Homebridge المضافة حديثًا وستظهر لك بعض المعلومات ، وإذا احتجت لاحقًا إلى إزالة رابط Homebridge ، فما عليك سوى النقر فوق " إزالة الجسر من المنزل ":

إذا قمت بإزالة Homebridge من تطبيق Home وأردت إضافته مرة أخرى ، فستحتاج إلى حذف مجلدات "الملحقات" و "المستمرة" من الخادم.

في Raspberry Pi:

قم بإنهاء Homebridge بكتابة الأمر أدناه في Terminal والضغط على Enter:

توقف homebridge خدمة sudo

إذا قمت بالخطوة 4 لتشغيل Homebridge فور بدء Raspbian ، فاكتب الأمر أدناه واضغط على Enter:

قرص مضغوط / فار / هومبريدج

إذا لم تضع Homebridge لتبدأ بـ Raspbian ، فاكتب الأمر أدناه واضغط على Enter:

cd.homebridge /

اكتب كلًا من الأوامر أدناه واضغط على إدخال بعد كل منها لحذف مجلدي "الملحقات" و "المستمرة":

sudo rm -r persist /

ملحقات sudo rm -r /

Digite o comando abaixo no terminal e dê enter para iniciar o Homebridge:

بدء homebridge خدمة sudo

قم بالخطوات مرة أخرى لربط Homebridge بتطبيق Home.

على نظام Windows:

أوقف خدمة Homebridge من خلال Windows Task Manager ، وانتقل إلى المسار "C: / Users / YOUR NAME OR DOCUMENTS \.homebridge" ، واحذف "الملحقات" و "المجلدات المستمرة. ابدأ خدمة Homebridge من خلال إدارة مهام Windows.

قم بالخطوات مرة أخرى لربط Homebridge بتطبيق Home.

من المهم ملاحظة أن أي جهاز مدمج في تطبيق Home يتم تشغيله محليًا. لتتمكن من التحكم في أجهزة تطبيق Home عبر شبكة خارجية (اتصال 3G / 4G ، على سبيل المثال) ، ستحتاج إلى إعداد مركز أتمتة من أحد أجهزة Apple التالية: iPad (يعمل بنظام iOS 10 أو أحدث) ، Apple TV (الجيل الرابع) أو HomePod. بهذه الطريقة ، حتى بعيدًا عن المنزل ، ستتمكن من التحكم عن بُعد في التشغيل الآلي وأجهزة إنترنت الأشياء المدمجة مع تطبيق Home من خلال Homebridge أو Homekit.

من خلال ربط Homebridge بتطبيق Complete Home ، يمكنك استكشاف وظائف هذه الأداة الرائعة. في الرابط أدناه ، يمكنك رؤية قائمة المكونات الإضافية المتاحة للاستخدام مع Homebridge وبالنقر على كل واحدة يمكنك رؤية معلوماتها وكيفية التثبيت:

www.npmjs.com/search؟q=homebridge-plugin

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

نظرًا لعدم تمكين المستخدم الجذر على Raspbian ، تذكر دائمًا استخدام كلمة sudo قبل أمر تثبيت المحطة الطرفية لعمليات تثبيت البرنامج المساعد. إذا كنت لا تستخدم sudo ، فسيطالبك النظام دائمًا بإدخال كلمة مرور النظام لتنفيذ الإجراء أو يمكنك إرجاع رسالة تفيد بأنه ليس لديك إذن.

في Windows ، يجب تشغيل موجه الأوامر كمسؤول حتى تتمكن من تنفيذ أسطر الأوامر ، ويجب ألا تستخدم كلمة sudo حيث لن يتعرف عليها النظام.

عندما تقوم بتثبيت مكون إضافي ، تأكد من إضافة معلوماته في config.json وأعد تشغيل Homebridge حتى يمكن تحديث تطبيق Home بالمعلومات من المكونات الإضافية المضافة. وبالمثل ، عندما تقوم بإلغاء تثبيت مكون إضافي لـ Homebridge ، تأكد من إزالة معلومات config.json الخاصة بالمكون الإضافي ، كما لو لم تقم بإزالة الخادم ، فقد تواجه مشكلات في بدء التشغيل.

فيما يلي بعض الروابط التي قد تكون مفيدة في العثور على مزيد من المعلومات حول Homebridge و Homekit:

homebridge.io/

github.com/nfarina/homebridge

support.apple.com/pt-br/HT204893

إذا كانت لديك أجهزة Sonoff وترغب في استخدامها مع تطبيق Home و Siri ، فإنني أوصيك بقراءة تعليمات Integrate Sonoff With Home App (Apple IPhone IOS).