mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-09 03:36:49 +00:00
125 lines
4.5 KiB
Markdown
125 lines
4.5 KiB
Markdown
---
|
|
title: YoLink
|
|
description: Instructions on how to integrate YoLink Devices into Home Assistant.
|
|
ha_category:
|
|
- Binary sensor
|
|
- Climate
|
|
- Cover
|
|
- Light
|
|
- Lock
|
|
- Number
|
|
- Sensor
|
|
- Siren
|
|
- Switch
|
|
ha_release: 2022.6
|
|
ha_iot_class: Cloud Push
|
|
ha_config_flow: true
|
|
ha_codeowners:
|
|
- '@matrixd2'
|
|
ha_domain: yolink
|
|
ha_platforms:
|
|
- binary_sensor
|
|
- climate
|
|
- cover
|
|
- light
|
|
- lock
|
|
- number
|
|
- sensor
|
|
- siren
|
|
- switch
|
|
- valve
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
Integrates [YoLink](https://www.yosmart.com/) Devices into Home Assistant.
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
{% details "Using custom application credentials" %}
|
|
Home Assistant will use account linking provided by Nabu Casa for authenticating with YoLink, this service is provided for free and does not require a Nabu Casa subscription. The steps below are thus not required.
|
|
If you want to use separate credentials, please contact <service@yosmart.com> to obtain a `client_id` and `client_secret`. Then you can add your credentials via application credentials. Settings > Devices & services > click the menu (three dots at the top right of the screen) and then **Application Credentials**. Enter your credentials in the pop-up window.
|
|
{% enddetails %}
|
|
|
|
## Supported device list
|
|
|
|
The integration is tested and verified for the following devices from YoLink:
|
|
|
|
- YS1604-UC (SpeakerHub)
|
|
- YS3604-UC (YoLink KeyFob)
|
|
- YS3614-UC (Mini FlexFob)
|
|
- YS4002-UC (YoLink Thermostat)
|
|
- YS4003-UC (YoLink Thermostat Heatpump)
|
|
- YS4004-UC (YoLink Thermostat 2)
|
|
- YS4906-UC + YS7706-UC (Garage Door Kit 1)
|
|
- YS4908-UC + YS7706-UC (Garage Door Kit 2 (Finger))
|
|
- YS4909-UC (Water Valve Controller)
|
|
- YS5001-UC (X3 Water Valve Controller)
|
|
- YS5002-UC (YoLink Motorized Ball Valve)
|
|
- YS5003-UC (Water Valve Controller 2)
|
|
- YS5006-UC (FlowSmart Control)
|
|
- YS5007-UC (FlowSmart Meter)
|
|
- YS5008-UC (FlowSmart All-in-One)
|
|
- YS5705-UC (In-Wall Switch)
|
|
- YS5706-UC (YoLink Relay)
|
|
- YS5707-UC (Dimmer Switch)
|
|
- YS5708-UC (In-Wall Switch 2)
|
|
- YS6602-UC (YoLink Energy Plug)
|
|
- YS6604-UC (YoLink Plug Mini)
|
|
- YS6704-UC (In-wall Outlet)
|
|
- YS6801-UC (Smart Power Strip)
|
|
- YS6802-UC (Smart Outdoor Power Strip)
|
|
- YS6803-UC (Outdoor Energy Plug)
|
|
- YS7103-UC (Siren Alarm)
|
|
- YS7104-UC (Outdoor Alarm Controller)
|
|
- YS7105-UC (X3 Outdoor Alarm Controller)
|
|
- YS7106-UC (Power Fail Alarm)
|
|
- YS7107-UC (Outdoor Alarm Controller 2)
|
|
- YS7201-UC (Vibration Sensor)
|
|
- YS7606-UC (YoLink Smart Lock M1)
|
|
- YS7607-UC (YoLink Smart Lock M2)
|
|
- YS7616-UC (YoLink Smart Lock)
|
|
- YS7617-UC (YoLink Smart Lock)
|
|
- YS7618-UC (YoLink Smart Lock)
|
|
- YS7704-UC (Door Sensor)
|
|
- YS7706-UC (Garage Door Sensor)
|
|
- YS7707-UC (Contact Sensor)
|
|
- YS7804-UC (Motion Sensor)
|
|
- YS7805-UC (Outdoor Motion Sensor)
|
|
- YS7903-UC (Water Leak Sensor)
|
|
- YS7904-UC (Water Leak Sensor 2)
|
|
- YS7905-UC (WaterDepthSensor)
|
|
- YS7906-UC (Water Leak Sensor 4)
|
|
- YS7916-UC (Water Leak Sensor 4 MoveAlert)
|
|
- YS7A01-UC (Smart Smoke/CO Alarm)
|
|
- YS8003-UC (Temperature Humidity Sensor)
|
|
- YS8004-UC (Weatherproof Temperature Sensor)
|
|
- YS8005-UC (Weatherproof Temperature & Humidity Sensor)
|
|
- YS8006-UC (X3 Temperature & Humidity Sensor)
|
|
- YS8007-UC (Thermometer Hygrometer)
|
|
- YS8008-UC (Floating Thermometer)
|
|
- YS8013-UC (Thermometer Hygrometer)
|
|
- YS8014-UC (X3 Outdoor Temperature Sensor)
|
|
- YS8015-UC (X3 Outdoor Temperature & Humidity Sensor)
|
|
- YS8017-UC (Thermometer)
|
|
- YS8023-UC (Hygrometer Thermometer)
|
|
|
|
## Actions
|
|
|
|
### `Play on SpeakerHub`
|
|
|
|
With this action, you can convert text to speech for playback on SpeakerHub.
|
|
|
|
| Data attribute | Optional | Description |
|
|
| --------------- | -------- | ----------------------------------------------------------------- |
|
|
| `target_device` | no | SpeakerHub device ID for audio playback. |
|
|
| `message` | no | Text for speech conversion. |
|
|
| `tone` | yes | Tone before playing audio. |
|
|
| `volume` | yes | Override the speaker volume during playback of this message only. |
|
|
| `repeat` | yes | The number of times the text will be repeated. |
|
|
|
|
## Community notes
|
|
|
|
1. This integration requires an MQTT connection to be established via port 8003. If you are using a firewall, please allow communication via port 8003 in the firewall settings.
|
|
2. If you use a network proxy, such as a VPN, the integration may not be able to update the device status. Turn off the VPN.
|
|
3. Please do not use UAC as credentials for the Home Assistant YoLink integration.
|