raspberry4faith / xiaomiplug

Xiaomi Mi Smart WiFi Socket integration for Home Assistant

Xiaomi Smart WiFi Sockets and Power Strips

This is a custom component for Home Assistant to integrate the Xiaomi Smart WiFi Socket (called Plug), Xiaomi Smart Power Strip and Xiaomi Chuangmi Plug V1.

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

Credits: Thanks to Rytilahti for all the work.

Supported devices

Name	Model	Model no.
Xiaomi Smart WiFi Socket	chuangmi.plug.m1
Xiaomi Smart WiFi Socket	chuangmi.plug.m3
Xiaomi Smart WiFi Socket	chuangmi.plug.v2
Xiaomi Smart WiFi Socket	chuangmi.plug.hmi205
Xiaomi Smart WiFi Socket	chuangmi.plug.hmi206
Xiaomi Chuangmi Plug V1	chuangmi.plug.v1
Xiaomi Chuangmi Plug V3	chuangmi.plug.v3
Xiaomi Chuangmi Plug HMI208	chuangmi.plug.hmi208
Xiaomi Smart Power Strip	qmi.powerstrip.v1
Xiaomi Smart Power Strip	zimi.powerstrip.v2
Xiaomi Air Conditioning Companion V3	lumi.acpartner.v3

Features

Xiaomi Smart WiFi Socket

Supported models: chuangmi.plug.m1, chuangmi.plug.m3, chuangmi.plug.v2, chuangmi.plug.hmi205, chuangmi.plug.hmi206

• Power (on, off)
• Attributes
  • Temperature

Xiaomi Chuangmi Plug V1

Supported models: chuangmi.plug.v1, chuangmi.plug.hmi208

• Power (on, off)
• USB (on, off)
• Attributes
  • Temperature

Xiaomi Chuangmi Plug V3

Supported models: chuangmi.plug.v3

• Power (on, off)
• USB (on, off)
• Wifi LED (on, off)
• Attributes
  • Temperature
  • Load power
  • Wifi LED

Xiaomi Smart Power Strip

Supported models: qmi.powerstrip.v1, zimi.powerstrip.v2

• Power (on, off)
• Wifi LED (on, off)
• Power Price (0...999)
• Power Mode (green, normal) (Power Strip V1 only)
• Attributes
  • Temperature
  • Current
  • Load power
  • Wifi LED
  • Mode (Power Strip V1 only)

Xiaomi Air Conditioning Companion V3

Supported models: lumi.acpartner.v3 (the socket of the acpartner.v1 and v2 isn't switchable!)

• Power (on, off)
• Attributes
  • Load power

Setup

# configuration.yaml

switch:
  - platform: xiaomi_miio_plug
    name: Original Xiaomi Mi Smart WiFi Socket
    host: 192.168.130.59
    token: b7c4a758c251955d2c24b1d9e41ce47d
    model: chuangmi.plug.m1
  - platform: xiaomi_miio_plug
    name: Xiaomi Mi Smart Power Strip
    host: 192.168.130.60
    token: 0ed0fdccb2d0cd718108f18a447726a6
    model: zimi.powerstrip.v2

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 device. Valid values are chuangmi.plug.v1, chuangmi.plug.v3, qmi.powerstrip.v1, zimi.powerstrip.v2, chuangmi.plug.m1, chuangmi.plug.m3, chuangmi.plug.v2, chuangmi.plug.hmi205 and lumi.acpartner.v3. This setting can be used to bypass the device model detection and is recommended if your device isn't always available.

Platform services

Service xiaomi_miio_plug.switch_set_wifi_led_on (Power Strip and Chuangmi Plug V3)

Turn the wifi led on.

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

Service xiaomi_miio_plug.switch_set_wifi_led_off (Power Strip and Chuangmi Plug V3)

Turn the wifi led off.

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

Service xiaomi_miio_plug.switch_set_power_price (Power Strip only)

Set the power price.

Service data attribute	Optional	Description
entity_id	yes	Only act on a specific air purifier. Else targets all.
price	no	Power price, between 0 and 999.

Service xiaomi_miio_plug.switch_set_power_mode (Power Strip V1 only)

Set the power mode.

Service data attribute	Optional	Description
entity_id	yes	Only act on a specific xiaomi miio entity. Else targets all.
mode	no	Power mode, valid values are 'normal' and 'green'