Configurazione: Utilizzando MQTT

MQTT, che sta per Message Queuing Telemetry Transport, è un protocollo di messaggistica leggero ed efficiente ampiamente utilizzato nell'Internet delle cose (IoT) per la comunicazione tra dispositivi. È progettato per funzionare con larghezza di banda di rete limitata e con dispositivi a basso consumo energetico, il che lo rende ideale per collegare sensori remoti, dispositivi mobili e vari gadget di piccole dimensioni a internet.

Agent DVR può sia pubblicare eventi su MQTT che ricevere comandi attraverso di esso, il che lo rende un ponte flessibile tra le telecamere e il sistema di domotica o automazione domestica.

Connetti Agent DVR al tuo server MQTT utilizzando il menu Impostazioni. Una volta connesso, puoi impostare le azioni di avviso per pubblicare messaggi sul tuo server MQTT. Consulta Impostazioni server MQTT per i dettagli.

Per configurare questo, modifica il tuo dispositivo e seleziona Azioni nel menu. Aggiungi un'azione per un avviso (o altro evento) e scegli MQTT come tipo di attività. Qui puoi specificare l'argomento e il messaggio da pubblicare.

Specifica l'argomento su cui pubblicare (ad esempio Agent/alerts) e componi il tuo messaggio di conseguenza.

Agent DVR può anche ricevere ed elaborare messaggi MQTT sull'argomento SERVER/commands, dove SERVER è il nome del tuo server (visualizzato nel Menu server, modificabile in Impostazioni). Eventuali barre oblique, trattini bassi e trattini vengono rimossi dal nome del server per gli argomenti MQTT. Questi comandi sono formattati in modo simile all'API HTTP. Sostituisci semplicemente /command con cmd=:

Per attivare tutti i dispositivi: cmd=allon.

Per scattare una foto su un dispositivo specifico: cmd=snapshot&ot=2&oid=1.

Per reimpostare i contatori di attraversamento dei fili di attivazione su una telecamera: cmd=resettripwires&ot=2&oid=1.

Utilizzando mosquitto, puoi inviare un comando come questo (sostituisci SERVER con il nome del tuo server):

mosquitto_pub -t 'SERVER/commands' -m 'cmd=record&ot=2&oid=1'

Agent DVR eseguirà il comando e invierà una risposta JSON all'argomento SERVER/responses.

Agent DVR dispone di una configurazione MQTT automatica che invia eventi predefiniti, stati e statistiche di utilizzo. Per attivare questa funzione, abilita l'opzione "Eventi MQTT" nella scheda MQTT durante la modifica di un dispositivo.

I topic vengono pubblicati sotto SERVER/telecamere/NOME/ o SERVER/microfoni/NOME/, dove SERVER è il nome del server e NOME è il nome del dispositivo (entrambi in minuscole, con le barre oblique rimosse). Questa configurazione include contrassegni per topic come movimento, connesso, avviso, registrazione, timelapse, avvisi (stato attivato) e rilevatore (rilevamento del movimento attivato o disattivato), oltre ai risultati JSON dal riconoscimento di oggetti AI, volti, targhe e audio.

Le telecamere che utilizzano il rilevatore di linee di passaggio con Conteggio abilitato pubblicano anche (v7.7.4.0+):

• tripwire: un messaggio per ogni passaggio conteggiato, ad es.

  {"wire":1,"direction":"left","left":3,"right":2,"total":5}

• tripwire_left, tripwire_right, tripwire_total: i contatori correnti, mantenuti in modo che siano disponibili non appena ti iscrivi. Reimpostati a 0 dal pulsante Reimposta Conteggio, dal comando resettripwires o da un riavvio della telecamera.

Se usi Home Assistant non è necessario lavorare direttamente con questi argomenti: consulta Home Assistant per la configurazione automatica.

Risoluzione dei problemi

Se riscontri frequenti disconnessioni e riconnessioni in MQTT, generalmente indica che l'ID client specificato in Impostazioni server in MQTT viene utilizzato da più client. È importante assicurarsi che ogni client connesso a MQTT abbia un ID client univoco.

Agent DVR può annunciare i suoi dispositivi a Home Assistant automaticamente utilizzando la scoperta MQTT. Le tue telecamere e microfoni appariranno quindi in Home Assistant come dispositivi con sensori e interruttori, pronti per essere utilizzati nei quadri di controllo e nelle automazioni senza alcuna configurazione YAML.

Cosa ottieni

• Sensore di movimento: attivo mentre il rilevatore rileva attività.
• Sensore di avviso: attivo mentre il dispositivo sta inviando avvisi.
• Sensore di connessione: indica se il dispositivo è in linea.
• Sensore di registrazione: attivo mentre il dispositivo sta registrando.
• Interruttore abilitazione: attiva o disattiva il dispositivo da Home Assistant.
• Interruttore avvisi: attiva o disattiva gli avvisi da Home Assistant.
• Interruttore rilevatore: attiva o disattiva il rilevamento del movimento da Home Assistant.
• Sensori Conteggio Sinistra, Conteggio Destra E Conteggio Totale: contatori di attraversamento per telecamere che utilizzano il rilevatore di linea di attivazione, per il conteggio delle persone. (v7.7.4.0+)

Con Invia statistiche abilitato, il server appare anche come dispositivo con sensori di utilizzo CPU, memoria e disco. Tutte le entità si mostrano come non disponibili in Home Assistant quando Agent DVR va offline.

Configurazione

Hai bisogno di un broker MQTT (tipicamente il componente aggiuntivo Mosquitto sulla tua macchina Home Assistant) e dell'integrazione MQTT di Home Assistant collegata ad esso. Nessuna porta aggiuntiva deve essere aperta per Agent DVR: si connette al broker proprio come fa Home Assistant.

In una nuova installazione, inserisci semplicemente l'indirizzo e le credenziali del tuo broker nella sezione Home Assistant della schermata di benvenuto. È tutto: MQTT e la scoperta sono già attivati per te, e ogni telecamera e microfono che aggiungerai in seguito apparirà in Home Assistant automaticamente.

Per configurarlo in seguito (o su un'installazione esistente), vai a Impostazioni server - MQTT, configura il tuo broker e abilita sia Abilitato che Scoperta Home Assistant. Poi abilita Eventi MQTT su ogni dispositivo che desideri pubblicare (scheda MQTT quando modifichi il dispositivo). I dispositivi aggiunti mentre la scoperta è attiva hanno gli eventi MQTT abilitati automaticamente; i dispositivi che esistevano in precedenza mantengono l'impostazione attuale.

Note

• I dispositivi appaiono in Home Assistant entro pochi secondi dalla connessione di Agent DVR al broker. Rinominare un dispositivo o attivare/disattivare gli eventi MQTT aggiorna Home Assistant automaticamente.
• Il Prefisso di Scoperta nelle impostazioni MQTT avanzate deve corrispondere al prefisso di scoperta nell'integrazione MQTT di Home Assistant. Lascia entrambi al valore predefinito (homeassistant) a meno che tu non sappia di averli modificati.
• Disattivare la scoperta Home Assistant rimuove le entità da Home Assistant.
• Gli interruttori utilizzano i comandi MQTT di Agent DVR dietro le quinte, quindi qualsiasi altro dispositivo sulla tua rete MQTT può inviare gli stessi comandi.