zigbee2mqtt
1.41.0
يسمح لك باستخدام أجهزة Zigbee الخاصة بك بدون جسر أو بوابة البائع.
فهو يربط الأحداث ويسمح لك بالتحكم في أجهزة Zigbee عبر MQTT. بهذه الطريقة يمكنك دمج أجهزة Zigbee الخاصة بك مع أي بنية تحتية للمنزل الذكي تستخدمها.
توفر لك الوثائق جميع المعلومات اللازمة للتشغيل! تأكد من عدم تخطي الأقسام إذا كانت هذه هي زيارتك الأولى، حيث قد تكون هناك تفاصيل مهمة بالنسبة لك.
إذا لم تكن على دراية بمصطلحات Zigbee فتأكد من قراءة هذا لمساعدتك.
يتكامل Zigbee2MQTT بشكل جيد مع كل حلول التشغيل الآلي للمنزل (تقريبًا) لأنه يستخدم MQTT. لكن التكاملات التالية جديرة بالذكر:
يتكون Zigbee2MQTT من ثلاث وحدات، تم تطوير كل منها في مشروع Github الخاص بها. البدء من الأجهزة (المحول) والانتقال للأعلى؛ يتصل zigbee-herdsman بمحول Zigbee الخاص بك ويجعل واجهة برمجة التطبيقات (API) متاحة للمستويات الأعلى من المكدس. بالنسبة لأجهزة Texas Instruments على سبيل المثال، يستخدم zigbee-herdsman واجهة برمجة التطبيقات للمراقبة والاختبار TI zStack للتواصل مع المحول. يتولى Zigbee-herdsman اتصالات Zigbee الأساسية. تتعامل وحدة محولات zigbee-herdsman مع التعيين من نماذج الأجهزة الفردية إلى مجموعات Zigbee التي تدعمها. مجموعات Zigbee هي طبقات بروتوكول Zigbee الموجودة أعلى البروتوكول الأساسي والتي تحدد أشياء مثل كيفية تواصل الأضواء وأجهزة الاستشعار والمفاتيح مع بعضها البعض عبر شبكة Zigbee. أخيرًا، تعمل وحدة Zigbee2MQTT على تشغيل zigbee-herdsman وتعيين رسائل zigbee إلى رسائل MQTT. يقوم Zigbee2MQTT أيضًا بتتبع حالة النظام. يستخدم ملف database.db لتخزين هذه الحالة؛ ملف نصي يحتوي على قاعدة بيانات JSON للأجهزة المتصلة وإمكانياتها. يوفر Zigbee2MQTT واجهة على شبكة الإنترنت تسمح بالمراقبة والتكوين.
يستخدم Zigbee2MQTT TypeScript (جزئيًا في الوقت الحالي). ولذلك، بعد إجراء تغييرات على الملفات الموجودة في الدليل lib/ ، تحتاج إلى إعادة ترجمة Zigbee2MQTT. يمكن القيام بذلك عن طريق تنفيذ npm run build . للتطوير بشكل أسرع بدلاً من تشغيل npm run build يمكنك تشغيل npm run build-watch في جلسة طرفية أخرى، وسيتم إعادة ترجمة هذا أثناء تغيير الملفات. في المرة الأولى قبل البناء، تحتاج إلى تشغيل npm install --include=dev قبل إرسال التغييرات، قم بتشغيل npm run test-with-coverage و npm run pretty:check و npm run eslint
راجع الأجهزة المدعومة للتحقق مما إذا كان جهازك مدعومًا. هناك قائمة واسعة جدًا، بما في ذلك الأجهزة من البائعين مثل Xiaomi وIkea وPhilips وOSRAM والمزيد.
إذا لم يكن مدرجًا في الأجهزة المدعومة، فيمكن إضافة الدعم بسهولة (إلى حد ما)، راجع كيفية دعم الأجهزة الجديدة.
إذا كنت بحاجة إلى مساعدة يمكنك التحقق من القضايا المفتوحة. لا تتردد في المساعدة في طلبات السحب عندما تتمكن من إصلاح الأشياء أو إضافة أجهزة جديدة أو مجرد مشاركة الحب على وسائل التواصل الاجتماعي.
