Smoothieboard Beta Guide

The ( current/jan-2013 ) beta status of the first batch of Smoothieboards leads to new users having much of the same questions, which are not really answered in the documentation.

This is a guide for new users of Smoothieboard in general, with specific information about whatever is specific to this first beta batch.


When unpacking your Smoothieboard, you’ll see it looking something much like this:


As you can see, it lacks most of its connectors. This is so you have the choice to solder whatever connectors is best for your particular setup. This also means you’ll have to solder them.


A great way to see what connector options you have for each connection is to look at this picture ( or click on it ):


You can find links to buy those connectors on the Smoothieboard page, in the “border connectors” section.

The cheapest option is simply to use 2.54mm pins for everything ( except power ), but your choice really depends at what is at the end of the wires on your printer: screw terminals are a more “universal” option.

To run a 3D printer with Smoothie, you’ll need to solder connectors to the following:

Once the connectors are soldered, you can start actually doing stuff with your Smoothieboard:

MicroSD card

Smoothieboard doesn’t come with a microSD card, but it needs one.

If you don’t already have one, you want to get one ( they are a few bucks on eBay ).

If you already have one, you are faced with a choice: the bootloader that was flashed on the beta boards is a bit old, and does not support SDHC cards.

This means that if your card is more than 2GB in size, it won’t be able to use it. So if your microSD card is bigger than 2GB, you can either:


Now that you have a bootloader installed, you can update the firmware.

You very probably want to do this. The firmware you have corresponds to the “master” branch in the GitHub repo. While it works for most things, it’s quite old, and the USB stuff will probably give you trouble. It also does not support SDHC cards.

The edge branch on the other hand ( ) has all of the latest stuff, including SDHC support, and the new USB stack ( and a whole bunch of added features ).

Getting and compiling and flashing Smoothie is pretty well documented, just remember you want the “edge” branch:

Once the firmware is flashed onto the board ( you know it is because the firmware file is renamed on the SD card ), we move on to config:


Smoothie gets its configuration from a small file named “config” that you drop in the root of the SD card.

You can find information on the page configuring-smoothie.

Once you have copied the file under the name “config” on the SD card, you can move on.

I hate Windows

Seriously. If you are unfortunate enough to be a Windows user, you want to go read this page: windows-drivers to get USB to work on your Smoothieboard.

If something does not work, you can contact the team via IRC.

If you are a Linux or Mac user, don’t worry about a thing, it’ll all work out of the box.

Talking to Smoothie

Now Smoothie is flashed on your Smoothieboard, and your computer is ready to talk to it.

Plug Smoothieboard in using the USB-mini cable.

You will see a USB mass-storage device ( much like USB flash drives ) pop up. It shows you the contents of the microSD card. You can use it at any time to access/modify files, drop G-code files in etc.

Now you will want to install a serial terminal program to talk to your Smoothieboard.

You can also simply use Pronterface if you want a more “control-oriented” interface and start printing right away.

Now use your program of choice to talk to Smoothie. The interface will be named:

Once the serial terminal is up and running resetting the board should display smoothie ok in the terminal.

You are now connected to Smoothie and you can start talking to it. A few commands:

Have fun!