--- title: "Updating Firmware" canonical: "https://help.scopious.co.nz/space/KB/434536466/Updating%20Firmware" format: markdown --- > Macro (toc) ## Recommended Firmware Update Process > ℹ️ IMPORTANT: > ℹ️ > ℹ️ - Changing the device firmware version in Scopious will **NOT** update the firmware in the device, as Firmware Update Over The Air (FUOTA) is not currently supported. > ℹ️ - Ensure the firmware version is supported in Scopious BEFORE you manually update the firmware in the device. If you wish to update the firmware in your device, we recommend following this 2 step approach: 1. Update the firmware version in Scopious first, then 2. Update the firmware in the physical device. Following this process ensures the version is supported in Scopious before you update the firmware on the device. This may prevent you having to roll back firmware updates on the device in situations where Scopious does not support the latest version. To minimise the risk of incorrectly decoding uplink packets, update the firmware version in both Scopious and the device as close together in time as possible. > ℹ️ It is important the firmware version is supported in Scopious to ensure device uplink packets are decoded correctly. If you are unsure whether the firmware version is supported follow the first 2 steps in [Change Firmware Version](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Change-Firmware-Version) to view the list of supported versions. ## View Firmware Version > ℹ️ The device firmware version is only visible on pre-approved devices. ### Device > ℹ️ By default, the displayed firmware version is the version installed during manufacture. If the firmware is updated on the device, ensure this field is updated to reflect the change. To view the current firmware version associated with your device: 1. Navigate to **Network** > **Devices** page using the navigation menu on the left side of the screen. 2. Click on the device you want to check. 3. Scroll down to the **Pre-Approved Device Details** section. ![image-20260615-014029.png](media://362a9a11-1c78-46cf-a3fc-235b735947d6) ### Peripheral Device To view the current firmware version associated with your peripheral device: 1. Navigate to **Network** > **Devices** page using the navigation menu on the left side of the screen. 2. Click on the device with the peripheral device you want to check. 3. Scroll down to the **Peripheral Device** section. ![image-20260615-014122.png](media://a2abaac8-e3c7-44f6-bb8d-5055f83408ca) ## Change Firmware Version > ℹ️ The firmware version can only be adjusted on pre-approved devices and peripheral devices. > ℹ️ > ℹ️ Changing the firmware version in Scopious will **NOT** update the firmware in the device as FUOTA is not supported. ### Device To change the current firmware version associated with your device: 1. Navigate to the device page following the steps in [View Firmware Version - Device](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Device). 2. Click on the context menu (…) to the right of the “Pre-Approved Device” badge. 3. Select “Edit Firmware Version”. 4. Select the firmware version you wish to change to in the drop-down. > ℹ️ If the firmware version you wish to change to is not available in the drop-down, request our support team to support the new version by clicking the **Request New Version** button. This will open the request in your preferred mail application or webpage. Required device information will be prefilled, but you will still need to add the firmware version you wish to use. ![image-20260615-014424.png](media://c8c95ca3-8b42-4fbd-9c35-ce30f1e5c6ba) 4. Click **Save** to proceed. Checks are conducted to identify any potential issues in changing to the new version. If no issues are identified the change will be saved. If potential issues are identified they will be categorised as [Major](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Major-Change) or [Minor](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Minor-Change), and you will be prompted before continuing. ### Peripheral Device To change the current firmware version associated with your peripheral device: 1. Navigate to the device page following the steps in [View Firmware Version - Peripheral Device](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Peripheral-Device). 2. Follow the same steps from step 2 onwards in [Change Firmware Version - Device](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Device.1). ### Devices with Custom Payload Formatters > ℹ️ An extra step may be involved when changing the firmware version of a device using a custom [payload formatter](https://scopious.atlassian.net/wiki/spaces/KB/pages/85917701/Glossary+of+Terms#Payload-Formatter). In some situations, custom payload formatters may be used to process uplink packets from your devices. You can identify if your device is using a custom payload formatter by looking at the **Device Details > Formatter Info** section. When selecting a new firmware version for a device using a custom payload formatter, changes may need to be made to the custom payload formatter. Scopious support will need to determine that, and once they have they will inform you of what custom payload formatter version to use. ![Screenshot from 2026-06-15 14-26-57.png](media://f6862ff2-90e0-486c-80f6-324ba815a0dc) To change the firmware version of a device using a custom payload formatter: 1. Follow the steps in [Change Firmware Version](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Change-Firmware-Version). 2. Click **Confirm** to proceed. Checks are conducted to identify any potential issues in changing to the new version. If no issues are identified the change will be saved. If potential issues are identified, continue with the next step. 3. If potential issues are identified they will be categorised as [Major](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Major-Change), [Minor](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Minor-Change), or [Patch](https://scopious.atlassian.net/wiki/spaces/KB/pages/434536466/Updating+Firmware#Patch-Change), and you will be prompted to select a *Payload Formatter* version. Select the payload formatter version to use and click “**I understand, proceed**” to save the firmware version and use the new payload formatter. > ℹ️ If you are unsure which payload formatter version to choose, ask our support team by clicking **Request Help Version** and a support team member will get back to you. ![image-20250730-014613.png](media://11734c38-5152-43db-bc0e-5ce1ad464f1e) ## Data Format Changes New firmware versions may result in changes to the data format of the device. This section contains information about the types of changes that may occur. ### Major change Major changes involve altering the data format so it is incompatible with previous data formats. > ⚠️ A major change will likely break Dashboards and Alarm's due to the significant data format changes. > ⚠️ A major change will likely break external Integrations the device uses. If you proceed with the change, ensure you reconfigure and test the associated features once the new firmware has been installed on the device. ![image-20250730-025351.png](media://3e6b93c0-f8ba-4cf8-a10a-89bedb16ebc9) ### Minor change Minor changes involve extending the data format to include new fields. These new fields can be utilised in Dashboards and Alarms. > ⚠️ New fields may cause issues with external Integrations that reject packets containing unknown (new) fields. > ⚠️ If you are downgrading a firmware version, this may cause Dashboards and Alarm's to malfunction as they may rely on fields that have been removed. If you proceed with the change, ensure you reconfigure and test the associated features once the new firmware has been installed on the device. ![image-20250730-025430.png](media://ec4403f4-55f2-44a2-95d5-d437573ba4d5) ### Patch change > ℹ️ You will only be notified of patch changes if your device uses a custom payload formatter. Patch changes are usually bug fixes that help ensure your device is running smoothly. This should not break any features in the Scopious platform or external Integrations. > ℹ️ You may be prompted to select a payload formatter version. If you are unsure which payload formatter version to choose, ask our support team by clicking **Request Help Version** and a support team member will get back to you. ![image-20250730-025302.png](media://506b55aa-b11a-4490-ba9f-efb31cf2c10b) ## Troubleshooting ### No Compatible Peripheral Device Firmware > ℹ️ The message below will only appear when choosing a device firmware version that has no peripheral device firmware version registered against it. A device firmware version will display an asterisk '*' next to it when there is no compatible peripheral device firmware version registered against it. In this situation you will not be able to proceed to select that device firmware version. You will need to wait until a compatible peripheral device firmware version has been registered in the platform. To request the peripheral device firmware version be supported, click the “**Request Peripheral Device Support**” button. This will open the request in your preferred mail application or webpage. All required information will be prefilled, so you just need to send the email. Once a compatible peripheral device firmware version has been registered a support team member will contact you. You will then be able to update the firmware version. ![image-20250725-031620.png](media://15652124-1028-411d-bf87-8cffd5aa9419)