thunderboard-ble

by: Ryan Rutan

A Node.js library to assist with the reading of data from the following Silicon Labs products.

Note: This code was pulled out of a project and converted into an npm module. It still has a lot of refactoring and features to be added to make it complete, but in it's state ... it does a good job at auto-subscribing to Thunderboard data-events for processing. Pull requests and feedback are always welcome; however, time to maintain this library is limited ... so patience is appreciated. So hope you enjoy. =)

• Thunderboard React
• Thunderboard Sense

Install

npm install thunderboard-ble --save

Usage

Below is an example use of this library.

• config - JSON map of ble devices by MAC address.
• dataCallback - Function to handle callbacks as defined by readIntervals in the config
• normalizeData (optional)- [true|false (default)] Used to interpret the raw data values and convert them to clean measurement values.

    var config = {
        "000b5bbbaaaa" : {
         "uuid" : "000b5bbbaaaa",
         "enabled" : false,
         "family" : "thunderboard",
         "type" : "react",
         "autoconnect" : true,
         "readIntervals" : {
           "environment" : {
             "humidity" : 15000,
             "temperature" : 15000,
             "uv" : 15000
           },
           "ambient-light" : {
             "ambient-light" : 15000
           }
          },
         "services" : {
           "generic-access" : ["device-name"],
           "device-info" : ["manufacturer"],
           "environment" : ["humidity","temperature","uv"],
           "ambient-light" : ["ambient-light"]
        }
      }
    };

    var dataCallback = function(data) {
      console.log('Thunderboard Event',data);
    };

    var normalizeData = true;

    var ThunderBoard = require('thunderboard-ble');
    var tb = new ThunderBoard(config,dataCallback,normalizeData);

Service / Characterstic Names

Thunderboard React

| Service | Characteristics | |--- |:-- | | generic-access | device-name, appearance | | generic-attribute | service-changed | | device-info | manufacturer, model-num, hardware-revision, firmware-revision, system-id | | battery | battery-level | | environment | humidity, temperature, uv | | ambient-light | ambient-light | | cycling-speed-cadence | csc-measurement, csc-feature, sc-control-point | | acceleration-orientation | acceleration, orientation, control-point, | | automation | digital, characteristic-format, num-digitals |

Thunderboard Sense

Note: I have not mapped all the Sense services/characteristics yet, but will complete in the near future.

| Service | Characteristics | |--- |:-- | | generic-access | device-name, appearance | | generic-attribute | service-changed | | device-info | manufacturer, model-num, hardware-revision, firmware-revision, system-id | | battery | battery-level | | environment | humidity, temperature, uv, ambient-light, microphone | | cycling-speed-cadence | csc-measurement, csc-feature, sc-control-point | | acceleration-orientation | acceleration, orientation, control-point, | | automation | digital, characteristic-format, num-digitals |