Eventi MQTT da sistemi esterni: come Roraima reagisce ai rilevamenti di Frigate

Frigate è un software open-source di videosorveglianza con riconoscimento oggetti locale. Roraima non integra telecamere direttamente, ma il suo MQTT adapter può sottoscrivere i topic su cui Frigate pubblica gli eventi di rilevamento, trasformando ogni detection in un trigger per lo scenario engine.

Cos'è Frigate e come comunica

Frigate è un NVR (Network Video Recorder) open-source con object detection integrato. A differenza delle soluzioni cloud come Ring o Nest, tutta l'elaborazione avviene sul dispositivo locale: nessun fotogramma lascia la rete domestica. Frigate si integra con Home Assistant e comunica tramite MQTT, pubblicando eventi strutturati ogni volta che rileva una persona, un veicolo o un oggetto.

La comunicazione MQTT è il punto chiave: Frigate pubblica su topic come `frigate/events` e `frigate/camera_name/person`, con payload JSON che contengono il tipo di oggetto rilevato, la zona, il timestamp e il livello di confidenza. Qualsiasi sistema che sottoscrive questi topic può reagire agli eventi in tempo reale.

Requisiti hardware per Frigate

L'object detection è un'operazione computazionalmente intensiva. I requisiti minimi includono un server Home Assistant (o un'installazione Docker standalone), un broker MQTT configurato (Mosquitto è il più diffuso), e telecamere con supporto RTSP.

Per le prestazioni, un processore potente è essenziale. Un Raspberry Pi può gestire una telecamera a risoluzione ridotta, ma per un sistema multi-camera serve hardware più capace. L'acceleratore hardware Google Coral TPU rappresenta la soluzione ideale, superando le prestazioni di qualsiasi CPU consumer per l'inferenza TensorFlow.

Configurazione e funzionalità di Frigate

L'installazione avviene come add-on di Home Assistant o tramite Docker. La configurazione iniziale richiede un file YAML dove si definiscono le credenziali MQTT e le telecamere con i relativi stream RTSP.

Le funzionalità avanzate includono zone di rilevamento personalizzate (il vialetto, il giardino, l'ingresso), maschere per escludere aree con falsi positivi (alberi mossi dal vento, strade trafficate), e tipi di oggetto differenziati (persona, auto, animale, bicicletta).

Ogni rilevamento genera un evento MQTT con un payload strutturato. È questo evento MQTT che diventa il ponte tra il mondo della videosorveglianza e il mondo dell'automazione IoT.

Privacy: il vantaggio del rilevamento locale

In un'epoca di crescente consapevolezza sulla privacy, Frigate offre un vantaggio concreto: nessun dato video lascia la rete domestica. Non ci sono abbonamenti mensili per lo storage cloud, non c'è rischio di breach dei dati su server terzi, e non c'è possibilità che il fornitore cambi le condizioni di servizio.

Questo aspetto è particolarmente rilevante in Europa, dove il GDPR impone requisiti stringenti sulla gestione dei dati personali, specialmente quelli biometrici come il riconoscimento facciale.

Come farlo con Roraima

Roraima non gestisce telecamere né video, ma il suo gateway IoT supporta nativamente MQTT come protocollo di comunicazione -- la stessa base su cui Frigate pubblica i suoi eventi di rilevamento. L'MQTT adapter di Roraima può sottoscrivere i topic di Frigate e trasformare ogni evento di detection in un trigger per lo scenario engine.

Il flusso funziona così: Frigate rileva una persona nel giardino e pubblica un evento MQTT sul topic `frigate/giardino/person`. L'MQTT adapter di Roraima, sottoscritto a quel topic, riceve l'evento e attiva un trigger di tipo device_state_change. Lo scenario configurato può quindi coordinare dispositivi di brand diversi: accendere le luci Shelly esterne (step 1), attivare una sirena Tuya (step 2), registrare un log nell'audit trail crittografato (step 3). Le condizioni permettono di differenziare il comportamento: di giorno solo log, di notte risposta completa con luci e sirena.

Questo pattern -- sistema esterno che pubblica su MQTT, Roraima che sottoscrive e reagisce -- è applicabile a qualsiasi fonte di eventi MQTT, non solo Frigate. Qualsiasi dispositivo o software che pubblica su topic MQTT può diventare un trigger per gli scenari Roraima, estendendo le capacità della piattaforma senza richiedere integrazioni dirette.

La filosofia di sicurezza di Roraima si allinea con quella di Frigate: crittografia AES-256 per i dati in transito, JWT per l'autenticazione, opzione di controllo locale senza dipendenza cloud, e audit log per tracciare ogni azione. Le 13 categorie ambientali includono "Security" come categoria dedicata, dove i vendor possono pubblicare dispositivi di sicurezza compatibili MQTT.

Per gli installatori certificati Roraima, la configurazione di un sistema Frigate con scenari IoT integrati rappresenta un servizio ad alto valore aggiunto. L'agente AI installer, alimentato dalla knowledge base RAG, fornisce supporto tecnico sui parametri di configurazione e sulle best practice per l'integrazione MQTT.

Conclusione

Frigate dimostra che la videosorveglianza intelligente può funzionare senza cedere dati a terzi. Roraima estende questo concetto permettendo di trasformare gli eventi MQTT di Frigate in trigger per automazioni multi-dispositivo, senza dover integrare direttamente telecamere o video. Il risultato è un sistema di sicurezza che combina il meglio di entrambi i mondi: rilevamento locale con Frigate, reazione automatizzata con lo scenario engine Roraima.