This Hubot script uses the ParticleJS library to communicate and control your Particle Photon / Particle Core devices. The syntax was inspired by the particle cli utility.
- list
- callFunction
- getVariable
- signal
- stopSignal
- publish
- subscribe
To get a list of your claimed devices associated with your access token
user> Hubot particle list
hubot> Your devices:
hubot> dorito [123abc] (Photon) is online
hubot> Variables:
hubot> ledStatus (string)
hubot> Functions:
hubot> int led(String args)
hubot> pretzel [567def] (Core) is offline
To call a function on your device that has been uploaded to your device and registered to the Particle cloud
doc> Hubot particle call <device-id> <function> <params>
user> Hubot particle call dorito led on
hubot> Received response code 1
To retrieve a variable
doc> Hubot particle get <device-id> <variable>
user> Hubot particle get dorito ledStatus
hubot> on
To shout rainbows
doc> Hubot particle signal <device-id>
user> Hubot particle signal dorito
hubot> Signaling dorito
To stop shouting rainbows
doc> Hubot particle stop signal <device-id>
user> Hubot particle stop signal dorito
hubot> Stopped signaling dorito
See src/particle.coffee for full documentation.
In hubot project repo, run:
npm install hubot-particle --save
Then add hubot-particle to your external-scripts.json:
["hubot-particle"]You will need to set one environment variable to use this script.
export HUBOT_PARTICLE_ACCESS_TOKEN=abc123
You can get your Particle access token from the "Settings" section of Particle's Web IDE
Just send pull request or file an issue !