Introduction

There are 2 methods to start the firmware update / downgrade via provisioning.

  • Provisioning Version 1.1 where all settings are in one file. (Preferred)
  • Provisioning Version 1.0 where multiple files are used.


From software 2.14.5 we have implemented a new parameter to automatically upgrade your phone when new software is available, or do not upgrade.

SettingComment
Automatic check for updates: No (Default)We disabled the automatic check because the customer should decide to use new software yes or no.
Automatic check for updates: YesIf enabled then if new software is available, the device will start the update.
Provisioning version 1.1

Below is an example for the provisioning file:

MAC.xml

<?xml version="1.0" encoding="UTF-8"?>

<provisioning version="1.1" productID="mx3b">

<firmware>

<!-- If the automatic update is enabled, the firmware update will start. if the automatic update is disabled then firmware update will not be done.
Only Firmware update is supported, downgrade not. -->

<file version="2.14.5" url="http://192.168.178.200/firmware/maxwell3/GC_MAX_2.14.5-release.bin" />

</firmware>

<nvm>

    <param name="PhoneUI.Settings.Confirmations" value="12121"/>

    <param name="PhoneUI.Settings.KeyClick" value="221122"/>

</nvm>

</provisioning>


If you use one template for all Maxwell devices, the firmware file of the Maxwell 4 is different. Therefore you need to define the location if the firmware file based on the device. for this you can use the DVID

MAC.xml

<?xml version="1.0" encoding="UTF-8"?>

<provisioning version="1.1" productID="mx3b">

<firmware>

<!-- The DVID depends on the device type.
Maxwell Basic: DVID = /82/2

Maxwell 2: DVID = /82/6

Maxwell 3: DVID = /82/1

Maxwell 4: DVID = /84/1

In the example below, the Maxwell 3 will use the URL: http://192.168.178.200/firmware/82/1/GC_MAX_2.14.5-release.bin

-->

<file version="2.14.5" url="http://192.168.178.200/firmware/%DVID/GC_MAX_2.14.5-release.bin" />

</firmware>

<nvm>

    <param name="PhoneUI.Settings.Confirmations" value="12121"/>

    <param name="PhoneUI.Settings.KeyClick" value="221122"/>

</nvm>

</provisioning>

Provisioning version 1.0

firmware.xml

<?xml version="1.0" encoding="UTF-8"?>

<firmware version="1.0" productID="mx3b">

<!-- If the automatic update is enabled, the firmware update will start. if the automatic update is disabled then firmware update will not be done.
Only Firmware update is supported, downgrade not. -->

<file version="2.14.5" url="http://192.168.178.200/firmware/maxwell3/GC_MAX_2.14.5-release.bin"/>

</firmware>

How to force firmware upgrade or downgrade.

It is possible to force the device to do a firmware upgrade or to force a firmware downgrade.

When firmware downgrade is done, the device will be factory default after downgrade.

Provisioning version 1.1

Below is an example for the provisioning file:

MAC.xml

<?xml version="1.0" encoding="UTF-8"?>

<provisioning version="1.1" productID="mx3b">

<firmware>

<!-- the flags="FORCE_ACCEPT" will force the device to start the upgrade or downgrade, even if the automatic update setting is No -->

<file version="2.14.5" url="http://192.168.178.200/firmware/maxwell3/GC_MAX_2.14.5-release.bin" flags="FORCE_ACCEPT" />

</firmware>

<nvm>

    <param name="PhoneUI.Settings.Confirmations" value="12121"/>

    <param name="PhoneUI.Settings.KeyClick" value="221122"/>

</nvm>

</provisioning>

Provisioning version 1.0

Below is an example for the provisioning file:

firmware.xml

<?xml version="1.0" encoding="UTF-8"?>

<firmware version="1.0" productID="mx3b">

<!-- the flags="FORCE_ACCEPT" will force the device to start the upgrade or downgrade, even if the automatic update setting is No -->

<file version="2.14.5" url="http://192.168.178.200/firmware/maxwell3/GC_MAX_2.14.5-release.bin" flags="FORCE_ACCEPT"/>

</firmware>

Special variant firmware provisioning.

For special customers, the software update can only be done if the variant is mentioned.

Here behind the software version, additional the variant has to be inserted.

version = "SW version" ":" "variant"

Provisioning version 1.0

Below is an example for the provisioning file, "FORCE_ACCEPT" is optional, see above:

firmware.xml

<?xml version="1.0" encoding="UTF-8"?>

<firmware version="1.0" productID="mx3b">

<!-- the flags="FORCE_ACCEPT" will force the device to start the upgrade or downgrade, even if the automatic update setting is No -->

<file version="2.14.5:vodafone-italy" url="http://192.168.178.200/firmware/maxwell3/GC_MAX_2.14.5-release_vodafone-italy.bin" flags="FORCE_ACCEPT"/>

</firmware>

Provisioning version 1.1

Below is an example for the provisioning file, "FORCE_ACCEPT" is optional, see above:

MAC.xml

<?xml version="1.0" encoding="UTF-8"?>

<provisioning version="1.1" productID="mx3b">

<firmware>

<!-- the flags="FORCE_ACCEPT" will force the device to start the upgrade or downgrade, even if the automatic update setting is No -->

<file version="2.14.5:vodafone-italy" url="http://192.168.178.200/firmware/maxwell3/GC_MAX_2.14.5-release_vodafone-italy.bin" flags="FORCE_ACCEPT" />

</firmware>

<nvm>

    <param name="PhoneUI.Settings.Confirmations" value="12121"/>

    <param name="PhoneUI.Settings.KeyClick" value="221122"/>

</nvm>

</provisioning>




  • No labels