Yeelight

Yeelight 集成可让你在 Home Assistant 中控制 Yeelight Wi-Fi 灯泡。

此集成在 Home Assistant 中支持以下设备类型：

Light - 通过 Yeelight 平台支持灯光。
Binary sensor - 通过 Yeelight 平台支持二进制传感器。目前仅支持吸顶灯的夜灯模式传感器。

配置

此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

Custom effects

自定义效果只能通过 YAML 配置。要开启效果，可使用 light.turn_on 动作。

可用的过渡类型有 RGBTransition、HSVTransition、TemperatureTransition、SleepTransition。

数组值格式如下：

RGBTransition: [red, green, blue, duration, brightness]，其中 red/green/blue 为 0 到 255 的数值，duration 为毫秒（最小 50），最终亮度为 1-100（%）。
HSVTransition: [hue, saturation, duration, brightness]，其中 hue 为 0 到 359，saturation 为 0 到 100，duration 为毫秒（最小 50），最终亮度为 1-100（%）。
TemperatureTransition: [temp, duration, brightness]，其中 temp 为最终色温（1700 到 6500），duration 为毫秒（最小 50），最终亮度为 1-100（%）。
SleepTransition: [duration]，其中 duration 为效果时长（毫秒，最小 50）。

有关过渡类型及其参数的更多信息，请参阅 python-yeelight 文档。

yeelight:
  custom_effects:
    - name: 'Fire Flicker'
      flow_params:
        count: 0
        transitions:
          - TemperatureTransition: [1900, 1000, 80]
          - TemperatureTransition: [1900, 2000, 60]
          - SleepTransition:       [1000]

Full configuration

此示例展示了如何使用可选配置项。

# configuration.yaml 示例
yeelight:
  devices:
    192.168.1.25:
      name: Living Room
      transition: 1000
      use_music_mode: true
      save_on_change: true
  custom_effects:
    - name: 'Fire Flicker'
      flow_params:
        count: 0
        transitions:
          - TemperatureTransition: [1900, 1000, 80]
          - TemperatureTransition: [1900, 2000, 60]
          - SleepTransition:       [1000]

devices:
  required: false
  description: Yeelight 设备列表。
  type: map
  keys:
    host:
      description: 灯泡的主机名或 IP 地址。
      required: true
      type: map
      keys:
        name:
          description: 设备的友好名称。
          required: false
          type: string
        transition:
          description: 平滑过渡时长（毫秒）。
          required: false
          type: integer
          default: 350
        use_music_mode:
          description: 启用音乐模式。
          required: false
          type: boolean
          default: false
        save_on_change:
          description: 当在 Home Assistant 中更改状态时，将灯泡状态保存到其非易失性存储器中。
          required: false
          type: boolean
          default: false
        nightlight_switch_type:
          description: 添加一个额外实体用于控制夜灯模式（仅限支持该功能的型号）。目前仅支持 `light`。将创建两个灯光实体，一个用于普通模式，另一个用于夜灯模式，二者互斥。
          required: false
          type: string
        model:
          description: "Yeelight 型号。可选值为 `mono1`、`color1`、`color2`、`strip1`、`bslamp1`、`ceiling1`、`ceiling2`、`ceiling3`、`ceiling4`、`ceiling10`、`ceiling13`。该设置用于启用型号特定功能，例如特定色温范围。"
          required: false
          type: string
