Particle (formally Spark)


Repository| Issues

Both the Particle Core and Particle Photon contain a Wi-Fi connected microcontroller. Once it connects to a Wi-Fi network, it automatically connects with a central server (the "Particle Cloud") and stays connected so it can be controlled from external systems, such as a Cylon.js program.

For more info about the Particle platform, click here.

How to Install

Install the module with:

$ npm install cylon cylon-spark

You'll need your access_token and device_id to push new software to yourSpark, and you can get both of these from Spark's Build tool.

  • access_token: In the Build tool, click on the Settings cog in the bottom-left corner to find your access token.
  • device_id: After you have your Spark Core registered to your account through the Tinker app, click on the Cores section (just above the Settings cog) on the Build tool. Then, click on the arrow next to your core's name to get its device ID.

Installing Firmware On Your Spark Core

You will need to install the appropriate firmware on your Spark Core to use it from Cylon.js.

One option is to use the Tinker software, which has the same API as the "default.cpp" code that is included with the Gort CLI (http://gort.io). This routes all of your calls thru the Spark cloud, with is appropriate for communicating with Spark devices in a remote location.

Another option is to use the VoodooSpark firmware, which has its own binary API. This discovers your device thru the Spark cloud, and then routes all of your calls directly to the Spark Core device. This is appropriate for communicating with Spark devices on the same local subnet as the computer that you wish to control them from.

For more information on how to program your Spark, please see Spark's examples.

For more information about VoodooSpark, click here.

How to Use

Spark using Tinker API:

var Cylon = require('cylon');

// Initialize the robot
Cylon.robot({
  connections: {
    spark: { adaptor: 'spark', accessToken: 'XYZPDQ123', deviceId: '123ABC456' }
  },

  devices: {
    led: { driver: 'led', pin: 'D0'}
  },

  work: function(my) {
    every((1).second(), function() {my.led.toggle()});
  }
}).start();

Spark using VoodooSpark API:

var Cylon = require('cylon');

// Initialize the robot
Cylon.robot({
  connections: {
    voodoospark: {
      adaptor: 'voodoospark',
      accessToken: 'XYZPDQ123',
      deviceId: '123ABC456',
      module: 'cylon-spark'
    }
  },

  devices: {
    led: { driver: 'led', pin: 'D0' }
  },

  work: function(my) {
    every((1).second(), function() {my.led.toggle()});
  }
}).start();

How to Connect

The setup process for the Spark core is fully explained by their docs, and requires only an active internet connection with a WiFi access point.

Once your Spark is connected, you can get the accessToken and deviceId necessary to communicate with it from Cylon.

Drivers

Available drivers for the Particle platform are listed below: