syssi / xiaomiplug

Xiaomi Mi Smart WiFi Socket integration for Home Assistant

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Xiaomi Smart WiFi Sockets and Power Strips

GitHub actions GitHub stars GitHub forks GitHub watchers "Buy Me A Coffee"

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'

About

Xiaomi Mi Smart WiFi Socket integration for Home Assistant

License:Apache License 2.0


Languages

Language:Python 100.0%