Auto Provision Manual Version 1 2 3

1

www.tiptel.nl

Tiptel b.v. Camerastraat 2 1336 BC Almere

Tel: 036 53 666 50 Fax: 036 53 678 81

Auto Provision Manual

2

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

Contents

Contents ................................................................................................................................................................................. 2 1.1 Summary ........................................................................................................................................................................ 3 2.1 Obtain the server address ....................................................................................................................................... 3

2.1.1 Pushed by PnP servers .................................................................................................................................. 3

2.1.2 Detect DHCP custom option. ...................................................................................................................... 4

2.1.3 Detect DHCP Option 66. ............................................................................................................................... 4

2.1.4 Detect DHCP Option 43. ............................................................................................................................... 4

2.1.5 Detect the phone flash. ................................................................................................................................ 5

2.2 Download configuration files .................................................................................................................................. 6 2.3 Resolve and apply the configurations ................................................................................................................. 7 2.4 Do other updates ........................................................................................................................................................ 8 Appendix A .......................................................................................................................................................................... 11

1. Description of configuration parameters in CFG file ............................................................................ 11

2.5 Configure the Expansion Module via Auto Provisioning ............................................................................. 30

3

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

1.1 Summary

The presented document will show you how auto provision works and how to make auto provision work.

The process of a successful auto provision is:

1. Obtain a server address in which store the configuration files. 2. Download the configuration files from the configured server. 3. Resolve and apply the configurations written in the configuration file. 4. Do other updates, for example the firmware updating.

2.1 Obtain the server address

When the phone boots up, it will go by the following process to try to obtain the server address:

PnP server DHCP custom option DHCP option 66 DHCP option 43 Phone Flash

The following are the details of each process:

2.1.1 Pushed by PnP servers

Note proprietary method to enable "Auto Provisioning". When PnP

config is Enabled, the phone will send SIP SUBSCRIBE messages to a multicast address. Any SIP

server understanding that message may reply with a SIP NOTIFY message containing the Auto

4

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

Provisioning Server URL where the phones can request their configuration. Modern SIP PBXs/Proxies

can provide the PnP configuration data. Please refer to the manual of your PBX/Proxy. This kind of auto

provision is mainly used under some possible circumstance like your phones have no default

provisioning server set and are not able to detect DHCP options (when the they use static IP address).

Pay attention to the point that PnP config has the highest priority in obtaining the provisioning server

address and if it

2.1.2 Detect DHCP custom option.

It must be configured to the phone by web management:

Note: A valid Custom Option is from 128 to 254. The Custom Option Type must be in accordance

with the one defined in the DHCP server. If the phone fails to get any information from custom option,

it will go to detect DHCP Option 66.

2.1.3 Detect DHCP Option 66.

Tiptel phones will check this option by default. If the phone fails to get any information from DHCP

Option 66, it will go to detect DHCP Option 43.

2.1.4 Detect DHCP Option 43.

Tiptel phones will check this option by default. If the phone fails to get any information from DHCP

Option 43 and Check New Config is not Disabled, it will go to detect the phone flash.

5

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

2.1.5 Detect the phone flash.

The value is what you can read from the web management of the phone:

Note: This process depends on the setting of Check New Config and if it is set to be Disabled, the

The supported protocols of a URL are: HTTP/HTTPS/FTP/TFTP.

Account and Password will be used to access to the URL if required. FTP server always has this

requirement. For example, the following settings will make the phone access to FTP server

192.168.0.231, using account Vin and Passwords 123 (on the web it is hid by 3 black points). If the

phone fails to get any information from phone flash, the current round of obtaining server address will

stop here.

6

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

2.2 Download configuration files

There are 2 configuration files both of which are CFG formatted that the phone will try to download from

the server. We call them Common CFG file and Phone-specific CFG file. The Common CFG file will be

effectual for all the phones of the right model. However, a Phone-specific CFG file will only be effectual for

one specific phone which can be tell by its MAC address. A common CFG file has a fixed name for each

model while a Phone-specific CFG file is named after a MAC address of a specific phone. The names of the

Common CFG file for each model are:

tiptel IP 286: y000000000000.cfg

tiptel IP 284: y000000000004.cfg

tiptel IP 280: y000000000007.cfg

There are 11 zeros between the letter y and the last number. The last number is decided by the hardware

version of the relevant model, for it is the first number of the hardware version of the model. For instance,

for a tiptel IP 286 whose MAC address is 001565113af8, the 2 configuration files for it will be:

y000000000000.cfg and 001565113af8.cfg.

