Jetty Firmware - Install Guide

Install Guide > > > Setup

The Jetty Firmware referenced in this manual can be found on Thingiverse Thing 17855


This document provides directions on how to install versions 3.5 and later of Jetty Firmware on a Thing-o-Matic, Cupcake, or other RepRaps using either Gen 4 or Gen 3 electronics. For versions prior to v3.5, please see Jetty Firmware - Setup Guide v3.4.

This document assumes use of ReplicatorG 39 or later. However, earlier versions of ReplicatorG may be used to install the Jetty Firmware. Using versions prior to 29r2 is not recommended.

Machine Requirements

The Jetty Firmware described here runs only on Gen 4 and Gen 3 electronics.

  • Thing-o-Matics: a Makerbot v2.X motherboard, a Makerbot v3.6 Extruder Controller, Makerbot v3.3 Stepper Drivers, a stepper-based extruder, and an Arduino Mega or Arduino Mega 2560. Other than the extruder, these are all "stock" Thing-o-Matic electronics; i.e., Gen 4 electronics. Stepper-based extruders include the Mk6+, Mk7, and Mk8. Other electronics and extruders may or may not work with the Jetty Firmware.
  • Cupcakes with Gen 4 electronics: As per the above.
  • Cupcakes with Gen 3 electronics: A 3G5D Shield or the "Ugly Cable Hack" is required in order to control a stepper-based extruder. Additionally, the remaining complement of Gen 3 electronics: RepRap Motherboard v1.2, Plastruder Extruder Controller, and v2.3 or later stepper drivers.

Volumetric 5D (only for those using it)

Some users are using Volumetric 5D settings in ReplicatorG: the Skeinforge "Dimension" plugin combined with the "makerbot4g" driver. If you have changed your settings previously to Volumetric 5D and are experiencing problems, it’s suggested that you disable the Dimension plugin, switch the driver back to "makerbot4ga", and switch your extruder back to the normal direction via ReplicatorG's Machine Onboard Preferences window (i.e., not reversed). After making this reversion, check that you can still print before proceeding.

If you haven’t configured Volumetric 5D or don’t know what it is, then ignore this. Note that 5D is not the same as the 3G5D Shield.

Step 1: Install the firmware

Before proceeding you should know the motherboard type you have. For Gen 4 electronics (Thing-o-Matics, or upgraded Cupcakes), this will be an Arduino Mega or Arduino Mega 2560 and will appear in ReplicatorG's Firmware Upgrade window as "MakerBot Motherboard v2.X (Gen4)" or "MakerBot Motherboard v2.X (Gen4) with Mega 2560". For Gen 3 electronics (Cupcakes), it'll be a RepRap Motherboard v1.X and will appear in ReplicatorG as "RepRap Motherboard v1.X (Gen3)".

If you don’t know the board type, stop now and inspect your bot to find out the type of board you have installed. For Thing-o-Matics, you will need to open up the bottom to inspect the board. You may even have to remove the Gen 4 shield (Motherboard v2.X) from the Arduino board. If that is the case, then carefully remove it, lifting straight up. When re-attaching it, be careful to not bend any of the pins.

Updating the Extruder Controller firmware

The Jetty Firmware is a derivative of version 3.1 of the motherboard firmware. Consequently, you must first ensure that your Thing-o-Matic's Extruder Controller (EC) is updated to v3.1 firmware. You can do this with ReplicatorG as per the directions found at

Thing-o-Matic EC

Thing-o-Matic owners should complete this step before beginning the next step.

This step is not necessary for Cupcakes using Gen 3 electronics and the 3G5D shield. However, directions on upgrading your Plastruder firmware may be found at:

Plastruder Firmware Update

Installing the Jetty Firmware

Connect your bot via USB, and then power your bot on. Check the "Connection (Serial Port)" sub-menu of ReplicatorG's "Machine" menu. Make sure that you see the USB port for your bot listed. If it does not appear, then select the "Rescan serial ports" item of that sub-menu. You cannot proceed until your bot's serial port appears.

From ReplicatorG select the "Upload New Firmware" sub-menu of the “Machine” menu. You’ll see different boards listed. The suitable choice will be one of,

  1. MakerBot Motherboard v2.X (Gen4) — Use for the Arduino Mega
  2. MakerBot Motherboard v2.X (Gen4) with Mega 2560
  3. RepRap Motherboard v1.X (Gen3) — Use for Cupcakes with Gen3 electronics

Select the correct one for your bot and then click "Next". Do not select "3G 5D Shield for 3G Hardware": that is not Jetty Firmware branch and is an older branch of MBI's 3.0 firmware.

You should then see firmware listed. In the following picture you see 3.5
as well as earlier versions; however, select the latest version.


Click "Next" and then select the USB port your bot is connected to (it’s normally the first item). Again, click "Next":


Now press the reset button on your bot a fraction of a second before you click the “Upload” button on your computer screen. You may have to try this a few times, but when you have it correct, you’ll see the debug light rapidly flash whilst the upload takes place.

When the upload has finished, restart ReplicatorG and ensure that you can connect to your bot. The connect should happen automatically if you had previously checked the "Automatically connect to machine at startup" box in ReplicatorG's preference window.

Note some machines may need the bot to be powered off to upgrade, some require electronics to be disconnected. This is a standard upgrade: whatever worked last time you installed firmware, is the same you should do here.

Step 2: Let your bot reboot

Once the firmware has been uploaded, your bot should perform a software reset, thereby rebooting itself. Connect to your bot over the USB cable from ReplicatorG. You should see in the activity log window at the bottom of ReplicatorG that the connection is successful and the reported firmware is the new version. There will also be a report of the Extruder Controller firmware. The Extruder Controller firmware will still be an older version such as 3.1. That is expected and as it should be.

Step 3: Cupcake owners only

If you are using a Cupcake and you have not previously installed the accelerated Cupcake machine profiles for ReplicatorG, then please follow the directions at Step 2: Speeding up your machine driver (.xml file). You will want to install the two 3G5D XML files described there. Thing-o-Matic owners do not need to do this step as ReplicatorG includes the necessary machine profiles for Thing-o-Matics.

Step 4: Setup

You're now ready to setup ReplicatorG and your Makerbot for accelerated printing. Proceed to the Setup Guide.

Install Guide > > > Setup

Unless otherwise stated, the content of this page is licensed under GNU Free Documentation License.