1. Einleitung
Diese Anleitung führt Sie durch die Integration der SONOFF-Kamera in Home Assistant mithilfe des ONVIF-Protokolls . Mit diesem Setup können Sie:
- Echtzeit-Video in Home Assistant ansehen
- Empfangen von Bewegungs- und Personenerkennungsereignissen
- Richten Sie eine Automatisierung ein (z. B. starten Sie die Aufnahme, wenn eine Bewegung erkannt wird).
Stellen Sie vor dem Start sicher, dass die Firmware und App-Version Ihres Geräts die Anforderungen für die ONVIF-Unterstützung erfüllen.
|
*Dieses Tutorial verwendet die SONOFF CAM-PT2-Kamera als Beispiel.
2. Was Sie brauchen
Um diese Integration abzuschließen, stellen Sie sicher, dass Sie über Folgendes verfügen:
Hardware und Software
- Ein Gerät mit Home Assistant (z. B. Raspberry Pi 4+, PC oder Docker)
- Sowohl die Kamera als auch der Home Assistant im selben lokalen Netzwerk
Kontoinformationen und Zugriff
- Ihre SONOFF-Kamera wurde der eWeLink-App hinzugefügt
- ONVIF/RTSP-Funktion aktiviert über:
Geräteeinstellungen → Weitere Einstellungen → ONVIF/RTSP
Notieren Sie die folgenden Informationen:
- IP-Adresse der Kamera
- ONVIF-Anschluss
- Benutzername und Passwort (änderbar)
3. Mit Home Assistant koppeln
Schritt 1: ONVIF-Integration installieren
- Gehen Sie zum Haupt-Dashboard von Home Assistant.
- Navigieren Sie zu: Einstellungen → Geräte & Dienste → Integration hinzufügen
- Suchen Sie nach ONVIF und wählen Sie es aus
- Klicken Sie auf „Senden“.
Schritt 2: Fügen Sie die Kamera hinzu
- Wenn CAM-PT2 erkannt wird, wählen Sie es aus und klicken Sie auf Senden
- Geben Sie den ONVIF-Benutzernamen und das Passwort ein
- Klicken Sie auf Überspringen und Fertigstellen
Sie sehen Ihre Kamera jetzt im Home Assistant-Dashboard unter der Registerkarte „Übersicht“ .
4. Was Sie tun können
4.1 Echtzeit-Streaming
- Sehen Sie sich Live-Video-Feeds direkt im Home Assistant an
- Audio ein-/ausschalten
4.2 Bewegungs- und Personenerkennungsstatus
- Bewegungs-/Personenerkennung als Automatisierungsauslöser
4.3 PTZ-Steuerung
- Erstellen eines neuen Dashboards
- Bearbeiten des Dashboards
- Erstellen eines neuen Abschnitts
- Aktivieren Sie im Bereich „ Nach Entität “ die Kontrollkästchen für die Bewegungs-/Personenerkennungssensoren Ihrer Kamera und die Stream-Entität
MainStream
. Klicken Sie anschließend auf „ Zum Dashboard hinzufügen “, um sie in Ihr Layout aufzunehmen.
- Klicken Sie im neu erstellten Abschnitt oben rechts auf das Bearbeitungssymbol (âź) und wählen Sie im Menü „ In YAML bearbeiten “ aus.
- Suchen Sie den Text links neben „_mainstream“. Dieser Text stellt den Namen Ihrer Kamera dar. Wenn Ihre Kamerazeichenfolge beispielsweise „cam_pt2_test_mainstream“ lautet, lautet der Kameraname „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
Zum Beispiel:
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
- Nach dem Ersetzen Ersetzen Sie den Originalcode vollständig durch den geänderten Code mit dem Namen Ihrer Kamera. Klicken Sie anschließend auf SPEICHERN und FERTIG, um die Änderungen zu übernehmen.
- An diesem Punkt sehen Sie den Live-Feed der Kamera sowie die PTZ-Steuertasten. Mit diesen Tasten können Sie die Kamera nach oben, unten, links und rechts drehen.
4.4 Automatisierungen
Erstellen Sie Automatisierungen mit Kameraereignissen als Auslöser. Beispiel:
Wenn eine Bewegung erkannt wird:
- Gehen Sie zu Geräteinfo → + Automatisierung hinzufügen → Gerät als Auslöser verwenden
- Wählen Sie „Bewegungserkennung gestartet“
- Wählen Sie eine Aktion:
Kamera → Aufnehmen , Dateipfad wie folgt festlegen:
/media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4
- Dauer und Rückblick konfigurieren
- Klicken Sie auf Speichern
Aufnahmen finden Sie dann unter Medien → Meine Medien .
5. Funktionsübersicht
Die SONOFF-Kamera unterstützt ONVIF und RTSP und ermöglicht so eine einfache Integration mit Home Assistant. Um Ihnen die Unterschiede näherzubringen, finden Sie unten eine kurze Funktionsübersicht.
CAM-PT2
Besonderheit |
ONVIF |
RTSP |
Geräteerkennung |
√ |
× |
Live-Ansicht |
√ |
√ |
PTZ-Steuerung |
√ Eine manuelle Konfiguration per Skript ist erforderlich. |
× |
Ereignisbenachrichtigung |
√ Löst Automatisierung aus (Bewegung, Mensch) |
× |
CAM-S2
Besonderheit |
ONVIF |
RTSP |
Geräteerkennung |
√ |
× |
Live-Ansicht |
√ |
√ |
Ereignisbenachrichtigung |
√ Löst Automatisierung aus (Bewegung, Mensch) |
× |