xiaomiplug
xiaomiplug copied to clipboard
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
andlumi.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' |