Configuration files are the containers for a subset of configuration parameters (“Settings”). They are UTF-8 XML coded, and can be apply to a specific phone type and/or a specific MAC address.
- <certificates> tag
- <dialplan> tag
- <functionKeys> tag
- <gui-languages>, <web-languages>tag
- <phone-settings> tag
- <ReplacementPlan> tag
- <Setting-Files> tag
- <tbook>,<phone-book> tag
- <uploads> tag
Table of Contents
The files should be written in the UTF-8 XML format. They can be segmented into the following tags:
Each of these tags can be stored as individual XML files, or within the <settings>-tag.
Example of a simple configuration file
Example of a more extensive configuration file for a German user including address book entries & function keys : D385-firmware.xml
Permission flags can be added to each parameter to define whether that setting is read only, read/write, or read/write protected. Valid values for the permission flag are:
- perm="!": The configuration parameter can be changed by the user. In case the user changed the value from the default, the value will not be overwritten during the auto provisioning.
perm="!" is not recommended for credential related settings like http_pass or admin_mode_password, as the phone does not track the interface used for first time configuration. Because of this, any sequential provisioning of those settings with new values will fail as current values is considered as changed by the user. Please also see the hint related to this type of settings.
NOTE: If administrators want to be able to overwrite user parameter definitions, they need to use perm="$". With perm="!", the settings can be changed by mass provisioning only if the end user has not made changes to the configuration on the phone itself or on its web interface.
- perm="R" or perm="&" or perm=" ": The configuration parameter becomes write-protected (read only).
- perm="RW", perm="" or perm="$" The configuration parameter can be changed but will be overwritten on reboot.
It is recommended to write-protect those parameters that are crucial for the correct functioning of the phone, e.g. SIP registrar and user credentials.