zigbee2mqtt

Zigbee2MQTT? ?

Memungkinkan Anda menggunakan perangkat Zigbee tanpa jembatan atau gerbang vendor.

Ini menjembatani peristiwa dan memungkinkan Anda mengontrol perangkat Zigbee Anda melalui MQTT. Dengan cara ini Anda dapat mengintegrasikan perangkat Zigbee Anda dengan infrastruktur rumah pintar apa pun yang Anda gunakan.

Memulai

Dokumentasi memberi Anda semua informasi yang diperlukan untuk memulai dan menjalankannya! Pastikan Anda tidak melewatkan bagian jika ini adalah kunjungan pertama Anda, karena mungkin ada detail penting di sana untuk Anda.

Jika Anda belum familiar dengan terminologi Zigbee, pastikan Anda membaca ini untuk membantu Anda.

Integrasi

Zigbee2MQTT terintegrasi dengan baik dengan (hampir) setiap solusi otomatisasi rumah karena menggunakan MQTT. Namun integrasi berikut patut disebutkan:

Asisten Rumah

• OS Asisten Rumah: Menggunakan addon resmi
• Instalasi lainnya: menggunakan instruksi di sini

Nyaman

• Integrasi diterapkan di Aplikasi Homey
• Dokumentasi dan dukungan di Homey Forum

Domotikz

• Integrasi diterapkan di Domoticz (dokumentasi).

Asisten Gladys

• Integrasi diterapkan secara asli di Gladys Assistant (dokumentasi).

IoBroker

• Integrasi diterapkan di IoBroker (dokumentasi).

Arsitektur

Arsitektur Internal

Zigbee2MQTT terdiri dari tiga modul, masing-masing dikembangkan dalam proyek Githubnya sendiri. Mulai dari perangkat keras (adaptor) dan seterusnya; zigbee-herdsman terhubung ke adaptor Zigbee Anda dan membuat API tersedia untuk tingkat tumpukan yang lebih tinggi. Misalnya perangkat keras Texas Instruments, zigbee-herdsman menggunakan API pemantauan dan pengujian TI zStack untuk berkomunikasi dengan adaptor. Zigbee-gembala menangani komunikasi inti Zigbee. Modul zigbee-herdsman-converters menangani pemetaan dari model perangkat individual ke cluster Zigbee yang didukungnya. Cluster Zigbee adalah lapisan protokol Zigbee di atas protokol dasar yang menentukan hal-hal seperti bagaimana lampu, sensor, dan sakelar berkomunikasi satu sama lain melalui jaringan Zigbee. Terakhir, modul Zigbee2MQTT menggerakkan zigbee-herdsman dan memetakan pesan zigbee ke pesan MQTT. Zigbee2MQTT juga melacak status sistem. Ia menggunakan file database.db untuk menyimpan status ini; file teks dengan database JSON perangkat yang terhubung dan kemampuannya. Zigbee2MQTT menyediakan antarmuka berbasis web yang memungkinkan pemantauan dan konfigurasi.

Berkembang

Zigbee2MQTT menggunakan TypeScript (sebagian untuk saat ini). Oleh karena itu setelah melakukan perubahan pada file di direktori lib/ Anda perlu mengkompilasi ulang Zigbee2MQTT. Hal ini dapat dilakukan dengan menjalankan npm run build . Untuk pengembangan yang lebih cepat daripada menjalankan npm run build Anda dapat menjalankan npm run build-watch di sesi terminal lain, ini akan dikompilasi ulang saat Anda mengubah file. Pertama kali sebelum membangun, Anda perlu menjalankan npm install --include=dev Sebelum mengirimkan perubahan, jalankan npm run test-with-coverage , npm run pretty:check dan npm run eslint

Perangkat yang didukung

Lihat Perangkat yang didukung untuk memeriksa apakah perangkat Anda didukung. Daftarnya cukup lengkap, termasuk perangkat dari vendor seperti Xiaomi, Ikea, Philips, OSRAM, dan banyak lagi.

Jika tidak tercantum dalam Perangkat yang didukung, dukungan dapat ditambahkan (dengan cukup) mudah, lihat Cara mendukung perangkat baru.

Dukungan & bantuan

Jika Anda memerlukan bantuan, Anda dapat memeriksa masalah yang terbuka. Jangan ragu untuk membantu dengan Permintaan Tarik ketika Anda dapat memperbaiki sesuatu atau menambahkan perangkat baru atau sekadar berbagi cinta di media sosial.