This file contains the skeleton of a common plugin for the Netbeast dashboard. You can use it, in order to give support for a device through the dashboard.
We have already developed plugins to control devices like:
- Belkin WeMo
- Philips Hue
- Lifx
- Sonos
- Chromecast
- Parrot Flower Power
- ...
I encourage you to help us growing this list, by adding new devices plugins
The plugins are installed at the dashboard like applications so, you should install it for testing. You can do it through:
- The user interface of the dashboard
- Command line, by copying your folder to dashboard/.sandbox/NAME_PLUGIN
All the physical devices available are include on the resources database. You can check the discovered devices by searching the database on
sqlite3 dashboard/.database.sqlite
Once you are in, check the following table:
select * from resources;
All the topics declared have a defined structured, that you can check on the Docs.
If you are going to work on this topic, please follow this structures:
- switch & bridge
- power:
true || false
- power:
- lights
- power:
true || false
- hue:
0..360
- saturation:
0..100
- brightness:
0..100
- color:
{r: 0, g: 0, b: 0} || #FF13AA
- power:
- music & video
- volume:
0..100
- status:
play || pause || stop || mute || unmute || info
- track:
must be the url of the song/video
- volume:
- temperature
ÂēC
- humidity
0..100
- luminosity
photons per square meter
- battery
0..100
If you need to define a new topic, you should think in a general structure that can be used for all devices with the same topic.
Topics are: lights, sound, temperature, switch, camera, video, lock, etc...
Example. If we are working with music:
- GET method will only accept volume, status and track as parameters
- POST method will accept the same parameters.