Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 25 days 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-11-09T21:20:27.806Z (about 1 month ago)
- Topics: ble, bluet, bluetooth, miflora, mijia, node-red, nodered, xia, xiaomi
- Language: JavaScript
- Homepage:
- Size: 18.6 KB
- Stars: 20
- 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