How Firmware Management Works

You Add Firmware Versions by Testing Them on Devices

All firmware versions reported by devices that have contacted your server will be listed in Control Center > Firmware > Versions.

You cannot manually add a firmware version to this list. The only way to include a new firmware version is to upload the firmware on to a device that connects to your EyeSaaS server. This prevents inaccuracies and discrepancies in file naming, and ensures that a firmware upgrade has been tested on a minimum of one device in your install base before provisioning starts.

You can delete firmware versions that are no longer in use, but if a device connects to your server with the firmware version that was deleted, it will reappear in the list. The version will then be displayed without any description or URL that was previously registered on this firmware.

You Place Firmware Downloads on Your Own Server

To ensure download capacity and limit traffic cost, each company has their own, local server for firmware distribution. Before you can apply a new version using a policy, you must place the download on your firmware server and add the download URL to the appropriate version in Control Center > Firmware > Versions.

If your company is using EyeSaaS Amber or Pearl, you should already have a firmware server in place. For instructions and requirements, see Set Up a Firmware Server.

You Apply Versions by Creating Policies

To apply the same firmware version to multiple devices, you must set up a firmware policy.

When creating the policy, you specify:

  • When the firmware change will happen (date span and, optionally, time of day).
  • The existing firmware version of the devices to get a new firmware version.
  • The exact firmware version to apply.

You can also specify whether only specific device events should trigger the firmware change (device startup, for example).

If you want to only apply the firmware to limited batches at a time, you can:

  • Specify a comma-separated list of exact device IDs.
  • Set a maximum number of upgrade failures to accept before stopping the policy.
  • Set a maximum number of successful upgrades to accept before stopping the policy.

In some cases, a device may not allow you to upgrade to a particular version without upgrading to another version first. In this case, you must set up multiple policies to install the “middle-firmware” or “step-firmware” before the desired version.

Also note that firmware policies override every other means of changing the firmware.

For example: If you have an active policy that upgrades from version A to version B, it will override any downgrades done by the end user or customer service every time the policy is triggered. This will happen even if the downgrade was made using Customer Center.

Search Support Articles

Community Support

Sign up for our Slack channel with your company email address if your company is an EyeSaaS customer.

Contact Support

EyeSaaS Support Portal

Go through your company's service administrator/super user if you don't have access to our support portal yourself.