node-flic-buttons

A NodeJS node to interact with the flic.io BLE buttons.

This node requires the fliclib-linux-dist daemon to handle the low level comunication with the buttons. You will need to install this (and the correct version of bluez) before you start.

The node supports all method that can be accesses by the C++ library made available in the fliclib-linux-dist package.

startScan
stopScan
connectButton
disconnectButton

connectButton and disconnectButton take the button MAC address of the button

var flic = require('node-flic-buttons');

var buttons = new flic();
// defaults to localhost:5000 else
//var buttons = new flic(host, port);

The buttons object will emit the following events

online - when connected to the daemon
offline - when disconnected from the daemon
discovered - when a button is discoverd (as part of a scan)
connected - when a button is connected
disconnected - when a button is disconnected
click - when a button is clicked, double clicked or long clicked

The discovered, connected, disconnected, and click all pass objects along with the event

flic.on('click', function(clickEvt){
  //{"deviceId":"80:E4:DA:70:XX:XX","queued":false,"timeDiff":0,"isSingleClick":true,"isDoubleClick":false,"isHold":false}
  if (clickEvt.isSingleClick) {
    ...
  } else if (clickEvt.isDoubleClick) {
    ...
  } else if (clickEvt.isHold) {
    ...
  }
});

I'm not 100% confident the startScan, stopScan, connect all work 100% of the time. You can pair buttons manually with the flic command that ships with the fliclib-linux package using the following actions:

Ensure that bluetoothd and the daemon are running
run flic
type the command startScan
press the flic button (you may have to press and hold for 7 seconds to unlock if it has been previously paired)
type the command stopScan
type the command list, this will show all known flic.io buttons

80:E4:DA:70:XX:XX [Disconnected]

type connect [80:E4:DA:70:XX:XX] where [mac address is the button you want to pair]
you should now see something that looks like

Connected to: 80:E4:DA:70:XX:XX
Verified: 80:E4:DA:70:XX:XX

the button should now be paired

node-flic-buttons