node-red-contrib-xiaomi-smart-home 2.0.3

This is node for node-red which can receive message and send command from device Xiaomi smart home.<br> <b>support all devices*</b> <br> support for all devices is experimental technology, and may experience crashes with the module.

npm install node-red-contrib-xiaomi-smart-home

Русская версия описания плагина

Данный плагин для системы node-red принимает и отправляет данные для шлюза gateway (Xiaomi Smart Home)

#Поддерживаемые устройства На данный момент поддерживаються следующие устройства:

• Gateway
• Wireless switch
• Door and window sensor
• Temperature and humidity sensor
• Cube controller
• Occupancy sensor
• Wireless switch(One Button)
• Wireless switch(Two Buttons)
• Plug

#Отправка/принятие данных ##Настройка перед отправкой данных Перед тем как отправить данные необходимо в настройках самого плагина указать 2 пункта, а именно:

1. sid - Id устройства
2. key - Ключ который выдается при включение функции Wireless communication protocol

###Отправка данных на шлюз(gateway) Для отправки данных на шлюз(gateway) нужно создать элемент ввода(input) и прописать в нем следующие данные(формата json):
{
"model": "gateway" - Модель устройства к которой надо обратиться
"sid": "sid(id) устройства" - Sid устройства
"command": "command" - Команда для отправки на устройство
"value": "value" - Значение для команды
}

###Принятие данных из шлюза Для принятие данных можно воспользоваться элементом вывода(debug),формат данных имеет немного иную структуру от формата отправки данных, а именно: msg.model = Здесь обозначаеться модель устройства msg.topic = Здесь отображается sid(id) устройства msg.payload = Здесь отображаються данные пришедшие с вывода

Все выводимые свойства с payload:

• voltage
• temperature
• humidity
• no_motion
• rotate
• ip
• channel_0
• channel_1

#English version

Smart home

This is node for node-red which can receive message and send command from device Xiaomi smart home.
support all devices*
support for all devices is experimental technology, and may experience crashes with the module.

100% Support next devices:

• Gateway
• Wireless switch
• Door and window sensor
• Temperature and humidity sensor
• Cube controller
• Occupancy sensor
• Wireless switch(One Button)
• Wireless switch(Two Buttons)

Other device may display not current data!!!

How install and using

install this node you can via command in directory node-red

cd ~/.node-red
npm install node-red-contrib-xiaomi-smart-home

Use it with block which is located in the section 'input'. Note: you can put only one instance on a work surface!

Data analysis

received message has next format:

• msg => topic - sid device
• msg => payload - here may be more properties but main event
• msg => model - it name device

All properties payload:

• voltage
• temperature
• humidity
• no_motion
• rotate
• ip
• channel_0
• channel_1

That would apply to this property, you need write in function:

msg.payload.voltage; // or temperature, humidity, no_motion and other...
return msg;

Example input date:

input module must be in format JSON, and have next view:
{"model": "gateway", "sid": "you sid", "command": "you command for example rgb", "value": you value for example 4286578816}
At the moment I know of 2 commands:

1. rgb - set color for gateway.
2. mid - play music with 0 to 13.

Example flow

Update

2.0.0 - fix bugs and added support more gateway