To have this name division on configuration files will help when doing same auto provision to mass phones.

For example, assumed that you have 1000 pieces of tiptel IP 286 and you want to update firmware for all

phones, you just need to prepare only one y000000000000.cfg in which defines the firmware update

request, then put it onto the provisioning server.

Note: In case that the phone is on a live call, it will keep on asking for the CFG files with an interval of 30

seconds for up to 2 hours.

7

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

2.3 Resolve and apply the configurations

If the downloaded configuration files have been AES encrypted, the specified keys will be needed. The

Specified AES Key is for decrypting the Common CFG file. The Per-phone AES Key is for decrypting the

Phone-specific CFG file. The keys must be 16 bytes and the supported characters are: 0 ~ 9, A ~ Z, a ~

z and the following special characters: # $ % * + , - . : = ? @ [ ] ^ _ ~

In a CFG file, there are texts defining configurations. the texts. Take the

AES_KEY section in the following picture for example.

8

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

The following texts are system-defined that cannot be changed manually;; otherwise it will cause a failure

to auto provision:

1. The section header [AES_KEY]

2. The directory of the section path = /config/Setting/autop.cfg

3. The parameters aes_key_16 and aes_key_16_mac

You can only specify a valid value . This is a section for specifying the AES keys. So

you can make it like follow to specify 1234567890123456 for both Specified AES Key and Per-phone

AES Key:

[ AES_KEY ]

path = /config/Setting/autop.cfg

aes_key_16 = 1234567890123456

aes_key_16_mac =1234567890123456

The lines start with # are instructions, just for easy

understanding when read by a person. For the detailed instruction of the parameters written in the CFG

files, please refer to the Appendix A.

Note: If the phone finds that the downloaded CFG files are completely the same as it is applied the very

last time, the auto provision will stop here. The phone knows it by comparing the MD5 value of the

downloaded CFG files and the latest applied CFG files.

2.4 Do other updates

It depends on the texts written in the CFG files to decide whether to make other updates. There are mainly

the following other updates:

1. The section defining request for ringtone update in the CFG files: ###############################################################

########################

[ ringtone ]

path = /tmp/download.cfg

9

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

server_address =

###############################################################

########################

The server_address must link to a .wav file. The wav file should not be larger than 100kB.

For example: ftp://Vin:[email protected]/Ring20.wav

2. The section defining request for language update in the CFG files: ###############################################################

########################

[ Lang ]


server_address =

###############################################################

########################

The server_address must be like serverAddress/lang-*.txt. For example:

http://192.168.0.231/provision/lang-Dutch.txt

And note that it does not enable you to add new languages. It just enables you to modify the existed

languages. Currently in TIPTEL IP 286, there are lang-English.txt, lang-Chinese_S.txt, lang-Chinese_T.txt,

lang-Russian.txt, lang-Turkey.txt, lang-spanish.txt, lang-Dutch.txt, lang-Hebrew.txt, lang-Italian.txt

3. The section defining request for contacts update in the CFG files: ###############################################################

########################

[ ContactList ]


server_address =

###############################################################

########################

An example of server_address: http://192.168.0.132:9/provision/contactData1.xml

Note that the name has to be contactData1.xml.

You can export an existed local phone book to see what the format is exactly.

4. The section defining request for firmware update in the CFG files: ###############################################################

########################

[ firmware ]


server_type =

server_ip =

server_port =

login_name =

login_pswd =

http_url =

firmware_name =

###############################################################

########################

ftp://Vin:[email protected]/Ring20.wav

http://192.168.0.231/provision/lang-Dutch.txt

http://192.168.0.132:9/provision/contactData1.xml

10

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

An example:

[ firmware ]


server_type = ftp

server_ip = 192.168.0.231

server_port = 21

login_name = Vin

login_pswd = 123

http_url = http://192.168.0.231/

firmware_name = 0.0.0.143.rom

The above section will make the phone access to ftp server 192.168.0.231, using port 21, Vin

and 123 0.0.0.143.rom. And if the server_type = http, it will go to

http://192.168.0.231/ to download the 0.0.0.143.rom and then update.

11

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

Appendix A

1. Description of configuration parameters in CFG file

Section Header and Path Parameters Permitte

d Values Descriptions

[ autop_mode ]


mode 0,1,4,5,6,7

It defines the value of Check New

Config.

0:Disabled

1:Power on

4:Repeatedly

5:Weekly

6:Power on + Repeatedly

7:Power on + Weekly

The default is 0.

schedule_min 1 to 43200

It is available when mode is 4 or 6.It

stands for the interval time (by

minutes) of checking new config.

