Downloading the source files

Downloading the source files

First things first - open a new tab on this page - https://github.com/CircuitMess.

You're going to need it a lot while modifying your firmware since there are a lot of materials to learn from. 

CircuitMess GitHub repository - loads of cool stuff!

CircuitMess GitHub repository - loads of cool stuff!

For start, we'll be looking at these two repositories - CircuitMess-Ringo and CircuitMess-Ringo-firmware

Two main repositories we're going to use

Two main repositories we're going to use

First, you're going to open CircuitMess-Ringo-firmware.

It is where pretty much all of the firmware files are located and you'll be editing those. 

When you open the repository, it looks something like this.

CircuitMess Ringo firmware repository

CircuitMess Ringo firmware repository

Download the ZIP containing all of the files. You can also use GitHub Desktop if you're familiar with that piece of software.

GitHub Dekstop basically allows you to manipulate with GitHub repositories much easier and faster, but we'll not be covering it in this tutorial. 

Once you've downloaded the ZIP, unpack all of the files into the project folder. 

Replace all of the files that are matching.

Your project folder should look something like this.

VS Code project folder after the insertion of Ringo firmware files

VS Code project folder after the insertion of Ringo firmware files

One of the most important files in this folder is platformio.ini, which contains the settings for the board. 

Open it up and make sure that the parameters inside are set to the following:




If not, copy the lines above and paste it inside the file.

The next step is to download the CircuitMess-Ringo repository.

CircuitMess Ringo repository

CircuitMess Ringo repository

Download it as a ZIP (or by using the GitHub Desktop).

When unzipping it, make sure you place it inside the lib > MAKERphone folder of the main project folder.

Project folder before copying CircuitMess Ringo repository

Project folder before copying CircuitMess Ringo repository

Your project folder should now look something like this.

Project folder after copying CircuitMess Ringo repository

Project folder after copying CircuitMess Ringo repository

Now that everything is placed in the proper directories, it's time to compile and upload the firmware!