Content

Page tree

Konfigurationsdateien beinhalten eine Teilmenge von Konfigurationsparametern (" Settings"). Sie sind UTF-8 XML kodiert und können auf einen bestimmten Telefontyp und/oder eine bestimmte MAC-Adresse angewendet werden.


Inhalt:



Verwendete Parameter



Dateiformat

Die Dateien sollten im UTF-8 XML-Format erstellt werden. Sie können in die folgenden Tags unterteilt werden:

<phone-settings>
<functionKeys>
<tbook>
<dialplan>
<ReplacementPlan>
<certificates>

Jedes dieser Tags kann als einzelne XML-Dateien oder innerhalb des <settings>-tags gespeichert werden.

Beispiel einer einfachen Konfigurationsdatei
<?xml version="1.0" encoding="utf-8"?>
<settings>
  <phone-settings>
    <language perm="">English</language>
    <setting_server perm="R">https://my.pbx.com/{mac}</setting_server>
    <timezone perm="">ITA+1</timezone>
    <user_active idx="1" perm="RW">on</user_active>
    <user_realname idx="1" perm="R">John Doe - 401</user_realname>
    <user_name idx="1" perm="">401</user_name>
    <user_host idx="1" perm="">my.pbx.com</user_host>
    <user_active idx="2" perm="RW">on</user_active>
    <user_realname idx="2" perm="R">Artur Black - 500</user_realname>
    <user_name idx="2" perm="">500</user_name>
    <user_host idx="2" perm="">company.com</user_host>
  </phone-settings>
</settings>

Beispiel einer umfangreicheren Konfigurationsdatei für einen deutschen Nutzer inklusive Adressbucheinträgen & Funktionstasten :

D385-firmware.xml
<?xml version="1.0" encoding="utf-8"?>
<settings>
	<phone-settings>  

		<!-- General settings, e.g. localisation and update policy --> 
		
		<update_policy>auto_update</update_policy>
		<phone_name perm="R">Snom-D385</phone_name> <!-- hostname of the phone. If set, the hostname is used to sign syslog packages and as the title of the WUI -->
		<language perm="">Deutsch</language>
		<web_language perm="">Deutsch</web_language>
		<date_us_format perm="">off</date_us_format>
		<dialnumber_us_format perm="">off</dialnumber_us_format>
		<timezone>GER+1</timezone>
		<tone_scheme>GER</tone_scheme>

		<!-- SIP identity settings. As config files contain sensible data such as user names and passwords in plaintext, please always make sure they are sent over a secure network connection -->

		<user_name idx="1" perm="">1004</user_name> <!-- SIP account user name -->
		<user_pass idx="1">8LmxdmZdv4FW62PC</user_pass> <!-- SIP account password. Please always use strong passwords -->
		<user_host idx="1">192.168.100.1</user_host> <!-- SIP registrar -->
		<user_realname idx="1">D385</user_realname> <!-- display name of the registered identity -->
		<user_active idx="1">on</user_active> <!-- Enables the SIP account -->
		
		<!-- Security settings for admin mode and Web User Interface --> 

		<admin_mode_password perm="">PmQYQHrLd6Q47fP3</admin_mode_password> <!-- Please always use strong passwords -->
		<http_user perm="">snom</http_user>
		<http_pass perm="">NsYdZMkdf4MbGfVh</http_pass> <!-- Please always use strong passwords -->
	</phone-settings>

	<!-- Here we define the functions and values of the fkeys on the phone --> 

	<functionKeys e="2">
		<fkey idx="1" context="active" label="Meier" lp="on" default_text="$name" perm="">blf sip:1001@192.168.100.1;user=phone</fkey> <!-- fkey monitoring line 1001 -->
		<fkey idx="2" context="active" label="Müller" lp="on" default_text="$name" perm="">blf sip:1002@192.168.100.1;user=phone</fkey> <!-- fkey monitoring line 1002 -->
		<fkey idx="3" context="active" label="Schulze" lp="on" default_text="$name" perm="">blf sip:1003@192.168.100.1;user=phone</fkey> <!-- fkey monitoring line 1003 -->
		<fkey idx="5" context="active" label="" lp="on" default_text="$name" perm="">keyevent F_REDIAL</fkey> <!-- fkey with function show last dialled numbers -->
	</functionKeys>
	
	<!-- Phone directory entries locally stored on the phone -->
	
	<tbook e="2">
		<item context="active" type="none" fav="false" mod="true" index="0"><name>Meier</name><number>1001</number><number_type>extension</number_type><birthday>00.00.99</birthday></item>
		<item context="active" type="none" fav="false" mod="true" index="1"><name>Müller</name><number>1002</number><number_type>extension</number_type><birthday>00.00.99</birthday></item>
		<item context="active" type="none" fav="false" mod="true" index="2"><name>Schulze</name><number>1003</number><number_type>extension</number_type><birthday>00.00.99</birthday></item>
	</tbook>
</settings>

Berechtigungs Kennzeichen (permission flags)

Es wird empfohlen, die Parameter, die für das ordnungsgemäße Funktionieren des Telefons entscheidend sind, wie z.B. SIP-Registrar und Benutzerdaten, schreibgeschützt zu setzen.