Cubeio

An active meeting engagement tool designed to foster and facilitate decision-making, meaningful dialogue and equal input.

Getting Started

If this is your first time using the particle, please refer to the quickstart guide. The following instructions are written for Mac. If you are using Particle's web compiler, search for the Cubeio library under libraries.

1. Install Particle CLI

$ npm install -g particle-cli

2. Create a new project

$ particle project create

3. Add library to your project

This should create the library scaffolding necessary to import the library from within your project directory.

$ particle library add Cubeio

$ particle library view Cubeio

Usage

Once you install the library through the Particle CLI, you should be ready to go.

#include "Cubeio.h"

Cubeio mycube(D6, D1, A1,A2,A3);

Your object declaration might be constructed differently depending on the hardware. Please view the hardware revision and pinouts under /hardware. View the /examples and /src files to get detailed information about the library.

Examples

There is a pretty handy script called upload.sh inside of every example. upload.sh puts the particle device in DFU mode, compiles the cpp file, and uploads the firmware to the device. Make sure that your cube's particle is connected via USB to your computer.

$ ./examples/set-calibration/upload.sh

This script was working well before I upgraded to Catalina... For now, you can use Particle's cloud compiler, which works fine it just takes longer...

Hardware

Cubeio uses an Analog Devices ADXL325 3-axis accelerometer to calculate the roll and pitch (±5 g) of the cube, a Microchip MCP73831 Li-Polymer charge managment controller, a Worldsemi WS2812 RGB LED, a single Schmitt-Trigger inverter, and a button among other hardware components. Please view the hardware revision and pinouts under /hardware. You can use this library with any microcontroller if you are using an ADXLxxx chip on its own. You may set the analog pins to your microcontroller and it will work the same. This is intended for the cubeio hardware, so there are no default values set in the Cubeio object() object. This library will work for this device from Adafruit.

Contribution

I don't think that the Particle CLI allows branching/merging of libraries from multiple users. This may change, so for now you are welcome to submit pull requests and i will publish the changes.