node-sensortag


Node.js lib for the TI SensorTag and TI CC2650 SensorTag

Prerequisites

* node-gyp install guide
* noble prerequisites

Install

``sh
npm install sensortag
`

Examples

See test.js or sensorTag folder in Tom Igoe's BluetoothLE-Examples repo

Usage

`javascript
var SensorTag = require('sensortag');
`

$3

#### One

`javascript
SensorTag.discover(callback(sensorTag));
`

#### All

`javascript
function onDiscover(sensorTag) {
// ...
}

SensorTag.discoverAll(onDiscover);

SensorTag.stopDiscoverAll(onDiscover);
`

#### By id

`javascript
SensorTag.discoverById(id, callback(sensorTag));
`

#### By address

`javascript
SensorTag.discoverByAddress(address, callback(sensorTag));
`

#### Properties:

`javascript
sensorTag = {
id: "",
type: "cc2540" | "cc2650"
}
`

$3

`javascript
sensorTag.connectAndSetUp(callback(error));
`

$3

`javascript
sensorTag.disconnect(callback);
`

$3

Add listener for when SensorTag is disconnected:

`javascript
sensorTag.once('disconnect', callback);
`

$3

`javascript
sensorTag.readDeviceName(callback(error, deviceName));

sensorTag.readSystemId(callback(error, systemId));

sensorTag.readSerialNumber(callback(error, serialNumber));

sensorTag.readFirmwareRevision(callback(error, firmwareRevision));

sensorTag.readHardwareRevision(callback(error, hardwareRevision));

sensorTag.readSoftwareRevision(callback(error, softwareRevision));

sensorTag.readManufacturerName(callback(error, manufacturerName));
`

$3

#### Enable/disable

`javascript
sensorTag.enableIrTemperature(callback(error));

sensorTag.disableIrTemperature(callback(error));

sensorTag.setIrTemperaturePeriod(period, callback(error)); // period min 300ms, default period is 1000 ms
`

#### Read

`javascript
sensorTag.readIrTemperature(callback(error, objectTemperature, ambientTemperature));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyIrTemperature(callback(error));

sensorTag.unnotifyIrTemperature(callback(error));

sensorTag.on('irTemperatureChange', callback(objectTemperature, ambientTemperature));
`

$3

#### Enable/disable/configure

`javascript
sensorTag.enableAccelerometer(callback(error));

sensorTag.disableAccelerometer(callback(error));

// CC2540: period 1 - 2550 ms, default period is 2000 ms
// CC2650: period 100 - 2550 ms, default period is 1000 ms
sensorTag.setAccelerometerPeriod(period, callback(error));
`

#### Read

`javascript
sensorTag.readAccelerometer(callback(error, x, y, z));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyAccelerometer(callback(error));

sensorTag.unnotifyAccelerometer(callback(error));

sensorTag.on('accelerometerChange', callback(x, y, z));
`

$3

#### Enable/disable

`javascript
sensorTag.enableHumidity(callback(error));

sensorTag.disableHumidity(callback(error));

sensorTag.setHumidityPeriod(period, callback(error));
`

#### Read

`javascript
sensorTag.readHumidity(callback(error, temperature, humidity));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyHumidity(callback(error));

sensorTag.unnotifyHumidity(callback(error));

sensorTag.on('humidityChange', callback(temperature, humidity));
`

$3

#### Enable/disable

`javascript
sensorTag.enableMagnetometer(callback(error));

sensorTag.disableMagnetometer(callback(error));

// CC2540: period 1 - 2550 ms, default period is 2000 ms
// CC2650: period 100 - 2550 ms, default period is 1000 ms
sensorTag.setMagnetometerPeriod(period, callback(error));
`

#### Read

`javascript
sensorTag.readMagnetometer(callback(error, x, y, z));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyMagnetometer(callback(error));

sensorTag.unnotifyMagnetometer(callback(error));

sensorTag.on('magnetometerChange', callback(x, y, z));
`

$3

#### Enable/disable

`javascript
sensorTag.enableBarometricPressure(callback(error));

sensorTag.disableBarometricPressure(callback(error));

sensorTag.setBarometricPressurePeriod(period, callback(error)); // period 100 - 2550 ms
`

#### Read

`javascript
sensorTag.readBarometricPressure(callback(error, pressure));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyBarometricPressure(callback(error));

sensorTag.unnotifyBarometricPressure(callback(error));

sensorTag.on('barometricPressureChange', callback(pressure));
`

$3

#### Enable/disable/configure

`javascript
sensorTag.enableGyroscope(callback(error));

sensorTag.disableGyroscope(callback(error));

// period 100 - 2550 ms, default period is 1000 ms
sensorTag.setGyroscopePeriod(period, callback(error));
`

#### Read

`javascript
sensorTag.readGyroscope(callback(error, x, y, z));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyGyroscope(callback(error));

sensorTag.unnotifyGyroscope(callback(error));

sensorTag.on('gyroscopeChange', callback(x, y, z));
`

$3

#### Data read/write

`javascript
sensorTag.readIoData(callback(error, value));
sensorTag.writeIoData(value, callback(error));
`

#### Config read/write

`javascript
sensorTag.readIoConfig(callback(error, value));
sensorTag.writeIoConfig(value, callback(error));
`

$3

#### Enable/disable/configure

`javascript
sensorTag.enableLuxometer(callback(error));

sensorTag.disableLuxometer(callback(error));

sensorTag.setLuxometerPeriod(period, callback(error));
`

#### Read

`javascript
sensorTag.readLuxometer(callback(error, lux));
`

#### Notify/Unnotify

`javascript
sensorTag.notifyLuxometer(callback(error));

sensorTag.unnotifyLuxometer(callback(error));

sensorTag.on('luxometerChange', callback(lux));
`

$3

#### Read

`javascript
sensorTag.readBatteryLevel(callback(error, batteryLevel));
`

$3

#### Notify/Unnotify

`javascript
sensorTag.notifySimpleKey(callback(error));

sensorTag.unnotifySimpleKey(callback(error));
`

CC2540:

`javascript
sensorTag.on('simpleKeyChange', callback(left, right));
`

CC2650:

`javascript
sensorTag.on('simpleKeyChange', callback(left, right, reedRelay));
``