node-red-contrib-mihome
Get Xiaomi device information from Mi Home
node-red-contrib-mihome
Add nodes to get data from devices connected to Mi Home using node-mihome. See changelog for the latest changes.
Requirements
-
node
v12.22.0 or higher -
node-red
v1.3.0 or higher
Install
Run npm i node-red-contrib-mihome
in ~/.node-red
directory or search node-red-contrib-mihome and install from Palette Manager.
Supported devices
Device | Models | Tested | Node info |
---|---|---|---|
Mi Temperature and Humidity Monitor 2 |
LYWSD03MMC (China) NUN4126GL (Global, should be checked) |
Palette name: th monitor Node name: mihome-th-monitor
|
|
Mi Temperature and Humidity Sensor |
WSDCGQ01LM | Palette name: th sensor Node name: mihome-th-sensor
|
Adding device support
If you want to add device support, you can make a PR or add request in discussions. Check supported devices in node-mihome
package and use node template for boost development. Additional information you can find in contributing guide.
Available nodes
mihome-cloud
Provide authorization for Mi Home.
Settings
Setting | Required | Description |
---|---|---|
Username | Mi Home account username | |
Password | Mi Home account password | |
Country | Which server use to connect | |
Aqara | Should it be Aqara protocol initiated |
Setting preview
Aqara protocol limitations: you can set up only one mihome-cloud
node with Aqara protocol enabled, all another may cause errors (in short explanation it's because node-mihome
open socket connection in exclusive mode).
mihome-devices
Returns all devices connected to Mi Home.
Palette name: devices.
Statuses
Statuses | Preview |
---|---|
Node not connected to cloud | |
Node connected to cloud |
Settings
Setting | Required | Description |
---|---|---|
Cloud | Mi Home account settings | |
Name | Node display name |
Setting preview
Setup
Description | |
---|---|
Input |
payload with true value |
Output |
payload as array of objects |
mihome-th-monitor
Returns climate data.
Palette name: th monitor.
Statuses
Statuses | Preview |
---|---|
Node not connected to cloud | |
Node connected to cloud but not configured | |
Node connected to cloud and configured |
Settings
Setting | Required | Description |
---|---|---|
Cloud | Mi Home account settings | |
Device ID | Unique device ID from Mi Home, you can get it by checking did field from mihome-devices output |
|
Name | Node display name |
Setting preview
Setup
Description | |
---|---|
Input |
payload with true value |
Output |
payload as object contains temperature, humidity, battery level (could be null) and timestamps |