All Collections
Configurations
Pico Firmware Update Policies
Pico Firmware Update Policies

How to remotely update Pico headset firmware versions (or prevent unapproved PUI updates from occurring)

Luke Wilson avatar
Written by Luke Wilson
Updated over a week ago

With ManageXR, you can remotely update Pico headsets and controller firmware versions. You can also lock a headset to a specific firmware version, preventing your users from updating to a PUI version that you haven't tested yet.

Pico Firmware Update Policy Options

πŸ›‘ If you switch a device to a configuration with a newer or "unmanaged" Pico firmware (PUI) version, it will update to the newer/newest version, and you will not be able to roll back this update.

You can choose between 3 firmware update policies for your Pico devices:

Pico Firmware Update Policy

Description

Defer to Device

This policy allows each individual device to update according to its native setting.

Pico devices automatically prompt end-users to update firmware when a new version is available. So, choosing this option will typically result in your users having the choice to upgrade to the latest firmware.

Disabled (Default)

This policy locks each device onto the firmware version it currently has installed, preventing upgrades.

We recommend this policy if you want to enforce stability and don't care about the specific firmware version your devices are on e.g., in a clinical trial, using devices with patients, or at a big event where you can't take a chance on a firmware upgrade.

Target a specific firmware version

Selecting a specific target firmware version will update your devices to the version of your choice and lock them on that version.

Note, firmware downgrades are not possible. If your devices have already upgraded beyond your target firmware, they will report "Unable to Downgrade" and remain on the higher firmware version.

We recommend this approach once you have tested a firmware version and confirmed that it is compatible with your content.

How to set an Update Policy

  1. Edit your Configuration of choice.

  2. Navigate to the Device Settings tab.

  3. In the top right, you'll find the Firmware section.

  4. Set the Update Policy for each device model using your configuration.

  5. Save your changes.

How devices download and install target firmware

Download Process

After you set a specific target pico firmware version on your configuration each device with this configuration will check to see if it has an out of date PUI version. If it is out of date, the device will begin to download the update in the background. A PUI update is typically 2GB, so it may take some time, depending on your internet speed.

You can track a PUI version's download progress on your device's detail page.

Once a Pico device's PUI version is up to date with your configuration setting, ManageXR will prevent the device from being manually updated to a different PUI version. This will prevent your users from updating to a PUI version that you haven't tested yet.

Installation Process

When you target a specific firmware version, you can also choose how your devices install this new target firmware. After devices download the firmware update in the background (see Download Process above), they will install the new firmware version according to the install option you select.

Select from three Target Firmware install process options for Pico devices:

Target Firmware Install Process Option

Description

User-initiated (Home Screen or Kiosk + Shortcut Menu only)

This option requires that you have Home Screen or Shortcut Menu enabled. A "System Update Available" button will appear in the toolbar of the Home Screen/Shortcut Menu. Once the user clicks this button, the PUI update will begin.

Prompt to install on boot

This option will bring up a prompt to update the headset the next time the user turns on their device. The prompt can be dismissed if the user does not want to initiate the update. The prompt will continue to appear on boot until the update is performed.

Begin installation on boot

This option will bring up a prompt to update the headset the next time the user turns on their device. The prompt cannot be dismissed, effectively forcing the PUI update.

FAQ

How do controller firmware updates work?

A PUI update is also linked to a controller update. Users in-headset will be prompted to update the controllers when you update the PUI and reboot into the updated version.

How long does it take for a new PUI version to be added to ManageXR's configuration settings?

About two weeks from Pico's official release.


Need more help?

Talk to a member of our team using the chat bubble in the bottom right of your screen, or reach out to support@managexr.com

Did this answer your question?