custom_effects:
  description: 要添加的自定义效果列表。请参考下方示例。
  required: false
  type: map
  keys:
    name:
      description: 效果名称。
      required: true
      type: string
    flow_params:
       description: 效果的流参数。
       required: true
       type: map
       keys:
         count:
            description: 此流运行次数（0 表示无限循环）。
           required: false
           type: integer
           default: 0
         action:
             description: 流结束后执行的动作。可选值为 'recover'、'stay'、'off'。
            required: false
            type: string
            default: recover
         transitions:
            description: 该效果的过渡列表，请参阅[示例](#custom-effects)。
           required: true
           type: list

Music mode

默认情况下，灯泡每分钟最多处理 60 次请求。启用音乐模式后可绕过该限制。在音乐模式下，灯泡会主动连接到集成提供的 socket，并尝试保持连接常开，这并不一定适用于所有场景。另请注意，音乐模式下的灯泡断开连接后不会将状态更新为 "unavailable"，这可能导致 Home Assistant 出现延迟。如果连接中断，音乐模式下灯泡首次可能不响应 Home Assistant 指令。若遇到此问题，请在前端将灯关闭再打开，通常即可恢复正常。

Initial setup

:::important 在尝试通过 Home Assistant 控制灯之前，你需要先在 Yeelight App 中完成灯泡设置（Android、IOS）。在灯泡属性中，你需要启用 "LAN Control"（之前称为 "Developer mode"）。LAN Control 可能仅在灯泡安装最新固件后可用。连接灯泡后可在应用中更新固件。确定灯泡 IP（可通过路由器、软件、ping 等方式）。目前没有官方方式切换 LAN 模式，不过你可以参考以下方法：

Desktop app
CLI using the python-miio library: 1, 2

:::

Supported models

Note

此集成已测试可用于以下型号。如果你使用其他型号且运行正常，欢迎反馈。

Model ID	Model number	Product name
`mono`	YLTD03YL	Yeelight Serene Eye-Friendly Desk Lamp
`mono1`	YLDP01YL	LED Bulb (White)
?	YLDP05YL	LED Bulb (White) - 2nd generation
`color1`	YLDP02YL	LED Bulb (Color)
`color1`	YLDP03YL	LED Bulb (Color) - E26
`color2`	YLDP06YL	LED Bulb (Color) - 2nd generation
`color4`	YLDP13YL	LED Bulb 1S (Color)
`color4`	YLDP04YL	LED Bulb 1S (Color)
`color6`	YLDP13AYL	LED Bulb 1S (Color)
`colorb`	YLDP005	LED Bulb (Color)
`colorc`	YLDP004-A	GU10 W1 (Color)
`strip1`	YLDD01YL	Lightstrip (Color)
`strip1`	YLDD02YL	Lightstrip (Color)
?	YLDD04YL	Lightstrip (Color)
`strip6`	YLDD05YL	Lightstrip (Color)
`bslamp1`	MJCTD01YL	Xiaomi Mijia Bedside Lamp - Wi-Fi Version!
`bslamp1`	MJCTD02YL	Xiaomi Mijia Bedside Lamp II
`RGBW`	MJDP02YL	Mi LED smart Lamp - white and color Wi-Fi Version
`lamp`	MJTD02YL	Xiaomi Mijia Desk Lamp Pro
`lamp1`	MJTD01YL	Xiaomi Mijia Smart LED Desk Lamp (autodiscovery isn't possible because the device doesn't support mDNS due to the small amount of RAM)
`lamp9`	YLCT03YL	Yeelight Staria Bedside Lamp Pro
`lamp15`	YLTD003	Yeelight LED Screen Light Bar Pro
`ceiling1`	YLXD01YL	Yeelight Ceiling Light
`ceiling2`	YLXD03YL	Yeelight Ceiling Light - Youth Version
?	YLXD62YI	Yeelight Ceiling Light (Jiaoyue 260)
?, may be `ceiling3`	YLXD04YL	Yeelight Ceiling Light (Jiaoyue 450)
`ceiling3`	YLXD05YL	Yeelight Ceiling Light (Jiaoyue 480)
`ceiling4`	YLXD02YL	Yeelight Ceiling Light (Jiaoyue 650)
`ceiling10`	YLDL01YL	Yeelight Meteorite Pendant Light
`ceiling13`	YLXD01YL	Yeelight LED Ceiling Light
`ceil26`	YLXD76YL	Yeelight Ceiling Light - Updated HomeKit 23w
?, may be `ceilb`	YLXD013-B	Yeelight Arwen Ceiling Light 450C
?, may be `ceilb`	YLXD013-C	Yeelight Arwen Ceiling Light 550C
`ceilb`	YLXD013	Yeelight Arwen Ceiling Light 450S

Actions

Action: Set mode

yeelight.set_mode 动作用于设置运行模式。

Data attribute	Optional	Description
`entity_id`	yes	仅对指定灯光生效。
`mode`	no	运行模式。可选值：'last'、'normal'、'rgb'、'hsv'、'color_flow'、'moonlight'。

Action: Start flow

yeelight.start_flow 动作用于启动包含指定过渡的流。

Data attribute	Optional	Description
`entity_id`	yes	仅对指定灯光生效。
`count`	yes	流运行次数（0 表示无限循环）。
`action`	yes	流结束后执行的动作。可选值为 'recover'、'stay'、'off'。默认 'recover'。
`transitions`	no	过渡数组。参见自定义效果。

Action: Set color scene

yeelight.set_color_scene 动作会将灯设置为指定 RGB 颜色和亮度。若灯处于关闭状态，将自动打开。

Data attribute	Optional	Description
`entity_id`	yes	Only act on specific lights.
`rgb_color`	no	A list containing three integers between 0 and 255 representing the RGB color you want the light to be. Three comma-separated integers that represent the color in RGB, within square brackets.
`brightness`	no	The brightness value to set (1-100).

Action: Set HSV scene

yeelight.set_hsv_scene 动作会将灯设置为指定 HSV 颜色和亮度。若灯处于关闭状态，将自动打开。

Data attribute	Optional	Description
`entity_id`	yes	Only act on specific lights.
`hs_color`	no	A list containing two floats representing the hue and saturation of the color you want the light to be. Hue is scaled 0-360, and saturation is scaled 0-100.
`brightness`	no	The brightness value to set (1-100).

Action: Set color temperature scene

yeelight.set_color_temp_scene 动作会将灯设置为指定色温。若灯处于关闭状态，将自动打开。

Data attribute	Optional	Description
`entity_id`	yes	Only act on specific lights.
`kelvin`	no	Color temperature in Kelvin.
`brightness`	no	The brightness value to set (1-100).

Action: Set color flow scene

yeelight.set_color_flow_scene 动作用于启动颜色流。与 yeelight.start_flow 的区别是它调用了不同的 Yeelight API。若灯原本关闭，将自动打开。不同固件在处理复杂流时可能存在差异。

Data attribute	Optional	Description
`entity_id`	yes	Only act on specific lights.
`count`	yes	The number of times to run this flow (0 to run forever).
`action`	yes	The action to take after the flow stops. Can be 'recover', 'stay', 'off'. Default 'recover'
`transitions`	no	Array of transitions. See custom effects.

Action: Set auto delay off scene

yeelight.set_auto_delay_off_scene 动作会以指定亮度开灯，并设置定时器在指定分钟后自动关灯。若灯处于关闭状态，将自动打开。

Data attribute	Optional	Description
`entity_id`	yes	Only act on specific lights.
`minutes`	no	The minutes to wait before automatically turning the light off.
`brightness`	no	The brightness value to set (1-100).

Action: Set music mode

yeelight.set_music_mode 动作用于启用或禁用 music_mode。

Data attribute	Optional	Description
`entity_id`	yes	Only act on specific lights.
`music_mode`	no	Use 'true' or 'false' to enable / disable music_mode.

故障排除

设备发现

Yeelight 设备在 SSDP 中使用了非标准搜索参数，因此在 SSDP/UPnP Browser 中不可见。

如果你想检查网络中有哪些设备，可使用 async-upnp-client 库，然后运行以下命令：

upnp-client search \
    --target 239.255.255.250 \
    --target_port 1982 \
    --bind 0.0.0.0 \
    --search_target wifi_bulb

你也可以查看 Zeroconf Browser 或 DHCP Browser，它们可以正确发现 Yeelight 设备。

#Yeelight

#Custom effects

#Full configuration

#Music mode

#Initial setup

#Supported models

#Actions

#Action: Set mode

#Action: Start flow

#Action: Set color scene

#Action: Set HSV scene

#Action: Set color temperature scene

#Action: Set color flow scene

#Action: Set auto delay off scene

#Action: Set music mode

#故障排除

#设备发现