Below you can find examples via different Methods how to provide the device with an provisioning URL and which files are downloaded.

There are 2 versions of XML files that can be downloaded:

  1. Version 1.0 where multiple files are used to download Software, settings and special parameters.
  2. Version 1.1 where one file is used that contains all. (Preferred method) Below is described how to create one xml file with all parameters.


URL via:URLDownloadComment

Redirect server

http://<SERVER URL>/%MACD.xml

http://<SERVER URL>/<MAC>.xml


http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml
http://<SERVER URL>

http://<SERVER URL>/provisioning.xml

when provisioning.xml is not available

http://<SERVER URL>/<MAC>.xml

The provisioning.xml contains information about the next files to be downloaded, see wiki article.

Web-interface

http://<SERVER URL>/%MACD.xml

http://<SERVER URL>/<MAC>.xml


http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml
http://<SERVER URL>

http://<SERVER URL>/provisioning.xml

when provisioning.xml is not available

http://<SERVER URL>/<MAC>.xml

The provisioning.xml contains information about the next files to be downloaded, see wiki article.

DHCP option 114

http://<SERVER URL>/%MACD.xml

http://<SERVER URL>/<MAC>.xml


http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml
http://<SERVER URL>

http://<SERVER URL>/provisioning.xml

when provisioning.xml is not available

http://<SERVER URL>/<MAC>.xml

The provisioning.xml contains information about the next files to be downloaded, see wiki article.

DHCP option 66

DHCP option 15 is not available

http://<SERVER URL>/%MACD.xml

http://<SERVER URL>/<MAC>.xml


http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml
http://<SERVER URL>

http://<SERVER URL>/provisioning.xml

when provisioning.xml is not available

http://<SERVER URL>/<MAC>.xml

The provisioning.xml contains information about the next files to be downloaded, see wiki article.

DHCP option 66

DHCP option 15 is available

http://<SERVER URL>/%MACD.xmlhttp://<SERVER URL>/%MACD.xml.<DHCP option 15>Implemented for special provider
http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml.<DHCP option 15>
http://<SERVER URL>http://<SERVER URL>.<DHCP option 15>


XML file version 1.1

On the server, the xml file contains info about:

  • Firmware
  • NVM (Settings), all parameters can be found here.
  • Custom


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

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

  <firmware>

<!-- Here you define the version of the software and the URL where to download the software -->

    <file version="2.24.7" url="http://192.168.178.101/device/maxwell/GC_MAX_2.24.7-release.bin" />

  </firmware>

  <nvm>

<!-- settings of the device -->

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

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

  </nvm>

  <custom>

<!-- Special options -->

    <step type="certificate" url="/custom/certificate.cert" flags="FORCE_ACCEPT"/>

  </custom>

</provisioning>



Below you can find examples via different Methods how to provide the device with an provisioning URL and which files are downloaded.


URL via:
URLDownloadComment
Redirect serverhttp://<SERVER URL>/%MACD.xmlhttp://<SERVER URL>/<MAC>.xml

http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml

http://<SERVER URL>http://<SERVER URL>No file will be downloaded.
Web-interfacehttp://<SERVER URL>/%MACD.xml

http://<SERVER URL>/<MAC>.xml

Web-interface: Configuration file (URL) field is used.

http://<SERVER URL>/AABBCCDDEEFF.xml

http://<SERVER URL>/AABBCCDDEEFF.xml

Web-interface: Configuration file (URL) field is used.

http://<SERVER URL>

http://<SERVER URL>/42/2/master.bin

Web-interface: Dataserver field is used.
DHCP option 114http://<SERVER URL>/%MACD.xmlhttp://<SERVER URL>/<MAC>.xml/42/2/master.binFor DHCP option 114, only use the option: http://<SERVER URL>

http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml/42/2/master.binFor DHCP option 114, only use the option: http://<SERVER URL>

http://<SERVER URL>

http://<SERVER URL>/42/2/master.bin
when provisioning.xml is not available
http://<SERVER URL>/<MAC>.xml


DHCP option 66http://<SERVER URL>/%MACD.xmlhttp://<SERVER URL>/<MAC>.xml/<MAC>.xmlFor DHCP option 66, only use the option: http://<SERVER URL>

