Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including miflora with all npm packages installed. Try it out:

var miflora = require("miflora")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

miflora v1.0.3

Node.js package for the Xiaomi Plant Sensor Flower Care (Mi Flora)

miflora

Node.js package for the Xiaomi Mi Flora Plant Sensor built on top of noble.

npm language XO code style commit firmware licence

Have a look in the Wiki for more information on the sensor.


Prerequisites

Please see the Prerequisites section for noble.

Install

npm install miflora

Usage

The library uses async/await code syntax instead of Promises chaining in order to execute asynchronous code sequentially. Since all internal code is based on Promises you still can use the method().then().catch()-pattern regardless.

All examples use async/await syntax.

Discover devices

const devices = await miflora.discover();
console.log('devices discovered: ', devices.length);

In this example we listen for 10000 (default value) milliseconds (10 seconds) and print out the number of detected devices.

Discover devices (advanced)

const opts = {
  duration: 60000,
  ignoreUnknown: true,
  addresses: ['c4:7c:8d:65:d6:1d', 'c4:7c:8d:65:d5:26', 'c4:7c:8d:65:e6:20']
};
const devices = await miflora.discover(opts);
console.log('devices discovered: ', devices.length);

This time we listen for 60000 milliseconds (60 seconds) or until all devices from given opts.addresses have been discovered and print out the number of detected devices. If opt.ignoreUnknown is true, devices which are not in opt.addresses will be ignored in result.

Query device information

All query methods implicitly initiate a connection if none exists. You can call device.connect() explicitly if you like nevertheless.

The library however doesn't perform a disconnect implicitly. You can call device.disconnect() when you have finished you queries or let you disconnect automatically from the device after 10 seconds.

Firmaware & Battery

const data = await device.queryFirmwareInfo();
console.log(data);

Example output:

{ address: 'c4:7c:8d:65:e6:20',
  type: 'MiFloraMonitor',
  firmwareInfo: { battery: 100, firmware: '3.1.9' } }

Sensor values

const data = await device.querySensorValues();
console.log(data);

Example output:

{ address: 'c4:7c:8d:65:e6:20',
  type: 'MiFloraMonitor',
  sensorValues: { temperature: 21.1, lux: 104, moisture: 36, fertility: 1049 } }

Serial Number

const data = await device.querySerial();
console.log(data);

Combined query

const data = await device.query();
console.log(data);

Debugging

The library uses Debug with the logger names miflora and miflora:device. You can start your script with prefixing DEBUG=miflora* to see all debug output.

DEBUG=miflora* node yourapp.js

References

  • https://github.com/demirhanaydin/node-mi-flora
  • https://wiki.hackerspace.pl/projects:xiaomi-flora

Licence

MIT

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free