schedule_dayofweek

0,1,2,3,4,5

,6 or a

combinatio

n of these

numbers


defines the day of week

a need to check new config. If it is

set to be 0123456, it means every

day.

0:Sunday

1:Monday

2:Tuesday

3:Wednesday

4:Thursday

5:Friday

6:Saturday

schedule_time Time as

19:45


means the phone will check new

config at a time between

schedule_time and

schedule_time_end on a specified

day every week.

schedule_time_end Time as

19:45

[ PNP ]

path = /config/Setting/autop.cfg Pnp 0 or 1

It defines the value of PNP config.

0 stands for Disabled.

1 stands for Enabled.

The default is 0.

[ cutom_option ]


cutom_option_code0

Integer

from 129 to

254

It defines the Custom Option.

No default value.

cutom_option_type0 0 or 1 It defines the Custom Option

12

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

Type..

0 stands for IP Address.

1 stands for String.

The default is 1.

[ AES_KEY ]


aes_key_16 16-byte

String

It defines the Specified AES Key

which is used for decrypting the

common CFG file. Besides 0 ~ 9, A ~

Z, a ~ z, the valid characters include

the following special ones:

#$%*+,-.:=?@[]^_~

aes_key_16_mac 16-byte

string

It defines the Per-phone AES Key

which is used for decrypting the

phone-specific CFG file. The valid

characters are the same as

aes_key_16.

[ autoprovision ]


server_address

HTTP/HTTP

S/FTP/TFTP

Address

It defines the URL which is supposed

to be the auto provisioning server.

user String

It defines the Account which may

be used when the access to the URL

requires authentication.

password String

It defines the Password which may

be used when access to the URL

requires authentication.

[ account ]

path =

/config/voip/sipAccount0.cfg

Enable 0 or 1

It defines the Line Active value of

account1.

0 stands for off

1 stands for on

The default is 0.

Label String It defines the Label of account1.

No default value.

DisplayName String

It defines the Display Name of

account1.

No default value.

AuthName String

It defines the Register Name of

account1.

No default value.

UserName String

It defines the User Name of

account1.

No default value.

password String

It defines the Password of

registration for account1.

No default value.

SIPServerHost Domain

name or

It defines the SIP Server of

account1.

13

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

IP Address No default value.

SIPServerPort Integer

It defines the Port of the SIP Server

of account1.

The default is 5060.

UseOutboundProxy 0 or 1

It defines the value of Enable

Outbound Proxy Server of

account1.



The default is 0.

OutboundHost

Domain

name or

IP Address

It defines the Outbound Proxy

Server of account1.

No default value.

OutboundPort Integer

It defines the Port of the Outbound

Proxy Server of account1.


Transport 0,1 or 2

It defines the value of Transport of

account1.

0 stands for UDP.

1 stands for TCP.

2 stands for TLS.

The default is 0.

BakOutboundHost

Domain

name or IP

Address

It defines the Backup Outbound

Proxy Server of account1.

No default value.

BakOutboundPort Integer

It defines the Port of Backup

Outbound Proxy Server of account1.


proxy-require String

It defines the value of Proxy

Require of account1.

No default value.

AnonymousCall 0 or 1

It defines the value of Anonymous

Call of account1.



The default is 0.

RejectAnonymousCal

l 0 or 1

It defines the value of Anonymous

Call Rejection of account1.



The default is 0.

Expire Integer

It defines the value of Login Expire

of account1.


SIPListenPort Integer It defines the value of Local SIP

14

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

Port of account1.


Enable 100Rel 0 or 1

It defines the value of 100 reliable

retransmission of account1.



The default is 0.

precondition 0 or 1

It defines the value of Enable

Precondition of account1.



The default is 0.

SubsribeRegister 0 or 1

It defines the value of Subscribe

Register of account1.



The default is 0.

SubsribeMWI 0 or 1


for MWI of account1.



The default is 0.

CIDSource 0 or 1

It defines the value of Caller ID

Header of account1.

0 stands for FROM.

1 stands for PAI.

The default is 0.

EnableSessionTimer 0 or 1

It defines the value of Use Session

Timer of account1.



The default is 0.

SessionExpires

Integer

from 1 to

999

It defines the value of Session

Timer of account1.

No default value.

SessionRefresher 0 or 1

It defines the value of Refresher of

account1.

0 stands for Uac.

1 stands for Uas.

The default is 0.

EnableUserEqualPho

ne 0 or 1

It defines the value of Use

user=phone of account1.



The default is 0.

15

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

srtp_encryption 0 or 1

