jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions
home-assistant.github.io/source/_components/light.xiaomi_miio.markdown
Paulus Schoutsen 772fb32af9 Merge branch 'current' into next
2018-03-23 14:07:56 -07:00

6.3 KiB
Raw Blame History

layout title description date sidebar comments sharing footer logo ha_category ha_version ha_iot_class
page Xiaomi Philips Light Instructions on how to integrate your Xiaomi Philips Lights within Home Assistant. 2017-08-26 08:45 true false true true philips.png Light 0.53 Local Polling

The xiaomi_miio platform allows you to control the state of your Xiaomi Philips LED Ball Lamp, Xiaomi Philips Zhirui LED Bulb E14 Candle Lamp, Xiaomi Philips LED Ceiling Lamp and Xiaomi Philips Eyecare Lamp 2.

Features

Philips LED Ball Lamp and Philips Zhirui LED Candle Lamp

  • Power (on, off)
  • Brightness
  • Color temperature (175...333 mireds)
  • Scene (1, 2, 3, 4)
  • Delayed turn off (Resolution in seconds)
  • Attributes
    • model
    • scene
    • delayed_turn_off

Philips LED Ceiling Lamp

  • Power (on, off)
  • Brightness
  • Color temperature (175...370 mireds)
  • Scene (1, 2, 3, 4)
  • Night light mode (on, off)
  • Delayed turn off (Resolution in seconds)
  • Attributes
    • model
    • scene
    • delayed_turn_off
    • night_light_mode
    • automatic_color_temperature

Philips Eyecare Smart Lamp 2

  • Eyecare light (on, off)
  • Ambient light (on, off)
  • Brightness (of each light)
  • Scene (1, 2, 3, 4)
  • Night light mode (on, off)
  • Delayed turn off (Resolution in seconds)
  • Eye fatigue reminder / notification (on, off)
  • Eyecare mode (on, off)
  • Attributes
    • model
    • scene
    • delayed_turn_off
    • night_light_mode
    • reminder
    • eyecare_mode

Please follow the instructions on Retrieving the Access Token to get the API token to use in the configuration.yaml file.

To add a Xiaomi Philips Light to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entries
light:
  - platform: xiaomi_miio
    name: Xiaomi Philips Smart LED Ball
    host: 192.168.130.67
    token: YOUR_TOKEN
    model: philips.light.bulb

Configuration variables:

  • host (Required): The IP of your light.
  • token (Required): The API token 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.candle2, 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 Service light.xiaomi_miio_set_scene %}

Set one of the 4 available fixed scenes.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.
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.

{% linkable_title Service light.xiaomi_miio_reminder_on %} (Eyecare Smart Lamp 2 only)

Enable the eye fatigue reminder/notification.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.

{% linkable_title Service light.xiaomi_miio_reminder_off %} (Eyecare Smart Lamp 2 only)

Disable the eye fatigue reminder/notification.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.

{% linkable_title Service light.xiaomi_miio_night_light_mode_on %} (Eyecare Smart Lamp 2 only)

Turn the smart night light mode on.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.

{% linkable_title Service light.xiaomi_miio_night_light_mode_off %} (Eyecare Smart Lamp 2 only)

Turn the smart night light mode off.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.

{% linkable_title Service light.xiaomi_miio_eyecare_mode_on %} (Eyecare Smart Lamp 2 only)

Turn the eyecare mode on.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.

{% linkable_title Service light.xiaomi_miio_eyecare_mode_off %} (Eyecare Smart Lamp 2 only)

Turn the eyecare mode off.

Service data attribute Optional Description
entity_id yes Only act on a specific light. Else targets all.