http://<SERVER URL>/AABBCCDDEEFF.xmlhttp://<SERVER URL>/AABBCCDDEEFF.xml/<MAC>.xmlFor DHCP option 66, only use the option: http://<SERVER URL>

http://<SERVER URL>http://<SERVER URL>/<MAC>.xml

Configuration file (URL) auto provisioning

Below you can find how to configure the Configuration file (URL) via auto provisioning.

XML parameters:

<S_CONFIGFILE_URL class="string" value='"provider URL/xml/<MAC address>.xml"'/>

Please take care that extra ' ' are used.

 



Tag Name




Value




Location in web-interface


S_CONFIGFILE_URL


or


BS_IP_Data.aucS_CONFIGFILE_URL[0]

max. 74 characters from (0-9,a-z,A-Z,-,.); default is empty
it must be complete/proper URL such as http://domain/path/filename.xml .

From software 210 and higher, the placeholder %MACD is allowed, the device will replace this with it's own MAC address.

Example: http://domain/path/%MACD.xml

Important, the xml file name must contain capital letters

<S_CONFIGFILE_URL class="string" value='"provider URL/xml/<MAC address>.xml"'/>

or

<BS_IP_Data.aucS_CONFIGFILE_URL[0] class="symb_item" value='"provider URL/xml/<MAC address>.xml"'/>

Settings -> Management -> Firmware Update -> Configuration file URL


<?xml version="1.0" encoding="ISO-8859-1"?>
<ProviderFrame xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="N510.xsd">
<Provider>
<!-- Please enter the correct MAC Address example: 3E2F800E1234
Please enter correct Version value: DDMMYYHHMM example: 2811120928
Please enter a Profile name
If not correct, no setting will be done
-->
<MAC_ADDRESS value="7C2F80170386"/>
<PROFILE_NAME class="string" value="IPDEC"/>

<I_PHONE_SYSTEM class="integer" value="5"/>

<S_CONFIGFILE_URL class="string" value='"<provider URL>/device/xml/%MACD.xml"'/>

</Provider>

</ProviderFrame>

Web-interface:

 

Settings - Management - Firmware Update - Configuration file URL:




SYMB_ITEM ID="BS_IP_Data.aucS_CONFIGFILE_URL" class="string" value='"http://....path to xml file...."'/>

With this values IWU will download profile from aucS_CONFIGFILE_URL after every check-sync /reboot.




Tag Name




Value




Location in web-interface


BS_IP_Data.aucS_CONFIGFILE_URL

max. 255 characters from (0-9,a-z,A-Z,-,.); default is empty
it must be complete/proper URL such as http://domain/path/filename.xml .

Not available.

 

x. 255 characters from (0-9,a-z,A-Z,-,.); default is empty
it must be complete/proper URL such as http://domain/path/filename.xml .

System -> Firmware Update -> Configuration file URL

<?xml version="1.0" encoding="ISO-8859-1"?>
<ProviderFrame xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="N510.xsd">
<Provider>

<MAC_ADDRESS value="FFFFFFFFFFFF"/>
<PROFILE_NAME class="string" value="Test"/>

<SYMB_ITEM ID="BS_IP_Data.aucS_CONFIGFILE_URL" class="symb_item" value='"http://192.168.178.101/device/xml/test.xml"'/>

</Provider>

</ProviderFrame>

Web-interface:

Settings - Management - Firmware Update - Configuration file (URL):



XML parameters:

<S_CONFIGFILE_URL class="string" value="provider URL/xml/<MAC address>.xml"/>

 



Tag Name




Value




Location in web-interface


S_CONFIGFILE_URL

max. 74 characters from (0-9,a-z,A-Z,-,.); default is empty
it must be complete/proper URL such as http://domain/path/filename.xml .

Important, the xml file name must contain capital letters.

The usage of placeholders like %MACD will be supported soon.

Settings -> System -> Auto Provisioning -> Configuration file URL

<?xml version="1.0" encoding="ISO-8859-1"?>
<ProviderFrame>
.<Provider>
<MAC_ADDRESS value="FF:FF:FF:FF:FF:FF"/>
..<PROFILE_NAME class="string" value="PBX"/>

..<S_CONFIGFILE_URL class="string" value="http://192.168.178.101/device/xml/FFFFFFFFFFFF.xml"/>

.</Provider>
</ProviderFrame>


Web-interface:

Settings - System - Auto Provisioning: