Skip to content

Jewelbots/arduino-library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

Jewelbots Library for Arduino IDE Development

This library is designed to make coding the Jewelbots for Arduino easier for users. Installation instructions are below. If you would like to contribute, pull requests are welcome. Documentation is here and in the Wiki. Please feel free to ask us questions in Slack by signing up here.

Requirements

  1. A Jewelbot device!
  2. PC with one of the following OS:
  • Mac OSX 10.11.4 (current tested version), OSX 10.9.x, 10.10.x should also work.
  • Windows 10 (current tested version), Windows 7 and 8.x should also work.
  1. Arduino IDE version 1.6.9 (current tested version).
  2. A Micro-B USB cable.

Getting Started

Install Board Package Add-on

  1. Get Arduino IDE from Arduino website and install it to your PC.
  2. Start the IDE and from the Menu, click "Preference...", add the following line to "Additional Boards Manager URLs"
  https://jewelbots.github.io/arduino-library/package_jewelbots_index.json  
  1. Open the Boards Manager from the Menu: Tools -> Board "..." -> Boards Manager.
  2. Search for "Jewelbots", select the "Jewelbots Arduino Library" and click "Install".
  3. Wait for the library to finish installation and click "Close".
  4. Go to Tools -> Board "..." dropdown and select the "JWB nRF51822" board.
  5. Make sure the serial port is selected from Tools -> Port.
  6. Put your Jewelbots device in coding mode by holding down the button for two seconds. Either the charging light will go out or the device will flash purple depending on what version of the firmware you have. Coding mode lasts for two minutes.
  7. Test the "hello world" sketch below:
#include "JWB_API.h"

void setup() {
  // put your setup code here, to run once:
  breathe_all(1);
}

void loop() {
  // put your main code here, to run repeatedly:
  Animation animation;
  animation.jewelbots_logo();
}

void button_press() {
  // put code here to run whenever the Magic Button is pressed:
  Animation animation;
  animation.breathe_single_color(BLUE);
}

If you would like to contribute to this library, you can get started in the Wiki