Skip to content
Bambauer Docs

Update Guide

Starting with Yocto OS version 0.0.5, updates can be performed from Buildroot to Yocto and from Yocto to Yocto.

This allows for users who upgraded their Buildroot system to an older version of Yocto to still have easy access to the latest changes. Note that newer versions will install correctly on top of any older versions, regardless of whether the older version was capable of Yocto-to-Yocto updates.

No additional steps are required for Yocto-to-Yocto updates. Simply flash the image to your USB and the scripts in the app and image will do the rest.

Install Latest Yocto OS Updater

Section titled “Install Latest Yocto OS Updater”

The commands for starting the update to the new Yocto OS are contained in a special package that can be installed from the app like a regular software update. This makes the process much more familiar for the user.

This half of the process generally follows the normal procedure for updating to a new software version.

NOTE: app version 3.x.x implements a serial number validation process for Yocto updates. You will only need to follow the serial number-related steps in the guide if you are using one of those latest app versions.

  1. Make sure the device is powered on and the app is running.
  2. App version 3.x.x only: Navigate to the about screen (Menu > Diagnostics > About) to get the device’s serial number. You will need it to start the update.
  3. Plug the formatted USB drive containing the Yocto image into the back of the MConn display.
  4. Navigate to the software update screen (Menu > Unit Config 1 > Update).
  5. Select yocto-os x.x.x (x.x.x will be the version number) and tap the Update button.
  6. App version 3.x.x only: verify the serial number from step 2 matches the one displayed onscreen.
    • If it does not, or if no serial number is shown, tap Enter New to enter the correct serial number.
    • If it does, tap Proceed to continue with the update.
  7. Wait for the package install to complete. It should not take more than a few seconds.
    • If the install fails, see here for help.
  8. Turn the display off.

Finish Installation

Section titled “Finish Installation”

DO NOT TOUCH ANYTHING WHEN THE SCREEN GOES BLACK!!! This is when the old OS is being wiped and the new one is being installed directly from the USB.

  1. Turn the display back on. The screen will be black. This is expected and normal.
  2. The update process takes a few minutes to complete.
  3. Wait for the display’s buzzer to start beeping. This is the signal that the update is finished.
    • If you hear the lower-pitched tone, the update was a success! Power cycle the display again to begin normal operations.
    • If you hear the high-pitched tone, you may have to troubleshoot.