Software update page

Periodically, an updated set of MiRo software will be released, bringing bug fixes and/or enhanced functionality. Updates are published on the Software page of the labs website.

Some software updates will include changes only to the off-board software (the simulator, or the tools for exchanging data with your robot). However, the RELEASE NOTES may indicate that you also need to update the software and/or the firmware on your robot. If so, this page of MiRoapp will help you perform both operations.

To return to the Management page, click the red exit symbol.

Do not attempt to update your robot's software manually—use the procedure described on this page.

Current software configuration

The table shows the software currently installed on your robot. Unless something exotic has happened, you will see that you are on software channel miro2_release and on branch master. The field "Hash" identifies the installed software precisely—support may ask you for this value, in some cases.

You can only update the software if the on-board software repository is "clean" (as opposed to "modified"). If you have modified the on-board repository (under ~/mdk) you will have to revert these modifications before you can update. For this reason, we strongly recommend that you do not modify the repository. Updating your robot after modifying the repository may become impossible.

Software update

Do I need to update my robot's software?

The software revision installed on your robot is indicated next to the label "MDK" (MiRo Developer Kit). This will read R190211 on brand new MiRos (later production batches may ship with a later software revision pre-installed).

If the current software release, as shown on the Software page of the labs website, does not match this your robot's installed software, you can update it.

Procedure

  1. You only need to update the software on your robot if this is indicated in the RELEASE NOTES—if not, we recommend you do not run the update.
  2. To start the update, click on "Update Software".
  3. Please be patient—the operation can take a little time.
  4. You will receive a message indicating success, or a reason for failure.
  5. Contact support if you are unable to perform this operation.
After a successful software update, immediately restart your robot by switching off underneath, waiting for shutdown, and switching on again.

Firmware update

Do I need to update my robot's firmware?

Your robot also carries embedded software, or "firmware". Two firmware images, "P2" and "P1", are installed, and their revisions should match that of "MDK". If either or both do not, you can update the firmware.

Procedure

  1. The only time you will need to update firmware is immediately following a software update, as described above. Do not attempt to update firmware at any other time.
  2. You only need to update the firmware on your robot if this is indicated in the RELEASE NOTES—if not, we recommend you do not run the update.
  3. To start the update, click on "Program Firmware".
  4. Select "Program firmware into P2 and then P1 in sequence", unless you have been advised otherwise by a support engineer.
  5. Please be patient—the operation can take a little time.
  6. You will receive a message indicating success, or a reason for failure.
  7. Contact support if you are unable to perform this operation.
After a successful firmware update, immediately restart your robot by switching off underneath, waiting for shutdown, and switching on again.
The final field, "P1p", indicates the firmware version in the back-up controller; you do not need to update this, unless instructed to do so by support.