Integriamo le camere IMOU in Home Assistant tramite OnVIF
Home Assistant Guide
Scritto da Vincenzo Caputo
Qualche tempo fa ho scritto una guida per l'integrazione in Home Assistant delle telecamere IMOU tramite un custom component che ancora oggi è possibile installare tramite HACS (Home Assistant Community Store).
Il progetto ufficiale lo trovate al seguente link:
https://github.com/Imou-OpenPlatform/Imou-Home-Assistant
Il mio vecchio articolo è invece raggiungibile al seguente link:
Con mio grande stupore ho notato che l'articolo ha avuto ad oggi quasi 25.000 accessi, sintomo del fatto che l'argomento è di grande interesse.
Sarà che le telecamere IMOU, che vi ricordo essere la versione consumer del notissimo brand Dahua, sono molto apprezzate dal pubblico per la loro ottima qualità e robustezza.
E a tal proposito colgo l'occasione per lasciarvi i link a qualcuno delle decine di recensioni che abbiamo realizzato per i prodotti di questo brand:
Varchi sotto controllo con IMOU Knight 4K UHD 8MP
Videosorveglianza IP intelligente con IMOU Ranger IQ
Telecamera WiFi IMOU Ranger 2 - la telecamera IP che ti segue!
Recensione IMOU Cue2, la IPcam gestibile da Google Home e Alexa
Recensione IMOU LOOC, la Outdoor security camera di DAHUA
Io stesso ho usato per lungo tempo l'integrazione mostrata nel mio articolo che, benché fosse basata sul Cloud, funzionava discretamente bene ed era molto semplice da implementare.
Dopo un po' però le cose sono cambiate perché IMOU ha ridotto le risorse messe a disposizione per i progetti di sviluppo, infatti se ricordate era necessario creare un account sviluppatore su https://open.imoulife.com
Come conseguenza gli utenti avevano il funzionamento dell'integrazione sono per i primi 5 o 6 giorni del mese (in base al numero di accessi al proprio Home Assistant), dopo di che ricevevano un'email che avvisava delle risorse Cloud dedicate agli sviluppatori terminate per il periodo corrente e il tutto andava offline.
Il mese successivo punto e a capo!
Mi sono ripromesso più volte di mettere mani ad una guida per mostrare un'alternativa di integrazione in Home Assistant, ed eccomi oggi con le istruzioni per usare il protocollo ONVIF con il quale tutte le telecamere IMOU sono compatibili.
Installare l'integrazione ONVIF e configurare una scheda
- Vai alla dashboard principale di Home Assistant.
- Vai a: Impostazioni → Dispositivi e servizi → Aggiungi integrazione
- Cerca ONVIF e selezionalo
- Lascia che l'integrazione cerchi automaticamente nuovi dispositivi Onvif nella rete premendo invia
- Le cam IMOU vengono generalmente rilevate come Lechange seguito dall'indirizzo IP locale e dal modello della telecamera. Seleziona quella che vuoi integrare e clicca su Invia
- Inserisci il nome utente (per le cam IMOU è sempre admin) e la password ONVIF che potrai recuperare dall'app IMOU come spiego qui di seguito
Entra nell'app IMOU life, nelle impostazioni della camera che stai configurando in Home Assistant, e clicca su Etichetta del dispositivo come puoi osservare nella seguente immagine
A questo punto avrai l'etichetta del dispositivo con il codice di sicurezza che non è altro che la password che dovrai usare in Home Assistant.
Nota bene: su alcune telecamere non è presente il codice di sicurezza. In tal caso la password da usare è quella presente nel campo dispositivo password
Dunque inserisci la password nel relativo campo di configurazione e, se tutto è andato per il verso giusto, dovresti assegnare una stanza al dispositivo e poi vedere la tua camera in Home Assistant.
Tramite Home Assistant sostanzialmente si potrà:
- Guardare il feed video in diretta
- Attivare/disattivare l'audio
- Rilevare movimento/dell'essere umano come trigger di automazione
- alcuni comandi tipo il riavvio della telecamera ecc...
Sarà possibile gestire anche i controlli motorizzati (PTZ) per le telecamere che li possiedono, ma questo richiederà una piccola programmazione che vado ad indicare qui di seguito.
- Aggiungete una scheda alla vista che vi interessa selezionando la scheda da entità e scegliendo l'entità stream della camera come osservate nell'immagine seguente.
- A questo punto entrate nella modifica testuale della scheda appena aggiunta e incollate, al posto del codice di base che trovate nella scheda, il seguente codice avendo l'accortezza di sostituire ogni volta che trovate scritto camera.lechange_mediaprofile_channel1_substream1_2, che è il nome dell'entità della mia camera, con l'id entità della vostra camera.
type: picture-glance
entities:
- entity: camera.lechange_mediaprofile_channel1_substream1_2
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.lechange_mediaprofile_channel1_substream1_2
pan: LEFT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Left
show_state: false
icon: mdi:arrow-left
show_icon: true
- entity: camera.lechange_mediaprofile_channel1_substream1_2
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.lechange_mediaprofile_channel1_substream1_2
tilt: UP
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Up
icon: mdi:arrow-up
- entity: camera.lechange_mediaprofile_channel1_substream1_2
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.lechange_mediaprofile_channel1_substream1_2
tilt: DOWN
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Down
icon: mdi:arrow-down
- entity: camera.lechange_mediaprofile_channel1_substream1_2
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.lechange_mediaprofile_channel1_substream1_2
pan: RIGHT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Right
icon: mdi:arrow-right
show_icon: true
camera_image: camera.lechange_mediaprofile_channel1_substream1_2
camera_view: live
- Salvate e chiudete.
Come risultato avrete una scheda con lo stream live della camera e i comandi per muovere la camera.
Spero che questa guida sia utile a molti, vi lascio al video dal nostro canale YouTube MissingTech.
Buona visione!
Produrre e aggiornare contenuti su vincenzocaputo.com richiede molto tempo e lavoro. Se il contenuto che hai appena letto è di tuo gradimento e vuoi supportarmi, clicca uno dei link qui sotto per fare una donazione.