This page describes how to update GridOS on existing Grid devices.

Raspberry PI4

Requirements

• At least

  GridOS

  v0

  v.

  8.5 for arm64: https://lexa.blob.core.windows.net/grid-os/gridos.0.8.5.arm64.img.xz

  0.9.0+. The over-the-air OS update is supported from this version and higher

  , for RPI4

  . Lower versions will not have OTA OS update support

• Latest omg utility. If you hav existing omg utility installed, do omg update , or npm install -g @ombori/ga-cli

Instructions

• flash the minimum required RPI4 (arm64) GridOS version to your SD Card https://lexa.blob.core.windows.net/grid-os/gridos.0.8.5.arm64.img.xz. Checkout in the Device Set-up flow in the Grid Console for the newer versions

• Set the device agent module to at least v1.5.0 and up, in console <TODO: insert pic below>

• once the device is online and running, run omg dev stream <devicename> agent update '{version: "0.8.6"}'

• then omg dev stream <devicename> agent install '{version: "0.8.6"}'

finally, reboot the device through console, or through omg - omg dev invoke <device-name> agent reboot

• Agent module v.1.5.4+

Instructions

Select desired Grid OS version in the drop-down list of the agent module.

...

The update will be downloaded and applied automatically. The new version will be used on next device reboot. The download will start immediately after the setting is changed. In case download have failed, the next download attempt will be scheduled in an hour.

Monitoring status

Currently you can check the status of the update in agent module telemetry, using omg dev modules <devicename> command.

...

• current stays for currently active GridOS version

• downloaded stays for the version that was downloaded, but not installed

• pending is a version that will be installed on next reboot

• error indicates there was an error with download