homebridge hue
v0.14.7
حقوق الطبع والنشر © 2016-2024 إريك باو. جميع الحقوق محفوظة.
يعرض هذا المكون الإضافي Homebridge أجهزة Apple المتوافقة مع HomeKit Hue (المصابيح، والمقابس، وأجهزة الاستشعار، والمفاتيح، ...) المتصلة بجسر Hue بواسطة Signify.
لاحظ أن Hue تم تطويره في الأصل بواسطة Philips، قبل أن يقسموا قسم الإضاءة الخاص بهم إلى Signify. لا تزال شركة Signify تستخدم اسم العلامة التجارية Philips Hue.
راجع Wiki للحصول على قائمة بميزات Homebridge Hue والأجهزة المدعومة، بما في ذلك مقارنة ميزات:
يقوم Homebridge Hue باكتشاف جسور Hue تلقائيًا. وهو يدعم جسور متعددة من تثبيت واحد. وهو يدعم كلاً من جسر Hue v2 (المربع) وv1 (الدائري). إنه يعمل جنبًا إلى جنب مع وظيفة HomeKit الأصلية لجسر v2 Hue.
يرجى الاطلاع على Wiki للحصول على وصف تفصيلي لـ Homebridge Hue.
أنت بحاجة إلى جسر Philips Hue لتوصيل Homebridge Hue بالمصابيح والمفاتيح وأجهزة الاستشعار المتوافقة مع Hue. أوصي باستخدام أحدث البرامج الثابتة Hue Bridge، مع API v1.61.0 (جسر v2) أو v1.16.0 (جسر v1) أو أعلى.
أنت بحاجة إلى خادم لتشغيل Homebridge. يمكن أن يكون هذا أي شيء يعمل بنظام Node.js: من Raspberry Pi، أو نظام NAS، أو جهاز كمبيوتر يعمل دائمًا بنظام التشغيل Linux، أو macOS، أو Windows. راجع Homebridge Wiki للحصول على التفاصيل. أوصي باستخدام Ethernet السلكية لتوصيل الخادم الذي يقوم بتشغيل Homebridge وجسر Hue وAppleTV الذي يعمل كمحور منزلي.
للتفاعل مع HomeKit، تحتاج إلى Siri أو تطبيق HomeKit على iPhone أو Apple Watch أو iPad أو iPod Touch أو Apple TV (الجيل الرابع أو الأحدث). أوصي باستخدام أحدث الإصدارات من iOS، وwatchOS، وtvOS.
يرجى ملاحظة أن Siri وحتى تطبيق Apple Home لا يزالان يوفران دعمًا محدودًا لـ HomeKit فقط. لاستخدام الميزات الكاملة لـ Homebridge Hue، قد ترغب في التحقق من بعض تطبيقات HomeKit الأخرى، مثل تطبيق Eve (مجاني) أو تطبيق Matthias Hochgatterer’s Home+ (مدفوع).
نظرًا لأن HomeKit يستخدم نظام DNS المتعدد البث (المعروف أيضًا باسم Bonjour) لاكتشاف Homebridge، فيجب أن يكون الخادم الذي يقوم بتشغيل Homebridge على نفس الشبكة الفرعية مثل أجهزة iDevices التي تعمل بنظام HomeKit. للوصول عن بعد ولتشغيل HomeKit (بما في ذلك دعم المفاتيح اللاسلكية)، تحتاج إلى إعداد Apple TV (الجيل الرابع أو الأحدث) أو HomePod كمحور منزلي.
يتضمن Homebridge Hue أداة مساعدة لسطر الأوامر ph للتفاعل مع Hue API من سطر الأوامر. راجع البرنامج التعليمي على Wiki للحصول على مقدمة لهذه الأداة المساعدة.
قم بإصدار ph -h أو ph --help لتقديم نظرة عامة موجزة عن وظائفه ووسيطات سطر الأوامر.
لتثبيت هومبريدج هوى:
اتبع الإرشادات الموجودة على Homebridge Wiki لتثبيت Node.js وHomebridge؛
قم بتثبيت البرنامج الإضافي Homebridge Hue من خلال Homebridge Config UI X أو يدويًا عن طريق:
$ sudo npm -g i homebridge-hue
قم بتحرير config.json وأضف منصة Hue التي توفرها Homebridge Hue، راجع التكوين ؛
قم بتشغيل Homebridge Hue لأول مرة، ثم اضغط على زر الارتباط الموجود على (كل جسر) من الجسور (الجسور). لاحظ زوج مفاتيح معرف الجسر/واجهة برمجة التطبيقات (API) لكل جسر في مخرجات السجل. قم بتحرير config.json لتضمينها، راجع التكوين .
لاحظ أنه لا يمكنك إضافتها من خلال إعدادات Homebridge Hue في Homebridge Config UI X، ولكن يمكنك استخدام Homebridge Config Editor .
لتحديث Homebridge Hue، ما عليك سوى إصدار sudo npm -gi homebridge-hue@latest . يرجى التحقق من ملاحظات الإصدار قبل تحديث Homebridge Hue. لاحظ أن التغيير في الإصدار الثانوي يشير عادةً إلى أنك بحاجة إلى مراجعة/إعادة تكوين HomeKit الخاص بك. نظرًا للتغييرات في تعيين كيفية عرض موارد Hue Bridge، قد يتعامل معها HomeKit على أنها ملحقات و/أو خدمات و/أو خصائص جديدة، مما يؤدي إلى فقدان أي تخصيص لغرف HomeKit والمشاهد والإجراءات والمشغلات. للعودة إلى إصدار سابق، حدد الإصدار عند تثبيت Homebridge Hue، كما في: sudo npm -gi [email protected] .
في config.json الخاص بـ Homebridge، يتعين عليك تحديد Homebridge Hue كمكون إضافي للنظام الأساسي. علاوة على ذلك، تحتاج إلى تحديد ما تريد كشفه لـ HomeKit. راجع Wiki للحصول على مرجع كامل لإعدادات config.json التي يستخدمها Homebridge Hue، وللحصول على بعض الأمثلة.
للتحكم بشكل أكثر دقة في الموارد التي يعرضها Homebridge Hue لـ HomeKit، وكيفية إنشاء روابط الموارد على الجسر، راجع Wiki.
يرجى التحقق من الأسئلة الشائعة.
إذا واجهت مشكلات في بدء تشغيل Homebridge، فيرجى التحقق مرة أخرى من إصدارات Node.js وHomebridge التي تم تثبيتها. تم تطوير واختبار Homebridge Hue باستخدام أحدث إصدار LTS من Node.js وأحدث إصدار من Homebridge. قد تعمل أو لا تعمل الإصدارات الأخرى - ببساطة ليس لدي النطاق الترددي لاختبارها.
إذا واجهت مشكلات في بدء تشغيل Homebridge، فيرجى تشغيل مثيل منفصل لـ Homebridge مع تمكين Homebridge Hue (وHomebridge Config UI X) فقط في config.json . بهذه الطريقة، يمكنك تحديد ما إذا كانت المشكلة مرتبطة بـ Homebridge Hue نفسها، أو بتفاعل مكونات Homebridge الإضافية المتعددة في الإعداد الخاص بك. يمكنك بدء هذا المثيل المنفصل لـ Homebridge على نظام مختلف، كمستخدم مختلف، أو من دليل مستخدم مختلف (محدد بواسطة العلامة -U ). تأكد من استخدام name Homebridge username port (إذا كان يعمل على نفس النظام) مختلفًا في ملف config.json لكل مثيل.
يقوم Homebridge Hue بإخراج رسالة معلومات لكل قيمة مميزة لـ HomeKit يقوم بتعيينها ولكل إشعار بتغيير قيمة خاصية HomeKit يتلقاها. عند بدء تشغيل Homebridge باستخدام -D ، يقوم Homebridge Hue بإخراج رسالة تصحيح الأخطاء لكل طلب يقدمه إلى الجسر، ولكل تغيير حالة يكتشفه أثناء استطلاع الجسر، ولكل إشعار دفع يتلقاه من تدفق أحداث جسر Hue من الجيل الثاني. بالإضافة إلى ذلك، فإنه يصدر رسالة تصحيح لكل مورد جسر يكتشفه.
لالتقاط هذه الرسائل في ملف سجل، قم بما يلي:
$ homebridge -CD 2>&1 | tee homebridge.log
$ gzip homebridge.log
للمساعدة في استكشاف الأخطاء وإصلاحها، عند بدء التشغيل، يقوم Homebridge Hue بتفريغ بيئته، بما في ذلك إعدادات config.json والحالة الكاملة لجميع الجسور في ملف json مضغوط، homebridge-hue.json.gz . يتم إخفاء عناوين IP ومفاتيح واجهة برمجة تطبيقات الجسر. يتم إنشاء هذا الملف في دليل مستخدم Homebridge، ~/.homebridge افتراضيًا. يمكن تنزيله من خلال واجهة مستخدم Homebridge Config UI X، من النافذة المنبثقة Homebridge Hue SETTINGS ، في علامة التبويب Plugins .
إذا كان لديك سؤال، يرجى نشر رسالة على قناة #hue لمجتمع Homebridge على Discord.
إذا واجهت مشكلة، يرجى فتح مشكلة على GitHub. يرجى إرفاق نسخة من homebridge-hue.json.gz بالمشكلة، راجع Debug Dump File . الرجاء إرفاق نسخة من homebridge.log.gz بالمشكلة، راجع Debug Log File . الرجاء عدم نسخ/لصق كميات كبيرة من مخرجات السجل.
أحيانًا أطرح سؤالاً حول كيف يمكن للأشخاص دعم عملي في Homebridge Hue. لقد أنشأت Homebridge Hue كمشروع هواية لاستخدامي الخاص. أشاركه على GitHub حتى يستفيد الآخرون، ولرد الجميل لمجتمع المصادر المفتوحة، الذي بدونه لم يكن من الممكن إنشاء Homebridge Hue.
ومع ذلك، فإن إضافة دعم للأجهزة الجديدة، في Homebridge Hue، أمر صعب للغاية دون الوصول الفعلي إلى الجهاز. نظرًا لأن هذا مشروع هواية، فلا أستطيع إنفاق المال على الأجهزة التي لن أستخدمها بنفسي، فقط لدمجها لصالح الآخرين. ويسعدني أن أتلقى تبرعات صغيرة على شكل أجهزة جديدة لدمجها، أو أموال لشراء هذه الأجهزة بنفسي. ويسعدني أيضًا إرجاع الأجهزة بعد ذلك، إذا قمت بتوفير تكاليف الشحن. يرجى الاتصال بي عبر البريد الإلكتروني أو على Discord للحصول على تفاصيل الشحن.
Homebridge Hue هو مشروع هواية خاص بي، يتم توفيره كما هو، دون أي ضمان على الإطلاق. لقد قمت بتشغيله بنجاح في منزلي لسنوات، ولكن قد يختلف عدد الأميال المقطوعة.
تحتاج مصطلحات HomeKit إلى بعض التعود عليها. يتوافق الملحق بشكل أو بآخر مع جهاز فعلي، ويمكن الوصول إليه من جهاز iOS الخاص بك عبر WiFi أو Bluetooth. يعد الجسر (مثل Homebridge) أحد الملحقات التي توفر الوصول إلى الملحقات الأخرى المتصلة. قد يوفر أحد الملحقات خدمات متعددة. تتوافق كل خدمة مع جهاز افتراضي (مثل المصباح الكهربائي، والمفتاح، ومستشعر الحركة، ...، ولكن أيضًا: زر التبديل القابل للبرمجة، ومعلومات الملحقات، وحالة البطارية). يتفاعل Siri مع الخدمات، وليس مع الملحقات. تحتوي الخدمة على خاصية واحدة أو أكثر. الميزة تشبه سمة الخدمة، والتي يمكن قراءتها أو كتابتها بواسطة تطبيقات HomeKit. قد ترغب في الاطلاع على محاكي ملحقات HomeKit من Apple، والذي يتم توزيعه كأداة إضافية لـ Xcode .
داخليًا، يتعرف HomeKit على الملحقات بواسطة UUID. بالنسبة لأجهزة Zigbee (الأضواء وأجهزة الاستشعار والمفاتيح)، يبني Homebridge Hue معرف UUID هذا على عنوان Zigbee mac. بالنسبة للموارد غير Zigbee (المجموعات والجداول وأجهزة استشعار CLIP)، يعتمد UUID على معرف الجسر ومسار المورد (على سبيل المثال /sensors/1 ). ومن خلال عدم استخدام اسم المورد (على سبيل المثال Daylight )، يستطيع Homebridge Hue التعامل مع الأسماء المكررة. بالإضافة إلى ذلك، سيظل HomeKit يتعرف على الملحق بعد تغيير اسم المورد على الجسر، ويتذكر غرفة HomeKit والمجموعات والمشاهد والإجراءات والمشغلات التي ينتمي إليها. ومع ذلك، عندما يتم حذف مورد غير جسر Zigbee ثم إعادة إنشائه، مما يؤدي إلى مسار مورد مختلف، فسيعامله HomeKit كملحق جديد، وستحتاج إلى إعادة تكوين HomeKit.
