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.

Below is an example for the provisioning file:

<?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

<?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>

<?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>

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:

<?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:

<?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>

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:

<?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:

<?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>