Upgrading Motor Controller Firmware

Before you can upgrade firmware, your robot needs to be connected to the internet. See Connecting the Robot to Your Network

We upgrade firmware using a tool that will by default install the latest released firmware. If a newer version is available it will require manual version entry seen in the Version column of the table below.

Sometimes improvements to our motor controller firmware, in this case v35 or later, make it necessary to first upgrade the linux host side software before installing the newest firmware. Our host side software supports prior firmware versions. To update host software use a process we call ‘Linux Host Software Update’ seen on this page.

The table below shows the default and latest available versions of firmware as well as the expected LED blink rates which is handy to visually check. It is best to count the time of 2 blinks then divide by 2 for more accuracy.

Version Rate Description
v28 6.0 sec Production shipment version that does wheel movement check on startup. Users should do a firmware upgrade from this very old version
v32 5.0 sec Latest production firmware used in 2019. This is default if no version is entered. Supported by any host side software
v35 4.0 sec Beta firmware with double resolution wheel encoders and many improvements. Requires host side software update done after 11/10/2019

To see more details about our firmware as well as our hardware revisions for the motor controller please view this page.

Firmware Installation

To install any firmware first log into the Raspberry Pi:

ssh ubuntu@YOURROBOT.local

all of the following commands are to be run on the Pi.

Stop all running ROS nodes:

sudo systemctl stop magni-base

Run the firmware upgrade utility:

rosrun ubiquity_motor

After entering your email address, you should receive an access token. Enter this token and either accept the default version which is seen in the above table or specify a different version perhaps for latest features. The download will start and upgrade the motor controller board.

Should any problems show up you are always allowed to do this firmware upgrade again to select a version you know was best for your needs.

The process should take less than a minute; make sure that power is not interrupted during this process. Otherwise your robot may become inoperable and require factory servicing.

When done, reboot the robot with sudo reboot.

You are now on the latest version of the firmware.