It defines the value of Voice

Encryption (SRTP) of account1.

0 stands for off.

1 stands for on.

The default is 0.

ptime

0,10,20,30

,40,50 or

60

It defines the value of ptime of

account1.


10 stands for 10ms.

20 stands for 20ms.

And alike.

The default is 0.

ShareLine 0 or 1

It defines the value of Shared Line

of account1.



The default is 0.

dialoginfo_callpickup 0 or 1

It defines the value of Dialog-Info

Call Pickup of account1.



[ account ]

path =


For different models, s of Account. For each Account,

there are completely same parameters and they share same permitted values

and default values. The difference is just on the path. For example, the path of

Account1 is path = /config/voip/sipAccount0.cfg.While for

Account2 is path = /config/voip/sipAccount1.cfg,and other sections alike.

[ DTMF ]

path =


DTMFInbandTransfer 0,1 or 2

It defines the value of DTMF Type of

account1.

0 stands for INBAND.

1 stands for RFC2833.

2 stands for SIP INFO.

The default is 1.

InfoType 0,1,2 or 3

It defines the value of How to INFO

DTMF of account1.


1 stands for DTMF-Relay.

2 stands for DTMF.

3 stands for Telephone-Event.

The default is Disabled.

DTMFPayload

Integer

from 96 to

255

It defines the value of DTMF

Payload of account1.

The default is 101.

[ NAT ]

path =


NATTraversal 0 or 1

It defines the value of NAT

Traversal of account1.


16

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

1 stands for STUN.

The default is 0.

STUNServer

Domain

name or IP

Address

It defines the value of STUN Server

of account1.

No default value.

STUNPort Integer

It defines the Port of STUN Server of

account1.


EnableUDPUpdate 0 or 1

It defines the value of UDP

Keep-alive Message of account1.



The default is 1.

UDPUpdateTime Integer

It defines the value of UDP

Keep-alive Interval of account1.

The default is 30(seconds).

rport 0 or 1

It defines the value of Rport of

account1.



The default is 0.

[ ADVANCED ]

path =


default_t1 Float

It defines the value of SIP Session

Timer T1 of account1.

The default is 0.5.

default_t2 Float



The default is 4.

default_t4 Float



The default is 5.

[ blf ]

path =


SubscribePeriod Integer


Period of account1.


BLFList_URI String

It defines the value of BLFList URI

of account1.

No default value.

[ audio0 ]

path =


enable 0 or 1

It defines the activity of a specific

codec.

0 means to disable the codec.

1 means to enable the codec.

PayloadType

One of the

following:

PCMU

PCMA

G723_53

It stands for a specific Codec type.

17

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

G723_63

G729

G722

G726-16

G726-24

G726-32

G726-40

priority

Integer

from 0 to

10

It stands for the priority of a specific

enabled codec.

rtpmap Integer It defines the payload of the codec.

[ audio1 ]

path =


The parameters and the Permitted values are the same as[ audio0 ]. For each

account there are totally 10 usable codecs and each one has a section in

configuration files and so there are sections from [ audio0 ] to [ audio10 ] for

each account. (audio 6 is just a reserved section)

They have default values as below. If you want to change one of them, please

note that there should be no same parameter values for the same account:

[ audio0 ]

enable = 1

PayloadType = PCMU

priority = 1

rtpmap = 0

[ audio1 ]

enable = 1

PayloadType = PCMA

priority = 2

rtpmap = 8

[ audio2 ]

enable = 0

PayloadType =

G723_53

priority = 0

rtpmap = 4

[ audio3 ]

enable = 0

PayloadType =

G723_63

priority = 0

rtpmap = 4

[ audio4 ]

enable = 1

PayloadType = G729

priority = 3

rtpmap = 18

[ audio5 ]

enable = 1

PayloadType = G722

priority = 4

rtpmap = 9

[ audio6 ]

enable = 0

PayloadType = iLBC

priority = 0

rtpmap = 102

[ audio7 ]

enable = 0

PayloadType =

G726-16

priority = 0

rtpmap = 112

[ audio8 ]

enable = 0

PayloadType =

G726-24

priority = 0

rtpmap = 102

[ audio9 ]

enable = 0

PayloadType =

G726-32

priority = 0

rtpmap = 2

[ audio10 ]

enable = 0

PayloadType =

G726-40

priority = 0

rtpmap = 104

[ audio2 ]

path =


[ audio3 ]

path =


[ audio4 ]

path =


[ audio5 ]

path =


[ audio7 ]

path =


[ audio8 ]

path =


[ audio9 ]

