Vai al contenuto

Gestione delle telecamere (aggiungere, modificare, togliere)

Dipende dal detector del box. Verificato sul codice (mdm_web_panel branch dev, mdm_installation branch main) e sulla guida di Maurizio "Procedura Nuova Installazione GANZ" (28/10/2026).

Box con Frigate: dal pannello MDM

Le telecamere non hanno una pagina a sé: sono la configurazione di Frigate del box. Pagina Frigate dell'installazione (/installations/<MAC>/frigate).

  1. Il pannello carica la configurazione attuale dal box (GET /frigate/config/json/{mac}).
  2. Aggiungere: "Add Camera". Il dialogo chiede nome, URL del flusso (rtsp:// o http://), "Enabled" (gira in Frigate), "Detection" (inclusa nel rilevamento).
  3. Modificare: "Edit Camera". Togliere: "Delete", che rimuove anche lo stream go2rtc.
  4. Fino a qui le modifiche esistono solo nella pagina, che le controlla e segnala i problemi.
  5. "Update Config" o "Save All Changes", poi conferma: il pannello manda tutta la configurazione (PUT /frigate/config/update/json/{mac}). Il box la scrive e riavvia Frigate: per qualche secondo nessuna telecamera di quel box rileva.

Scorciatoie: gli interruttori Enabled/Detection di ogni telecamera si applicano subito (con riavvio). Zone, registrazione, stream go2rtc e maschere si modificano dall'editor YAML o con "Import YAML".

Attenzioni: - il dialogo crea solo l'ingresso diretto per il rilevamento (ffmpeg.inputs con ruolo detect), senza registrazione né stream go2rtc, anche se il box usa l'hub go2rtc: su questi box la telecamera va aggiunta anche in go2rtc.streams dall'editor YAML e Frigate deve leggere da localhost:8554/<telecamera>, come le altre (vedi connessioni-telecamere.md); - l'URL contiene di solito le credenziali della telecamera: non copiarlo in chat o nei ticket; - il salvataggio riavvia Frigate: evitarlo con l'impianto inserito, o avvisare la centrale; - negli impianti con più box ogni telecamera sta nel box che la elabora (per uno slave: installazione <MAC>-01); - le stesse chiamate esistono nel midserver v3.

Box con GANZ: sull'apparato GANZ

Il software MDM legge le telecamere dal GANZ (GET /api/network/vsources/ in mdm_installation/app/clients/ganz_client.py) e non ha chiamate per modificarle. Ogni canale diventa una telecamera MDM con nome uguale al numero del canale (1–16); il rilevamento risulta attivo se sul canale c'è un algoritmo di IA.

  1. Aprire l'interfaccia web del GANZ: https://<IP del GANZ>:8443/, con l'utente amministratore del GANZ. Il GANZ è nella rete del cliente: da remoto si passa dal box (proxy sulle porte 101xx).
  2. SETUP → AI SOURCES → Video Source: per ogni canale nome, URL RTSP, protocollo (TCP), AI Algorithm (es. "Human / Vehicle - Normal"; "None" = niente rilevamento). Poi APPLY.
  3. Zone e regole di allarme: AI SECURITY. In Event Action → HTTP ci sono le chiamate di allarme verso il box (MDM_ALARM → http://<IP box>:5005/api/v1/alarm/...): non vanno toccate.
  4. Verifica nel pannello MDM: riquadro Cameras dell'installazione, pulsante Snapshot.

Finora i GANZ sono stati consegnati già configurati da Michele: la procedura completa va raccolta nel passaggio di consegne (MDM-001).

Orario sbagliato nelle immagini

Data e ora sovraimpresse le scrive la telecamera: il box copia il flusso senza modificarlo. Se sono sbagliate, è sbagliato l'orologio della telecamera, di solito perché nella rete del cliente non c'è un server NTP raggiungibile. Rimedio immediato: impostare ora, fuso orario o un server NTP dall'interfaccia della telecamera (o dal GANZ/NVR, se sincronizza le telecamere). Soluzione stabile: il box come server NTP della rete locale (ticket MDM-036).

Live stream e snapshot: come funzionano (valido per Frigate e GANZ)

  • Live: il box non chiede il flusso al detector. Cerca nella propria configurazione l'elenco webrtc_streams una voce con nome uguale al nome della telecamera e ne usa l'URL RTSP (mdm_installation/app/services/mqtt/handlers/web_rtc_handler.py). Se manca, il live fallisce con "Camera not found in webrtc streams configuration". Si configura nel pannello: Installation Config → Features → Live Streaming → Add Stream (nome identico alla telecamera, es. 1 per il canale 1 di un GANZ; URL RTSP della telecamera), poi Update Config. Il valore di esempio Front Door / stream_url va tolto.
  • Attenzione al limite di connessioni: se in webrtc_streams si mette l'URL della telecamera, ogni live apre una connessione in più verso la telecamera, che può far perdere il flusso al detector. Sui box Frigate con hub go2rtc usare il restream (rtsp://<utente go2rtc>@127.0.0.1:8554/<telecamera>). Sui box GANZ oggi non c'è restream: la proposta del team è usare il DVR dell'impianto come sorgente del live (da verificare, MDM-037). Vedi connessioni-telecamere.md.
  • Dove va il flusso: nella linea 3.2.x all'OME di produzione (srt://185.31.66.185:9999, scritto nel codice, M15); nella linea stage all'indirizzo di WEBRTC_SRT_BASE_URL, che il segreto AWS imposta per ambiente (Stage → OME di dev). Per provare il live dal pannello dev serve quindi un box della linea stage installato come Stage.
  • Snapshot GANZ: il box chiede al GANZ l'immagine attuale del canale (GET /api/snapshot/jpeg/?ch=<n>) e la inoltra, senza copie intermedie. Un'immagine "vecchia" viene quindi dal GANZ: orologio della telecamera sbagliato (data sovraimpressa), telecamera scollegata dal GANZ (ultimo fotogramma; vedi colonna STATUS in Video Source) o canale sbagliato.