Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleIntroduction

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.
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleProvisioning version 1.1

Below is an example for the provisioning file:

Info
titleMAC.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

Info
titleMAC.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>

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleProvisioning version 1.0
Info
iconfalse
titlefirmware.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>

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleHow 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:

Info
titleMAC.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:

Info
iconfalse
titlefirmware.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>

Section
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleSpecial 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:

Info
iconfalse
titlefirmware.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:

Info
titleMAC.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>