path =


[ audio10 ]

path =


[ WAN ]

path =

/config/Network/Network.cfg

WANType 0,1 or 2

It defines the type of Internet Port

(WAN).

0 stands for DHCP.

1 stands for PPPoE.

2 stands for Static IP Address.

The default is 0.

18

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

WANStaticIP IP Address

It defines the IP Address when

using static WAN settings.

No default value.

WANSubnetMask Network

Mask

It defines the Subnet Mask when


No default value.

WANDefaultGateway IP Address

It defines the Default Gateway

when using static WAN settings.

No default value.

[ DNS ]

path =


PrimaryDNS IP Address

It defines the Primary DNS when


No default value.

SecondaryDNS IP Address

It defines the Secondary DNS

when using static WAN settings.

No default value.

[ PPPoE ]

path =


PPPoEUser string

It defines the User name when

using PPPoE WAN settings.

No default value.

PPPoEPWD string

It defines the Password when using

PPPoE WAN settings.

No default value.

[ LAN ]

path =


LANTYPE 0 or 1

It defines the type of PC Port

(LAN).

0 stands for Rooter.

1 stands for Bridge.

The default is 1.

RouterIP IP Address

It defines the IP Address when the

LAN is set as Rooter.

The default is 10.0.0.1

LANSubnetMask Network

Mask

It defines the Subnet Mask when

the LAN is set as Rooter.

The default is 255.255.255.0.

EnableDHCP 0 or 1

It means whether to enable DHCP

server when the LAN is set as Rooter.



The default is 1.

DHCPStartIP IP Address It defines the IP Address range the

DHCP rooter will allocate.

The default is from 10.0.0.10 to

10.0.0.100.

DHCPEndIP IP Address

[ VLAN ]

path =


ISVLAN 0 or 1

It defines the VLAN Active option of

LAN Port.



19

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

The default is 0.

VID

Integer

from 0 to

4094

It defines the VID of LAN Port.

The default is 0.

USRPRIORITY Integer

from 0 to 7

It defines the VLAN USRPRIORITY

of LAN Port.

The default is 0.

PC_PORT_VLAN_ENA

BLE 0 or 1

It defines the VLAN Active option of

PC Port.



The default is 0.

PC_PORT_VID

Integer

from 0 to

4094

It defines the VID of PC Port.

The default is 0.

PC_PORT_PRIORITY Integer

from 0 to 7

It defines the VLAN USRPRIORITY

of PC Port.

The default is 0.

[ QOS ]

path =


RTPTOS

Integer

from 0 to

63

It defines the value of Voice QoS.

The default is 40

SIGNALTOS

Integer

from 0 to

63

It defines the value of SIP QoS.

The default is 40

[ RTPPORT ]

path =


MaxRTPPort

Integer

from 0 to

65535

It defines the MaxRTPPort of Local

RTP Port.


MinRTPPort

Integer

from 0 to

65535

It defines the MinRTPPort of Local

RTP Port.


[ SYSLOG ]

path =


SyslogdIP IP Address

It defines the server where the

syslog is supposed to be exported

onto.

[ Lang ]

path = /config/Setting/Setting.cfg WebLanguage

Language

Name

It defines the Language used on

the Webpage.

The other

Languages are: Turkish, Czech,

Russian, Chinese_S depending on

the firmware support.

[ Time ]

path = /config/Setting/Setting.cfg

TimeZone

Time Zone

from -11 to

+12

It defines the Time Zone you expect

to use on the phone.

The default is +8.

TimeServer1

Domain

name or IP

Address

It defines the Primary NTP Server.

The default is cn.pool.ntp.org.

20

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

TimeServer2

Domain

name or IP

Address

It defines the Secondary NTP

Server.

The default is cn.pool.ntp.org.

Interval Integer

It defines the Update Interval

when using NTP Server.


SummerTime 0 or 1

It defines the activity of Daylight

Saving Time.



The default is 0.

StartTime MM/DD/HH

It defines the StartTime of Daylight

Saving Time.

The default is 1/1/0

EndTime MM/DD/HH

It defines the EndTime of Daylight

Saving Time.

The default is 12/31/23

[ PhoneSetting ]


InterDigitTime Integer It defines the Inter Digit Time.


FlashHookTimer

Integer

from 0 to

800

It defines the Flash Hook Time.

The default is 1(ms)

Lock 0,1,2 or 3

It defines the type of Keyboard

Lock.


1 stands for Menu Key.

2 stands for Function Key.

3 stands for Talk call only.

The default is 0.

Ringtype Ring name

