1. Introduzione
Questa guida ti guiderà nell'integrazione della telecamera SONOFF in Home Assistant utilizzando il protocollo ONVIF . Con questa configurazione, sarai in grado di:
- Visualizza video in tempo reale in Home Assistant
- Ricevi eventi di movimento e di rilevamento umano
- Imposta l'automazione (ad esempio, attiva la registrazione quando viene rilevato un movimento)
Prima di iniziare, assicurati che il firmware del tuo dispositivo e la versione dell'app soddisfino i requisiti per il supporto ONVIF.
|
*Questo tutorial prende come esempio la telecamera SONOFF CAM-PT2.
2. Cosa ti servirà
Per completare questa integrazione, assicurati di avere quanto segue:
Hardware e software
- Un dispositivo che esegue Home Assistant (ad esempio, Raspberry Pi 4+, PC o Docker)
- Sia la telecamera che Home Assistant si trovano nella stessa rete locale
Informazioni sull'account e accesso
- La tua telecamera SONOFF è stata aggiunta all'app eWeLink
- Funzione ONVIF/RTSP abilitata tramite:
Impostazioni dispositivo → Altre impostazioni → ONVIF/RTSP
Registrare le seguenti informazioni:
- Indirizzo IP della telecamera
- Porta ONVIF
- Nome utente e password (modificabili)
3. Abbinamento con Home Assistant
Passaggio 1: installare l'integrazione ONVIF
- Vai alla dashboard principale di Home Assistant.
- Vai a: Impostazioni → Dispositivi e servizi → Aggiungi integrazione
- Cerca ONVIF e selezionalo
- Fai clic su Invia
Passaggio 2: aggiungere la fotocamera
- Quando viene rilevato CAM-PT2, selezionarlo e fare clic su Invia
- Inserisci il nome utente e la password ONVIF
- Fai clic su Salta e termina
Ora vedrai la tua telecamera nella dashboard di Home Assistant, nella scheda Panoramica .
4. Cosa puoi fare
4.1 Streaming in tempo reale
- Guarda il feed video in diretta direttamente in Home Assistant
- Attiva/disattiva l'audio
4.2 Stato di rilevamento del movimento e della presenza umana
- Rilevamento del movimento/dell'essere umano come trigger di automazione
4.3 Controllo PTZ
- Crea una nuova dashboard
- Modifica la dashboard
- Crea una nuova sezione
- Nel pannello " Per entità ", seleziona le caselle relative ai sensori di rilevamento di movimento/persona della tua telecamera e all'entità stream
MainStream
. Quindi, clicca su " Aggiungi alla dashboard " per includerli nel tuo layout.
- Nella sezione appena creata, fai clic sull'icona di modifica (â‹®) nell'angolo in alto a destra e scegli " Modifica in YAML " dal menu.
- Identifica il testo a sinistra di "_mainstream". Questo testo rappresenta il nome della tua telecamera. Ad esempio, se la stringa della telecamera è "cam_pt2_test_mainstream", il nome della telecamera sarà "cam_pt2_test".
type: grid
square: false
columns: 1
cards:
- type: entities
entities:
- binary_sensor.<camera_name>_cell_motion_detection
- binary_sensor.<camera_name>_motion_alarm
- binary_sensor.<camera_name>_person_detection
- type: picture-glance
entities:
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
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.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
tilt: UP
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Up
icon: mdi:arrow-up
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
tilt: DOWN
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Down
icon: mdi:arrow-down
- entity: camera.<camera_name>_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.<camera_name>_mainstream
pan: RIGHT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Right
icon: mdi:arrow-right
show_icon: true
camera_image: camera.<camera_name>_mainstream
camera_view: live
Per esempio:
type: grid
square: false
columns: 1
cards:
- type: entities
entities:
- binary_sensor.cam_pt2_test_cell_motion_detection
- binary_sensor.cam_pt2_test_motion_alarm
- binary_sensor.cam_pt2_test_person_detection
- type: picture-glance
entities:
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
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.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
tilt: UP
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Up
icon: mdi:arrow-up
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
tilt: DOWN
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Tilt Down
icon: mdi:arrow-down
- entity: camera.cam_pt2_test_mainstream
tap_action:
action: call-service
service: onvif.ptz
service_data:
entity_id: camera.cam_pt2_test_mainstream
pan: RIGHT
speed: 1
distance: 0.3
move_mode: ContinuousMove
name: Pan Right
icon: mdi:arrow-right
show_icon: true
camera_image: camera.cam_pt2_test_mainstream
camera_view: live
- Dopo la sostituzione con il nome della tua telecamera, sostituisci completamente il codice originale con la versione modificata. Quindi fai clic su SALVA e FINE per applicare le modifiche.
- A questo punto, è possibile visualizzare il feed live della telecamera e i pulsanti di controllo PTZ. È possibile utilizzare questi pulsanti per ruotare la telecamera verso l'alto, verso il basso, verso sinistra e verso destra.
4.4 Automazioni
Crea automazioni utilizzando gli eventi della telecamera come trigger. Esempio:
Quando viene rilevato un movimento:
- Vai a Informazioni dispositivo → + Aggiungi automazione → Usa dispositivo come trigger
- Seleziona "Rilevamento movimento avviato"
- Scegli un'azione:
Fotocamera → Registra , imposta il percorso del file come:
/media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4
- Configura durata e lookback
- Fare clic su Salva
Puoi quindi trovare le registrazioni in Media → I miei media .
5. Panoramica delle funzionalità
La telecamera SONOFF supporta ONVIF e RTSP, consentendo una facile integrazione con Home Assistant. Per aiutarti a comprendere le differenze, di seguito è riportata una rapida panoramica delle funzionalità.
CAM-PT2
Caratteristica |
ONVIF |
RTSP |
Rilevamento del dispositivo |
√ |
× |
Vista dal vivo |
√ |
√ |
Controllo PTZ |
√ È richiesta la configurazione manuale tramite script. |
× |
Notifica evento |
√ Automazione dei trigger (movimento, umano) |
× |
CAM-S2
Caratteristica |
ONVIF |
RTSP |
Rilevamento del dispositivo |
√ |
× |
Vista dal vivo |
√ |
√ |
Notifica evento |
√ Automazione dei trigger (movimento, umano) |
× |