Configurazione: Utilizzando MQTT

MQTT, acronimo di Message Queuing Telemetry Transport, è un protocollo di messaging leggero ed efficiente ampiamente utilizzato nell'Internet of Things (IoT) per la comunicazione tra dispositivi. È progettato per funzionare con larghezza di banda di rete limitata e dispositivi a basso consumo energetico, rendendolo 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 su di esso, rendendolo un ponte flessibile tra le tue telecamere e il tuo sistema di smart home o domotica.

Connetti Agent DVR al tuo server MQTT utilizzando il menu Impostazioni. Una volta connesso, puoi impostare 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 es., 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, trattini bassi e trattini vengono rimossi dal nome del server per gli argomenti MQTT. Questi comandi hanno un formato simile all'API HTTP. Basta sostituire /command con cmd=:

Per attivare tutti i dispositivi: cmd=allon.

Per scattare una foto su un dispositivo specifico: cmd=snapshot&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 "MQTT Events" nella scheda MQTT durante la modifica di un dispositivo.

Questa configurazione include flag per topic quali motion, connected, alert, recording, timelapse, alerts (stato armato) e detector (rilevamento movimento attivo o disattivo).

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

Risoluzione dei problemi

Se riscontri frequenti disconnessioni e riconnessioni in MQTT, questo in genere indica che il Client ID specificato in Impostazioni server nella sezione MQTT è utilizzato da più client. È importante assicurarsi che ogni client connesso a MQTT abbia un Client ID univoco.

Agent DVR può annunciare i suoi dispositivi ad Home Assistant automaticamente usando la discovery MQTT. Le tue fotocamere e microfoni appariranno quindi in Home Assistant come dispositivi con sensori e interruttori, pronti da usare in dashboard e automazioni senza configurazione YAML.

Cosa ottieni

• Sensore di movimento: attivo mentre il rilevatore vede attività.
• Sensore di avviso: attivo mentre il dispositivo sta inviando un avviso.
• Sensore di connessione: se il dispositivo è in linea.
• Sensore di registrazione: attivo mentre il dispositivo sta registrando.
• Interruttore di attivazione: attiva o disattiva il dispositivo da Home Assistant.
• Interruttore di avvisi: attiva o disattiva gli avvisi da Home Assistant.
• Interruttore di rilevamento: attiva o disattiva il rilevamento del movimento da Home Assistant.

Con Send Stats abilitato il server appare anche come dispositivo con sensori di utilizzo CPU, memoria e disco. Tutte le entità vengono visualizzate 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 l'integrazione MQTT di Home Assistant ad esso connessa. Non è necessario aprire porte extra per Agent DVR: si connette al broker proprio come fa Home Assistant.

Su una nuova installazione, inserisci l'indirizzo del broker e le credenziali di accesso sotto Home Assistant nella schermata di benvenuto. È tutto: MQTT e discovery sono attivati per te, e ogni fotocamera e microfono che aggiungi in seguito apparirà automaticamente in Home Assistant.

Per configurarlo in seguito (o su un'installazione esistente), vai a Impostazioni Server - MQTT, configura il tuo broker e attiva sia Enabled che Home Assistant Discovery. Quindi attiva MQTT Events su ogni dispositivo che desideri pubblicare (scheda MQTT quando modifichi il dispositivo). I dispositivi aggiunti mentre discovery è attiva hanno MQTT Events abilitato automaticamente; i dispositivi preesistenti mantengono la loro 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 MQTT Events aggiorna automaticamente Home Assistant.
• Il Discovery Prefix nelle impostazioni MQTT avanzate deve corrispondere al prefisso di discovery nell'integrazione MQTT di Home Assistant. Lascia entrambi al valore predefinito (homeassistant) a meno che tu non sappia di averlo modificato.
• Disattivare Home Assistant Discovery rimuove le entità da Home Assistant.
• Gli interruttori utilizzano i comandi MQTT di Agent DVR dietro le quinte, quindi qualsiasi altra cosa sulla tua rete MQTT può inviare gli stessi comandi.