bermuda

Trilaterasi Bermuda BLE

• Lacak perangkat bluetooth berdasarkan Area (Ruangan) di HomeAssistant, menggunakan perangkat bluetooth_proxy ESPHome.

• (akhirnya) Lakukan pelacakan posisi perangkat! Seperti, di peta. Mungkin.

Kegunaannya:

Bermuda bertujuan untuk memungkinkan Anda melacak perangkat bluetooth apa pun, dan meminta Homeassistant memberi tahu Anda di mana perangkat itu berada di rumah Anda. Satu-satunya perangkat keras tambahan yang Anda perlukan adalah perangkat esp32 yang menjalankan esphome yang bertindak sebagai proxy bluetooth. Alternatifnya, perangkat Shelly Plus juga dapat menjalankan fungsi ini.

• Lokasi perangkat berbasis area (yaitu keberadaan ruangan di tingkat perangkat) berfungsi dengan cukup baik.
• Membuat sensor untuk Area dan Jarak untuk perangkat yang Anda pilih
• Mendukung perangkat iBeacon, termasuk perangkat dengan alamat MAC acak (seperti ponsel Android yang menjalankan Aplikasi HA Companion)
• Mendukung IRK (kunci yang dapat diselesaikan) melalui komponen inti Perangkat Private BLE. Setelah perangkat iOS Anda (atau Android!) diatur di Perangkat BLE Pribadi, maka secara otomatis akan menerima sensor Bermuda juga!
• Membuat entitas device_tracker untuk perangkat yang dipilih, yang dapat ditautkan ke "Orang" untuk pelacakan Rumah/Bukan Rumah
• Pengaturan yang dapat dikonfigurasi untuk tingkat referensi rssi, redaman lingkungan, radius pelacakan maksimal
• Menyediakan kumpulan perangkat json/yaml yang komprehensif dan jaraknya dari setiap penerima bluetooth, melalui layanan bermuda.dump_devices .

Apa yang Anda butuhkan:

• Satu atau lebih perangkat yang menyediakan informasi proksi bluetooth ke HA menggunakan komponen bluetooth_proxy esphome. Saya menyukai papan D1-Mini32 karena murah dan mudah dipasang. Perangkat proxy bluetooth Shelly Plus dilaporkan berfungsi dengan baik. Hanya perangkat bluetooth yang didukung secara asli yang didukung, artinya tidak ada dukungan saat ini atau yang direncanakan untuk perangkat MQTT, dll.

• USB Bluetooth pada host HA Anda tidak ideal, karena tidak memberikan stempel waktu pada paket iklan. Namun ini dapat digunakan untuk pelacakan sederhana "Rumah/Tidak Rumah", dan dukungan jarak Area diaktifkan saat ini.

• Beberapa perangkat bluetooth BLE yang ingin Anda lacak. Jam tangan pintar, ubin suar, termometer, dll

• Instal Bermuda melalui HACS:

Dokumentasi dan bantuan - Wiki

Lihat Wiki untuk informasi lebih lanjut tentang cara kerjanya dan cara mengkonfigurasi Bermuda untuk rumah Anda.

Tangkapan layar

Setelah menginstal, integrasi akan terlihat di Pengaturan, Perangkat & Layanan

Tekan tombol CONFIGURE untuk melihat dialog konfigurasi. Di bagian bawah terdapat kolom tempat Anda dapat memasukkan/mendaftar perangkat bluetooth apa pun yang dapat dilihat sistem. Memilih perangkat akan menambahkannya ke daftar perangkat yang dikonfigurasi dan membuat entitas sensor untuk perangkat tersebut. Lihat Bagaimana Cara Kerja Pengaturannya? untuk informasi lebih lanjut.

Memilih layar perangkat menunjukkan sensor saat ini dan info lainnya. Perhatikan bahwa ada sensor tambahan di bagian "tidak ditampilkan" yang dinonaktifkan secara default (tangkapan layar menunjukkan beberapa di antaranya sudah diaktifkan). Anda dapat mengedit properti ini untuk mengaktifkannya untuk data yang lebih detail tentang lokasi perangkat Anda. Namun hal ini terutama ditujukan untuk pemecahan masalah atau pengembangan.

Informasi sensor juga mencakup nama dan id area atribut, alamat MAC yang relevan, dll.

Di Pengaturan, Orang, Anda dapat menentukan perangkat Bermuda apa pun untuk melacak status pulang/pergi untuk orang/pengguna mana pun.

Pertanyaan Umum

Lihat FAQ di Wiki!

TODO / Ide

• Beralih untuk melakukan pembaruan pada penerimaan iklan, bukan melakukan polling berkala (tidak, interval bekerja lebih baik)
• "Selesaikan" perkiraan jarak antar-proxy secara real-time menggunakan Ketimpangan Segitiga
• Selesaikan koordinat x/y semua pemindai dan proxy (!)
• Semacam peta, cukup pilih dua proxy sebagai vektor sumbu x dan lanjutkan
• Pengaturan konfigurasi untuk menentukan lokasi absolut dari dua proxy
• Dukung beberapa cara untuk "menyematkan" lebih dari dua proxy/tag, dan tidak merusaknya.
• Antarmuka untuk menentukan Area sehubungan dengan proxy yang disematkan
• Bereksperimenlah dengan beberapa algo ini untuk meningkatkan akurasi (terlalu banyak perhitungan bagi saya!). Terutama memberi bobot lebih tinggi pada jarak yang lebih pendek dan mungkin sidik jari kesamaan kosinus, mungkin terhadap suar tetap juga untuk memperlancar fluktuasi rssi lingkungan.

