switch.py

Go to the documentation of this file.

"""Support turning on/off motion detection on Hikvision cameras."""
 
from __future__ import annotations
 
import logging
from typing import Any
 
import hikvision.api
from hikvision.error import HikvisionError, MissingParamError
import voluptuous as vol
 
from homeassistant.components.switch import (
    PLATFORM_SCHEMA as SWITCH_PLATFORM_SCHEMA,
    SwitchEntity,
)
from homeassistant.const import (
    CONF_HOST,
    CONF_NAME,
    CONF_PASSWORD,
    CONF_PORT,
    CONF_USERNAME,
    STATE_OFF,
    STATE_ON,
)
from homeassistant.core import HomeAssistant
import homeassistant.helpers.config_validation as cv
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
 
# This is the last working version, please test before updating
 
_LOGGING = logging.getLogger(__name__)
 
DEFAULT_NAME = "Hikvision Camera Motion Detection"
DEFAULT_PASSWORD = "12345"
DEFAULT_PORT = 80
DEFAULT_USERNAME = "admin"
 
PLATFORM_SCHEMA = SWITCH_PLATFORM_SCHEMA.extend(
    {
        vol.Required(CONF_HOST): cv.string,
        vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string,
        vol.Optional(CONF_PASSWORD, default=DEFAULT_PASSWORD): cv.string,
        vol.Optional(CONF_PORT): cv.port,
        vol.Optional(CONF_USERNAME, default=DEFAULT_USERNAME): cv.string,
    }
)
 
 
def setup_platform(
    hass: HomeAssistant,
    config: ConfigType,
    add_entities: AddEntitiesCallback,
    discovery_info: DiscoveryInfoType | None = None,
) -> None:
    """Set up Hikvision camera."""
    host = config.get(CONF_HOST)
    port = config.get(CONF_PORT)
    name = config.get(CONF_NAME)
    username = config.get(CONF_USERNAME)
    password = config.get(CONF_PASSWORD)
 
    try:
        hikvision_cam = hikvision.api.CreateDevice(
            host, port=port, username=username, password=password, is_https=False
        )
    except MissingParamError as param_err:
        _LOGGING.error("Missing required param: %s", param_err)
        return
    except HikvisionError as conn_err:
        _LOGGING.error("Unable to connect: %s", conn_err)
        return
 
    add_entities([HikvisionMotionSwitch(name, hikvision_cam)])
 
 
class HikvisionMotionSwitch(SwitchEntity):
    """Representation of a switch to toggle on/off motion detection."""
 
    def __init__(self, name, hikvision_cam):
        """Initialize the switch."""
        self._name_name = name
        self._hikvision_cam_hikvision_cam = hikvision_cam
        self._state_state = STATE_OFF
 
    @property
    def name(self):
        """Return the name of the device if any."""
        return self._name_name
 
    @property
    def is_on(self):
        """Return true if device is on."""
        return self._state_state == STATE_ON
 
    def turn_on(self, **kwargs: Any) -> None:
        """Turn the device on."""
        _LOGGING.info("Turning on Motion Detection ")
        self._hikvision_cam_hikvision_cam.enable_motion_detection()
 
    def turn_off(self, **kwargs: Any) -> None:
        """Turn the device off."""
        _LOGGING.info("Turning off Motion Detection ")
        self._hikvision_cam_hikvision_cam.disable_motion_detection()
 
    def update(self) -> None:
        """Update Motion Detection state."""
        enabled = self._hikvision_cam_hikvision_cam.is_motion_detection_enabled()
        _LOGGING.info("enabled: %s", enabled)
 
        self._state_state = STATE_ON if enabled else STATE_OFF