Getting Started

Get your SwiftIO board? Where do I start? Let's start with the hello world project - LED blink.

Here is a simple instruction manual about the whole process:

Well, please follow us step-by-step. You will know how to run the code on your SwiftIO board, and thus get prepared for more exciting projects later.

Step 1: Download and install the MadMachine IDE

MadMachine IDE is what you use to write and download the code. It provides you with an easy way to code, and you no longer need to face with all the complicated stuffs.

If you're an experienced programmer, you may edit your code wherever you like, and then just use the IDE to download your code to board.

The IDE is now available on Windows and Mac. You'll find the latest software package here. Select the appropriate version according to your operating system.

Double click the downloaded file and follow the installation instructions.

If you meet with any problem, please refer to FAQ.

When you first open up the MadMachine IDE, it appears like this:

Now you just begin to play with it, it's empty on the right side. As you try more projects and explore more, it will be filled with all kinds of projects.

Step 2: Coding in the IDE

It's time to start your first project in the IDE. It's pretty simple.

First of all, create a new project.

We call it "Blink". Just try to choose a descriptive name as you like for the project.

Then click Create.

Here is a simple example for your reference:

import SwiftIO
let green = DigitalOut(Id.GREEN)
while true {
sleep(ms: 1000)
sleep(ms: 1000)

You could also see some example codes in the IDE by clicking on the button on the bottom left corner.

Choose GettingStarted > Blink. The code will show up in a new window.

Step 3: Prepare SD card and confirm USB connection

Make sure that you have inserted a SD card into the slot.

Connect your SwiftIO board to your computer through the Download port using a Micro-USB cable.

Press the DOWNLOAD button. SwiftIO will mount the SD card as a USB Flash Drive on your computer.

Note: Bad quality USB cable or some third-party USB hub may cause connection failure.

The onboard RGB LED will show the current status of the USB connection:

LED State





USB communication failed

USB connection established


Slow flashing

Fail to verify file swiftio.bin



Fast flashing

Fail to open file swiftio.bin

Detecting USB connection

Detecting SD card

Step 4: Build your code and download it to the board

Once the SD card is mounted successfully, an icon will appear in the status bar.

Click Download button.

The IDE begins to build your project and then download it to the board if there is no error.

After a few seconds, you will see the USB flash drive is removed automatically.

And then, the onboard LED will blink✨.

Btw, you can also watch this tutorial video to get more info.