Skip to content
L3D Cube library for Spark.
C++ HTML JavaScript C Makefile
Branch: master
Clone or download
Pull request Compare This branch is 15 commits ahead, 11 commits behind jmptable:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
firmware
html/js-streaming
.gitignore
Doxyfile
LICENSE
README.md
makefile
spark.json
tools.mk

README.md

Spark L3D Cube Library

About

This is the official library for use with the Spark Core in the L3D Cube.

It provides 3D drawing functions for writing visual effects and utility functions for working with color. The library also takes care of communication with the LED strips making up the cube.

The API can be found in L3D.h. Further documentation can be found on the L3D Cube website.

Example Usage

Cube cube = Cube(); // 8x8x8 cube with max brightness of 50
cube.begin(); // initialize the cube

cube.background(Color(0, 0, 0)); // clear the cube
cube.sphere(4, 4, 4, 3, Color(255, 0, 0)); // draw a red sphere in the center
cube.show(); // update the LEDs to make the changes visible

Building Locally

To compile a firmware binary using a local copy of the library:

  1. Follow the instructions for compiling the Spark firmware. Make sure you can successfuly compile the firmware before continuing.
  2. Edit the FIRMWARE_DIR variable in the l3d-cube makefile to the path of the spark firmware repository on your machine.
  3. Choose an example to compile or put your own code in firmware/examples.
  4. Run make bin/<name of example>.bin to generate firmware for that example in the bin/ directory. For example, to compile examples/bit-of-everything.cpp run make bin/bit-of-everything.bin.
  5. Flash the firmware using spark flash (the Spark CLI tool) or dfu-util.
You can’t perform that action at this time.