Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • Introduction
  • Firmware Update

    This page describes the firmware update via auto-

    provisioning 

    provisioning. 

    • Using <firmware> tag
    • Using <firmware_status> tag
    • Using <firmware> tag

    Automatic provisioning allows many phones to be set up and updated automatically.

    Firmware Update via auto-provisioning

    There are several different methods to update firmware through auto-provisioning.

    Using

    <firmware_status>

    <firmware> tag

    • In the setting file,
      • Add / Change <firmware_status> <firmware> tag under <phone-settings> tag.
      • This <firmware_status> file <firmware> tag should be the URL to a different xml file, including firmware informationof the firmware executable file. For example,

    Code Block
    languagexml
    <?xml version="1.0" encoding="utf-8"?>

    Code Block
    languagexml
    
     
    <settings>
        <phone-settings>
            <update_policy perm="">auto_update</update_policy>
            <firmware_status perm="">http://example.com/firmware.xml</firmware_status>/P820/GigasetP82x-SIP10.1.193.12.swu</firmware>
        </phone-settings>
    </settings>
    • In No need to add or configure the firmware configuration file,
    • Add/change <firmware> tag under <firmware_settings> tag

    • This <firmware> tag should be the URL of the firmware executable file. For example,
    Code Block
    languagexml
    <?xml version="1.0" encoding="utf-8"?>
     
    <firmware-settings>
        <firmware perm="">http://example.com/gigasetP820-193.bin</firmware>
    </firmware-settings>
    • setting configuration file.
    • Reboot the phone.
    • After the reboot, the phone fetches the phone settings configuration file first. Then the phone fetches the firmware setting configuration file. Finally, the phone fetches the firmware executable file.
    • The phone starts the software update process.

    Note:

    Do not test the functionality using setup - advanced - update - Upload Setting File Manually. This does not work for firmware update !!!

    Image Added

    To test, enter the URL of the provisioning file: setup - advanced - update - Setting URL

    Reboot the device, the update starts after the reboot.

    Image Added

    After firmware update provisioning, the URL of the firmware is stored in the device:

    setup - Software update - Manual Software Update

    To start a new software update, the Firmware URL must be changed, only when the Firmware URL is changed the device will download the firmware file.


    Image Added

    draw.io Diagram
    bordertrue
    diagramNameDesktopFirmwareUpgrade
    simpleViewerfalse
    width
    linksauto
    tbstyletop
    lboxtrue
    diagramWidth811
    revision1

    Using <firmware_status>

    Using <firmware>

    tag

    • In the setting file,
      • Add / Change

        <firmware>

        <firmware_status> tag under <phone-settings> tag.

      • This <firmware> tag <firmware_status> file should be the URL of the firmware executable fileto a different xml file, including firmware information. For example,<?xml version="1.0" encoding="utf-8"?>

    Code Block
    languagexml
    <?xml version="1.0" encoding="utf-8" ?>
     
    <settings>
        <phone-settings>
            <update_policy perm="">auto_update</update_policy>
    		<!-- URL to the provisioning file below -->
            <firmware_status perm="">http://example.com/gigasetP820-193firmware.bin<xml</firmware>firmware_status>
        </phone-settings>
    </settings>
    No need to add or configure the firmware setting configuration file.


    • In the firmware configuration file,

      • Add/change <firmware> tag under <firmware_settings> tag

      • This <firmware> tag should be the URL of the firmware executable file. For example,

    Code Block
    languagexml
    <?xml version="1.0" encoding="utf-8"?>
     
    <firmware-settings>
    	<!-- URL to the firmware file
    	The following placeholders are supported: {mac} / {phone_type} -->
        <firmware perm="">http://example.com/gigasetP820-193.bin</firmware>
    </firmware-settings>


    • Reboot the phone.
    • After the reboot, the phone fetches the phone settings configuration file first. Then the phone fetches the firmware setting configuration file. Finally, the phone fetches the firmware executable file.
    • The phone starts the software update process.
    Info

    Note: If there are both <firmware> and <firmware_status> tags under <phone-settings> tag of the setting file, firmware update follows the URL of <firmware> tag. The URL of <firmware_status> is ignored.