Types of blocks

There are a total of nine block types in CB. Each of them is represented by their own color. Every block translates to code, which is then compiled and uploaded to the phone, just like on every Arduino based platform.

Pressing on every block type will open a section from which you can drag-and-drop those blocks into the drawing area.
Also, pressing on ‘More’ will open even more blocks that are not so commonly used.
There are two main functions of every Arduino code – void setup() and void loop().
Everything that goes into the void setup() the function will run only once. It is primarily used for starting the software, initializing and declaring variables and running functions that only have to run once (ex. Intro screen in a video game).
The void loop() is where everything else takes place. It basically runs every bit of code inside it over and over again (speed depends on the device – just imagine it’s ultra-fast!). It should pretty much follow the refresh rate of the screen and make the program do things accordingly.
Every block you place automatically goes into the void loop() function.
If you wish to put something in the void setup(), you have to drag the main block from Functions and place your blocks inside as you wish, but more on that a little bit later.

Elliptical blocks

Elliptical blocks represent variables. Whether we’re talking about integers, strings or other variable types (other than boolean), they can all be recognized by the same shape.

Also, larger blocks that have elliptical shape return either integer or float values.

When ever you find circular “holes” inside some blocks, that is the place where variables can be inserted. It’s most commonly found in comparison or action blocks.

Triangular blocks

Boolean variables are represented by triangular blocks.

Both variables (true and false), as well as functions that return boolean values, have the same shape.

Regardless of color, each of these blocks returns either true or false.
Triangular “holes” require boolean blocks to be inserted.

Building blocks

Everything else is basically a building block. Those are functions that have no return value (they return null). Both elliptical and triangular blocks first have to be placed inside of the building blocks in order to act as part of the program.

They have a specific “puzzle” shape and can be stacked inside each other.

The main building block is located inside the ‘Functions’ section.
It basically gives you two main building blocks sections.
Everything that is placed inside Arduino run first goes into void setup() and everything that is placed inside Arduino loop forever goes into a void loop().

Inserting blocks

Now, this is the main part.

The whole point of blocks-like IDE is connecting blocks and placing them one inside another.

It is all done by simple drag-and-drop action.

Here is an example of a program that will set the variable Var to 1 and then increase that variable while it is smaller than 10.

At the end of the program, Var will be 10.

This is just a simple example and block-building will be further explained in the following chapters.