106 lines
3.0 KiB
Python
106 lines
3.0 KiB
Python
"""
|
|
homeassistant.components.camera.foscam
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
This component provides basic support for Foscam IP cameras.
|
|
|
|
As part of the basic support the following features will be provided:
|
|
-MJPEG video streaming
|
|
|
|
To use this component, add the following to your configuration.yaml file.
|
|
|
|
camera:
|
|
platform: foscam
|
|
name: Door Camera
|
|
ip: 192.168.0.123
|
|
port: 88
|
|
username: YOUR_USERNAME
|
|
password: YOUR_PASSWORD
|
|
|
|
Variables:
|
|
|
|
ip
|
|
*Required
|
|
The IP address of your Foscam device.
|
|
|
|
username
|
|
*Required
|
|
The username of a visitor or operator of your camera. Oddly admin accounts
|
|
don't seem to have access to take snapshots.
|
|
|
|
password
|
|
*Required
|
|
The password for accessing your camera.
|
|
|
|
name
|
|
*Optional
|
|
This parameter allows you to override the name of your camera in homeassistant.
|
|
|
|
port
|
|
*Optional
|
|
The port that the camera is running on. The default is 88.
|
|
|
|
For more details about this platform, please refer to the documentation at
|
|
https://home-assistant.io/components/camera.foscam.html
|
|
"""
|
|
import logging
|
|
from homeassistant.helpers import validate_config
|
|
from homeassistant.components.camera import DOMAIN
|
|
from homeassistant.components.camera import Camera
|
|
import requests
|
|
import re
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
# pylint: disable=unused-argument
|
|
def setup_platform(hass, config, add_devices_callback, discovery_info=None):
|
|
""" Adds a Foscam IP Camera. """
|
|
if not validate_config({DOMAIN: config},
|
|
{DOMAIN: ['username', 'password', 'ip']}, _LOGGER):
|
|
return None
|
|
|
|
add_devices_callback([FoscamCamera(config)])
|
|
|
|
|
|
# pylint: disable=too-many-instance-attributes
|
|
class FoscamCamera(Camera):
|
|
""" An implementation of a Foscam IP camera. """
|
|
|
|
def __init__(self, device_info):
|
|
super(FoscamCamera, self).__init__()
|
|
|
|
ip_address = device_info.get('ip')
|
|
port = device_info.get('port', 88)
|
|
|
|
self._base_url = 'http://' + ip_address + ':' + str(port) + '/'
|
|
self._username = device_info.get('username')
|
|
self._password = device_info.get('password')
|
|
self._snap_picture_url = self._base_url \
|
|
+ 'cgi-bin/CGIProxy.fcgi?cmd=snapPicture&usr=' \
|
|
+ self._username + '&pwd=' + self._password
|
|
self._name = device_info.get('name', 'Foscam Camera')
|
|
|
|
_LOGGER.info('Using the following URL for %s: %s',
|
|
self._name, self._snap_picture_url)
|
|
|
|
def camera_image(self):
|
|
""" Return a still image reponse from the camera. """
|
|
|
|
# send the request to snap a picture
|
|
response = requests.get(self._snap_picture_url)
|
|
|
|
# parse the response to find the image file name
|
|
|
|
pattern = re.compile('src="[.][.]/(.*[.]jpg)"')
|
|
filename = pattern.search(response.content.decode("utf-8")).group(1)
|
|
|
|
# send request for the image
|
|
response = requests.get(self._base_url + filename)
|
|
|
|
return response.content
|
|
|
|
@property
|
|
def name(self):
|
|
""" Return the name of this device. """
|
|
return self._name
|