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 andHumidity Monitor 2 | LYWSD03MMC (China)NUN4126GL (Global, should be checked) | ✅ | Palette name: th monitorNode name: mihome-th-monitor | | Mi Temperature andHumidity Sensor | WSDCGQ01LM | ❌ | Palette name: th sensorNode 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 |