https://github.com/eschava/node-red-contrib-xiaomi-ble

Xiaomi Bluetooth4 (BLE) sensors
https://github.com/eschava/node-red-contrib-xiaomi-ble

ble bluet bluetooth miflora mijia node-red nodered xia xiaomi

Last synced: 3 months ago
JSON representation

Xiaomi Bluetooth4 (BLE) sensors

• Host: GitHub
• URL: https://github.com/eschava/node-red-contrib-xiaomi-ble
• Owner: eschava
• License: mit
• Created: 2018-06-06T13:21:58.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2021-01-19T11:24:17.000Z (almost 4 years ago)
• Last Synced: 2024-07-07T03:24:05.406Z (4 months ago)
• Topics: ble, bluet, bluetooth, miflora, mijia, node-red, nodered, xia, xiaomi
• Language: JavaScript
• Homepage:
• Size: 18.6 KB
• Stars: 19
• Watchers: 8
• Forks: 15
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-nodered - xiaomi-ble - Single "Xiaomi BLE" node that gets all known data from Xiaomi BLE (Bluetooth 4). (Nodes / I/O)

README

        
# node-red-contrib-xiaomi-ble

This Node-Red module contains single "Xiaomi BLE" node that gets all known data from Xiaomi BLE (Bluetooth 4) devices 

using Bluetooth 4 compatible adapter.

Currently supported devices are:

* MiFlora - Xiaomi Mi plant sensor

* Xiaomi Mijia Bluetooth Temperature Humidity Sensor

## Installation

This module requires [noble](https://github.com/noble/noble) library. It will be installed automatically but in case 

of any problems you can try to install it manually using corresponding instructions.

To install this module use Node-Red GUI installer or console command:

```

npm install node-red-contrib-xiaomi-ble

```

## Usage

**Configuration:** Xiaomi BLE node needs only bluetooth address of devices (optional, if it's omitted then incoming message should have **address** property)

**Input message:** just triggers requesting data from the sensor. Optional parameters:

* _address_ - override address of the device from configuration.

* _scan_ - re-lookup for device even if it was already found before.

**Output message:** **msg.payload** object of the output message could contain next fields:

* _temperature_ - temperature from sensor

* _battery_ - battery level in percents

* _humidity_ - Mijia Temperature Humidity device only

* _light_, _moisture_, _conductivity_ - MiFlora device only

## Linux

On Linux bluetooth adapter could be used by root user only. 

To run node-red without root/sudo use instructions from [noble](https://github.com/noble/noble#running-on-linux)

## Version history

1.0.0 Initial release

1.1.0 Changed format of output message

1.2.0 Device's address could be specified in input message + configurable scanning timeout

1.2.1 Memory leak fixed

1.2.2 Added 'scan' parameter to message to force scanning

1.2.3 Bug-fix release

1.2.4 Change noble dependency to @abandonware/noble as former package is unmaintained

1.3.0 Added support of Xiaomi Mijia Bluetooth Thermometer 2 (aka LYWSD03MMC)

1.3.1 Protection from the "Peripheral already connected" error

1.3.2 Negative temperature support

1.3.3 Original message object is preserved