hass aarlo
version 0.8.1.9
Aarlo adalah komponen khusus untuk Home Assistant, yang menyediakan akses ke sistem Arlo.
Aarlo menyediakan antara lain:
Aarlo adalah komponen khusus untuk Home Assistant, yang menyediakan akses ke sistem Arlo.
Integrasinya menggunakan API yang disediakan oleh Situs Web Arlo Camera dan terdapat beberapa batasan dalam hal ini. Lihat bagian Batasan yang Diketahui untuk rincian lebih lanjut.
Jika Anda mengalami masalah, lihat bagian FAQ untuk melihat apakah masalah tersebut diketahui dan memiliki solusi atau perbaikan. Jika tidak, lihat bagian Laporan Bug untuk informasi tentang cara membuat log debug dan membuat laporan debug.
README tingkat lanjut ada di sini
README lama masih tersedia di sini.
Dokumen ini mengasumsikan Anda sudah familiar dengan pengaturan dan konfigurasi Home Assistant .
Di mana pun Anda melihat /config dalam dokumen ini, ini mengacu pada direktori konfigurasi Home Assistant Anda. Misalnya, untuk instalasi saya, /home/steve/ha yang dipetakan ke /config oleh wadah buruh pelabuhan saya.
Di mana pun Anda melihat Arlo, itu mengacu pada bagian mana pun dari sistem Arlo .
Di mana pun Anda melihat Aarlo, yang saya maksud adalah komponen ini.
Terima kasih banyak kepada:
Aarlo juga menyediakan Kartu Lovelace khusus, yang melapisi foto terakhir kamera dengan statusnya saat ini dan memungkinkan akses ke perpustakaan rekaman kamera dan streaming langsung.
Jika Anda belum familiar dengan Home Assistant, saya sarankan untuk mengunjungi Situs Komunitas. Ini penuh dengan orang-orang yang membantu dan selalu ada seseorang yang mengalami masalah yang Anda coba perbaiki.
Aarlo membutuhkan akun Arlo khusus. Jika Anda mencoba menggunakan kembali akun yang sudah ada, misalnya akun yang Anda gunakan pada aplikasi Arlo di ponsel, aplikasi dan integrasi ini akan terus berjuang untuk masuk. Ini adalah batasan Arlo .
Akun Aarlo khusus perlu mengaktifkan Allow Access Rights untuk mengatur tingkat alarm dan membaca nilai status tertentu.
Lihat dokumentasi Arlo untuk instruksi lebih lanjut.
Anda harus mengaktifkan otentikasi dua faktor. Siapkan alamat email untuk menerima kode verifikasi. Aarlo mendukung mekanisme TFA lainnya tetapi email adalah yang paling mudah digunakan. Lihat bagian Otentikasi Dua Faktor nanti untuk detail selengkapnya.
Anda hanya perlu menggunakan salah satu mekanisme instalasi ini. Saya merekomendasikan HACS.
Aarlo adalah bagian dari penyimpanan HACS default. Jika Anda tidak tertarik menggunakan cabang pengembangan, ini adalah cara termudah untuk menginstal.
Salin direktori aarlo ke direktori /config/custom_components Anda.
Jalankan skrip instalasi. Jalankan sekali untuk memastikan operasi terlihat normal dan jalankan untuk kedua kalinya dengan parameter go untuk melakukan pekerjaan sebenarnya. Jika Anda memperbarui, jalankan kembali skrip, itu akan menimpa semua file yang diinstal.
install /config # check output looks good
install go /config Bagaimanapun Anda menginstal kode sumber, Anda tahu perlu menambahkan integrasi ke Home Assistant . Dari halaman beranda pilih Settings -> Devices & Services , dari sini klik ADD INTEGRATION dan cari Aarlo . Di layar pertama masukkan detail akun Anda.
| Bidang | Nilai |
|---|---|
| Nama belakang | Nama pengguna akun Arlo Anda |
| Kata sandi | Kata sandi akun Arlo Anda |
| Mekanisme Dua Faktor | Pilih IMAP |
| Nama Pengguna TFA | Akun email yang Anda daftarkan untuk TFA |
| Kata Sandi TFA | Kata sandi akun email |
| Tuan Rumah TFA | Server IMAP untuk mencari email |
Jika Anda membiarkan Use aarlo prefix dicentang, semua perangkat Anda akan berformat type.aarlo_* .
Klik SUBMIT . Integrasi akan masuk ke Arlo dan mengambil daftar perangkat yang terkait dengannya. Jika semuanya berfungsi, Anda akan dapat menetapkan perangkat ke ruangan di layar berikutnya.
Anda dapat menyempurnakan pengaturannya lebih lanjut. Dari halaman Integrasi, klik CONFIGURE .
Sempurnakan pengaturan alarm:
| Bidang | Nilai |
|---|---|
| Kode Alarm/melucuti senjata | Masukkan kode jika diperlukan, jika tidak, biarkan sebagai default |
| Nama mode yang dilucuti | Ubah jika akun Arlo Anda memiliki nama khusus yang dilucuti |
| Nama mode rumah | Ubah jika akun Arlo Anda memiliki nama mode rumah khusus |
| Nama mode tandang | Ubah jika akun Arlo Anda memiliki nama mode tandang khusus |
| Nama mode malam | Ubah jika akun Arlo Anda memiliki nama mode malam khusus |
| Kode lengan diperlukan | Pilih apakah kode Alarm/melucuti senjata diperlukan untuk mempersenjatai |
| Diperlukan pelucutan kode | Pilih apakah kode Alarm/lucuti diperlukan untuk melucuti senjata |
| Waktu pemicu | Berapa lama menunggu saat mempersenjatai |
| Volume alarm | Volume default untuk sirene alarm |
Modus Malam ; Arlo tidak akan memilikinya kecuali Anda membuatnya
Jika Anda perlu menghapus kode alarm, masukkan no code needed . Saya akan berusaha membuat ini menerima entri kosong...
Tentukan sensor biner mana yang tersedia:
| Bidang | Nilai |
|---|---|
| Deteksi suara | Aktifkan mikrofon di kamera |
| Deteksi gerakan | Aktifkan deteksi gerakan pada kamera |
| Bel pintu ditekan | Aktifkan tombol bel pintu |
| Deteksi tangisan | Untuk bayi Arlo, aktifkan deteksi tangisan |
| Konektivitas perangkat | Diberitahu saat perangkat terputus |
| Sensor Buka/Tutup | Aktifkan sensor pintu dan jendela |
| Sensor kecerahan | Aktifkan deteksi cahaya |
| Deteksi kerusakan | Aktifkan notifikasi jika perangkat dibuka |
| Deteksi kebocoran | Aktifkan perangkat pemantauan kebocoran |
Tidak semua sensor tersedia di semua perangkat.
Tentukan sensor mana yang tersedia:
| Bidang | Nilai |
|---|---|
| Waktu pengambilan terakhir | Sensor per kamera yang menunjukkan kapan rekaman terakhir dibuat |
| Jumlah total kamera terdeteksi | Nilai bilangan bulat dari jumlah kamera |
| Aktivitas terkini terdeteksi | Apakah kamera baru-baru ini aktif |
| Jumlah video/snapshot yang diambil hari ini | Nilai bilangan bulat dari rekaman yang dibuat hari ini |
| Tingkat baterai perangkat | Persentase baterai tersisa |
| Kekuatan sinyal WiFi | Kekuatan WiFi, memiliki rentang 1 hingga 5 |
| Suhu kamar | Kondisi kamar |
| Kelembaban ruangan | Kondisi kamar |
| Kualitas udara | Kondisi kamar |
Tidak semua sensor tersedia di semua perangkat. Dan aktivitas terkini mungkin berupa biner_sensor .
Aktifkan sakelar lain-lain:
| Bidang | Nilai |
|---|---|
| Beralih untuk menyalakan sirene | Sediakan saklar untuk menyalakan sirene individual |
| Sebuah saklar menghidupkan semua sirene | Sediakan saklar untuk menyalakan semua sirene |
| Biarkan sirene dimatikan | Izinkan sirene dimatikan dengan sakelar |
| Volume saklar sirene | Tingkat volume default, dari 1 hingga 10 |
| Durasi Peralihan Sirene | Waktu default untuk menjalankan alarm |
| Beralih untuk meminta kamera mengambil foto | Sediakan tombol untuk mengambil snapshot kamera |
| Batas waktu jepretan kamera habis | Berapa lama menunggu hingga kamera berperilaku buruk selesai |
| Beralih untuk membungkam bunyi bel pintu | Sediakan saklar untuk membungkam bel pintu. |
Jika Anda datang lebih awal, ada beberapa hal yang perlu diperhatikan:
config flow . Semua perangkat Anda akan muncul di halaman integrasi.yaml asli.prefix with _aarlo menjaga agar penamaan tetap identik.aarlo .pyaarlo sekarang diinstal melalui pip dan tidak disertakan dengan Integrasi..aarlo/session.pickle . Saya tidak ingin memindahkan beberapa item konfigurasi yang lebih esoteris ke dalam mekanisme config flow , jika Anda telah mengonfigurasinya, item tersebut akan muncul di file /config/aarlo.yaml . Lihat di sini untuk mengetahui lebih lanjut tentang opsi ini.
Arlo akan menggunakan SSE atau MQTT untuk memberi sinyal peristiwa ke Aarlo . Saya tidak sepenuhnya yakin dengan mekanisme yang menentukan mana yang akan dipilih tetapi saya tahu menambahkan atau menghapus user_agent akan beralih di antara keduanya.
Arlo baru-baru ini memperbarui respons yang mereka kirim ke permintaan API session/v3 untuk menunjukkan back end mana yang harus dipilih. Aarlo akan menguraikannya saat menggunakan auto .
# This is the MQTT backend. We use the host and port.
' mqttUrl ' : ' ssl://mqtt-cluster-z1.arloxcld.com:8883 '
# This is the SSE backend. We use a fixed host and port.
' mqttUrl ' : ' wss://mqtt-cluster-z1.arloxcld.com:8084 'Jika Anda mengaktifkan proses debug verbose, Anda seharusnya dapat menemukan nilai ini di log Home Assistant .
Dimulai dengan rilis 0.8 Aarlo harus cukup pintar untuk menentukan back end mana yang akan digunakan. Namun jika Anda mengalami masalah, seperti peristiwa deteksi gerakan yang hilang atau pembaruan nilai sensor yang hilang, Anda dapat mengganti pengaturan secara manual. Ubah pengaturan ini di /config/aarlo.yaml .
aarlo :
# This forces the SSE backend
backend : sse aarlo :
# This forces the MQTT backend
backend : mqtt
# These might also be needed
mqtt_hostname_check : false
mqtt_host : mqtt-cluster-z1.arloxcld.com aarlo :
# This forces Aarlo to choose
backend : auto Catatan, menghapus pengaturan sama dengan auto .
Arlo menggunakan perlindungan anti-bot Cloud Flare untuk login situs web Arlo . Layanan ini tidak berfungsi dengan baik dengan paket Permintaan Python (atau bagaimana Aarlo menggunakan permintaan tersebut, saya tidak terlalu yakin).
Jika Anda melihat kesalahan berikut, Anda mengalami masalah Cloud Flare .
2021-06-03 13:28:32 WARNING (SyncWorker_4) [pyaarlo] request-error=CloudflareChallengeError
Masalah ini memengaruhi saya, dan saya terus berusaha menyempurnakan kodenya.
Aarlo melakukan beberapa hal untuk mengatasi hal ini:
Header .Namun, jika Anda masih mengalami masalah login, ada beberapa item konfigurasi yang dapat Anda coba.
Anda dapat mencoba agen pengguna lain. Ini dikonfigurasi di /config/aarlo.yaml :
aarlo :
# Change the user agent. It can be either arlo, iphone, ipad, mac, firefox or linux
# or random. random will change it each time it tries to login
user_agent : linux
# Or use a custom user agent, everything after the ! will be used
user_agent : !this-is-a-custom-user-agent Anda dapat menambahkan header Source bersama dengan permintaan login. Saya punya satu situs yang membutuhkan ini dan satu lagi tidak. Saya pikir ini mungkin terkait dengan agen pengguna.
aarlo :
# This adds the following header "Source: arloCamWeb"
send_source : trueAnda dapat menonaktifkan cache sesi dengan yang berikut ini:
aarlo :
# This will force a full login on every restart
save_session : false
Anda dapat memilih kurva ecdh yang berbeda untuk digunakan. Topik ini di luar cakupan dokumen ini, lihat di sini untuk penjelasannya.
aarlo :
# Make this curve the first choice. You can only enter 1 choice.
ecdh_curve : secp384r1 Anda dapat memodifikasi /etc/hosts untuk menunjuk ke server web Arlo tertentu
# Remove the # to force the request to go to a particular cloudflare server
#104.18.30.98 ocapi-app.arlo.com
#104.18.31.98 ocapi-app.arlo.com
Arlo menyebutnya Verifikasi Dua Langkah . Anda harus mengaktifkan ini untuk akun khusus Asisten Rumah Anda. Aarlo mendukung mekanisme IMAP dan PUSH tetapi saya sarankan menggunakan IMAP , dengan PUSH Anda perlu merespons permintaan login secara manual.
Anda akan menemukan petunjuk untuk menyiapkan otentikasi dua faktor di sini yang disediakan Arlo di sini
Anda memasukkan autentikasi dua faktor saat menambahkan integrasi.
Ikuti instruksi autentikasi dua faktor dan tambahkan serta atur metode verifikasi Email . Anda dapat mengujinya dengan masuk ke halaman web utama Arlo dan memastikannya mengirimi Anda email.
Untuk Gmail dan Yahoo (dan klien email berbasis web lainnya) Anda tidak dapat masuk dengan kata sandi biasa, Anda harus membuat kata sandi khusus aplikasi. Penjelasan mengapa hal ini perlu berada di luar cakupan dokumen ini, jadi lihat halaman berikut.
Jika ternyata Anda tidak dapat masuk ke akun IMAP Anda, periksa persyaratan kata sandi aplikasi.
Server berikut diketahui berfungsi:
| Melayani | Nama Tuan Rumah |
|---|---|
| Gmail | imap.gmail.com |
| Yahoo! | imap.mail.yahoo.com |
Ikuti instruksi autentikasi dua faktor dan tambahkan serta siapkan metode verifikasi PUSH .
Jika Anda perlu mengubah daftar sandi yang diteruskan ke klien IMAP, Anda menentukannya dengan opsi berikut. Anda tidak perlu melakukan ini. lihat halaman manual openssl untuk informasi lebih lanjut.
aarlo :
# specify cipher list to use
cipher_list : " HIGH:!DH:!aNULL "
# Use DEFAULT for the cipher list
default_ciphers : TrueJika Anda mengalami masalah silakan buat laporan bug, sertakan informasi berikut dalam laporan bug untuk membantu debugging. Jika tidak, aku akan mengganggumu sampai kamu melakukannya.
Anda mengaktifkan debugging Aarlo dasar dengan mengubah pengaturan logging di configuration.yaml .
logger :
default : info
logs :
pyaarlo : debug
custom_components.aarlo : debug Anda dapat mengaktifkan debugging verbose dengan mengaktifkan logging dan menambahkan yang berikut ini ke /config/aarlo.yaml juga. Debug verbose akan menghasilkan banyak log, jadi sebaiknya aktifkan saja saat diperlukan.
aarlo :
verbose_debug : true Aarlo akan menulis log debug ke file log Home Assistant standar /config/home-assistant.log .
Sebelum Anda mengirimi saya debug, Anda harus mengenkripsinya. Anda dapat mengenkripsi keluaran Anda di halaman web ini. Anda dapat mengunggah file atau menyalin dan menempelkannya ke buffer lalu tekan Submit .
Halaman ini tidak meneruskan hasilnya secara otomatis kepada saya, jadi Anda harus menyalin dan menempelkannya ke dalam file dan melampirkannya ke laporan bug.
Halaman ini akan mengaburkan log sehingga hanya saya yang bisa membacanya, saya satu-satunya pemilik kunci pribadi untuk mendekripsinya, tapi hati-hati, bersama dengan nomor seri mungkin berisi informasi akun dan kata sandi Anda. Anda dapat mengaburkannya sebelum mengenkripsi, saya tidak membutuhkannya.
Saya tidak memiliki semua perlengkapan Arlo , jadi terkadang, saat terjadi kesalahan atau perlengkapan baru dirilis, saya perlu melihat apa yang sebenarnya diharapkan Arlo dari kode ini untuk dikirimkan dan apa yang dapat diharapkan kembali dari kode ini dari Arlo . Aarlo mensimulasikan koneksi browser web sehingga Anda dapat mengetahui apa yang diharapkan dengan menggunakan Alat Pengembang browser.
Petunjuk ini ditujukan untuk Chrome tetapi sebagian besar browser (saya harap!) memiliki fungsi serupa.
More Tools dan terakhir pilih Developer Tools . Anda juga dapat menggunakan pintasan CTRL+SHIFT+I .Network di jendela yang baru dibuka. Saat Anda masuk, data yang dikirimkan antara browser dan situs web Arlo akan mulai muncul, dan terus muncul, di tab ini. Jika Anda mengklik entri di bawah Name Anda dapat memeriksa paket secara lebih rinci.
Headers menunjukkan kepada Anda apa yang dikirim dalam header permintaan.Payload menunjukkan kepada Anda apa yang dikirim dalam isi permintaanPreview menunjukkan balasan yang dikirim kembali dari Arlo . 
Jika Anda mengarahkan kursor ke bidang di bawah name , pop up akan menampilkan URL lengkap tujuan pengiriman permintaan.
Saya perlu mendokumentasikan ini.
Carilah URL yang mengandung kata subscribe , ini akan menjadi aliran genap yang dikirim Arlo kembali ke halaman web. Saat Anda mengklik tombol di halaman web, lebih banyak item akan muncul di daftar ini. Saya dapat menggunakan informasi ini untuk menentukan cara mengurai paket respons untuk kasus yang belum saya tangani.
Misalnya, Arlo membuat perangkat baru dengan tombol WOOHOO , saya tidak memiliki perangkat seperti itu tetapi Anda ingin fungsi WOOHOO diterapkan di Aarlo . Yang saya perlukan adalah urutan paket dan balasannya saat Anda menekan tombol. Satu-satunya cara nyata untuk melakukan ini adalah dengan menekan tombol dan melihat paket baru apa yang muncul di tab Name .
Anda kemudian perlu menyalin dan menempelkannya ke laporan bug di GitHub . Lihat bagian sebelumnya tentang cara menyembunyikan data sensitif.
Tidak. Mereka menghabiskan seluruh waktunya berdebat tentang siapa yang memegang kendali. Ini adalah batasan Arlo .
Apakah Anda yakin telah berbagi perangkat? Masuk ke Halaman Web Arlo dan pastikan itu muncul di sana. Jika ya, aktifkan log debug dan ajukan laporan bug bersama mereka.
Pastikan Anda telah memberikan akun yang Anda bagikan perangkat dengan Akses Admin , ini diperlukan untuk hal-hal seperti pembaruan kekuatan baterai atau sinyal.
Pastikan Anda telah memberikan akun yang Anda bagikan perangkat dengan Akses Admin , ini diperlukan untuk berbagi stasiun pangkalan.
Apakah Anda menggunakan antarmuka berbasis lokasi Arlo yang baru, dalam hal ini Anda hanya dapat mempersenjatai atau melucuti lokasi dan bukan perangkat individual.
Tidak diperlukan langganan untuk melihat feed, tetapi Anda memerlukan langganan untuk melihat rekaman.
Pada saat penulisan ini (Mei 2024), tidak ada opsi untuk membaca rekaman lokal. Semua fitur lainnya berfungsi dengan baik.
Tentu saja mereka melakukannya. Arlo tidak berfungsi seperti kamera IP dan hanya merekam ketika gerakan terdeteksi, jadi memintanya untuk memulai streaming melibatkan pembicaraan dengan server Arlo yang berbicara dengan kamera di rumah Anda... diperlukan waktu beberapa detik untuk menjalankannya. Streaming berfungsi seperti ini:
Camera ---> Arlo Cloud Servers --> Home Assistant --> Your Home Assistant Client
Lalu lintas video harus keluar dari rumah Anda dan kemudian kembali ke sana...
Ini adalah daftar perangkat yang diketahui berfungsi. Sebagian besar perangkat Arlo akan berfungsi meskipun tidak disebutkan secara eksplisit dalam daftar ini meskipun fungsinya mungkin terbatas.
| Model | Nama | Fitur |
|---|---|---|
| ABC1000 | Bayi | gerak, audio, lingkungan, tangisan |
| AVD1001 | Bel Pintu Video Berkabel | gerakan |
| AVD2001 | Bel Pintu Video Penting | gerak, sirene |
| AVD3001 | Bel Pintu Video Berkabel HD | gerak, sirene |
| AVD4001 | Bel Video Berkabel 2K | gerak, sirene |
| FB1001 | Lampu Sorot Pro 3 | lampu sorot |
| MS1001 | Semua dalam 1 Sensor | gerak, terbuka, basah, tamper, suhu |
| VMB3010 | Stasiun Pangkalan | |
| VMB4000 | Stasiun Pangkalan 2 | sirene |
| VMB4500 | Stasiun Pangkalan Pro | sirene |
| VMC2030 | Kamera Penting | gerak, audio, sirene, sorotan |
| VMC2040 | Kamera Dalam Ruangan Penting | gerak, audio, sirene tanpa baterai |
| VMC3030 | Kamera HD | gerak, audio |
| VMC3040 | Q Kamera | gerak, audio |
| VMC3060 | Kamera Dalam Ruangan Penting 2 | gerak, perlu dilihat |
| VMC3052 | Kamera XL Penting | gerak, audio, sorotan |
| VMC4030 | Kamera Pro 2 | gerak, audio |
| VMC4040 | Kamera Pro 3 | gerak, audio, sirene, sorotan |
| VMC4041 | Kamera Pro 4 | gerak, audio, sirene, sorotan |
| VMC4060 | Kamera Pro 5 | gerak, audio, sirene, sorotan |
| VMC5040 | Kamera Ultra | gerak, audio, sirene, sorotan |
| VML2030 | Buka 2 Kamera | gerak, audio |
| VML4030 | Pergi Kamera | gerakan |
Komponen ini ditulis dengan merekayasa balik API yang digunakan pada halaman web Arlo Camera.
Ini adalah batasan umum:
Ini adalah batasan dari situs web:
Ini adalah batasan dibandingkan aplikasi seluler:
Dua yang terakhir dapat diringkas seolah if the WEB API doesn't support it, neither can the component. Ingatlah hal itu ketika meminta permintaan fitur baru.