It defines the default Ring tone that

has been built in the phone flash, for

example,Ring1.wav,Ring2.wav and

alike.

Contrast 1,2 or 3

It defines the LCD Contrast. The

parameter depends on model types.

tiptel IP 280

The default is 2.

BackLight 1,2 or 3

It defines the Backlight

Brightness. The parameter

depends on model types. tiptel IP

280 t it.

The default is 2.

BacklightTime 15,30,60 or

120

It defines the Backlight Time. The

parameter depends on model types.

tiptel IP 280

21

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

The default is 30.

ProductName String

It defines the Product Name which

you can see via LCD interface.

The default value for Tiptel models

are tiptel IP 286, tiptel IP 284, tiptel

IP 280 respectively.

[ AlertInfo0 ]


Text String

It defines the first Internal Ringer

Text.

No default value.

Ringer Integer

It defines the ringer for the first

Internal Ringer Text. The ringer is

defined by its order number.

The default is 1.

[ AlertInfo1 ]


They have same path and parameters as [ AlertInfo0 ] and share the same

Permitted Values and default values.

[ AlertInfo2 ]


[ AlertInfo3 ]


[ AlertInfo4 ]


[ AlertInfo5 ]


[ AlertInfo6 ]


[ AlertInfo7 ]


[ AlertInfo8 ]


[ AlertInfo9 ]


[ Forward ]

path =

/config/Features/Forward.cfg

Type 0,1,2 or 3

It defines the type of Forward.

0 stands for Cancel Forward.

1 stands for Always Forward.

2 stands for Busy Forward.

3 stands for No Answer Forward.

4 stands for Busy/No Answer

Forward.

The default is 0.

AlwaysForward Phone

number

It defines the number that the phone

will Always Forward to.

No default value.

BusyForward Phone

number


will Busy Forward to.

No default value.

22

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

NoAnswerForward Phone

number


will No Answer Forward to.

No default value.

AfterRingTimes 5,10 or 15

It defines the time after which the

call will be forwarded when using No

Answer Forward.


BusyNoAnswerForward Phone

number


will Busy/No Answer Forward to.

No default value.

BusyNoAfterRingTimes 5,10 or 15

It defines the time after which the

call will be forwarded when using

Busy/No Answer Forward.


[ Features ]

path = /config/Features/Phone.cfg

Call_Waiting 0 or 1

It defines the activity of Call

Waiting.



The default is 1.

Hotlinenumber Phone

number

It defines the Hotline Number.

No default value.

BusyToneDelay 0,3 or 5

It defines BusyToneDelay, the

Delay of Busy Tone which is played

when the other party hangs up.


[ PoundSend ]

path = /config/Features/Phone.cfg Enable 0,1 or 2

It defines the Key As Send.


1 stands for # key.

2 stands for * key.

The default is 1.

[ AutoAnswer ]

path = /config/Features/Phone.cfg Enable 0 or 1

It defines the activity status of Auto

Answer.



The default is 0.

[ Emergency ]

path = /config/Features/Phone.cfg Num

Phone

numbers

separated

by commas

It defines the Emergency numbers

separated by commas. For example,

it can be specified

as:911,999,110,120

No default value.

[ memory1 ]

path =

/config/vpPhone/vpPhone.ini

type blf or bla

It is used when configuring a DSS

Key as BLF or Shared Line.

blf stands for BLF.

bla stands for Shared Line.

No default value.

23

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

Line

Integer

from 0 to

max line

number

Seen from the web, it reflects the

value under Line title.

It defines the Line you are going to

use for a specific function (if the

function needs to specify a line).

Normally,0 stands for Auto,1 stands

for Line1 and so on.

However,

configured as bla or blf in which case

0 stands for Line1, 1 stands for Line2

and so on.

The default is 0.

Value It depends


value under Extension title.

Normally, the value is an extension

For example, when you configure a

key as URL, the value must be a url

string.

No default value.

PickupValue string

It is used only for BLF. It defines the

pickup number that your server

allocates.

DKtype Integer

function.

0:N/A 1:Conference

2:Forward 3:Transfer

4:Hold 5:DND

6:Redial 7:Call Return

8:SMS 9:Call Pickup

10:Call Park 11:Custom

12:Voicemail 13:SpeedDial

14:Intercom 15:Line(for line key

only)

16:BLF 17:URL

18:Group Listening 19:Public

Hold

20:Private Hold

The default is 0.

[ memory2 ]

path =

/config/vpPhone/vpPhone.ini From [ memory1 ] to [ memory2 ] are used for 10 DSS Keys on the phone

