โฮมบริดจ์เว้

ปลั๊กอิน Homebridge สำหรับ Philips Hue

การแนะนำ

ปลั๊กอิน Homebridge นี้เปิดเผยกับอุปกรณ์ที่เข้ากันได้กับ HomeKit Hue ของ Apple (ไฟ ปลั๊ก เซ็นเซอร์ สวิตช์ ...) ที่เชื่อมต่อกับ Hue Bridge โดย Signify

โปรดทราบว่า Hue ได้รับการพัฒนาโดย Philips ก่อนที่จะแยกแผนกระบบแสงสว่างออกเป็น Signify Signify ยังคงใช้ชื่อแบรนด์ Philips Hue

ดู Wiki สำหรับรายการคุณสมบัติ Homebridge Hue และอุปกรณ์ที่รองรับ รวมถึงการเปรียบเทียบคุณสมบัติของ:

ฟังก์ชัน HomeKit ดั้งเดิมของ Hue Bridge รุ่นที่ 2 (สี่เหลี่ยมจัตุรัส) ของ
ฟังก์ชัน Native Matter ของ Hue Bridge รุ่นที่ 2 (สี่เหลี่ยมจัตุรัส) ซึ่งเชื่อมต่อกับ HomeKit ของ
Homebridge Hue ร่วมกับสะพาน Hue; และของ
Homebridge deCONZ ร่วมกับเกตเวย์ deCONZ

Homebridge Hue ทำการค้นหาสะพาน Hue โดยอัตโนมัติ รองรับหลายบริดจ์จากการติดตั้งครั้งเดียว รองรับทั้งสะพานเว้ v2 (สี่เหลี่ยม) และ v1 (กลม) โดยจะทำงานร่วมกับฟังก์ชัน HomeKit ดั้งเดิมของ v2 Hue Bridge

โปรดดู Wiki สำหรับคำอธิบายโดยละเอียดของ Homebridge Hue

ข้อกำหนดเบื้องต้น

คุณต้องมี Philips Hue Bridge เพื่อเชื่อมต่อ Homebridge Hue กับไฟ สวิตช์ และเซ็นเซอร์ที่เข้ากันได้กับ Hue ฉันแนะนำให้ใช้เฟิร์มแวร์ Hue Bridge ล่าสุด โดยมี API v1.61.0 (v2 Bridge) หรือ v1.16.0 (v1 Bridge) หรือสูงกว่า

คุณต้องมีเซิร์ฟเวอร์เพื่อเรียกใช้ Homebridge ซึ่งอาจเป็นอะไรก็ได้ที่ใช้ Node.js: จาก Raspberry Pi, ระบบ NAS หรือพีซีที่ทำงานตลอดเวลาที่ใช้ Linux, macOS หรือ Windows ดู Homebridge Wiki สำหรับรายละเอียด ฉันแนะนำให้ใช้อีเธอร์เน็ตแบบมีสายเพื่อเชื่อมต่อเซิร์ฟเวอร์ที่ใช้ Homebridge, Hue Bridge และ AppleTV ที่ทำหน้าที่เป็นศูนย์กลางบ้าน

หากต้องการโต้ตอบกับ HomeKit คุณต้องมี Siri หรือแอพ HomeKit บน iPhone, Apple Watch, iPad, iPod Touch หรือ Apple TV (รุ่นที่ 4 หรือใหม่กว่า) ฉันแนะนำให้ใช้ iOS, watchOS และ tvOS เวอร์ชันล่าสุด
โปรดทราบว่า Siri และแม้แต่แอป Home ของ Apple ยังคงให้การสนับสนุน HomeKit อย่างจำกัดเท่านั้น หากต้องการใช้คุณสมบัติทั้งหมดของ Homebridge Hue คุณอาจต้องการลองใช้แอป HomeKit อื่นๆ เช่น แอป Eve (ฟรี) หรือแอป Home+ ของ Matthias Hochgatterer (ชำระเงิน)

เนื่องจาก HomeKit ใช้ multicast-DNS (aka Bonjour) เพื่อค้นหา Homebridge เซิร์ฟเวอร์ที่ใช้ Homebridge จึงต้องอยู่บนเครือข่ายย่อยเดียวกันกับ iDevices ของคุณที่ใช้ HomeKit สำหรับการเข้าถึงระยะไกลและสำหรับการทำงานอัตโนมัติของ HomeKit (รวมถึงการรองรับสวิตช์ไร้สาย) คุณต้องตั้งค่า Apple TV (รุ่นที่ 4 หรือใหม่กว่า) หรือ HomePod เป็นศูนย์กลางอุปกรณ์บ้าน

ยูทิลิตี้บรรทัดคำสั่ง

Homebridge Hue มียูทิลิตีบรรทัดคำสั่ง ph เพื่อโต้ตอบกับ Hue API จากบรรทัดคำสั่ง ดูบทช่วยสอนบน Wiki สำหรับคำแนะนำเกี่ยวกับยูทิลิตี้นี้

ปัญหา ph -h หรือ ph --help เพื่อให้ภาพรวมโดยย่อเกี่ยวกับฟังก์ชันการทำงานและอาร์กิวเมนต์บรรทัดคำสั่ง

การติดตั้ง

วิธีติดตั้ง Homebridge Hue:

ทำตามคำแนะนำบน Homebridge Wiki เพื่อติดตั้ง Node.js และ Homebridge
ติดตั้งปลั๊กอิน Homebridge Hue ผ่าน Homebridge Config UI X หรือด้วยตนเองโดย:
```
 $ sudo npm -g i homebridge-hue
```
แก้ไข config.json และเพิ่มแพลตฟอร์ม Hue ที่ Homebridge Hue จัดเตรียมไว้ โปรดดูที่ Configuration
เรียกใช้ Homebridge Hue เป็นครั้งแรก กดปุ่มลิงก์บน (แต่ละอัน) บริดจ์ของคุณ สังเกตคู่คีย์ ID/API บริดจ์สำหรับแต่ละบริดจ์ในเอาต์พุตบันทึก แก้ไข config.json เพื่อรวมสิ่งเหล่านี้ โปรดดูที่ Configuration
โปรดทราบว่าคุณไม่สามารถเพิ่มสิ่งเหล่านี้ผ่าน การตั้งค่า 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 ได้รับการพัฒนาและทดสอบโดยใช้ Node.js เวอร์ชัน LTS ล่าสุด และ Homebridge เวอร์ชันล่าสุด เวอร์ชันอื่นอาจใช้งานได้หรือใช้งานไม่ได้ - ฉันไม่มีแบนด์วิดท์ที่จะทดสอบสิ่งเหล่านี้

เรียกใช้ Homebridge Hue Solo

หากคุณประสบปัญหาการเริ่มต้น 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 Bridge รุ่นที่ 2 นอกจากนี้ยังออกข้อความตรวจแก้จุดบกพร่องสำหรับแต่ละทรัพยากรบริดจ์ที่ตรวจพบ

หากต้องการบันทึกข้อความเหล่านี้ลงในไฟล์บันทึก ให้ทำดังต่อไปนี้:

หากคุณใช้งาน Homebridge เป็นบริการ ให้หยุดบริการนั้น
รัน Homebridge ด้วยตนเอง โดยบันทึกเอาต์พุตเป็นไฟล์ โดยการออก:
```
 $ homebridge -CD 2>&1 | tee homebridge.log
```
โต้ตอบกับอุปกรณ์ของคุณผ่านแอพเนทีฟและหรือผ่าน HomeKit เพื่อกระตุ้นปัญหา
กดขัดจังหวะ (ctrl-C) เพื่อหยุด Homebridge;
หากคุณใช้งาน Homebridge เป็นบริการ ให้เริ่มบริการใหม่
บีบอัดไฟล์บันทึกโดยการออก:
```
 $ gzip homebridge.log
```

แก้ไขข้อบกพร่องไฟล์ดัมพ์

เพื่อช่วยแก้ไขปัญหา เมื่อเริ่มต้นระบบ Homebridge Hue จะทิ้งสภาพแวดล้อม รวมถึงการตั้งค่า config.json และสถานะเต็มของบริดจ์ทั้งหมดลงในไฟล์ json ที่บีบอัด homebridge-hue.json.gz ที่อยู่ IP และคีย์ API ของบริดจ์ถูกปกปิด ไฟล์นี้ถูกสร้างขึ้นในไดเร็กทอรีผู้ใช้ Homebridge ~/.homebridge ตามค่าเริ่มต้น สามารถดาวน์โหลดได้ผ่านอินเทอร์เฟซผู้ใช้ Homebridge Config UI X จากหน้าต่างป๊อปอัป Homebridge Hue SETTINGS บนแท็บ ปลั๊กอิน

การขอความช่วยเหลือ

หากคุณมีคำถาม โปรดโพสต์ข้อความไปที่ช่อง #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 Accessory Simulator ของ Apple ซึ่งเผยแพร่เป็นเครื่องมือเพิ่มเติมสำหรับ Xcode

ภายใน HomeKit จะระบุอุปกรณ์เสริมด้วย UUID สำหรับอุปกรณ์ Zigbee (ไฟ เซ็นเซอร์ สวิตช์) Homebridge Hue จะยึด UUID นี้ตามที่อยู่ Mac ของ Zigbee สำหรับทรัพยากรที่ไม่ใช่ Zigbee (กลุ่ม ตารางเวลา เซ็นเซอร์ CLIP) UUID จะขึ้นอยู่กับ ID บริดจ์และเส้นทางทรัพยากร (เช่น /sensors/1 ) หากไม่ใช้ชื่อทรัพยากร (เช่น Daylight ) Homebridge Hue สามารถจัดการกับชื่อที่ซ้ำกันได้ นอกจากนี้ HomeKit จะยังคงจดจำอุปกรณ์เสริมได้หลังจากที่ชื่อทรัพยากรเปลี่ยนไปบนบริดจ์ โดยจดจำห้อง HomeKit กลุ่ม ฉาก การกระทำ และทริกเกอร์ของอุปกรณ์ดังกล่าว อย่างไรก็ตาม เมื่อทรัพยากรบริดจ์ที่ไม่ใช่ Zigbee ถูกลบแล้วสร้างขึ้นใหม่ ส่งผลให้มีเส้นทางทรัพยากรที่แตกต่างกัน HomeKit จะถือว่าทรัพยากรดังกล่าวเป็นอุปกรณ์เสริมใหม่ และคุณจะต้องกำหนดค่า HomeKit ใหม่

ขยาย

ข้อมูลเพิ่มเติม