FAQs

All of the questions answered on this page are listened in the table of contents on the right. Just click on your question to be taken straight to the answer.

Where do I download the Yocto image from?

This Google Drive folder contains all the released versions of the Yocto operating system.

This is a link directly to the latest version.

The latest version, and the one you should download, is named bambauer-yocto-0.1.1.zip. OS release notes can be found here.

How big does my USB drive need to be?

The USB drive you use to flash the Yocto OS image needs to have at minimum 5 GB of storage.

Using a drive with less disk space runs the risk of losing parts of the new OS when trying to install it.

If you notice that the USB is full after flashing the Yocto image, do not worry. This is intentional.

Why isn’t the app showing any available Yocto updates?

Beginning with Yocto 0.1.0, a new packaging system has been put in place that streamlines the installation process. However, support for this new system was not implemented until app version 2.5.1.

So, if you are trying to install Yocto 0.1.0 or higher, and your app version is less than 2.5.1, you will need to upgrade the app to the latest version before you can install Yocto.

Why did the app fail to install Yocto?

NOTE: this fix only applies to Yocto versions 0.1.0 and above.

If you are trying to install a new version of the Yocto OS, and the app says that it failed to install properly, then the likely culprit is that the device’s serial number cannot be found anywhere in the filesystem.

The serial number is necessary because it tells the updater what hardware features the display has so that the updater knows how to set up the new OS.

The scripts in the updater that gets installed from the app search in two files where the serial number might be found. If it fails to find either one then the update fails altogether, which is likely what you are seeing.

If this happens, please contact support so that they can perform the following steps to fix the problem:

SSH into the modem of the device.

Run the following commands, where xxxxxxxx is the serial number of the device:

# Make root partition writable
mount -o remount,rw /
# Save serial number to the proper file
echo "xxxxxxxx" > /etc/mrs.conf

Retry the Yocto update from the app.

How do I tell if the OS update worked?

There are many differences between Buildroot and Yocto that can be tested to see if the update worked. See this page for details.

Also, starting with Yocto 0.0.7, the update scripts will create an output.log file on your USB. You can check the output there to verify the update succeeded.

Why aren’t USB app updates showing up anymore?

First, make sure you’ve downloaded the .deb package, not the .ipk package. The new OS requires a different package format.

Also, make sure the package is located in the updates/all folder on the USB.

If your app version is older than 2.2.1, and new app updates aren’t loading in the Update screen, then it’s possible that your USB isn’t partitioned correctly for the app to recognize it. Follow these steps to partition it.

Why does my IP address keep changing?

On Buildroot, your device would retain a static IP address. It would still have the same address even after cycling power.

However, Yocto does not have this behavior; the display’s IP address will change on every power cycle. See the release notes for Yocto 0.0.2.

These changing IP addresses are known as dynamic addresses. It’s a common practice used by cellular companies for effective management. Dynamic addressing also provides a security benefit since the device’s network connection is now a moving target.

Getting the IP address of the display is pretty easy. Either go to Menu > Diagnostics > Network in the app and view it there, or use the command line.

How do I manually partition my USB drive?

If the app isn’t recognizing your USB, one possible cause is if the USB is incorrectly partitioned.

To partition it with fdisk, go through these steps:

First, determine the device identifier/letter by running lsblk. We’ll use X as a placeholder, but the value will be either 1 or 2.
Umount the USB drive.
Terminal window
```
umount /dev/sdaX
```
Run the fdisk utilities. This will open a new shell, from which you can run commands from the fdisk suite.
Terminal window
```
fdisk /dev/sdaX
# Output should be something like:
# Welcome to fdisk...
# Command (m for help):
```
Run p to read the current partition table.
Run d to delete any pre-existing partitions. There shouldn’t be any, this is just a precaution.
Run n to create a new partition.
Press Enter four times to select all the default configs for the new partition.
If it asks if you want to remove the signature, select no.
Run w to save changes and exit.
Finally, reload the display’s partition table:
Terminal window
```
partx -u /dev/sda1
```

How do I manually reflash the bootloader?

In Yocto 0.1.0 a new bootloader system was introduced, where different displays require different bootloaders based on their memory configuration.

In some instances it may be beneficial to manually reflash the bootloader of a device. For example, if you had previously updated to an older version of Yocto but want to make sure you have the right bootloader now, you can manually flash just the bootloader.

Here are the steps for doing so:

Plug a USB containing the latest Yocto image into the display.
- The steps for flashing a USB are here.

Use the following command to flash the bootloader:

# Use lsblk to verify the USB mount location. Here I am using /run/media/sda1.
cd /run/media/sda1
# Replace <serial-number> with the serial number of the device.
bash =bootloaders/flash-new-mrs-bootloader.sh "bootloaders" "yocto" "3" "<serial-number>" "no" "/rw_data/opt/BambauerPump/bin/bootloader-ddr-config.txt"

Verify that the script runs successfully. Look for something like SUCCESS: flashed new bootloader. in the output.
Power cycle the display to apply the update.