tiptel IP 286/284. For a phone having no DSS keys like the tiptel IP 280,

use configuring the parameters. [ memory3 ]

path =


24

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

[ memory4 ]

path =


[ memory5 ]

path =


[ memory6 ]

path =


[ memory7 ]

path =


[ memory8 ]

path =


[ memory9 ]

path =


[ memory10 ]

path =


[ memory11 ]

path =


From [ memory11 ] to [ memory16 ] are used for Line keys. The available

sections depend on the numbers of Line keys. For tiptel IP 280 which have only

2 line keys, only the first 2 sections are available. For the tiptel IP 284,only the

first 3 sections are available.

In addition, the settings for a Line key is not completely the same as a DSS

key. For example, a line key cannot be configured as blf.

[ memory12 ]

path =


[ memory13 ]

path =


[ memory14 ]

path =


[ memory15 ]

path =


[ memory16 ]

path =


[ Profile ]

path = /config/vpm.cfg

VAD 0 or 1

It defines the activity status of VAD.



The default is 0

CNG 0 or 1 It defines the activity status of CNG.


25

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81


The default is 1.

ECHO 0 or 1

It defines the activity status of Echo

canceller.



The default is 1.

SIDE_TONE -3 or

-32768

It is an invisible setting which can

only be configured via auto

provision.

-32768 stands for Disable Side tone.

-3 stands for Enable Side tone.

The default is -3.

[ Jitter ]

path = /config/vpm.cfg

Adaptive 0 or 1

It defines the Type of Jitter Buffer.

0 stands for Fixed.

1 stands for Adaptive.

The default is 1.

Min Integer It defines the value of Min Delay.

The default is 0.

Max Integer It defines the value of Max Delay.

The default is 300.

Nominal Integer

It defines the value of Normal

Delay.

The default is 120.

[ Message ]

path =

/config/Features/Message.cfg

VoiceNumber0 String

It defines Voice Mail number of

account1.

No default value.

VoiceNumber1 String


account2.

No default value.

VoiceNumber2 String


account3 if the account exists.

No default value.

VoiceNumber3 String



No default value.

VoiceNumber4 String



No default value.

VoiceNumber5 String



No default value.

[ Country ]

path = /config/voip/tone.ini Country string

It defines the country name that

relates to its own tone rules.

The valid values can be seen from

26

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

the webpage which are like China,

France and so on.

It can be specified as Custom in

which case the tone rules can be

customized.

[ Tone Param ]

path = /config/voip/tone.ini

dial string

It defines the tone of Dial which will

be active when the Country is

chosen

The format of the string is like

100/200/300 which means it will be

a tone of 100Hz with 200ms

duration, followed by a 300ms pause

and then repeat.

0 stands for silence.

No default value.

ring string

It defines the tone of Ring Back.

The format is the same as dial.

No default value.

busy string

It defines the tone of Busy.


No default value.

congestion string

It defines the tone of Congestion.


No default value.

callwaiting string

It defines the tone of Call Waiting.


No default value.

dialrecall string

It defines the tone of Dial Recall.


No default value.

record string

It defines the tone of Record.


No default value.

info string

It defines the tone of Info.


No default value.

stutter string

It defines the tone of Stutter.


No default value.

message string

It defines the tone of Message.


No default value.

autoanswer string

It defines the tone of Auto Answer.


No default value.

27

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

[ Default ]

path = /config/voip/tone.ini

dial 0 or 1

It defines whether to enable the

customized ringtone of Dial when in

Custom mode.



The default is 1.

ring 0 or 1


customized ringtone of Ring Back

when in Custom mode.



The default is 1.

busy 0 or 1


customized ringtone of Busy when

in Custom mode.



The default is 1.

congestion 0 or 1


customized ringtone of Congestion




The default is 1.

callwaiting 0 or 1


customized ringtone of Call

Waiting when in Custom mode.



The default is 1.

dialrecall 0 or 1


customized ringtone of Dial Recall




The default is 1.

record 0 or 1


customized ringtone of Record




The default is 1.

info 0 or 1


customized ringtone of Info when in

Custom mode.

28

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81



The default is 1.

stutter 0 or 1


customized ringtone of Stutter




The default is 1.

message 0 or 1


customized ringtone of Message




The default is 1.

autoanswer 0 or 1


customized ringtone of Auto

Answer when in Custom mode.



The default is 1.

[ AreaCode ]

path =

/config/DialRule/areacode.cfg

Code Integer It defines the Code of Area Code.

No default value.

minlen Integer

It defines the Min Length of Area

