Welcome to the BLOCKS SDK documentation.

Here you will find all the information required to start creating BLOCKS applications. A brief summary of the main sections is below.

Downloading the SDK

This section describes how to obtain the SDK source code, either via the JUCE framework or The standalone BLOCKS SDK.

Connecting BLOCKS

Lightpad and Control Blocks communicate with a computer over USB-C or Bluetooth, and communicate with each other via magnetic connections on their sides. This section contains instructions for configuring your setup so that all the components can communicate with each other.

Discovering BLOCKS

Once you have connected your device to your computer you need to be able to discover it from your application. This section outlines the procedure for Lightpad and Control Block discovery and provides some simple example code which monitors for new connections.

Getting touch events

This section explains how to capture touch events from a compatible device and, building on the Discovering BLOCKS section, displays some example code.

Getting control button events

Lightpad and Control Blocks have control buttons, either a mode button on their side or labelled buttons on top, and this section shows you how to obtain button pressed and button released events.

Controlling LED grids

This section explains how to control the LED grid on a Lightpad.

The LittleFoot Language

Advanced SDK users can specify specialised programs to run on Lightpad Blocks. These programs must be written in the LittleFoot language, which is described in this section.

Controlling LED strips

Control Blocks have a strip of lights running along one side and this section provides instructions for controling the individual LEDs.

Controlling control buttons

As well as providing button pressed and button released events, control buttons also have LEDs. This section explains how to change the colour of different buttons.

The standalone BLOCKS SDK

The easiest way to get started using the SDK is via the JUCE framework, but if you want to integrate BLOCKS functionality into your existing application then it may be more convenient to use The standalone BLOCKS SDK. This section gives an overview of building and using the BLOCKS SDK as a library.