node-red-contrib-mi-devices 1.1.0

A set of nodes to control some of the popular Xiaomi sensors which are connected to the Xiaomi Gateway, and the Gateway itself.

npm install node-red-contrib-mi-devices

This module contains the following nodes to provide easy integration of the Xiaomi devices into node-red. This module is a fork of Harald Rietman module, node-red-contrib-xiaomi-devices

The following devices are currently supported:

  • Temperature/humidity sensor
  • Aqara temperature/humidity/pressure sensor
  • Magnet switch
  • Aqara window/door sensor
  • Button switch
  • Aqara smart wireless switch
  • Motion sensor
  • Power plug (zigbee)
  • Power plug (wifi)
  • Yeelight White (mono)
  • Yeelight RGB

Preperation

To interact with the gateway, you need to enable the developer mode, aka LAN mode in the gateway (see below).

To control the Wifi-Plug, extensive use is made of the miio library created by Andreas Holstenson. Make sure to check his page for compatible devices.

Install

npm install node-red-contrib-mi-devices

Usage

From the Xiaomi configurator screen add your different devices by selecting the type of device and a readable description. The readable discription is used on the different edit screen of the nodes to easily select the device you associate to the node.

Note that the Wifi power plug is not configured through the configurator as it is not connected to the gateway.

The Xiaomi configurator screen with ease of use to configure your different devices.

Mi configurator in node-red

Tip: use the configurator from the side-panel (hamburger menu, configuration nodes) to manage your devices. Node-red doesn't update underlying edit screens if the configuration panel is opened / closed from the edit node screen. (If you do, you need to first close the edit node screen and reopen it by double-clicking the node you want to edit the properties for.)

How to use different nodes

Here an example of how to use the different nodes (screenshot of importable flows-overview.json): Mi devices example in node-red

Sample flows

Here are different flow (screenshot of importable flows-sample.json): Mi devices example in node-red

Enable LAN mode

Gateway

  1. Install MiHome App
  2. Make sure you set your region to: Mainland China under settings -> Locale - required for the moment. Mainland China and language can set on English.
  3. Select your Gateway in Mi Home
  4. Then click the 3 dots at the top right of the screen
  5. Then click on about
  6. Tap under Tutorial menu (on the blank part) repeatedly
  7. You should see now 3 extra options listed in Chinese until you did now enable the developer mode (like the first screenshot below, if not try all steps again!)
  8. Choose the second new option
  9. Then tap the first toggle switch to enable LAN functions. Note down the password (A4D81977ED8A4177 in the second screenshot)
  10. Make sure you hit the OK button (to the right of the cancel button) to save your changes

If you change here something, you lose your password!

Gateway advanced mode Gateway LAN mode enabled

Yeelight

  1. Install Yeelight App
  2. Select your Yeelight in Mi Home
  3. Then click the third icon at the bottom of the screen
  4. Then click on the lightning icon "LAN control"
  5. In the new panel, toggle the switch to "on"

The lightning icon should be underline un yellow.

Yeelight options Yeelight LAN mode enabled

Sources

Credits

Node Info

Version: 1.1.0
Updated 1 week, 2 days ago
License: MIT

Downloads

14 in the last day
125 in the last week
406 in the last month

Nodes

  • xiaomi-ht
  • xiaomi-magnet
  • xiaomi-motion
  • xiaomi-switch
  • xiaomi-plug
  • xiaomi-plug-wifi
  • xiaomi-all
  • xiaomi-configurator
  • xiaomi-gateway
  • xiaomi-gateway in
  • xiaomi-gateway out
  • xiaomi-actions read
  • xiaomi-actions get_id_list
  • xiaomi-actions click
  • xiaomi-actions double_click
  • xiaomi-actions gateway_light
  • xiaomi-actions gateway_sound
  • xiaomi-actions gateway_stop_sound
  • xiaomi-actions on
  • xiaomi-actions off
  • xiaomi-actions toggle
  • xiaomi-yeelight out

Keywords

  • Xiaomi
  • Aqara
  • node-red

Maintainers

  • pierrecle