|
| 1 | +--- |
| 2 | +layout: page |
| 3 | +title: "Blink" |
| 4 | +description: "Instructions for how to integrate Blink camera/security system within Home Assistant." |
| 5 | +date: 2017-03-05 22:13 |
| 6 | +sidebar: true |
| 7 | +comments: false |
| 8 | +sharing: true |
| 9 | +footer: true |
| 10 | +logo: blink.png |
| 11 | +ha_category: Hub |
| 12 | +ha_release: "0.40" |
| 13 | +--- |
| 14 | + |
| 15 | +The `blink` component lets you view camera images and motion events from [Blink](http://blinkforhome.com) camera and security systems. |
| 16 | + |
| 17 | +You will need your Blink login information (username, usually you email address, and password) to use this module. |
| 18 | + |
| 19 | +To set it up, add the following information to your `configuration.yaml` file: |
| 20 | + |
| 21 | +```yaml |
| 22 | +# Example configuration.yaml entry |
| 23 | +blink: |
| 24 | + username: YOUR_USERNAME |
| 25 | + password: YOUR_PASSWORD |
| 26 | +``` |
| 27 | +
|
| 28 | +Once loaded, your front end will have the following components: |
| 29 | +* A camera image for each camera in your system. |
| 30 | +* A binary_sensor per camera that indicates whether motion detection is enabled. |
| 31 | +* A binary_sensor for the system that indicates if the system is armed or disarmed. |
| 32 | +* A sesnor per camera that reports temperature. |
| 33 | +* A sensor per camera that reports battery level. |
| 34 | +* A sensor per camera that reports unread notification (ie. detected motion events). |
| 35 | +
|
| 36 | +Since the cameras are battery operated, the images are only updated in Home Assistant when the user manually forces a new photo. The image can only be updated in Home Assistant every 60 seconds in order to not overwhelm Blink's servers with API requests. |
| 37 | +
|
| 38 | +Services: |
| 39 | +There are three services availiabe for the blink platform: |
| 40 | +- arm_system |
| 41 | +- arm_camera |
| 42 | +- snap_picture |
| 43 | +
|
| 44 | +For arm_system, the value sent can be either "True" or "False" and will arm and disarm the whole blink system, respectively |
| 45 | +
|
| 46 | +Arm system example |
| 47 | +```json |
| 48 | +{ |
| 49 | + "device_armed": "True" |
| 50 | +} |
| 51 | +``` |
| 52 | + |
| 53 | +Arm camera follows a similar structure, but each indidivual camera can have motion detection enabled or disabled. Because of this, you also need to supply a name. For example, if I have a camera named "Living Room" and I want to turn off motion detection on that camera, I'd call the blink.arm_camera service with the following payload: |
| 54 | +```json |
| 55 | +{ |
| 56 | + "friendly_name": "Living Room", |
| 57 | + "device_armed": "False" |
| 58 | +} |
| 59 | +``` |
| 60 | + |
| 61 | +The blink.snap_picture service takes the camera name as the payload and with take a new picture with your camera. |
| 62 | +``` |
| 63 | +{ |
| 64 | + "friendly_name": "Living Room" |
| 65 | +} |
| 66 | +``` |
| 67 | + |
| 68 | +Configuration variables: |
| 69 | + |
| 70 | +- **username** (*Required*): Your username to login to Blink |
| 71 | +- **password** (*Required*): Your password to login to Blink |
| 72 | + |
| 73 | +<p class='img'> |
| 74 | + <img src='{{site_root}}/images/screenshots/blink_example_frontend.png' /> |
| 75 | +</p> |
0 commit comments