homestar-particle

IOTDB Bridge for Particle.io boards.

About

This uses particle-io, the machine you are running on has to be IP reachable from the Particle.

Furthermore, you seem to need to press the Reset button on the Particle to properly do Analog Inputs. This is a bug somewhere in the Libraries we are using (and a huge problem).

• Read about Bridges

Installation and Configuration

• Read this first
• Read about installing Home☆Star

Module Installation

$ npm install -g homestar    ## may require sudo
$ npm install homestar-particle

Access Token Installation

You'll also need to save your Access Token. To get your Access Token, go to Particle Build, log in, and click on Settings (the cog in the lower right corner).

Copy the Access Token and use it as follows

$ homestar set /bridges/ParticleBridge/initd/key 8888888888888888888888888888888888888888

If you only have the one Particle device, you can save that too. If you have multiple devices, you'll need to specify the name when connecting.

$ homestar set /bridges/ParticleBridge/initd/name elrond

Flash Installation

The Particle board needs to be "flashed" with the "VoodooSpark" Firmata-like software. The instructions for this are here. It's quite straight forward

Use

Turn on the built in LED

var iotdb = require('iotdb')
iotdb.use("homestar-particle")

const things = iotdb.connect('ParticleOn');
things.set(':on', true);

Turn on the built in LED, specifying both the Access Token and the Board Name as parameters

const things = iotdb.connect('ParticleOn', {
    "key": "8888888888888888888888888888888888888888",
    "name": "elrond",
});
things.set(':on', true);

Turn on LED on D6

const things = iotdb.connect('ParticleOn', {
    pin: 'D6',
});
things.set(':on', true);

Turn the LED on A4 to 50% brightness

const things = iotdb.connect('ParticleValuePercent', {
    pin: 'A4',
});
things.set(':value', 50, iotdb.as.percent());

Models

See the models folder, particularly the .iotql files

• ParticleOn
• ParticleOpen
• ParticleValueBoolean
• ParticleValueUnit
• ParticleValuePercent
• ParticleSensorBoolean
• ParticleSensorUnit
• ParticleSensorPercent