Cylon.js adaptor/drivers for Bluetooth LE
Clone or download
Latest commit 9029180 Jan 15, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Peripherals now have 'id' instead of 'uuid' Aug 25, 2015
examples Update dynamic connect example to start device Sep 8, 2015
lib Correct behavior for multiple connections Jan 15, 2016
spec Improve the passthru ability to let Noble be Noble Jan 12, 2016
.eslintrc update deps Aug 5, 2015
.gitignore Initial commit Sep 11, 2014
.npmignore Initial commit Sep 11, 2014
.travis.yml Update Travis build file for testing Travis platform migration Dec 21, 2015
LICENSE Update to 0.10.0 Jan 12, 2016
Makefile Move index file to index.js Jun 26, 2015
README.md
RELEASES.md Update to v0.10.1 Jan 15, 2016
index.js WIP on general-purpose BLE characteristic interface Aug 2, 2015
package.json Update to v0.10.1 Jan 15, 2016

README.md

Cylon.js For Bluetooth LE

Cylon.js (http://cylonjs.com) is a JavaScript framework for robotics, physical computing, and the Internet of Things using Node.js

This repository contains the Cylon adaptor/drivers to connect to Bluetooth Low Energy (LE) peripherals. It uses the Noble node module (https://github.com/sandeepmistry/noble) created by @sandeepmistry thank you!

For more information about Cylon, check out the repo at https://github.com/hybridgroup/cylon

Build Status Code Climate Test Coverage

How to Install

Install the module with:

$ npm install cylon cylon-ble

For Ubuntu you must install the following dependency prior to npm install cylon-ble:

$ sudo apt-get install libbluetooth-dev

How to Use

Here's a basic BLE example to get the battery level of a device:

"use strict";

var Cylon = require('cylon');

Cylon.robot({
  connections: {
    bluetooth: { adaptor: 'ble', uuid: '207377654321' }
  },

  devices: {
    battery: { driver: 'ble-battery-service' }
  },

  work: function(my) {
    my.battery.getBatteryLevel(function(err, data) {
      if (!!err) {
        console.log("Error: ", err);
        return;
      }

      console.log("Data: ", data);
    });
  }
}).start();

How to Connect

var Cylon = require('cylon');

Cylon.robot({
  connections: {
    wiced: { adaptor: 'ble', uuid: '207377654321' }
  },

  devices: {
    battery: { driver: 'ble-battery-service' }
  },

  work: function(my) {
    every((1).second(), function() {
      my.battery.getBatteryLevel(function(err, data){
        if (err) {
          console.log(err);
        } else {
          console.log("BatteryLevel:", data);
        }
      });
    });
  }
}).start();

You will need a computer with a hardware adaptor that supports Bluetooth LE, also known as Bluetooth 4.0, or Bluetooth Smart. Also, this module currently only supports OSX and Linux operating systems.

Commands

You can use the cylon-ble modules's included commands to scan for BLE devices, and then to list the various BLE characteristics for a specific device.

Note that you need to install cylon-ble using the -g option, and then run each commands under sudo like this:

$ sudo cylon-ble-scan
Starting scan.
Peripheral discovered!
  Name: 2B-785E
  UUID: cc360e85785e
  rssi: -80

$ sudo cylon-ble-info cc360e85785e
peripheral with UUID cc360e85785e found
  Local Name        = 2B-785E
  TX Power Level    = -10
  Service Data      =
  Service UUIDs     = 22bb746f2ba075542d6f726568705327

services and characteristics:
1800 (Generic Access)
  2a00 (Device Name)
    properties  read, write
    value       32422d37383545 | '2B-785E'
...

Documentation

We're busy adding documentation to our web site at http://cylonjs.com/ please check there as we continue to work on Cylon.js

Thank you!

Contributing

For our contribution guidelines, please go to https://github.com/hybridgroup/cylon/blob/master/CONTRIBUTING.md .

Release History

For the release history, please go to https://github.com/hybridgroup/cylon-gpio/blob/master/RELEASES.md .

License

Copyright (c) 2014-2016 The Hybrid Group. Licensed under the Apache 2.0 license.