menú

🔎 ¿Cómo integrar la cámara SONOFF en Home Assistant?

1. Introducción

Esta guía le guía en la integración de la cámara SONOFF en Home Assistant mediante el protocolo ONVIF . Con esta configuración, podrá:

  • Ver video en tiempo real en Home Assistant
  • Recibir eventos de detección de movimiento y personas
  • Configurar la automatización (por ejemplo, activar la grabación cuando se detecta movimiento)

Antes de comenzar, asegúrese de que el firmware de su dispositivo y la versión de la aplicación cumplan con los requisitos de compatibilidad con ONVIF.

  • Cámara SONOFF CAM-PT2 con firmware ≥ v1.0.5
  • Cámara SONOFF CAM-S2 con firmware ≥ v1.1.5
  • Aplicación eWeLink (versión ≥ v5.18.0) instalada en su teléfono

*Este tutorial toma como ejemplo la cámara SONOFF CAM-PT2.


2. Lo que necesitarás

Para completar esta integración, asegúrese de tener lo siguiente:

Hardware y software

  • Un dispositivo que ejecuta Home Assistant (por ejemplo, Raspberry Pi 4+, PC o Docker)
  • Tanto la cámara como Home Assistant en la misma red local

Información y acceso a la cuenta

  • Su cámara SONOFF se ha añadido a la aplicación eWeLink
  • Función ONVIF/RTSP habilitada mediante:
    Configuración del dispositivo → Más configuraciones → ONVIF/RTSP

Registre la siguiente información:

  • Dirección IP de la cámara
  • Puerto ONVIF
  • Nombre de usuario y contraseña (modificable)

下载.jpg

3. Emparejar con Home Assistant

Paso 1: Instalar la integración ONVIF

  1. Vaya al panel principal de Home Assistant.
  2. Vaya a: Configuración → Dispositivos y servicios → Agregar integración

  1. Busque ONVIF y selecciónelo

  1. Haga clic en Enviar

Paso 2: Agregar la cámara

  1. Cuando se detecte CAM-PT2, selecciónelo y haga clic en Enviar

  1. Ingrese el nombre de usuario y la contraseña de ONVIF

  1. Haga clic en Omitir y finalizar

Ahora verá su cámara en el panel de Home Assistant, en la pestaña Descripción general .


4. Qué puedes hacer

4.1 Transmisión en tiempo real

  • Vea la transmisión de video en vivo directamente en Home Assistant
  • Activar o desactivar el audio

4.2 Estado de detección de movimiento y personas

  • Detección de movimiento/humanos como desencadenadores de automatización

4.3 Control PTZ

  • Crear un nuevo panel de control

  • Editar el tablero de instrumentos

  • Crear una nueva sección

  • En el panel " Por entidad ", marque las casillas de los sensores de detección de movimiento/personas de su cámara y la entidad de flujo MainStream. Luego, haga clic en " Añadir al panel " para incluirlos en su diseño.

  • En la sección recién creada, haga clic en el ícono de edición (⋮) en la esquina superior derecha y elija “ Editar en YAML ” en el menú.

  • Identifica el texto a la izquierda de "_mainstream". Este texto representa el nombre de tu cámara. Por ejemplo, si la cadena de tu cámara es "cam_pt2_test_mainstream", entonces el nombre de la cámara será "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

Por ejemplo:

 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

  • Después de reemplazar Con el nombre de tu cámara, reemplaza el código original por la versión modificada. Luego, haz clic en GUARDAR y LISTO para aplicar los cambios.

  • En este punto, puede ver la transmisión en vivo de la cámara, así como los botones de control PTZ. Puede usar estos botones para girar la cámara hacia arriba, abajo, izquierda y derecha.

4.4 Automatizaciones

Crea automatizaciones usando eventos de cámara como activadores. Ejemplo:

Cuando se detecta movimiento:

  • Vaya a Información del dispositivo → + Agregar automatización → Usar dispositivo como disparador

  • Seleccione “Detección de movimiento iniciada”

  • Elija una acción:
    Cámara → Grabar , configure la ruta del archivo como:
    /media/{{ now().strftime('%Y%m%d-%H%M%S') }}.mp4

  • Configurar la duración y la retrospección
  • Haga clic en Guardar

Luego podrás encontrar grabaciones en Medios → Mis medios .


5. Descripción general de las funciones

La cámara SONOFF es compatible con ONVIF y RTSP, lo que facilita su integración con Home Assistant. Para ayudarle a comprender las diferencias, a continuación se ofrece un breve resumen de sus funciones.

CAM-PT2

Característica

ONVIF

RTSP

Descubrimiento de dispositivos

×

Vista en vivo

Control PTZ

Se requiere configuración manual mediante script.

×

Notificación de eventos

Automatización de activadores (movimiento, humano)

×

 

CAM-S2

Característica

ONVIF

RTSP

Descubrimiento de dispositivos

×

Vista en vivo

Notificación de eventos

Automatización de activadores (movimiento, humano)

×

 
Anterior
🔎 Cómo montar ERBS con SONOFF MINI-RBS
Próximo
🔎¿Cómo integrar la cámara SONOFF en Scrypted?
Recientemente modificado: 2025-08-20