Skip to main content

Bantam Tools NextDraw™ Firmware

The Bantam Tools NextDraw™ software requires firmware version 3.0.2 or newer.

 

General information

This page gives instructions on updating the EBB (EiBotBoard) firmware, which may be found on your Bantam Tools NextDraw™, as well as on AxiDraw, EggBot, and WaterColorBot machines manufactured by Evil Mad Scientist, and any other machine using the EBB as its controller.

In most cases when the firmware is compatible with the current version of the software that you are using, no update is necessary. However, there may be cases where updating allows you to take advantage of bug fixes and new features in the software.

 

Important caution 1: Updating your firmware usually resets the EBB to its default state. If you are using a custom USB "nickname", for example with the NextDraw Naming utility, that nickname will be reset (erased) when updating firmware.

Important caution 2: If you are experiencing difficulty connecting to your machine over USB, then please do not update its firmware until those issues are resolved. Updating firmware will not resolve connection issues, but connection issues can cause firmware updates to fail.

 

Updater applications for Mac and Windows 

For users on Mac and Windows, the recommended way to update is to run one of our ready-built applications that updates the firmware to the latest major release.

As of this writing, that latest major release is version 3.0.3, and firmware updaters are available to download here for Mac and here for Windows.

For either platform, connect the EBB to your computer via USB. Close any program that may be trying to communicate with the EBB then run the application, which will automatically update the firmware.

For Linux, or if you need to update to a different specific version of the firmware, please follow the "Manual" updating procedures in the next section.


"Manual" updating with mphidflash

Besides the automatic updater applications, there are three different tools you can use to update your EBB firmware - a hardware programmer (like the PICKit2 from Microchip), Microchip's HID Bootloader application (which only runs under Windows), or the command-line mphidflash application.

Because one of the primary goals of the EBB ecosystem is to support all three OS platforms (Windows, Linux, macOS), this page will discuss the use of mphidflash. This application is cross platform and works identically on all three operating systems.

You will need to be comfortable with a very small amount of command line work to use this tool.

Note for Linux users: The Linux version of mphidflash was developed and tested under Ubuntu. Other distributions may have additional dependencies. Additionally, this method requires an "x86" type architecture; it does not currently run on Raspberry Pi.

 

Procedure 

  • Download the latest version of mphidflash, version 1.4 or newer. It can be found in the mphidflash repository. There is a single zip archive download that has all of the source code plus a directory (or set of directories) with executables in them, one for each OS. Unzip the archive.
  • Some hints about installing this on Linux can be found here.
  • Open a command shell (terminal window) and navigate (cd) to the directory with the mphidflash executable for your OS. (For Windows users, do Start->Run then type in cmd and click OK.)
  • To test that the software is ready and working, try it out as follows:

For Linux or Mac OS use:

./mphidflash -h

For Windows OS use:

mphidflash -h

You should see the help text for mphidflash. This shows that you can run the application properly.

  • Download the EBB firmware.
    • Easy link here.
    • To "manually" locate an EBB firmware version, look in the Repository under "EBB_Firmware." Download the repository contents by clicking the "Download ZIP" link. Identify the particular EBB firmware hex file that you want to program onto your board. The EiBotBoard Firmware ZIP archive contains several slightly different versions for some builds. Unless you have a specific reason to do otherwise, use the versions for "EBB 1.3 and newer".
  • Copy the hex file to the folder that contains the mphidflash exectuable for your OS.
  • Connect your machine (or bare EBB) to the PC with a USB cable. Do not plug in the power adapter; leave the machine or EBB connected by USB alone.
  • Put your EBB in bootloader mode by doing one of the following:
    • Press the PRG (pause) button and hold it down while you press and release the RST (reset) button. Then release the PRG (pause) button. On the Bantam Tools NextDraw™, the reset button is the recessed button directly above the pause button; you may need a pen tip or similar implement to press it.
    • Unplug USB, press and hold the PRG (pause) button, insert USB, and then release the PRG (pause) button.
    • If you are using the Inkscape based Bantam Tools NextDraw™ software, use the "Enter Bootloader mode" option from the Utility tab.
    • If you are using the Bantam Tools NextDraw™ CLI, use the bootload option.
  • Confirm that your EBB is in bootload mode by looking at the red and green LEDs by the USB connector. They should be blinking back and forth in a heartbeat-like rhythmic pattern.
  • From the command line, for Linux or Mac OS use:

./mphidflash -w EBF_v302_BL.unified.hex -r

For Windows OS use:

mphidflash -w EBF_v302_BL.unified.hex -r

Where "EBF_v302_BL.unified.hex" is the name of the hex file that you want to program.

  • Confirm that you get a long series of dots "." on the command line, and that there are no errors. Your EBB will reset itself at the end of the programming process (that's what the -r does).
  • On Windows, if you have an older firmware and are updating to a relatively newer one, Windows may ask you to find a driver for the device when the EBB resets. You can install the proper windows "INF" driver by downloading and running the EggBot installer for Windows, which Installs the USB driver (the "UBW" driver) from GitHub. If Windows says the drivers are unsigned and do you want to continue, allow it to install them.
  • After you've updated your EBB with fresh firmware, you can check to see that the new firmware was successfully programmed by opening Inkscape, going to Extensions > Bantam Tools NextDraw, then select the Options > Configuration tab, and click Apply. In the little dialog box that pops up when this process is finished you should see something like "firmware Version 3.0.2" or your new version number.

 

Was this article helpful?