Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleMaxwell Basic, 2 and 3

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>

As there will be no file downloaded, this should not be used

/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


Info
iconfalse
titleMaxwell 3/B example

<?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="12.1424.47" url="http://192.168.178.101/device/maxwell/GC_MAX_12.1424.47-pre-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>

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleN510 IP PRO
N510MethodURLDownloadComment

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


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


http://<SERVER URL>



Web-interface
  • Web-interface 4
4 Download URL/42/2/master.bin



  • DHCP option 114 4
4 Download URL/42/2/master.bin



  • DHCP option 66 5
5 Download URL/<MAC>.xml





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


Expand
titleN510 xml example

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




Panel
titleColor#F85404
titleBGColor#F0F0F0
titleN720 IP PRO

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

Expand
titleN720 xml example

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



Panel
titleColor#F85404
titleBGColor#F0F0F0
titleMaxwell 10

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

Expand
titleMaxwell 10 xml example

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