Skip to main content

Firmware Upgrades

Most of the time, the Instruct3D team should be able to perform a remote firmware upgrade via the internet. However, there are occasions (such as on air-gapped devices) that it may be necessary to manually upgrade the firmware running on your device.

Download firmware​

You will likely be sent a secure link (via email) to download the latest firmware as a .zip file. The file should be between 1.0GB and 2.0GB. For example: vertx-firmware-1.5.2.zip

Copy firmware to the device​

Copy the firmware onto a USB stick and insert the USB stick into one of multiple USB ports on the side of the 'core unit'.

Open the terminal​

Access the terminal of the device by following these steps:

  • Physically connect to the device using a keyboard, mouse and monitor.
  • Escape out of the dashboard by pressing Alt + F4 on your keyboard.
  • Open a terminal instance by clicking on the icon in the toolbar at the top of the screen.

Unzip the firmware​

Run the following command to list attached storage devices:

lsblk

Identify the mount point of your USB stick. For example: /mount/instruct3d/my_usb.

Change directory to your USB stick and verify the firmware is there:

cd /mount/instruct3d/my_usb
ls

Run the following command (changing the file/directory name as appropriate) to unzip the firmware:

unzip vertx-firmware-1.5.2.zip -d vertx-firmware-1.5.2

Install the firmware​

Change directory to the extracted firmware:

cd vertx-firmware-1.5.2

Make the install script executable:

chmod +x ./install.sh

Execute the install script:

./install.sh

The USB stick can now be safely removed.

Check device version​

Navigate to the Settings page on the dashboard and make sure the correct software version is listed. This verifies the upgrade was successful.