Credits to the following Github project
This is an complete Home Assistant component for Xiaomi Gateway. It allows you to integrate the following devices into HA
- Motion Sensor
- Door and Window Sensor
- Button
- Plug
- Aqara Wall Switch (Single)
- Aqara Wall Switch (Double)
- Aqara Wireless Switch (Single)
- Aqara Wireless Switch (Double)
- Cube
- Gateway Light
- Gateway Sensor
- Battery
- Ringtone play
What's not available?
- Gateway Radio
- Power Consumption
- First, copy all the files into the Home Assistant location. It can now be installed either to the custom_components folder
/home/homeassistant/.homeassistant/custom_components
or the root folder (using virtual environment)
/srv/homeassistant/homeassistant_venv/lib/python3.4/site-packages/homeassistant/components
- Add the following line to the Configuration.yaml. Make sure you're on the latest firmware. You will need to get the Hub's key in order to issue command to the hub like turning on and off plug. Follow the steps here http://bbs.xiaomi.cn/t-13198850
One Gateway
#you can leave sid empty if you only have one gateway
xiaomi:
gateways:
- sid:
key: xxxxxxxxxxxxxxxxMultiple Gateway
#12 characters sid can be obtained from the gateway's MAC address.
xiaomi:
gateways:
- sid: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
- sid: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx- Start HA. Pycrypto should install automatically. If not, install pycrypto manually. if you are using virtual environment, remember to install from virtual environment like below
(homeassistant_venv) pi@raspberrypi:~ $ pip3 install pycrypto
- Add friendly names to the Configuration.yaml like below
customize:
binary_sensor.switch_158d000xxxxxc3:
friendly_name: Ktichen Switch
binary_sensor.switch_158d000xxxxxc2:
friendly_name: Table Switch
binary_sensor.door_window_sensor_158d000xxxxx7a:
friendly_name: Door Sensor- Add automation. For the Button and Switch, use the following event. Available click types are 'single', 'double' and 'hold'. For door window sensor and motion sensor, you can use State or Event as trigger
automation:
- alias: Turn on Dining Light when click
trigger:
platform: event
event_type: click
event_data:
entity_id: binary_sensor.switch_158d000xxxxxc2
click_type: single
action:
service: switch.toggle
entity_id: switch.wall_switch_left_158d000xxxxx01 #trigger for motion sensor using State
trigger:
platform: state
entity_id: binary_sensor.motion_sensor_158d000xxxxxc2
from: 'off'
to: 'on'
#trigger for motion sensor using Event
trigger:
platform: event
event_type: motion_action
event_data:
entity_id: binary_sensor.motion_sensor_158d000xxxxxc2
action_type: motion # motion / no_motion #trigger for door window sensor using State
trigger:
platform: state
entity_id: binary_sensor.door_window_sensor_158d000xxxxxc2
from: 'off'
to: 'on'
#trigger for door window sensor using Event
trigger:
platform: event
event_type: door_window_action
event_data:
entity_id: binary_sensor.door_window_sensor_158d000xxxxxc2
action_type: open # open / close / no_close- For Cube, use the following trigger. Available actions are flip90, flip180, move, tap_twice, shake_air, swing, alert, free_fall and rotate
trigger:
platform: event
event_type: cube_action
event_data:
entity_id: binary_sensor.cube_158d000xxxxxc2
action_type: flip90- Important! Only use this if you have have issue with Socket binding or multicast. Using this when you have no problem with socket or mcast will introduce other issues. Add the IP address of the network interface to the config
xiaomi:
gateways:
- sid: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
- sid: xxxxxxxxxxxx
key: xxxxxxxxxxxxxxxx
interface: xx.xx.xx.xx