Kiat peretasan

Ingin memperbaikinya? Luar biasa! Ingatlah bahwa ini adalah integrasi HA pertama saya, dan saya lebih merupakan administrator sistem greybeard daripada programmer jika ketika saya melakukan hal-hal bodoh, saya sangat menyambut baik beberapa perbaikan!

Anda bisa memulai dengan menggunakan layanan bermuda.dump_devices untuk memeriksa keadaan internal.

Menggunakan layanan bermuda.dump_devices

Hanya dengan memanggil layanan bermuda.dump_devices akan memberi Anda gambaran lengkap tentang struktur data internal yang digunakan bermuda untuk melacak dan menghitung statusnya. Ini dapat berguna untuk mengetahui apa yang terjadi dan memecahkan masalah, atau untuk digunakan jika Anda memiliki kebutuhan khusus yang dapat diselesaikan dengan sensor templat, dll.

Jika dipanggil tanpa parameter, layanan akan mengembalikan semua data. Tersedia parameter yang memungkinkan Anda membatasi atau memformat ulang data yang dihasilkan agar lebih mudah digunakan. Khususnya parameter addresses berguna untuk hanya mengembalikan data yang relevan untuk satu atau lebih alamat MAC (atau UUID iBeacon). Lihat informasi tentang parameter di halaman Services di asisten rumah, di bawah Developer Tools .

Penting: Jika Anda memutuskan untuk menggunakan hasil panggilan ini untuk templat Anda sendiri, dll., ingatlah bahwa formatnya mungkin berubah dalam rilis apa pun, dan tidak serta merta dianggap sebagai "perubahan yang dapat menyebabkan gangguan". Hal ini karena strukturnya digunakan secara internal, bukan sebagai API yang dipublikasikan. Meskipun demikian, upaya akan dilakukan untuk menunjukkan dalam catatan rilis jika bidang dalam struktur diubah namanya atau dipindahkan, namun tidak untuk menambahkan item baru.

Seni Sebelumnya

Integrasi bluetooth_tracker dan ble_tracker hanya dibuat untuk memberikan penentuan "rumah/bukan rumah", dan tidak melakukan lokasi berdasarkan "Area". (nb: "Zona" adalah tempat di luar rumah, sedangkan "Area" adalah ruangan/area di dalam rumah). Saya ingin bebas bereksperimen dengan ini dengan cara yang mungkin tidak sesuai dengan inti, tapi semoga setidaknya beberapa di antaranya dapat menemukan tempat di basis kode inti suatu hari nanti.

Skrip "monitor" menggunakan Pi mandiri untuk mengumpulkan data bluetooth dan kemudian memompanya ke MQTT. Ia tidak menggunakan kemampuan bluetooth_proxy yang menurut saya merupakan masa depan jaringan bluetooth rumahan (ya, ini untuk rumah saya!).

ESPrescence terlihat keren, tapi saya tidak ingin mendedikasikan node saya untuk penggunaan non-esphome, dan sekali lagi ini tidak memanfaatkan fitur proxy bluetooth yang sekarang ada di HA. Saya mungkin menemukan kembali cukup banyak roda ESPrescense.

Instalasi

Pastinya gunakan antarmuka HACS! Setelah Anda menginstal HACS, buka Integrations , klik menu bakso di kanan atas, dan pilih Custom Repositories . Tempelkan agittins/bermuda ke dalam bidang Repository , dan pilih Integration untuk Category . Klik Add .

Anda sekarang dapat menambahkan integrasi Bermuda BLE Trilateration . Setelah Anda selesai melakukannya, Anda perlu me-restart Homeassistant, lalu di Settings , Devices & Services pilih Add Integration dan cari Bermuda BLE Trilateration . Mungkin saja itu akan mendeteksi secara otomatis untuk Anda hanya dengan memperhatikan perangkat bluetooth terdekat.

Setelah integrasi ditambahkan, Anda perlu menyiapkan perangkat Anda dengan mengklik Configure di Devices and Services , Bermuda BLE Trilateration .

Dalam dialog Configuration , Anda dapat memilih perangkat bluetooth mana yang ingin Anda lacak integrasinya.

Petunjuk di bawah ini adalah catatan umum dari templat:

1. Dengan menggunakan alat pilihan, buka direktori (folder) untuk konfigurasi HA Anda (tempat Anda menemukan configuration.yaml ).
2. Jika Anda tidak memiliki direktori (folder) custom_components di sana, Anda perlu membuatnya.
3. Di direktori custom_components (folder) buat folder baru bernama bermuda .
4. Unduh semua file dari direktori (folder) custom_components/bermuda/ di repositori ini.
5. Tempatkan file yang Anda unduh di direktori (folder) baru yang Anda buat.
6. Mulai ulang Asisten Rumah
7. Di HA UI buka "Konfigurasi" -> "Integrasi" klik "+" dan cari "Bermuda BLE Trilateration"

Kontribusi dipersilahkan!

Jika Anda ingin berkontribusi, silakan baca pedoman Kontribusi

Kredit

Proyek ini dihasilkan dari templat Cookiecutter Komponen Kustom Asisten Rumah @oncleben31.

Templat kode sebagian besar diambil dari Panduan Pengguna Cookiecutter template integrasi_blueprint @Ludeeus**

---