Arduino libraries for connecting to the Ninja API.
NinjaBlocksEthernet is a minimal library for connecting directly to the Ninja API from any board compatible with the standard Arduino Ethernet library. All up, it uses around 1K of RAM.
NinjaBlocksSerial is a streamlined version of the code that runs on the Ninja Block. This is what you want to use to connect an Arduino project to something (say a Beagle Bone or Raspberry Pi) running the Ninja Node.js Client.
For reference the NinjaBlock params are:
- token - For hacking use the virtual block token from https://a.ninja.is/hacking , there are other ways to get a token but hard to squeeze into a library for a 328.
- nodeID - This is the boards ID. Can be any 12+char string. Its used in REST so its a good idea to make it easy to remember, e.g. ARDUINOBLOCK.
- vendorID - Use 0 with the device IDs here http://ninjablocks.com/docs/device-ids and you get pretty widgets for "free". Create your own by pinging [email protected].
- deviceID - Identifies each device and maps to UI elements and properties that allow other apps to interact with your devices without knowing about them, see link above.
- guid - Think of this as port - it is used to differentiate between multiple devices of the same type.
You need a Ninja Blocks account to get tokens, signup at https://a.ninja.is
- Hit the forums http://forums.ninjablocks.com if something isn't clear.
- Copy your libraries into the Arduino IDEs library folder
- Get a virtual_block_token from https://a.ninja.is/hacking
- Use the Ninja Dashboard, REST interface, or helper libs to pissfart to your hearts content!
curl -H 'Content-Type: application/json' \\
-X 'PUT' \\
-d '{ "DA" : "Arduino REST FTW" }' \\
-i https://api.ninja.is/rest/v0/device/ARDUINOBLOCK_0_0_7000?user_access_token=YOURTOKEN
NB: A user access token is not the same as a block token, from https://a.ninja.is/hacking