mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-23 18:46:50 +00:00
118 lines
4.7 KiB
Markdown
118 lines
4.7 KiB
Markdown
---
|
|
title: Yi Home Cameras
|
|
description: Instructions on how to integrate a video feed (via FFmpeg) as a camera within Home Assistant.
|
|
ha_category:
|
|
- Camera
|
|
ha_release: 0.56
|
|
ha_iot_class: Local Polling
|
|
ha_codeowners:
|
|
- '@bachya'
|
|
ha_domain: yi
|
|
ha_platforms:
|
|
- camera
|
|
ha_integration_type: device
|
|
ha_quality_scale: legacy
|
|
---
|
|
|
|
The `yi` camera platform allows you to utilize [Yi Home Cameras](https://www.yitechnology.com/) within Home Assistant. Specifically, this platform supports the line of Yi Home Cameras that are based on the Hi3518e Chipset. This includes:
|
|
|
|
- Yi Home 17CN / 27US / 47US
|
|
- Yi 1080p Home
|
|
- Yi Dome
|
|
- Yi 1080p Dome
|
|
|
|
To successfully implement this platform, the Home Assistant host should be capable of multiple simultaneous reads. For every concurrent Home Assistant user, a connection will be made to the camera every 10 seconds. This should normally not be a problem.
|
|
|
|
## Preparing the device
|
|
|
|
### Installing alternative firmware
|
|
|
|
In order to integrate the camera with Home Assistant, it is necessary to install a custom firmware on the device. Instructions for doing so can be found via the [yi-hack-v3 GitHub project](https://github.com/shadow-1/yi-hack-v3).
|
|
If you have a 2019/2020 version camera use [yi-hack-MStar GitHub project](https://github.com/roleoroleo/yi-hack-MStar) or [yi-hack-Allwinner GitHub project](https://github.com/roleoroleo/yi-hack-Allwinner). In this case configure the cam as ONVIF and read the wiki for further details.
|
|
|
|
Once installed, please ensure that you have enabled FTP and Telnet on your device.
|
|
|
|
{% important %}
|
|
Currently, version 0.1.4-beta2 of the custom firmware is the highest supported without having to make additional modifications. Firmwares higher than this version use [Pure-FTPd](https://www.pureftpd.org/project/pure-ftpd), which has a bug that prevents FFmpeg from correctly rendering video files. To use higher firmware versions you must also follow [this workaround](https://github.com/shadow-1/yi-hack-v3/issues/129#issuecomment-361723075) to revert back to ftpd.
|
|
{% endimportant %}
|
|
|
|
{% tip %}
|
|
If you use a version higher than 0.1.4-beta2, you can simply solve the FTP issue by creating a symlink to `/tmp` in the `/home/yi-hack-v4` directory (the directory name can be different depending on the version which you use). For example, access the Yi camera via SSH and type command: `ln -s /tmp tmp`.
|
|
{% endtip %}
|
|
|
|
{% important %}
|
|
Raspbian users: don't forget to install FFmpeg support on your platform, otherwise, you'll not see video.
|
|
{% endimportant %}
|
|
|
|
{% tip %}
|
|
Some alternative Yi firmwares enable an experimental RTSP server, which will allow you to connect to your camera via other Home Assistant camera platforms. However, this RTSP server disables the ability to use the supremely-useful Yi Home app. In order to maintain both Home Assistant compatibility _and_ the native app, this platform retrieves videos via FTP.
|
|
{% endtip %}
|
|
|
|
### Changing the FTP password
|
|
|
|
Once the custom firmware is installed, a password must be added to the FTP
|
|
server. To do so:
|
|
|
|
1. Telnet into your camera: `telnet <IP ADDRESS>`.
|
|
2. Enter `root` as the username and `<blank>` as the password.
|
|
3. Type `passwd` and hit `<Enter>`.
|
|
4. Enter your new password twice.
|
|
5. Log out of Telnet.
|
|
|
|
## Configuring the platform
|
|
|
|
To enable the platform, add the following lines to your`configuration.yaml` file:
|
|
|
|
```yaml
|
|
camera:
|
|
- platform: yi
|
|
name: Camera
|
|
host: "192.168.1.100"
|
|
password: my_password_123
|
|
```
|
|
|
|
{% configuration %}
|
|
name:
|
|
description: A human-friendly name for the camera.
|
|
required: true
|
|
type: string
|
|
host:
|
|
description: The IP address or hostname of the camera.
|
|
required: true
|
|
type: string
|
|
password:
|
|
description: The password for the FTP server running on the camera. Can be any string as the current firmware doesn't allow setting FTP passwords.
|
|
required: true
|
|
type: string
|
|
path:
|
|
description: The path to the raw MP4 files.
|
|
required: false
|
|
type: string
|
|
default: /media/mmcblk0p1/record
|
|
username:
|
|
description: The user that can access the FTP server.
|
|
required: false
|
|
type: string
|
|
default: root
|
|
ffmpeg_arguments:
|
|
description: Extra options to pass to `ffmpeg` (e.g., image quality or video filter options).
|
|
required: false
|
|
type: string
|
|
{% endconfiguration %}
|
|
|
|
## Image quality
|
|
|
|
Any option supported by [`ffmpeg` camera](/integrations/camera.ffmpeg/) can be utilized via the `ffmpeg_arguments` configuration parameter.
|
|
|
|
One particularly useful adjustment deals with video size. Since Yi videos are fairly large (especially on the 1080p cameras), the following configuration will bring them down to a manageable size:
|
|
|
|
```yaml
|
|
camera:
|
|
- platform: yi
|
|
name: My Camera
|
|
host: "192.168.1.100"
|
|
password: my_password_123
|
|
path: /home/camera/feed
|
|
ffmpeg_arguments: "-vf scale=800:450"
|
|
```
|