Xiaomi MiIO Light: Flag the device as unavailable if not reachable (#4699)

* Configuration key "model" and "xiaomi_miio_set_delayed_turn_off" service added.

* Service parameter renamed.

* New device model (philips.light.zyceiling) added.

* Service parameter updated.

* Format of the services updated.
Configuration schema added.

* Missing supported device added.
This commit is contained in:
Sebastian Muszynski 2018-03-09 19:05:29 +01:00 committed by Paulus Schoutsen
parent 1886934894
commit d799127e30

View File

@ -13,7 +13,7 @@ ha_version: 0.53
ha_iot_class: "Local Polling" ha_iot_class: "Local Polling"
--- ---
The `xiaomi_miio` platform allows you to control the state of your Xiaomi Philips LED Ball Lamp and Xiaomi Philips LED Ceiling Lamp. The `xiaomi_miio` platform allows you to control the state of your Xiaomi Philips LED Ball Lamp, Xiaomi Philips LED Ceiling Lamp and Xiaomi Philips Eyecare Lamp 2.
Currently, the supported features are `on`, `off`, `set_cct` (colortemp) , `set_bright` (brightness). Currently, the supported features are `on`, `off`, `set_cct` (colortemp) , `set_bright` (brightness).
@ -28,12 +28,34 @@ light:
name: Xiaomi Philips Smart LED Ball name: Xiaomi Philips Smart LED Ball
host: 192.168.130.67 host: 192.168.130.67
token: YOUR_TOKEN token: YOUR_TOKEN
model: philips.light.bulb
``` ```
Configuration variables: Configuration variables:
- **host** (*Required*): The IP of your light. - **host** (*Required*): The IP of your light.
- **token** (*Required*): The API token of your light. - **token** (*Required*): The API token of your light.
- **name** (*Optional*): The name of your light. - **name** (*Optional*): The name of your light.
- **model** (*Optional*): The model of your light. Valid values are `philips.light.bulb`, `philips.light.sread1`, `philips.light.ceiling` and `philips.light.zyceiling`. This setting can be used to bypass the device model detection and is recommended if your device isn't always available.
{% configuration %}
host:
description: The IP address of your device.
required: true
type: string
token:
description: The API token of your device.
required: true
type: string
name:
description: The name of your device.
required: false
type: string
default: Xiaomi Philips Light
model:
description: The model of your device.
required: false
type: string
{% endconfiguration %}
## {% linkable_title Platform Services %} ## {% linkable_title Platform Services %}
@ -43,5 +65,14 @@ Set one of the 4 available fixed scenes.
| Service data attribute | Optional | Description | | Service data attribute | Optional | Description |
|---------------------------|----------|-------------------------------------------------------| |---------------------------|----------|-------------------------------------------------------|
| `entity_id` | yes | Only act on specific light. Else targets all. | | `entity_id` | yes | Only act on a specific light. Else targets all. |
| `scene` | no | Scene, between 1 and 4. | | `scene` | no | Scene, between 1 and 4. |
### {% linkable_title Service `light.xiaomi_miio_set_delayed_turn_off` %}
Delayed turn off.
| Service data attribute | Optional | Description |
|---------------------------|----------|-------------------------------------------------------|
| `entity_id` | yes | Only act on a specific light. Else targets all. |
| `time_period` | no | Time period for the delayed turn off. |