Code.

No default value.

maxlen Integer

It defines the Max Length of Area

Code.

No default value.

[ BlockOut ]

path =

/config/DialRule/BlockOut.cfg

1 Number or

String

It defines a number which will be

block when dial it out. Besides a

specific number, it support some

special characters:

string with arbitrary length.

or string.

For other details, please refer to

User Manual.

2

They share the same Permitted Value and rules as

1.

3

4

5

6

29

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

7

8

9

10

[ RemotePhoneBook0 ]


URL HTTP URL

It defines the Phone book url

which must be a url linking to an

XML-format phonebook like

http://192.168.0.231/Vin/phonebo

ok1.xml

NO default value.

Name String

It defines the Phone book name of

the first Remote phonebook.

For more details, please refer to the

instruction to Remote phonebook.



They share the same parameters and Permitted Values as

[ RemotePhoneBook0 ].







[ AdminPassword ]

path = /config/Setting/autop.cfg password String

It defines the new password for

admin.

[ UserPassword ]

path = /config/Setting/autop.cfg password String

It defines the new password for

user.

[ Webserver Type ]

path =

/config/Advanced/Advanced.cfg

WebType 0,1,2 or 3

It defines the WebServer Type.


1 stands for HTTP & HTTPS.

2 stands for HTTP Only.

3 stands for HTTPS Only.

The default is 1.

http://192.168.0.231/Vin/phonebook1.xml

http://192.168.0.231/Vin/phonebook1.xml

30

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

2.5 Configure the Expansion Module via Auto Provisioning

1. Connect the expansion module to the phone.

2. Open the .CFG file which you want to use for provision, and edit it as below:

[key0]

Path= /config/vpPhone/Ext38_00000000000001.cfg

DKtype =

Line =

Value =

Type =

PickupValue =

[key1]

Path= /config/vpPhone/Ext38_00000000000001.cfg

DKtype =

Line =

Value =

Type =

PickupValue =

Note:

Ext38_00000000000001.cfg means the first expansion module. If you want to configure more

than one expansion module, it will be Ext38_00000000000002.cfg,

Ext38_00000000000003.cfg

[key0] means the first DSS key on the expansion module, [key1]

31

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

DKtype = Line = Value = Type = PickupValue =

details please see the list below.

type blf or bla

It is used when configuring a DSS

Key as BLF or Shared Line.

blf stands for BLF.

bla stands for Shared Line.

No default value.

Line Integer from 0 to

max line number


value under Line title.

It defines the Line you are going to

use for a specific function (if the

function needs to specify a line).

Normally,0 stands for Auto,1 stands

for Line1 and so on.

configured as bla or blf in which case

0 stands for Line1, 1 stands for Line2

and so on. The default is 0.

Value It depends


value under Extension title.

Normally, the value is an extension

For example, when you configure a

key as URL, the value must be a url

string. No default value.

PickupValue string

It is used only for BLF. It defines the

pickup number that your server

allocates.

DKtype Integer

function.

0:N/A 1:Conference

2:Forward 3:Transfer

4:Hold 5:DND

6:Redial 7:Call Return

8:SMS 9:Call Pickup

10:Call Park 11:Custom

12:Voicemail 13:SpeedDial

14:Intercom 15:Line(for line key

only)

16:BLF 17:URL

18:Group Listening 19:Public

Hold

20:Private Hold

The default is 0.

32

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

For example if your want to configure some BLF No. to the expansion module, you can refer to the

picture below:

The example for the setting of each type.

1. BLF setting

[ Key0 ]

DKtype = 16

Line = 1

Value = 263

Type = blf

PickupValue = *97

2. Speed Dial setting

[ Key0 ]

DKtype = 13

Line = 2

Value = 1000

Type =

PickupValue =

33

www.tiptel.nl


Tel: 036 53 666 50 Fax: 036 53 678 81

3. KeyEvent setting

[ Key0 ]

DKtype = 1

Line = 0

Value =

Type =

PickupValue =

4. Intercom setting

[ Key0 ]

DKtype = 14

Line = 3

Value = 456

Type =

PickupValue =

5. Share Line setting

[ Key0 ]

DKtype = 21

Line = 2

Value = 21

Type = bla

PickupValue =

6. URL setting

[ Key0 ]

DKtype = 17

Line = 0

Value = http://tiptel/GoVo/ok.php

Type =

PickupValue =

3. Put the .cfg file to your provision server and follow the normal auto provision process to do it.

Auto Provision Manual Version 1 2 3

Documents

Transcript of Auto Provision Manual Version 1 2 3