Configuration File Parameters for SIP Provisioning

This article is applicable to all IP Stations (Turbine and INCA stations) operating in SIP mode.

Remote Provisioning using TFTP

An IP station may be set up to automatically poll configuration from a TFTP server. The IP address of this TFTP server can be obtained using DHCP procedures or be manually configured.

The IP station will first try to download the global configuration file:

ipst_config.cfg

Then the IP station will download a device specific configuration file:

ipst_config_01_02_03_04_05_06.cfg

where 01_02_03_04_05_06 is the MAC address of the IP station.

If the same parameter is found in both files, the value from the device specific file takes precedence.

General Parameters

auto_update_interval

• Required: No. If this parameter is not set in the file, the function will be disabled.
• Description: This parameter enables the station to automatically look for software updates on the TFTP server.
• Values: Number of minutes to wait between each server request. Value must be between 1 and 999.

auto_update_image_type

• Required: If auto_update_interval is set.
• Description: The name of the software image file to be uploaded.
• Values: Text giving the name of the software image file. The full name of the file, including extension, is required. This parameter must be set if the auto update function is enabled.

auto_update_image_crc

• Required: If auto_update_interval is set.
• Description: The CRC checksum calculated for the software image file specified by the auto_update_image_type parameter. This is used to check the integrity of the software file before updating the station.
• Values: Hexadecimal value.

SIP Parameters

nick_name

• Required: No. Defaults to sip_id.
• Description: The nickname for the station can be used to assign a logical name to the station. For example, a station belonging to James may be assigned the nickname “James” or “James’ station”.
• Values: Text string. Max length is 64 characters.

sip_id

• Required: Yes
• Description: This is the identification of the station in the SIP domain, i.e. the phone number of the station.
• Values: Integer value. Max length is 64 characters.

sip_domain

• Required: Yes
• Description: SIP domain is a server that uses SIP (Session Initiation Protocol) to manage real-time communication among SIP clients. The sip_domain parameter specifies the primary domain for the station, as opposed to sip_domain2 which specifies the secondary (or fallback) domain. The IP address for the SIP domain server (e.g. Asterisk or Cisco Call Manager) should be defined in this section.
• Values: IP address given in regular dot notation, e.g. 10.5.2.100

sip_domain2

• Required: No
• Description: This is the secondary (or fallback) domain. If the station loses connection to the primary SIP domain, it will switch over to the secondary domain.
• Values: IP address given in regular dot notation, e.g. 10.5.2.100

sip_domain3

• Required: No
• Description: This is the tertiary (or fallback) domain. If the station loses connection to the secondary SIP domain, it will switch over to the tertiary domain.
• Values: IP address given in regular dot notation, e.g. 10.5.2.100

auth_user

• Required: Only if the SIP server requires authentication.
• Description: The authentication user name used to register the station to the SIP server.
• Values: Text string.

auth_pwd

• Required: Only if the SIP server requires authentication.
• Description: The authentication user password used to register the station to the SIP server.
• Values: Text string.

sip_outbound_proxy

• Required: Optional
• Description: Configures an outbound proxy server that receives all initiating request (INVITE and SUBSCRIBE) messages.
• Values: IP address given in regular dot notation, e.g. 10.5.2.100

sip_outbound_proxy_port

• Required: If proxy server is defined. Default is 5060.
• Description: The UDP port on the SIP proxy server.
• Values: Integer.

register_interval

• Required: No. Defaults to 600 seconds.
• Description: This parameter specifies how often the station will register, and reregister, in the SIP domain. This parameter will affect the time it takes to discover that a connection to a SIP domain is lost.
• Values: Number of seconds. 60 ≤ register_interval ≤ 999999