misfit-bolt

Misfit Bolt Javascript Interface

Thin wrapper around sandeepmistry/noble, that helps Misfit Bolt bulbs discovery, and allows turning them on/off and changing their color and brightness, as well as reading their currently set values.

Prerequisites

To connect to the Misfit Bolt, you need BLE capabilities. See sandeepmistry/noble prerequisites for more details.

Setup

npm install misfit-bolt

API Methods

discover

Type static

Arguments

1. callback (function): function to be invoked once a Bolt is discovered. Takes a Bolt instance as first argument.
2. uuids (Array, optional): list of Bolt uuid to discover.

Returns

undefined

Example

Bolt.discover(function(bolt) {
  // do something
}, ['29852E52-67A0-490A-BC55-7FAB809AD0C0']);

connect

Type instance

Arguments

1. callback (function)

Returns

instance

Example

bolt.connect(function() {
  // do something
});

disconnect

Type instance

Arguments

1. callback (function)

Returns

instance

Example

bolt.disconnect(function(){
  // do something
});

on

Type instance

Arguments

1. callback (function)

Returns

instance

Example

bolt.on(function(){
  // do something
});

off

Type instance

Arguments

1. callback (function)

Returns

instance

Example

bolt.off(function(){
  // do something
});

set

Type instance

Arguments

1. value (String): value to set on bulb. Mostly in the form or RGBA. Accepts "CLTMP 3200,0" or "CLTMP 3200,1" (used for toggle on / off). Other undocumented formats might exist.
2. callback (function)

Returns

instance

Example

bolt.set("228,41,15,10", function(){
  // do something
});

setRGBA

Type instance

Arguments

1. value (Array): value to set on bulb. Although not enforced yet, should be in the form of [red, gree, blue, alpha].
2. callback (function)

Returns

instance

Example

bolt.setRGBA([228,41,15,10], function(){
  // do something
});

get

Type instance

Arguments

1. callback (function): function invoked when value is available. Return value of String type.

Returns

instance

Example

bolt.get(function(value) {
  // do something with value
});

getRGBA

Type instance

Arguments

1. callback (function): function invoked when value is available. Return value of Array type.

Returns

instance

Example

bolt.get(function(rgbaValue) {
  // do something with rgbaValue
});

Example

Bolt = require('.');

// Discover every nearby Bolt
Bolt.discover(function(bolt) {

  // Each time a bolt is discovered, connect to it
  bolt.connect(function() {
    var i = 0,
        colors = [['253','100%','49%'],
                  ['117','100%','49%'],
                  ['0','100%','49%'],
                  ['62','100%','49%'],
                  ['304','100%','49%']];

    // Change color every 2000 ms
    setInterval(function(){
      var color = colors[i++ % colors.length];
      bolt.setHSL(color, 10, function() {});
    }, 2000);
  });
});

TODO

• CLI tool

Notes

• Inspired by fayep's Python implementation
• PRs welcomed!