freebird-netcore-ble

A ble machine network core for freebird framework.

Table of Contents

1. Overiew
2. Installation
3. Basic Usage
4. APIs

1. Overview

freebird-netcore-ble is the network controller (netcore) with managment facilities ready for freebird.

2. Installation

$ npm install freebird-netcore-ble --save

3. Basic Usage

• To use this netcore with freebird, register it to freebird in your app:

var Freebird = require('freebird'),
    createBleCore = require('freebird-netcore-ble');
 
var freebird,
    bleCore = createBleCore('noble');
 
// Create freebird server and register freeebird-netcore-ble
freebird = new Freebird([ bleCore ]);
 
// Simply start the freebird server
freebird.start(function (err) {
    freebird.permitJoin(180);  // Let your netcores allow peripheral machines to join the network
});
 
// That's it!

4. APIs

1. Basic API

freebird-netcore-ble exports a function createBleCore() to create BLE netcore, it will returns a Netcore instance for network operating

• createBleCore()

2. Netcore APIs

Netcore provides you with the following APIs, please go to Netcore APIs for their usage.

• Basic Methods

• Network Management

• With cc-bnp sub-module: createBleCore('cc-bnp', spConfig)
• With noble sub-module: createBleCore('noble')

Arguments

• subModule (String): subModule can be either a string of 'cc-bnp' or 'noble' to specify the sub-module.

• spConfig (Object): This value-object has two properties path and options to configure the serial port.

  • path: A string that refers to the serial-port system path, e.g., '/dev/ttyUSB0'.
  • options: An object to set up the seiralport configuration options.

Returns

• (Object): bleCore

Example

• Using cc-bnp as a sub-module:

var createBleCore = require('freeebird-netcore-ble');
 
var bleCore = createBleCore('cc-bnp', {
        path: '/dev/ttyUSB0',
        options: {
            baudRate: 115200,   // default value
            rtscts: true,       // default value
            flowControl: true   // default value
        }
    });

• Using noble as a sub-module:

var createBleCore = require('freeebird-netcore-ble');
 
var bleCore = createBleCore('noble');