Difference between revisions of "Configuration File Parameters for SIP Provisioning"
From Zenitel Wiki
ZenitelAus (talk | contribs) |
|||
(37 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{S}}This article describes the parameters in the configuration file used for TFTP Provisioning. See [[SIP | + | {{S}}This article describes the parameters in the configuration file used for TFTP Provisioning. See [[TFTP Provisioning (SIP)|TFTP Provisioning]] for how to configure the station for this function. |
− | TFTP Provisioning is supported by all | + | TFTP Provisioning is supported by all [[:Category:Stations|IP Stations]] when operating in '''SIP mode'''. |
− | + | ==Remote Provisioning using TFTP== | |
− | == 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. | 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: | The IP station will first try to download the global configuration file: | ||
− | + | {{code|ipst_config.cfg}} | |
Then the IP station will download a device specific configuration file: | Then the IP station will download a device specific configuration file: | ||
− | + | {{code|ipst_config_01_02_03_04_05_06.cfg}} where '''01_02_03_04_05_06''' is the MAC address of the IP station. Or: | |
− | where '''01_02_03_04_05_06''' is the MAC address of the IP station. | + | {{code|ipst_config_10_9_8_7.cfg}} |
+ | where '''10_9_8_7''' is the IP address of the IP station. | ||
If the same parameter is found in several files, then the precedence is as following: | If the same parameter is found in several files, then the precedence is as following: | ||
+ | |||
#.MAC address file | #.MAC address file | ||
#IP address file | #IP address file | ||
#Global file | #Global file | ||
− | == | + | {{note| |
+ | * ''The last line in the configuration file must be terminated with <'''Enter'''> (CR-LF), else the configuration will not be applied.'' | ||
+ | * ''If there are changes in the configuration file that require a reboot to take effect, the station will do a reboot when the cofiguration file is downloaded and changes are applied'' | ||
+ | * ''If there are no changes in the downloaded configuration file compared to the previous downloaded file, the station will ignore the new file'' }} | ||
+ | |||
+ | |||
+ | ==Detailed description of general parameters== | ||
+ | ===auto_update_interval=== | ||
+ | |||
+ | *Required: No. If this parameter's 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 | ||
+ | |||
+ | ===use_last_known_ip (INCA stations only)=== | ||
− | + | *Required: No. Default is 0. | |
− | * | + | *Description: Use Last IP On DHCP failure. |
+ | *Values: Integer Value. 0 = disabled, 1 = enabled | ||
− | + | ===turbine_frontboard (deprecated from VS-IS 7.1)=== | |
− | * | + | *Description: Configures the turbine frontboard type |
+ | *Values: | ||
+ | **0 = KIT | ||
+ | **1 = TCIS-1, TCIS-2, TCIS-3 | ||
+ | **2 = TCIS-6 | ||
+ | **3 = TCIS4, TCIS-5 | ||
+ | **4 = TFIE-1, TFIX-1 | ||
+ | **5 = TFIE-2, TFIX-2 | ||
+ | **6 = TFIX-3 | ||
+ | **7 = ECPIR-P | ||
+ | **8 = EAPII-1, EAPFX-1 | ||
+ | **9 = EAPII-6, EAPFX-6 | ||
+ | **10 = ECPIR-3P | ||
+ | **11 = EAPIR-8 | ||
+ | **13 = TFIE-6 | ||
+ | **45 = IP-LCM | ||
+ | **51 = TCIV-2, TCIV-3 | ||
+ | **52 = TCIV-6 | ||
+ | **53 = TMIS1, TMIS-2 | ||
+ | **54 = TCIV-5 | ||
− | === | + | ==Detailed description of Relay parameter== |
− | |||
− | * | + | *The following relay keys are supported: |
+ | **relay1 and relay2 for station physical relays | ||
+ | **gpio1 to gpio6 for I/O pins configured as outputs | ||
+ | **e_relay1 and e_relay2 for TA-10 relay module | ||
+ | *To configure specific relay rename the parameter to contain the proper relay key, i.e. instead of "relay1_dtmf_activate" use "gpio1_dtmf_activate". | ||
− | + | ===relay1_dtmf_activate=== | |
− | + | *Description: Dtmf value to send for activating the relay | |
− | * | + | *Values: Valid values is 0-9, * and #. The character - means off. |
− | + | ===relay1_dtmf_deactivate=== | |
− | * | + | *Description: Dtmf value to send for deactivating the relay |
+ | *Values: Valid values is 0-9, * and #. The character - means off. | ||
− | === | + | ===relay1_dtmf_flashing_slow=== |
− | |||
− | * | + | *Description: Dtmf value to send for setting the relay to flashing slow |
− | * 0 | + | *Values: Valid values is 0-9, * and #. The character - means off. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | * | ||
− | |||
− | == | + | ===relay1_dtmf_flashing_fast=== |
− | + | *Description: Dtmf value to send for setting the relay to flashing fast | |
− | * | + | *Values: Valid values is 0-9, * and #. The character - means off. |
− | + | ===relay1_dtmf_toggle=== | |
− | * | + | *Description: Dtmf value to send for toggling the relay |
+ | *Values: Valid values is 0-9, * and #. The character - means off. | ||
− | === | + | ===relay1_dtmf_timed_relay=== |
− | |||
− | * | + | *Description: Dtmf value to send for activating the relay for X seconds |
+ | *Values: Valid values is 0-9, * and #. The character - means off. | ||
− | + | ===relay1_dtmf_timed_relay_duration=== | |
− | + | *Description: Duration to activate relay | |
− | * | + | *Values: Integer. 0 means activate relay forever. |
− | + | ===relay1_event_out_ringing=== | |
− | * | + | *Description: When the station is ringing in an outgoing call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
+ | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | ||
− | === | + | ===relay1_event_inc_ringing=== |
− | |||
− | * | + | *Description: When the station is ringing in an incoming call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
+ | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | ||
− | + | ===relay1_event_inc_call=== | |
− | === | + | *Description: When the station is in an incoming call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
− | + | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | |
− | + | ===relay1_event_out_call=== | |
− | * | + | *Description: When the station is in an outgoing call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
+ | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | ||
− | === | + | ===relay1_event_group_call=== |
− | |||
− | * | + | *Description: When the station is in a group call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
+ | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | ||
− | + | ===relay1_event_idle=== | |
− | === | + | *Description: When the station is idle, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
− | + | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | |
− | + | ===relay1_event_error=== | |
− | * | + | *Description: When the station is error, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing |
+ | *Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast | ||
− | === | + | ==Detailed description of Tone parameter== |
− | + | ===enabled=== | |
− | * | + | *Description: Enables tone test |
+ | *Values: Integer Value. 0 = disabled, 1 = enabled | ||
− | + | ===time_between_tonetest=== | |
− | + | *Description: Time between tone tests | |
− | * | + | *Values: Integer Value. |
− | + | ===sound_pressure_level (obsolete for SW > 6.1.3.0)=== | |
− | * | + | *Description: Minimum sound pressure level between silence and tone |
+ | *Values: Integer Value. Only odd values. 53 ≤ sound_pressure_level ≤ 97 | ||
− | === | + | ===volume (obsolete for SW > 6.1.3.0)=== |
− | |||
− | * | + | *Description: Volume of the tone test |
+ | *Values: Integer Value. 0 ≤ volume ≤ 7 | ||
− | + | ===auto_set_sound_pressure_level (obsolete for non-INCA stations)=== | |
− | + | *Description: Only available on INCA stations, station tries to calculate the parameter 'Minimum sound pressure level' (sound_pressure_level). | |
− | * | + | *Values: Integer Value. 0 = disabled, 1 = enabled |
− | + | ===tone_selection (SW > 6.1.3.0)=== | |
− | * | + | *Description: Defines frequency groups for the tone test. |
+ | *Values: Integer value. 1 <= tone_selection <= 8 | ||
− | == | + | ==Detailed description of SIP parameters== |
+ | ===nick_name=== | ||
− | + | *Required: No. Defaults to sip_id | |
− | * ' | + | *Description: The nick name for the station can be used to assign a logical name to the station. E.g. a station belonging to James may be assigned the nick name "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 for 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 fall back) 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 fall-back) domain. If the station loses connection to the primary SIP domain, it will switch over to the secondary. | ||
+ | *Values: IP address given in regular dot notation, e.g. 10.5.2.100 | ||
− | + | ===sip_domain3=== | |
− | + | *Required: No | |
− | * | + | *Description: This is the tertiary (or fall-back) domain. If the station loses connection to the primary and secondary SIP domain, it will switch over to the tertiary. |
+ | *Values: IP address given in regular dot notation, e.g. 10.5.2.100 | ||
− | + | ===registration_method=== | |
− | + | *Required: No | |
− | * | + | *Description: Registration method which the station will use if fall-back domains are available. |
+ | *Values: parallel = Parallel registration to fall-back domains, serial = Serial registration to fall-back domains | ||
− | + | ===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 5060. | |
− | * | + | *Description: The UDP port used for SIP on the 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 | ||
− | === | + | ===fail_interval (since 4.9.3.2)=== |
− | |||
− | * | + | *Required: No. Defaults to 60 seconds |
+ | *Description: In case Primary and both Backup servers are failing with SIP INVITEs, the device should go into failure mode, and immediately start sending REGISTER requests to all SIP servers, in time periods using this failure interval. | ||
+ | *Values: Number of seconds. 5 ≤ fail_interval ≤ 999999 | ||
− | + | ===playback_gain (RS amplifier only)=== | |
− | + | *Required: No. | |
− | * | + | *Description: This parameter specifies the gain on a output channel |
+ | *Values: dB. -40 ≤ playback_gain ≤ 0 | ||
− | + | ===recorder_gain (RS amplifier only)=== | |
− | * | + | *Required: No. |
+ | *Description: This parameter specifies the gain on a input channel | ||
+ | *Values: dB. 0 ≤ recorder_gain ≤ 40 | ||
− | === | + | ==Detailed description of Call parameters== |
− | |||
− | * | + | *DAK, input and special keys configuration have the same parameters available, the exact name of the parameter will depend on the desired key ID and the name must start with that key ID. |
− | * | + | *Depending on the station type, the following key IDs will be available: |
+ | **input1 to input6 | ||
+ | **dak1 to dak10 | ||
+ | **offhook | ||
+ | **onhook | ||
+ | **ptt | ||
+ | *For example, parameters name would then look like this: | ||
+ | **input2_function | ||
+ | **dak1_function | ||
+ | **offhook_function | ||
+ | **onhook_function | ||
+ | **dak_function | ||
+ | *This document will use "dak1" as an example for configuration parameters. | ||
− | === | + | ===dak1_value=== |
− | |||
− | * | + | *Required: Yes for input1_function values 0 (default, call to), 3 (forward call) and4 (group call). |
+ | *Description: This is the SIP ID for the extension to be called when the first DAK button is pressed, i.e. the telephone number of the receiving party. It's also used if input1_function is set to 3 (forward call to SIP ID) or 4 (group call to SIP ID). | ||
+ | *Values: String value | ||
− | + | ===dak1_option=== | |
− | + | *Required: No | |
− | * | + | *Description: Used in combination with call to function, configures if ringlist will be used or not. |
+ | *Values: Integer. -1 is no ringlist. 0 is ringlist 1. 1 is ringlist 2. 2 is ringlist 3. | ||
− | + | ===dak1_text (DualDisplay stations only)=== | |
− | * | + | *Required: No |
+ | *Description: Text which will be visible on the display next to DAK button 1. Note that this option will do nothing on inputs. | ||
+ | *Values: String value | ||
− | === | + | ===dak1_function=== |
− | |||
− | * | + | *Required: No. Default value is 0 (call to) |
+ | *Description: This decides what input button 1 will do when outside calls. | ||
+ | *Values: Integer. 0 is call to.1 is do nothing. 3 is forward call (Turbine only). 4 is group call (Turbine only). 5 is conversation mode (Turbine only). 6 is volume control (Turbine only). | ||
− | + | ===dak1_in_call_function=== | |
− | + | *Required: No. Default value is 1 (do nothing) | |
− | * | + | *Description: This decides what input button 1 will do when in calls. |
+ | *Values: Integer. 0 is answer/end call.1 is do nothing. 2 is send DTMF. 3 is send text. 5 is end call. 6 is answer call. 7 is park call. 9 is push to talk. 10 is hold call. 11 is defer | ||
− | + | ===dak1_dtmf_on=== | |
− | * | + | *Required: No. Only used with in call function "Send DTMF". |
+ | *Description: Which DTMF value will be sent when DAK button 1 is pressed. | ||
+ | *Values: String. Supported values are from 0 to 9, and *, #, ! (DTMF Flash), O (Do Nothing). | ||
− | === | + | ===dak1_dtmf_off=== |
− | |||
− | + | *Required: No. Only used with in call function "Send DTMF". | |
− | * | + | *Description: Which DTMF value will be sent when DAK button 1 is released. |
+ | *Values: String. Supported values are from 0 to 9, and *, #, ! (DTMF Flash), O (Do Nothing). | ||
− | === | + | ===dak1_text_on=== |
− | |||
− | |||
− | + | *Required: No. Only used with in call function "Send Text". | |
− | * | + | *Description: Which text value will be sent when DAK button 1 is pressed. |
+ | *Values: String. | ||
− | + | ===dak1_text_off=== | |
− | * | + | *Required: No. Only used with in call function "Send Text". |
+ | *Description: Which text value will be sent when DAK button 1 is released. | ||
+ | *Values: String. | ||
− | === | + | ===ringlist1_value1=== |
− | |||
− | * | + | *Required: No |
+ | *Description: This is the SIP ID for the extension to be called when ringlist 1 is used and it is at first entry. The next numbers in the ringlist is then ringlist1_value2, ringlist1_value3 etc. | ||
+ | *Values: String value | ||
− | + | ===ringlist1_wp1=== | |
− | + | *Required: No, default value is 0 (disabled) | |
− | * | + | *Description: Call with previous parameter for the first entry in the ringlist 1. The next numbers in the ringlist is then ringlist1_wp2, ringlist1_wp3 etc. |
+ | *Values: Integer. 0 = disabled, 1 = enabled | ||
− | + | ===ringlist2_value1=== | |
− | * | + | *Required: No |
+ | *Description: This is the SIP ID for the extension to be called when ringlist 2 is used and it is at the first entry. The next numbers in the ringlist is then ringlist2_value2, ringlist2_value3 etc. | ||
+ | *Values: String value | ||
− | === | + | ===ringlist2_wp1=== |
− | |||
− | * | + | *Required: No, default value is 0 (disabled) |
+ | *Description: Call with previous parameter for the first entry in the ringlist 2. The next numbers in the ringlist is then ringlist2_wp2, ringlist2_wp3 etc. | ||
+ | *Values: Integer. 0 = disabled, 1 = enabled | ||
− | + | ===ringlist3_value1=== | |
− | + | *Required: No | |
− | * | + | *Description: This is the SIP ID for the extension to be called when ringlist 3 is used and it is at the first entry. The next numbers in the ringlist is then ringlist3_value2, ringlist3_value3 etc. |
+ | *Values: String value | ||
− | + | ===ringlist3_wp1=== | |
− | * | + | *Required: No, default value is 0 (disabled) |
+ | *Description: Call with previous parameter for the first entry in the ringlist 3. The next numbers in the ringlist is then ringlist3_wp2, ringlist3_wp3 etc. | ||
+ | *Values: Integer. 0 = disabled, 1 = enabled | ||
− | === | + | ===ringlist_max_ring_time=== |
− | |||
− | * | + | *Required: No. Defaults to 4 |
+ | *Description: This parameter sets the time to wait ringing until step to next value in the ringlist | ||
+ | *Values: Number of seconds. 0 ≤ ringlist_max_ring_time ≤ 999999 | ||
− | + | ===ringlist_loop=== | |
− | + | *Required: No. Defaults to 0 | |
− | * | + | *Description: This parameter enable the loop so list is repeated until answer. |
+ | *Values: Integer. 0 to disable, 1 to enable | ||
− | + | ===ringlist_max_conv_time=== | |
− | * | + | *Required: No. Defaults to 4 |
+ | *Description: This parameter sets the max time of the conversation when followed ringlist | ||
+ | *Values: Number of seconds. 0 ≤ ringlist_max_conv_time ≤ 999999 | ||
− | === | + | ===conv_time=== |
− | |||
− | * | + | *Required: No. Defaults to 3600 |
+ | *Description: This parameter sets the max time of the conversation | ||
+ | *Values: Number of seconds. 0 ≤ conv_time ≤ 999999 | ||
− | + | ===ring_time=== | |
− | + | *Required: No. Defaults to 120 | |
− | * | + | *Description: This parameter sets the max time of the ringing/alerting phase of the call |
+ | *Values: Number of seconds. 0 ≤ ring_time ≤ 999999 | ||
− | + | ===poe_audio (obsolete)=== | |
− | * | + | *Description: This parameter sets whether to disable maximum speaker output |
+ | *Values: Set to 0 to enable full audio output. Set to 1 to disable full audio output. | ||
− | === | + | ===speaker_volume=== |
− | |||
− | * | + | *Required: No. Defaults to 4 |
+ | *Description: This parameter sets the volume of the station's speaker | ||
+ | *Values: Integer. 0 ≤ speaker_volume ≤ 7 | ||
− | + | ===mic_sensitivity=== | |
− | + | *Required: No. Defaults to 5 | |
− | * | + | *Description: This parameter adjusts the microphone sensitivity |
+ | *Values: Integer. 0 ≤ mic_sensitivity ≤ 7 | ||
− | + | ===noise_reduction=== | |
− | * | + | *Required: No. Defaults to 0 |
+ | *Description: This parameter adjusts the noise reduction level | ||
+ | *Values: Integer. 0 ≤ noise_reduction ≤ 7 | ||
− | === | + | ===echo_parameter (INCA stations only)=== |
− | |||
− | * | + | *Required: No. Defaults to 0 |
+ | *Description: This parameter adjusts the echo parameter | ||
+ | *Values: Integer. 0 ≤ echo_parameter ≤ 7 | ||
− | + | ===rtp_timeout=== | |
− | + | *Required: No. Defaults to 0 | |
− | * | + | *Description: Cancels a call if the station does not receive rtp. |
+ | *Values: Integer value: 0-9999 seconds. 0 = RTP timeout disabled. | ||
− | + | ===remote_controlled_volume_override_mode=== | |
− | * | + | *Required: No. |
+ | *Description: Acts as a simplex mode after first DTMF * or # is received. At remote station: send DTMF * to talk and # to listen. | ||
+ | *Values: Integer. 0 disabled, 1 enabled. | ||
− | === | + | ===speech_mode=== |
− | |||
− | * | + | *Required: No. |
+ | *Description: Set the conversation mode. | ||
+ | *Values: Integer. 0 = Full Open Duplex, 1 = Push To Talk, 2 = Half Duplex Switching, 3 = Open, 4 = Robust Duplex. | ||
− | + | ===ptt_mode=== | |
− | + | *Required: No. | |
− | * | + | *Description: Set the PTT mode, only active if Conversation Mode is set to PTT. |
+ | *Values: ptt_mic_and_speaker = Mic and speaker is controlled by PTT button, ptt_mic_only = Mic is controlled by PTT button. | ||
− | + | ===auto_answer_mode=== | |
− | * | + | *Required: No. |
+ | *Description: Enables autoanswer after a set number of seconds. | ||
+ | *Values: Integer. 0 disabled, 1 enabled. | ||
− | === | + | ===auto_answer_delay=== |
− | |||
− | * | + | *Required: No. Defaults to 0. |
+ | *Description: The number of seconds to delay the autoanswer | ||
+ | *Values: Integer. 0 ≤ delay ≤ 30 | ||
− | + | ===accessory=== | |
− | === | + | *Required: No. Defaults to 0. |
− | + | *Description: Which accessory to use | |
+ | *Values: 0 = unused/default, 1 = handset, 2 = microphone w/ptt, 3 = headset, 4 = handset w/offhook, 5 = headset auto detect, 6 = handset w/offhook normally closed | ||
− | + | ===input_as_key_matrix=== | |
− | * | + | *Required: No. Defaults to 0. |
+ | *Description: Use inputs as a key matrix. Requires that gpio is configured as gpi/input | ||
+ | *Values: 0 = no inputs as key, 1 = means 1 input as as key matrix (1 dak), 2 = means 2 inputs as as key matrix (3 daks), 3 = means 3 inputs as as key matrix (7 daks) | ||
− | == | + | ===fast_blink_pattern=== |
− | + | *Required: No. Defaults to 111000111000111000111000 | |
− | * | + | *Description: Customize fast blink pattern |
+ | *Values: 1 = gpo high, 0 = gpo low | ||
− | + | ===slow_blink_pattern=== | |
− | + | *Required: No. Defaults to 111111111111000000000000 | |
− | * | + | *Description: Customize slow blink pattern |
+ | *Values: 1 = gpo high, 0 = gpo low | ||
− | + | ===open_duplex_dtmf=== | |
− | + | *Required: No. Defaults to - | |
− | * | + | *Description: Forces the station in Open Duplex when configured DTMF is received |
+ | *Values: - = off, valid range: 0-9 | ||
− | + | ===override_remote_ptt=== | |
− | + | *Required: No. Defaults to 0 | |
− | * | + | *Description: If 2 stations call each other and Override Remote PTT is enabled, then conversation mode is switched to open duplex. |
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===dtmf_style=== | |
− | + | *Required: No. Defaults to 0 | |
− | * | + | *Description: Choose how to send DTMF |
+ | *Values: 0 = SIP INFO, 1 = RFC2833 | ||
− | + | ===tone_volume=== | |
− | + | *Required: No. Defaults to 0 | |
− | * | + | *Description: Control tone volume |
+ | *Values: -1 = no tones, 0 default volume, 1-4 increases volume | ||
− | + | ===codec_g729_pri=== | |
− | === | + | *Required: No |
− | + | *Description: Set the priority of g729 codec | |
+ | *Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority | ||
− | + | ===codec_g722_pri=== | |
− | + | *Required: No | |
− | * | + | *Description: Set the priority of g722 codec |
+ | *Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority | ||
− | + | ===codec_g711u_pri=== | |
− | + | *Required: No | |
− | * | + | *Description: Set the priority of g711u codec |
+ | *Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority | ||
− | + | ===codec_g711a_pri=== | |
− | + | *Required: No | |
− | * | + | *Description: Set the priority of g711a codec |
+ | *Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority | ||
− | + | ===io_pin1=== | |
− | + | *Required: No | |
− | * | + | *Description: Will the I/O pin 1 behave as an input or as an output. |
+ | *Values: 0 = Input, 1 = Output | ||
− | + | ===io_pin2=== | |
− | + | *Required: No | |
− | * | + | *Description: Will the I/O pin 2 behave as an input or as an output. |
+ | *Values: 0 = Input, 1 = Output | ||
− | + | ===io_pin3=== | |
− | + | *Required: No | |
− | * | + | *Description: Will the I/O pin 3 behave as an input or as an output. |
+ | *Values: 0 = Input, 1 = Output | ||
− | + | ===io_pin4=== | |
− | == | + | *Required: No |
+ | *Description: Will the I/O pin 4 behave as an input or as an output. | ||
+ | *Values: 0 = Input, 1 = Output | ||
− | === | + | ===io_pin5=== |
− | |||
− | * | + | *Required: No |
+ | *Description: Will the I/O pin 5 behave as an input or as an output. | ||
+ | *Values: 0 = Input, 1 = Output | ||
− | === | + | ===io_pin6=== |
− | |||
− | * | + | *Required: No |
+ | *Description: Will the I/O pin 6 behave as an input or as an output. | ||
+ | *Values: 0 = Input, 1 = Output | ||
− | === | + | ==Detailed description of SNMP parameters== |
− | + | ===trap_receiver=== | |
− | * | + | *Required: No. |
+ | *Description: The IP address of the server receiving SNMP traps. | ||
+ | *Values: IP address given in regular dot notation, e.g. 10.5.2.100 | ||
− | === | + | ===inform_receiver=== |
− | |||
− | * | + | *Required: No. |
+ | *Description: The IP address of the server receiving SNMP informs. | ||
+ | *Values: IP address given in regular dot notation, e.g. 10.5.2.100 | ||
− | == | + | ===network=== |
− | + | *Required: No. | |
− | * | + | *Description: Used, together with the network mask, to determine the allowed network for reading the MIB on the IP station. |
+ | *Values: IP address given in regular dot notation, e.g. 10.5.2.100. For example with an allowed network 10.5.2.0 and a network mask of 24, anyone with IP address 10.5.2.0 to 10.5.2.255 can access the MIB. | ||
− | + | ===network_mask=== | |
− | * | + | *Required: No. |
+ | *Description: The mask used to determine the allowed network for reading the MIB. | ||
+ | *Values: Integer. 0 ≤ network_mask ≤ 32. For example with an allowed network 10.5.2.0 and a network mask of 24, anyone with IP address 10.5.2.0 to 10.5.2.255 can access the MIB. | ||
− | === | + | ===community=== |
− | |||
− | * | + | *Required: No. |
+ | *Description: An text staring used as password for authentication. | ||
+ | *Values: String. | ||
− | + | ===enable_v1=== | |
− | + | *Required: No. | |
− | * | + | *Description: Enables reading of MIB using SNMP version 1 |
+ | *Values: Integer. 1 enabled. 0 disabled | ||
− | + | ===enable_v2c=== | |
− | * | + | *Required: No. |
+ | *Description: Enables reading of MIB using SNMP version 2c | ||
+ | *Values: Integer. 1 enabled. 0 disabled | ||
− | === | + | ===enable_ipsStarted=== |
− | |||
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when the station application is started | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_sipRegistered=== | |
− | + | *Required: No. Defaults to 1 | |
− | * | + | *Description: If enabled, the station will send an SNMP trap when successfully registered in the SIP domain |
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_sipRegisterFailed=== | |
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap if registration in the SIP domain failed | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | === | + | ===enable_callConnect=== |
− | |||
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when a call is connected | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_callConnectFailed=== | |
− | + | *Required: No. Defaults to 1 | |
− | * | + | *Description: If enabled, the station will send an SNMP trap if a call to the station fails to connect for any reason (busy etc.) |
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_callDisconnect=== | |
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when a call is disconnected | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | === | + | ===enable_buttonPressed=== |
− | |||
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when an input button has been pressed | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_buttonReleased=== | |
− | + | *Required: No. Defaults to 1 | |
− | * | + | *Description: If enabled, the station will send an SNMP trap when an input button has been released |
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_dakPressed=== | |
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when a DAK button has been pressed | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | === | + | ===enable_dakReleased=== |
− | |||
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when a DAK button has been released | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_relayActivated=== | |
− | + | *Required: No. Defaults to 1 | |
− | * | + | *Description: If enabled, the station will send an SNMP trap when a relay has been activated |
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_relayDeactivated=== | |
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when a relay has been deactivated | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | === | + | ===enable_buttonHanging=== |
− | |||
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when a button is hanging (pressed for more than 10 seconds). | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_soundTestSuccess=== | |
+ | *Required: No. Defaults to 1 | ||
+ | *Description: If enabled, the station will send an SNMP trap when a sound test has been successfull | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | === | + | ===enable_soundTestError=== |
− | |||
− | * | + | *Required: No. Defaults to 1 |
+ | *Description: If enabled, the station will send an SNMP trap when the tone test could not be carried out because the reference value ("silence") is not stable. This happens when measuring the "silence" several times, and the measured values are too different. | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | + | ===enable_soundTestFailed=== | |
+ | *Required: No. Defaults to 1 | ||
+ | *Description: If enabled, the station will send an SNMP trap when a sound test has failed because the microphone didn’t get loud enough tone from the speaker. | ||
+ | *Values: 0 = disabled, 1 = enabled | ||
− | === | + | ==Detailed description of Audio Files parameters== |
− | + | ===tftpserver=== | |
− | * | + | *Required: No. |
+ | *Description: IP Address of the TFTP server where audio files are located. | ||
+ | *Values: String Value | ||
− | + | ===ringing=== | |
+ | *Required: No. | ||
+ | *Description: Wav file to be played during outgoing calls. | ||
+ | *Values: String Value | ||
− | === | + | ==Detailed description of Time parameters== |
− | + | ===enabled=== | |
− | * | + | *Required: No. |
+ | *Description: If NTP is enabled or not. | ||
+ | *Values: Integer, 0 = disabled, 1 = enabled | ||
− | + | ===hostname=== | |
+ | *Required: No. | ||
+ | *Description: IP Address of hostname of NTP Server. | ||
+ | *Values: String Value | ||
− | === | + | ===time_region (Turbine stations only)=== |
− | |||
− | * | + | *Required: No. |
+ | *Description: Selected time region. | ||
+ | *Values: String Value | ||
− | + | ===time_zone (Turbine stations only)=== | |
+ | *Required: No. | ||
+ | *Description: Selected time zone. | ||
+ | *Values: String Value | ||
− | === | + | ===plus_minus (INCA stations only)=== |
− | |||
− | * | + | *Required: No. |
+ | *Description: If difference from GMT time is + or -. | ||
+ | *Values: String, + = positive difference, - = negative difference | ||
− | + | ===zone_hour (INCA stations only)=== | |
+ | *Required: No. | ||
+ | *Description: Hour difference from GMT time | ||
+ | *Values: Integer Value | ||
− | === | + | ===zone_minute (INCA stations only)=== |
− | |||
− | * | + | *Required: No. |
+ | *Description: Minutes difference from GMT time | ||
+ | *Values: Integer Value | ||
− | + | ===summertime (INCA stations only)=== | |
+ | *Required: No. | ||
+ | *Description: Automatically adjust clock for 'Daylight Saving Time'. | ||
+ | *Values: Integer, 0 = disabled, 1 = enabled. | ||
− | === | + | ==Detailed Description of DAVC parameters== |
− | |||
− | * | + | *NB! "avc_player_remotesLength" or "avc_target_receiversLength" have to be defined. |
+ | *The user have to specify how many AVC source/receiver devices they want to add by define the "avc_player_remotesLengt" or "avc_target_receiversLength", otherwise the DAVC configs won't be applied to the station. | ||
− | + | ===enable_davc=== | |
− | + | *Required: No. | |
− | * | + | *Description: *detail needed |
+ | *Values: Integer, 0 = disabled, 1 = enabled | ||
− | + | ===avc_algorithm_enable=== | |
− | * | + | *Required: No. |
+ | *Description: Enable AVC algorithm, and must be enabled on either all AVC Sources or all AVC Receivers. | ||
+ | *Values: Integer, 0 = disabled, 1 = enabled | ||
− | == | + | ===avc_algorithm_adjustmode=== |
− | |||
+ | *Required: No. | ||
+ | *Description: Changing mode in Adjustment Mode. | ||
+ | **Positive Mode: Gain adjustment is from zero at AVC threshold level and adjusted postive. AVC Receiver should have a low base gain. | ||
+ | **Negative Mode: Gain adjustment is from zero at AVC max level and adjusted with negative gain downwards. AVC Receiver should have a high base gain. | ||
+ | *Values: String, "positive" or "negative" | ||
+ | |||
+ | ===avc_algorithm_lowerthreshold=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Mic signal level where AVC starts to work. Below this level no adjustment is done, and Audio Receivers should work on default base gain. | ||
+ | *Values: Integer, Values between 30 dBA - 80 dBA, Have to be less than upper threshold value, default = 65 dBA. | ||
+ | |||
+ | ===avc_algorithm_upperthreshold=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Mic signal level where AVC stops to work. Above this level, no adjustment is done. The diff between upper and lower thresholds also defines the working range for AVC gain adjustments. In negative AVC mode this also defined the ambient level where configured base output gain is reached (offset adjustment is zero) | ||
+ | *Values: Integer, Values between 60 - 120 dBA, Have to be less than upper threshold value, default = 100 dB. (On firmware ver. 8.x and earlier the Values was between 80 - 120 dBA). | ||
+ | |||
+ | ===avc_algorithm_attackrate=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Determines how quickly the AVC adjusts gain on raising ambient audio level | ||
+ | *Values: Float with 1 decimal, Values between 0.1 dB/sec to 200 dB/sec, default = 10.0 dB/sec. | ||
+ | |||
+ | ===avc_algorithm_decayrate=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Determines how quickly the AVC adjusts gain on falling ambient audio level | ||
+ | *Values: Float with 1 decimal, Values between 0.1 dB/sec to 200 dB/sec, default = 1.0 dB/sec. | ||
+ | |||
+ | ===avc_algorithm_hysteresis=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Hysteresis around previous set ambient audio level before doing adjustments | ||
+ | *Values: Float with 2 decimal, Values between 0.00 dB to 200 dB, default = 3.00 dB. | ||
+ | |||
+ | ===avc_algorithm_farend_lockout_time=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: When playing audio in AVC Zone (far-end-signal) all AVC adjustments is locked. When there is a pause in far-end-signal, adjustment commences after this lockout-time | ||
+ | *Values: Float with 1 decimal, Values between 0.0 sec to 1.0 sec , default = 0.1 sec. | ||
+ | |||
+ | ===avc_target_receiversLength=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Define how many AVC receivers will be add, and the device is set to AVC Source | ||
+ | *Values: Integer | ||
+ | |||
+ | ===avc_target_receiver1_ipaddr=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: IP address of the first receivers, (For more receivers add "avc_algorithm_receiver3_ipaddr" and "avc_algorithm_receiver3_ipaddr" up to the length of receivers) | ||
+ | *Values: String | ||
+ | |||
+ | ===avc_player_remotesLength=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Define how many AVC source devices it will be and the device is set to AVC Receiver | ||
+ | *Values: Integer | ||
+ | |||
+ | ===avc_player_remote_selection_strategy=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Define the source selection strategy | ||
+ | *Values: String, "highest", "averge" and "averge_mid", default = "highest" | ||
+ | |||
+ | ===avc_player_remote1_id=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Source number of the first source (For more sources add "avc_player_remote2_id" etc) | ||
+ | *Values: String | ||
+ | |||
+ | ===avc_player_remote1_ch1=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Activate the audio channel 1 of the first source with "out_1", and delete this parameter for deactivate it. | ||
+ | *Values: String, "out_1" for activate | ||
+ | |||
+ | ===avc_player_remote1_ch2=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Activate the audio channel 2 of the first source with "out_2", and delete this parameter for deactivate it. | ||
+ | *Values: String, "out_2" for activate | ||
+ | |||
+ | |||
+ | ==Detailed Description of Multicast Paging== | ||
+ | ===mcast_enabled=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Activate Multicast Paging | ||
+ | *Values: Integer, 0 = disable, 1 = enable | ||
+ | |||
+ | ===order_enabled=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: Activate Order Priority in multicast paging | ||
+ | *Values: Integer, 0 = disable, 1 = enable | ||
+ | |||
+ | ===mcast_stream1_label=== | ||
+ | |||
+ | *Required: No. | ||
+ | *Description: First Paging label ( "mcast_stream2_label" is the second paging label and etc) | ||
+ | *Values: String. | ||
+ | |||
+ | ===mcast_stream1_address=== | ||
+ | |||
+ | *Required: No, have to define when mcast_stream1_label is defined. | ||
+ | *Description: Listening address of First Paging label ( "mcast_stream2_address" is the listening address for second paging ) | ||
+ | *Values: String. | ||
+ | |||
+ | ===mcast_stream1_port=== | ||
+ | |||
+ | *Required: No, have to define when mcast_stream1_label is defined. | ||
+ | *Description: Port number of the first paging label ( "mcast_stream2_port" is the port for second paging) | ||
+ | *The ports must be within the port range 61020-61250, recommended range is 61080-61250. Using odd numbers is not recommended for ports. Listening address and port must be defined. | ||
+ | *Values: Integer | ||
+ | |||
+ | ===mcast_stream1_codec=== | ||
+ | |||
+ | *Required: No, have to define when mcast_stream1_label is defined. | ||
+ | *Description: Which codec is used for the first paging label ( "mcast_stream2_codec" is the codec for second paging) | ||
+ | *Values: String, Choose between "g729", "g729", "g711a", "g711u" and "L16x48D". | ||
+ | |||
+ | ===mcast_stream1_priority=== | ||
+ | |||
+ | *Required: No, have to define when mcast_stream1_label is defined. | ||
+ | *Description: Set the priority for the first paging ( "mcast_stream2_priority" is the codec for second paging) | ||
+ | *Values: String, Choose between "low", "normal", "high" and "emergency". | ||
+ | |||
+ | ===mcast_stream1_order=== | ||
+ | |||
+ | *Required: No, have to define when mcast_stream1_label is defined. | ||
+ | *Description: Order of the first paging ( "mcast_stream2_order" is the order for second paging) | ||
+ | *Values: Integer, Choose between 0 - 9. | ||
+ | |||
+ | ===mcast_stream1_linemask=== | ||
+ | |||
+ | *Required: No, have to define when mcast_stream1_label is defined. | ||
+ | *Description: Select which Channels (Only for amplifiers) | ||
+ | *Values: Integer, 1 = Channel 1, 2 = Channel 2, 3 = Channel 1 and Channel 2 | ||
+ | |||
+ | ==Intercom Example== | ||
[general] | [general] | ||
auto_update_interval=10 | auto_update_interval=10 | ||
auto_update_image_type=A100G80200.01_10_1_2.bin | auto_update_image_type=A100G80200.01_10_1_2.bin | ||
auto_update_image_crc=C1466499 | auto_update_image_crc=C1466499 | ||
− | |||
[tone] | [tone] | ||
volume=2 | volume=2 | ||
Line 623: | Line 951: | ||
enabled=0 | enabled=0 | ||
sound_pressure_level=65 | sound_pressure_level=65 | ||
− | |||
[relays] | [relays] | ||
relay1_dtmf_activate=1 | relay1_dtmf_activate=1 | ||
Line 638: | Line 965: | ||
relay1_event_idle=2 | relay1_event_idle=2 | ||
relay1_event_error=4 | relay1_event_error=4 | ||
− | |||
[sip] | [sip] | ||
nick_name=Testname | nick_name=Testname | ||
Line 653: | Line 979: | ||
sip_id=1006 | sip_id=1006 | ||
sip_domain=10.5.2.209 | sip_domain=10.5.2.209 | ||
− | |||
[sip_ln1] Amplifier line in 1 configuration | [sip_ln1] Amplifier line in 1 configuration | ||
recorder_gain=15 | recorder_gain=15 | ||
Line 700: | Line 1,025: | ||
network=10.5.2.0 | network=10.5.2.0 | ||
network_mask=24 | network_mask=24 | ||
+ | network_ipv6=fec0:: | ||
+ | network_ipv6_length=64 | ||
community=public | community=public | ||
enable_v1=1 Accepted values 0 or 1. | enable_v1=1 Accepted values 0 or 1. | ||
Line 718: | Line 1,045: | ||
enable_soundTestFailed=1 Accepted values 0 or 1. | enable_soundTestFailed=1 Accepted values 0 or 1. | ||
+ | [audio_files] | ||
+ | tftpserver=10.8.25.200 | ||
+ | ringing=ringing.wav | ||
− | |||
− | + | [time] | |
+ | enabled=1 | ||
+ | hostname=10.8.25.200 | ||
+ | time_region=America | ||
+ | time_zone=Denver | ||
− | + | ==Amplifier Example== | |
− | + | [sip] | |
− | + | sip_id=0203 | |
− | + | sip_domain=10.5.11.75 | |
− | + | nick_name=CCP03 | |
− | + | auth_user=0203 | |
− | + | auth_pwd=Ashley77 | |
− | + | ||
− | + | [call] | |
− | + | # Use 3 GPI as key matrix for DAK1-7 | |
− | + | input_as_key_matrix=3 | |
− | + | io_pin1=0 | |
− | + | io_pin2=0 | |
− | + | io_pin3=0 | |
− | + | io_pin4=1 | |
− | + | io_pin5=1 | |
− | + | io_pin6=1 | |
− | + | fast_blink_pattern=1011111 | |
− | + | slow_blink_pattern=0000001000000 | |
− | + | # handset w/offhook - normally closed | |
− | + | accessory=6 | |
− | + | # Allow speech mode to be overriden | |
− | + | override_remote_ptt=1 | |
− | + | # use DTMF 9 go to open duplex | |
− | + | open_duplex_dtmf=9 | |
− | + | # Allow maximum audio output | |
− | + | poe_audio=1 | |
− | + | # Use RFC2833 to send DTMF | |
− | + | dtmf_style=1 | |
− | + | # Disable tones | |
− | + | tone_volume=-1 | |
− | + | # Use PTT as default speech mode | |
− | + | speech_mode=1 | |
− | + | # auto answer enabled | |
− | + | auto_answer_mode=1 | |
− | + | # reduced mic sensitivity | |
− | + | mic_sensitivity=4 | |
− | + | # onhook send dtmf 8 in call | |
− | + | onhook_in_call_function=2 | |
− | + | onhook_dtmf_on=8 | |
− | + | # Call 301 | |
− | + | dak1_value=0401 | |
− | + | dak1_in_call_function=0 | |
− | + | dak2_value=401 | |
− | + | dak2_in_call_function=0 | |
− | + | dak3_value=501 | |
− | + | dak3_in_call_function=0 | |
− | + | dak4_value=203 | |
− | + | dak4_in_call_function=0 | |
− | + | dak5_value=510 | |
− | + | dak5_in_call_function=0 | |
− | + | dak6_value=502 | |
− | + | dak6_in_call_function=0 | |
− | + | ||
− | + | [relays] | |
− | + | gpio3_dtmf_activate=2 | |
− | + | gpio3_dtmf_deactivate=0 | |
− | + | gpio3_dtmf_flashing_slow=1 | |
− | + | gpio4_dtmf_activate=5 | |
− | + | gpio4_dtmf_deactivate=3 | |
− | + | gpio4_dtmf_flashing_slow=4 | |
− | + | gpio5_dtmf_activate=7 | |
− | + | gpio5_dtmf_deactivate=6 | |
− | + | Example - Amplifier | |
− | + | [sip_ch1] | |
− | + | nick_name=amp1_ch1_marius | |
− | + | sip_id=0491 | |
− | + | auth_user=0491 | |
− | + | auth_pwd=Ashley77 | |
− | + | sip_domain=10.5.11.75 | |
− | + | playback_gain=-10 | |
− | + | ||
− | + | [sip_ch2] | |
− | + | nick_name=Amp1_ch2_marius | |
− | + | sip_id=0492 | |
− | + | auth_user=0492 | |
− | + | auth_pwd=Ashley77 | |
− | + | sip_domain=10.5.11.75 | |
− | + | playback_gain=-15 | |
− | + | ||
− | + | [[Category: Turbine Configuration]] | |
− | + | ||
− | + | ||
− | + | [[Category:INCA Station Configuration Guide]] | |
− | + | ||
− | + | ||
− | + | [[Category: SIP intercom - Configuration]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | [[Category: Turbine Configuration]] | ||
− | [[Category:INCA Station Configuration Guide]] | ||
− | [[Category: SIP intercom - Configuration]] |
Latest revision as of 09:32, 14 October 2024
This article describes the parameters in the configuration file used for TFTP Provisioning. See TFTP Provisioning for how to configure the station for this function.
TFTP Provisioning is supported by all IP Stations when operating in SIP mode.
Contents
- 1 Remote Provisioning using TFTP
- 2 Detailed description of general parameters
- 3 Detailed description of Relay parameter
- 3.1 relay1_dtmf_activate
- 3.2 relay1_dtmf_deactivate
- 3.3 relay1_dtmf_flashing_slow
- 3.4 relay1_dtmf_flashing_fast
- 3.5 relay1_dtmf_toggle
- 3.6 relay1_dtmf_timed_relay
- 3.7 relay1_dtmf_timed_relay_duration
- 3.8 relay1_event_out_ringing
- 3.9 relay1_event_inc_ringing
- 3.10 relay1_event_inc_call
- 3.11 relay1_event_out_call
- 3.12 relay1_event_group_call
- 3.13 relay1_event_idle
- 3.14 relay1_event_error
- 4 Detailed description of Tone parameter
- 5 Detailed description of SIP parameters
- 5.1 nick_name
- 5.2 sip_id
- 5.3 sip_domain
- 5.4 sip_domain2
- 5.5 sip_domain3
- 5.6 registration_method
- 5.7 auth_user
- 5.8 auth_pwd
- 5.9 sip_outbound_proxy
- 5.10 sip_outbound_proxy_port
- 5.11 register_interval
- 5.12 fail_interval (since 4.9.3.2)
- 5.13 playback_gain (RS amplifier only)
- 5.14 recorder_gain (RS amplifier only)
- 6 Detailed description of Call parameters
- 6.1 dak1_value
- 6.2 dak1_option
- 6.3 dak1_text (DualDisplay stations only)
- 6.4 dak1_function
- 6.5 dak1_in_call_function
- 6.6 dak1_dtmf_on
- 6.7 dak1_dtmf_off
- 6.8 dak1_text_on
- 6.9 dak1_text_off
- 6.10 ringlist1_value1
- 6.11 ringlist1_wp1
- 6.12 ringlist2_value1
- 6.13 ringlist2_wp1
- 6.14 ringlist3_value1
- 6.15 ringlist3_wp1
- 6.16 ringlist_max_ring_time
- 6.17 ringlist_loop
- 6.18 ringlist_max_conv_time
- 6.19 conv_time
- 6.20 ring_time
- 6.21 poe_audio (obsolete)
- 6.22 speaker_volume
- 6.23 mic_sensitivity
- 6.24 noise_reduction
- 6.25 echo_parameter (INCA stations only)
- 6.26 rtp_timeout
- 6.27 remote_controlled_volume_override_mode
- 6.28 speech_mode
- 6.29 ptt_mode
- 6.30 auto_answer_mode
- 6.31 auto_answer_delay
- 6.32 accessory
- 6.33 input_as_key_matrix
- 6.34 fast_blink_pattern
- 6.35 slow_blink_pattern
- 6.36 open_duplex_dtmf
- 6.37 override_remote_ptt
- 6.38 dtmf_style
- 6.39 tone_volume
- 6.40 codec_g729_pri
- 6.41 codec_g722_pri
- 6.42 codec_g711u_pri
- 6.43 codec_g711a_pri
- 6.44 io_pin1
- 6.45 io_pin2
- 6.46 io_pin3
- 6.47 io_pin4
- 6.48 io_pin5
- 6.49 io_pin6
- 7 Detailed description of SNMP parameters
- 7.1 trap_receiver
- 7.2 inform_receiver
- 7.3 network
- 7.4 network_mask
- 7.5 community
- 7.6 enable_v1
- 7.7 enable_v2c
- 7.8 enable_ipsStarted
- 7.9 enable_sipRegistered
- 7.10 enable_sipRegisterFailed
- 7.11 enable_callConnect
- 7.12 enable_callConnectFailed
- 7.13 enable_callDisconnect
- 7.14 enable_buttonPressed
- 7.15 enable_buttonReleased
- 7.16 enable_dakPressed
- 7.17 enable_dakReleased
- 7.18 enable_relayActivated
- 7.19 enable_relayDeactivated
- 7.20 enable_buttonHanging
- 7.21 enable_soundTestSuccess
- 7.22 enable_soundTestError
- 7.23 enable_soundTestFailed
- 8 Detailed description of Audio Files parameters
- 9 Detailed description of Time parameters
- 10 Detailed Description of DAVC parameters
- 10.1 enable_davc
- 10.2 avc_algorithm_enable
- 10.3 avc_algorithm_adjustmode
- 10.4 avc_algorithm_lowerthreshold
- 10.5 avc_algorithm_upperthreshold
- 10.6 avc_algorithm_attackrate
- 10.7 avc_algorithm_decayrate
- 10.8 avc_algorithm_hysteresis
- 10.9 avc_algorithm_farend_lockout_time
- 10.10 avc_target_receiversLength
- 10.11 avc_target_receiver1_ipaddr
- 10.12 avc_player_remotesLength
- 10.13 avc_player_remote_selection_strategy
- 10.14 avc_player_remote1_id
- 10.15 avc_player_remote1_ch1
- 10.16 avc_player_remote1_ch2
- 11 Detailed Description of Multicast Paging
- 12 Intercom Example
- 13 Amplifier Example
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. Or:
ipst_config_10_9_8_7.cfg
|
where 10_9_8_7 is the IP address of the IP station.
If the same parameter is found in several files, then the precedence is as following:
- .MAC address file
- IP address file
- Global file
Detailed description of general parameters
auto_update_interval
- Required: No. If this parameter's 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
use_last_known_ip (INCA stations only)
- Required: No. Default is 0.
- Description: Use Last IP On DHCP failure.
- Values: Integer Value. 0 = disabled, 1 = enabled
turbine_frontboard (deprecated from VS-IS 7.1)
- Description: Configures the turbine frontboard type
- Values:
- 0 = KIT
- 1 = TCIS-1, TCIS-2, TCIS-3
- 2 = TCIS-6
- 3 = TCIS4, TCIS-5
- 4 = TFIE-1, TFIX-1
- 5 = TFIE-2, TFIX-2
- 6 = TFIX-3
- 7 = ECPIR-P
- 8 = EAPII-1, EAPFX-1
- 9 = EAPII-6, EAPFX-6
- 10 = ECPIR-3P
- 11 = EAPIR-8
- 13 = TFIE-6
- 45 = IP-LCM
- 51 = TCIV-2, TCIV-3
- 52 = TCIV-6
- 53 = TMIS1, TMIS-2
- 54 = TCIV-5
Detailed description of Relay parameter
- The following relay keys are supported:
- relay1 and relay2 for station physical relays
- gpio1 to gpio6 for I/O pins configured as outputs
- e_relay1 and e_relay2 for TA-10 relay module
- To configure specific relay rename the parameter to contain the proper relay key, i.e. instead of "relay1_dtmf_activate" use "gpio1_dtmf_activate".
relay1_dtmf_activate
- Description: Dtmf value to send for activating the relay
- Values: Valid values is 0-9, * and #. The character - means off.
relay1_dtmf_deactivate
- Description: Dtmf value to send for deactivating the relay
- Values: Valid values is 0-9, * and #. The character - means off.
relay1_dtmf_flashing_slow
- Description: Dtmf value to send for setting the relay to flashing slow
- Values: Valid values is 0-9, * and #. The character - means off.
relay1_dtmf_flashing_fast
- Description: Dtmf value to send for setting the relay to flashing fast
- Values: Valid values is 0-9, * and #. The character - means off.
relay1_dtmf_toggle
- Description: Dtmf value to send for toggling the relay
- Values: Valid values is 0-9, * and #. The character - means off.
relay1_dtmf_timed_relay
- Description: Dtmf value to send for activating the relay for X seconds
- Values: Valid values is 0-9, * and #. The character - means off.
relay1_dtmf_timed_relay_duration
- Description: Duration to activate relay
- Values: Integer. 0 means activate relay forever.
relay1_event_out_ringing
- Description: When the station is ringing in an outgoing call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
relay1_event_inc_ringing
- Description: When the station is ringing in an incoming call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
relay1_event_inc_call
- Description: When the station is in an incoming call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
relay1_event_out_call
- Description: When the station is in an outgoing call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
relay1_event_group_call
- Description: When the station is in a group call, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
relay1_event_idle
- Description: When the station is idle, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
relay1_event_error
- Description: When the station is error, turn the relay to state: activated, deactivated, flashing slow, flashing fast, do nothing
- Values: Integer. 0 = do nothing, 1 = activate, 2 = deactivate, 3 = flash slow, 4 = flash fast
Detailed description of Tone parameter
enabled
- Description: Enables tone test
- Values: Integer Value. 0 = disabled, 1 = enabled
time_between_tonetest
- Description: Time between tone tests
- Values: Integer Value.
sound_pressure_level (obsolete for SW > 6.1.3.0)
- Description: Minimum sound pressure level between silence and tone
- Values: Integer Value. Only odd values. 53 ≤ sound_pressure_level ≤ 97
volume (obsolete for SW > 6.1.3.0)
- Description: Volume of the tone test
- Values: Integer Value. 0 ≤ volume ≤ 7
auto_set_sound_pressure_level (obsolete for non-INCA stations)
- Description: Only available on INCA stations, station tries to calculate the parameter 'Minimum sound pressure level' (sound_pressure_level).
- Values: Integer Value. 0 = disabled, 1 = enabled
tone_selection (SW > 6.1.3.0)
- Description: Defines frequency groups for the tone test.
- Values: Integer value. 1 <= tone_selection <= 8
Detailed description of SIP parameters
nick_name
- Required: No. Defaults to sip_id
- Description: The nick name for the station can be used to assign a logical name to the station. E.g. a station belonging to James may be assigned the nick name "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 for 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 fall back) 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 fall-back) domain. If the station loses connection to the primary SIP domain, it will switch over to the secondary.
- Values: IP address given in regular dot notation, e.g. 10.5.2.100
sip_domain3
- Required: No
- Description: This is the tertiary (or fall-back) domain. If the station loses connection to the primary and secondary SIP domain, it will switch over to the tertiary.
- Values: IP address given in regular dot notation, e.g. 10.5.2.100
registration_method
- Required: No
- Description: Registration method which the station will use if fall-back domains are available.
- Values: parallel = Parallel registration to fall-back domains, serial = Serial registration to fall-back domains
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 5060.
- Description: The UDP port used for SIP on the 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
fail_interval (since 4.9.3.2)
- Required: No. Defaults to 60 seconds
- Description: In case Primary and both Backup servers are failing with SIP INVITEs, the device should go into failure mode, and immediately start sending REGISTER requests to all SIP servers, in time periods using this failure interval.
- Values: Number of seconds. 5 ≤ fail_interval ≤ 999999
playback_gain (RS amplifier only)
- Required: No.
- Description: This parameter specifies the gain on a output channel
- Values: dB. -40 ≤ playback_gain ≤ 0
recorder_gain (RS amplifier only)
- Required: No.
- Description: This parameter specifies the gain on a input channel
- Values: dB. 0 ≤ recorder_gain ≤ 40
Detailed description of Call parameters
- DAK, input and special keys configuration have the same parameters available, the exact name of the parameter will depend on the desired key ID and the name must start with that key ID.
- Depending on the station type, the following key IDs will be available:
- input1 to input6
- dak1 to dak10
- offhook
- onhook
- ptt
- For example, parameters name would then look like this:
- input2_function
- dak1_function
- offhook_function
- onhook_function
- dak_function
- This document will use "dak1" as an example for configuration parameters.
dak1_value
- Required: Yes for input1_function values 0 (default, call to), 3 (forward call) and4 (group call).
- Description: This is the SIP ID for the extension to be called when the first DAK button is pressed, i.e. the telephone number of the receiving party. It's also used if input1_function is set to 3 (forward call to SIP ID) or 4 (group call to SIP ID).
- Values: String value
dak1_option
- Required: No
- Description: Used in combination with call to function, configures if ringlist will be used or not.
- Values: Integer. -1 is no ringlist. 0 is ringlist 1. 1 is ringlist 2. 2 is ringlist 3.
dak1_text (DualDisplay stations only)
- Required: No
- Description: Text which will be visible on the display next to DAK button 1. Note that this option will do nothing on inputs.
- Values: String value
dak1_function
- Required: No. Default value is 0 (call to)
- Description: This decides what input button 1 will do when outside calls.
- Values: Integer. 0 is call to.1 is do nothing. 3 is forward call (Turbine only). 4 is group call (Turbine only). 5 is conversation mode (Turbine only). 6 is volume control (Turbine only).
dak1_in_call_function
- Required: No. Default value is 1 (do nothing)
- Description: This decides what input button 1 will do when in calls.
- Values: Integer. 0 is answer/end call.1 is do nothing. 2 is send DTMF. 3 is send text. 5 is end call. 6 is answer call. 7 is park call. 9 is push to talk. 10 is hold call. 11 is defer
dak1_dtmf_on
- Required: No. Only used with in call function "Send DTMF".
- Description: Which DTMF value will be sent when DAK button 1 is pressed.
- Values: String. Supported values are from 0 to 9, and *, #, ! (DTMF Flash), O (Do Nothing).
dak1_dtmf_off
- Required: No. Only used with in call function "Send DTMF".
- Description: Which DTMF value will be sent when DAK button 1 is released.
- Values: String. Supported values are from 0 to 9, and *, #, ! (DTMF Flash), O (Do Nothing).
dak1_text_on
- Required: No. Only used with in call function "Send Text".
- Description: Which text value will be sent when DAK button 1 is pressed.
- Values: String.
dak1_text_off
- Required: No. Only used with in call function "Send Text".
- Description: Which text value will be sent when DAK button 1 is released.
- Values: String.
ringlist1_value1
- Required: No
- Description: This is the SIP ID for the extension to be called when ringlist 1 is used and it is at first entry. The next numbers in the ringlist is then ringlist1_value2, ringlist1_value3 etc.
- Values: String value
ringlist1_wp1
- Required: No, default value is 0 (disabled)
- Description: Call with previous parameter for the first entry in the ringlist 1. The next numbers in the ringlist is then ringlist1_wp2, ringlist1_wp3 etc.
- Values: Integer. 0 = disabled, 1 = enabled
ringlist2_value1
- Required: No
- Description: This is the SIP ID for the extension to be called when ringlist 2 is used and it is at the first entry. The next numbers in the ringlist is then ringlist2_value2, ringlist2_value3 etc.
- Values: String value
ringlist2_wp1
- Required: No, default value is 0 (disabled)
- Description: Call with previous parameter for the first entry in the ringlist 2. The next numbers in the ringlist is then ringlist2_wp2, ringlist2_wp3 etc.
- Values: Integer. 0 = disabled, 1 = enabled
ringlist3_value1
- Required: No
- Description: This is the SIP ID for the extension to be called when ringlist 3 is used and it is at the first entry. The next numbers in the ringlist is then ringlist3_value2, ringlist3_value3 etc.
- Values: String value
ringlist3_wp1
- Required: No, default value is 0 (disabled)
- Description: Call with previous parameter for the first entry in the ringlist 3. The next numbers in the ringlist is then ringlist3_wp2, ringlist3_wp3 etc.
- Values: Integer. 0 = disabled, 1 = enabled
ringlist_max_ring_time
- Required: No. Defaults to 4
- Description: This parameter sets the time to wait ringing until step to next value in the ringlist
- Values: Number of seconds. 0 ≤ ringlist_max_ring_time ≤ 999999
ringlist_loop
- Required: No. Defaults to 0
- Description: This parameter enable the loop so list is repeated until answer.
- Values: Integer. 0 to disable, 1 to enable
ringlist_max_conv_time
- Required: No. Defaults to 4
- Description: This parameter sets the max time of the conversation when followed ringlist
- Values: Number of seconds. 0 ≤ ringlist_max_conv_time ≤ 999999
conv_time
- Required: No. Defaults to 3600
- Description: This parameter sets the max time of the conversation
- Values: Number of seconds. 0 ≤ conv_time ≤ 999999
ring_time
- Required: No. Defaults to 120
- Description: This parameter sets the max time of the ringing/alerting phase of the call
- Values: Number of seconds. 0 ≤ ring_time ≤ 999999
poe_audio (obsolete)
- Description: This parameter sets whether to disable maximum speaker output
- Values: Set to 0 to enable full audio output. Set to 1 to disable full audio output.
speaker_volume
- Required: No. Defaults to 4
- Description: This parameter sets the volume of the station's speaker
- Values: Integer. 0 ≤ speaker_volume ≤ 7
mic_sensitivity
- Required: No. Defaults to 5
- Description: This parameter adjusts the microphone sensitivity
- Values: Integer. 0 ≤ mic_sensitivity ≤ 7
noise_reduction
- Required: No. Defaults to 0
- Description: This parameter adjusts the noise reduction level
- Values: Integer. 0 ≤ noise_reduction ≤ 7
echo_parameter (INCA stations only)
- Required: No. Defaults to 0
- Description: This parameter adjusts the echo parameter
- Values: Integer. 0 ≤ echo_parameter ≤ 7
rtp_timeout
- Required: No. Defaults to 0
- Description: Cancels a call if the station does not receive rtp.
- Values: Integer value: 0-9999 seconds. 0 = RTP timeout disabled.
remote_controlled_volume_override_mode
- Required: No.
- Description: Acts as a simplex mode after first DTMF * or # is received. At remote station: send DTMF * to talk and # to listen.
- Values: Integer. 0 disabled, 1 enabled.
speech_mode
- Required: No.
- Description: Set the conversation mode.
- Values: Integer. 0 = Full Open Duplex, 1 = Push To Talk, 2 = Half Duplex Switching, 3 = Open, 4 = Robust Duplex.
ptt_mode
- Required: No.
- Description: Set the PTT mode, only active if Conversation Mode is set to PTT.
- Values: ptt_mic_and_speaker = Mic and speaker is controlled by PTT button, ptt_mic_only = Mic is controlled by PTT button.
auto_answer_mode
- Required: No.
- Description: Enables autoanswer after a set number of seconds.
- Values: Integer. 0 disabled, 1 enabled.
auto_answer_delay
- Required: No. Defaults to 0.
- Description: The number of seconds to delay the autoanswer
- Values: Integer. 0 ≤ delay ≤ 30
accessory
- Required: No. Defaults to 0.
- Description: Which accessory to use
- Values: 0 = unused/default, 1 = handset, 2 = microphone w/ptt, 3 = headset, 4 = handset w/offhook, 5 = headset auto detect, 6 = handset w/offhook normally closed
input_as_key_matrix
- Required: No. Defaults to 0.
- Description: Use inputs as a key matrix. Requires that gpio is configured as gpi/input
- Values: 0 = no inputs as key, 1 = means 1 input as as key matrix (1 dak), 2 = means 2 inputs as as key matrix (3 daks), 3 = means 3 inputs as as key matrix (7 daks)
fast_blink_pattern
- Required: No. Defaults to 111000111000111000111000
- Description: Customize fast blink pattern
- Values: 1 = gpo high, 0 = gpo low
slow_blink_pattern
- Required: No. Defaults to 111111111111000000000000
- Description: Customize slow blink pattern
- Values: 1 = gpo high, 0 = gpo low
open_duplex_dtmf
- Required: No. Defaults to -
- Description: Forces the station in Open Duplex when configured DTMF is received
- Values: - = off, valid range: 0-9
override_remote_ptt
- Required: No. Defaults to 0
- Description: If 2 stations call each other and Override Remote PTT is enabled, then conversation mode is switched to open duplex.
- Values: 0 = disabled, 1 = enabled
dtmf_style
- Required: No. Defaults to 0
- Description: Choose how to send DTMF
- Values: 0 = SIP INFO, 1 = RFC2833
tone_volume
- Required: No. Defaults to 0
- Description: Control tone volume
- Values: -1 = no tones, 0 default volume, 1-4 increases volume
codec_g729_pri
- Required: No
- Description: Set the priority of g729 codec
- Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority
codec_g722_pri
- Required: No
- Description: Set the priority of g722 codec
- Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority
codec_g711u_pri
- Required: No
- Description: Set the priority of g711u codec
- Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority
codec_g711a_pri
- Required: No
- Description: Set the priority of g711a codec
- Values: unused = Not Used, low = Low Priority, medium = Medium priority, high = High Priority
io_pin1
- Required: No
- Description: Will the I/O pin 1 behave as an input or as an output.
- Values: 0 = Input, 1 = Output
io_pin2
- Required: No
- Description: Will the I/O pin 2 behave as an input or as an output.
- Values: 0 = Input, 1 = Output
io_pin3
- Required: No
- Description: Will the I/O pin 3 behave as an input or as an output.
- Values: 0 = Input, 1 = Output
io_pin4
- Required: No
- Description: Will the I/O pin 4 behave as an input or as an output.
- Values: 0 = Input, 1 = Output
io_pin5
- Required: No
- Description: Will the I/O pin 5 behave as an input or as an output.
- Values: 0 = Input, 1 = Output
io_pin6
- Required: No
- Description: Will the I/O pin 6 behave as an input or as an output.
- Values: 0 = Input, 1 = Output
Detailed description of SNMP parameters
trap_receiver
- Required: No.
- Description: The IP address of the server receiving SNMP traps.
- Values: IP address given in regular dot notation, e.g. 10.5.2.100
inform_receiver
- Required: No.
- Description: The IP address of the server receiving SNMP informs.
- Values: IP address given in regular dot notation, e.g. 10.5.2.100
network
- Required: No.
- Description: Used, together with the network mask, to determine the allowed network for reading the MIB on the IP station.
- Values: IP address given in regular dot notation, e.g. 10.5.2.100. For example with an allowed network 10.5.2.0 and a network mask of 24, anyone with IP address 10.5.2.0 to 10.5.2.255 can access the MIB.
network_mask
- Required: No.
- Description: The mask used to determine the allowed network for reading the MIB.
- Values: Integer. 0 ≤ network_mask ≤ 32. For example with an allowed network 10.5.2.0 and a network mask of 24, anyone with IP address 10.5.2.0 to 10.5.2.255 can access the MIB.
community
- Required: No.
- Description: An text staring used as password for authentication.
- Values: String.
enable_v1
- Required: No.
- Description: Enables reading of MIB using SNMP version 1
- Values: Integer. 1 enabled. 0 disabled
enable_v2c
- Required: No.
- Description: Enables reading of MIB using SNMP version 2c
- Values: Integer. 1 enabled. 0 disabled
enable_ipsStarted
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when the station application is started
- Values: 0 = disabled, 1 = enabled
enable_sipRegistered
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when successfully registered in the SIP domain
- Values: 0 = disabled, 1 = enabled
enable_sipRegisterFailed
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap if registration in the SIP domain failed
- Values: 0 = disabled, 1 = enabled
enable_callConnect
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a call is connected
- Values: 0 = disabled, 1 = enabled
enable_callConnectFailed
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap if a call to the station fails to connect for any reason (busy etc.)
- Values: 0 = disabled, 1 = enabled
enable_callDisconnect
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a call is disconnected
- Values: 0 = disabled, 1 = enabled
enable_buttonPressed
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when an input button has been pressed
- Values: 0 = disabled, 1 = enabled
enable_buttonReleased
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when an input button has been released
- Values: 0 = disabled, 1 = enabled
enable_dakPressed
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a DAK button has been pressed
- Values: 0 = disabled, 1 = enabled
enable_dakReleased
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a DAK button has been released
- Values: 0 = disabled, 1 = enabled
enable_relayActivated
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a relay has been activated
- Values: 0 = disabled, 1 = enabled
enable_relayDeactivated
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a relay has been deactivated
- Values: 0 = disabled, 1 = enabled
enable_buttonHanging
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a button is hanging (pressed for more than 10 seconds).
- Values: 0 = disabled, 1 = enabled
enable_soundTestSuccess
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a sound test has been successfull
- Values: 0 = disabled, 1 = enabled
enable_soundTestError
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when the tone test could not be carried out because the reference value ("silence") is not stable. This happens when measuring the "silence" several times, and the measured values are too different.
- Values: 0 = disabled, 1 = enabled
enable_soundTestFailed
- Required: No. Defaults to 1
- Description: If enabled, the station will send an SNMP trap when a sound test has failed because the microphone didn’t get loud enough tone from the speaker.
- Values: 0 = disabled, 1 = enabled
Detailed description of Audio Files parameters
tftpserver
- Required: No.
- Description: IP Address of the TFTP server where audio files are located.
- Values: String Value
ringing
- Required: No.
- Description: Wav file to be played during outgoing calls.
- Values: String Value
Detailed description of Time parameters
enabled
- Required: No.
- Description: If NTP is enabled or not.
- Values: Integer, 0 = disabled, 1 = enabled
hostname
- Required: No.
- Description: IP Address of hostname of NTP Server.
- Values: String Value
time_region (Turbine stations only)
- Required: No.
- Description: Selected time region.
- Values: String Value
time_zone (Turbine stations only)
- Required: No.
- Description: Selected time zone.
- Values: String Value
plus_minus (INCA stations only)
- Required: No.
- Description: If difference from GMT time is + or -.
- Values: String, + = positive difference, - = negative difference
zone_hour (INCA stations only)
- Required: No.
- Description: Hour difference from GMT time
- Values: Integer Value
zone_minute (INCA stations only)
- Required: No.
- Description: Minutes difference from GMT time
- Values: Integer Value
summertime (INCA stations only)
- Required: No.
- Description: Automatically adjust clock for 'Daylight Saving Time'.
- Values: Integer, 0 = disabled, 1 = enabled.
Detailed Description of DAVC parameters
- NB! "avc_player_remotesLength" or "avc_target_receiversLength" have to be defined.
- The user have to specify how many AVC source/receiver devices they want to add by define the "avc_player_remotesLengt" or "avc_target_receiversLength", otherwise the DAVC configs won't be applied to the station.
enable_davc
- Required: No.
- Description: *detail needed
- Values: Integer, 0 = disabled, 1 = enabled
avc_algorithm_enable
- Required: No.
- Description: Enable AVC algorithm, and must be enabled on either all AVC Sources or all AVC Receivers.
- Values: Integer, 0 = disabled, 1 = enabled
avc_algorithm_adjustmode
- Required: No.
- Description: Changing mode in Adjustment Mode.
- Positive Mode: Gain adjustment is from zero at AVC threshold level and adjusted postive. AVC Receiver should have a low base gain.
- Negative Mode: Gain adjustment is from zero at AVC max level and adjusted with negative gain downwards. AVC Receiver should have a high base gain.
- Values: String, "positive" or "negative"
avc_algorithm_lowerthreshold
- Required: No.
- Description: Mic signal level where AVC starts to work. Below this level no adjustment is done, and Audio Receivers should work on default base gain.
- Values: Integer, Values between 30 dBA - 80 dBA, Have to be less than upper threshold value, default = 65 dBA.
avc_algorithm_upperthreshold
- Required: No.
- Description: Mic signal level where AVC stops to work. Above this level, no adjustment is done. The diff between upper and lower thresholds also defines the working range for AVC gain adjustments. In negative AVC mode this also defined the ambient level where configured base output gain is reached (offset adjustment is zero)
- Values: Integer, Values between 60 - 120 dBA, Have to be less than upper threshold value, default = 100 dB. (On firmware ver. 8.x and earlier the Values was between 80 - 120 dBA).
avc_algorithm_attackrate
- Required: No.
- Description: Determines how quickly the AVC adjusts gain on raising ambient audio level
- Values: Float with 1 decimal, Values between 0.1 dB/sec to 200 dB/sec, default = 10.0 dB/sec.
avc_algorithm_decayrate
- Required: No.
- Description: Determines how quickly the AVC adjusts gain on falling ambient audio level
- Values: Float with 1 decimal, Values between 0.1 dB/sec to 200 dB/sec, default = 1.0 dB/sec.
avc_algorithm_hysteresis
- Required: No.
- Description: Hysteresis around previous set ambient audio level before doing adjustments
- Values: Float with 2 decimal, Values between 0.00 dB to 200 dB, default = 3.00 dB.
avc_algorithm_farend_lockout_time
- Required: No.
- Description: When playing audio in AVC Zone (far-end-signal) all AVC adjustments is locked. When there is a pause in far-end-signal, adjustment commences after this lockout-time
- Values: Float with 1 decimal, Values between 0.0 sec to 1.0 sec , default = 0.1 sec.
avc_target_receiversLength
- Required: No.
- Description: Define how many AVC receivers will be add, and the device is set to AVC Source
- Values: Integer
avc_target_receiver1_ipaddr
- Required: No.
- Description: IP address of the first receivers, (For more receivers add "avc_algorithm_receiver3_ipaddr" and "avc_algorithm_receiver3_ipaddr" up to the length of receivers)
- Values: String
avc_player_remotesLength
- Required: No.
- Description: Define how many AVC source devices it will be and the device is set to AVC Receiver
- Values: Integer
avc_player_remote_selection_strategy
- Required: No.
- Description: Define the source selection strategy
- Values: String, "highest", "averge" and "averge_mid", default = "highest"
avc_player_remote1_id
- Required: No.
- Description: Source number of the first source (For more sources add "avc_player_remote2_id" etc)
- Values: String
avc_player_remote1_ch1
- Required: No.
- Description: Activate the audio channel 1 of the first source with "out_1", and delete this parameter for deactivate it.
- Values: String, "out_1" for activate
avc_player_remote1_ch2
- Required: No.
- Description: Activate the audio channel 2 of the first source with "out_2", and delete this parameter for deactivate it.
- Values: String, "out_2" for activate
Detailed Description of Multicast Paging
mcast_enabled
- Required: No.
- Description: Activate Multicast Paging
- Values: Integer, 0 = disable, 1 = enable
order_enabled
- Required: No.
- Description: Activate Order Priority in multicast paging
- Values: Integer, 0 = disable, 1 = enable
mcast_stream1_label
- Required: No.
- Description: First Paging label ( "mcast_stream2_label" is the second paging label and etc)
- Values: String.
mcast_stream1_address
- Required: No, have to define when mcast_stream1_label is defined.
- Description: Listening address of First Paging label ( "mcast_stream2_address" is the listening address for second paging )
- Values: String.
mcast_stream1_port
- Required: No, have to define when mcast_stream1_label is defined.
- Description: Port number of the first paging label ( "mcast_stream2_port" is the port for second paging)
- The ports must be within the port range 61020-61250, recommended range is 61080-61250. Using odd numbers is not recommended for ports. Listening address and port must be defined.
- Values: Integer
mcast_stream1_codec
- Required: No, have to define when mcast_stream1_label is defined.
- Description: Which codec is used for the first paging label ( "mcast_stream2_codec" is the codec for second paging)
- Values: String, Choose between "g729", "g729", "g711a", "g711u" and "L16x48D".
mcast_stream1_priority
- Required: No, have to define when mcast_stream1_label is defined.
- Description: Set the priority for the first paging ( "mcast_stream2_priority" is the codec for second paging)
- Values: String, Choose between "low", "normal", "high" and "emergency".
mcast_stream1_order
- Required: No, have to define when mcast_stream1_label is defined.
- Description: Order of the first paging ( "mcast_stream2_order" is the order for second paging)
- Values: Integer, Choose between 0 - 9.
mcast_stream1_linemask
- Required: No, have to define when mcast_stream1_label is defined.
- Description: Select which Channels (Only for amplifiers)
- Values: Integer, 1 = Channel 1, 2 = Channel 2, 3 = Channel 1 and Channel 2
Intercom Example
[general] auto_update_interval=10 auto_update_image_type=A100G80200.01_10_1_2.bin auto_update_image_crc=C1466499 [tone] volume=2 time_between_tonetest=100 enabled=0 sound_pressure_level=65 [relays] relay1_dtmf_activate=1 relay1_dtmf_deactivate=2 relay1_dtmf_flashing_slow=3 relay1_dtmf_flashing_fast=4 relay1_dtmf_toggle=- relay1_dtmf_timed_relay=8 relay1_dtmf_timed_relay_duration=3 relay1_event_out_ringing=1 relay1_event_inc_ringing=0 relay1_event_inc_call=2 relay1_event_out_call=2 relay1_event_idle=2 relay1_event_error=4 [sip] nick_name=Testname sip_id=1003 sip_domain=10.5.2.209 sip_domain2=10.5.2.138 auth_user=1003 auth_pwd=1003pass sip_outbound_proxy=10.5.2.138 sip_outbound_proxy_port=5060 register_interval=600 Value: 60 < seconds < 999999 [sip_ch1] Amplifier channel 1 configuration playback_gain=-21 sip_id=1006 sip_domain=10.5.2.209 [sip_ln1] Amplifier line in 1 configuration recorder_gain=15 sip_id=1006 sip_domain=10.5.2.209 [call] ringlist_max_conv_time=200 ringlist_max_ring_time=30 ringlist_loop=1 noise_reduction=2 echo_parameter=3 input1_value=1000 input1_in_call_function=0 Input 1 will end current call if pressed during a call input2_value=1004@169.254.1.100 input2_in_call_function=1 Input 2 will do nothing if pressed during a call input3_value= dak1_value=2000 dak2_value= dak3_value= ringlist_loop=0 Ringlists will not start at the beginning after trying to call all entries ringlist_max_conv_time=600 Max conversation time of a call started with ringlist is 600 seconds ringlist_max_ring_time=50 Max ringing time of a call started with ringlist is 50 seconds ringlist1_value1=1001 Ringlist 1 entry 1 will call to number 1001 ringlist1_wp1=1 Ringlist 1 entry 1 will call at the same time as the previous entry ringlist1_value2=1002 Ringlist 1 entry 2 will call to number 1002 ringlist1_wp2=1 Ringlist 1 entry 2 will call at the same time as the previous entry ringlist1_value3=1003 ringlist1_value4=1004 ringlist2_value1=1001 ringlist2_value2=1002 ringlist2_value3=1003 ringlist2_value4=1004 ringlist2_value5=1005 ringlist3_value1=2001 ringlist3_value2=2001 speaker_volume=4 Value: 0 < level < 7. mic_sensitivity=5 Value: 0 < level < 7. rtp_timeout=60 Value: 0 < seconds < 9999. 0 = RTP timeout disabled. remote_controlled_volume_override_mode=1 Accepted values 0 or 1. auto_answer_mode=1 Accepted values 0 or 1. auto_answer_delay=10 Value: 0 < seconds < 30 disable_disconnect_by_button=1 Accepted values 0 or 1. [snmp] trap_receiver=10.5.2.219 network=10.5.2.0 network_mask=24 network_ipv6=fec0:: network_ipv6_length=64 community=public enable_v1=1 Accepted values 0 or 1. enable_v2c=1 Accepted values 0 or 1. enable_ipsStarted=1 Accepted values 0 or 1. enable_sipRegistered=1 Accepted values 0 or 1. enable_sipRegisterFailed=1 Accepted values 0 or 1. enable_callConnect=1 Accepted values 0 or 1. enable_callConnectFailed=1 Accepted values 0 or 1. enable_callDisconnect=1 Accepted values 0 or 1. enable_buttonPressed=1 Accepted values 0 or 1. enable_buttonReleased=1 Accepted values 0 or 1. enable_relayActivated=1 Accepted values 0 or 1. enable_relayDeactivated=1 Accepted values 0 or 1. enable_buttonHanging=1 Accepted values 0 or 1. enable_soundTestSuccess=1 Accepted values 0 or 1. enable_soundTestError=1 Accepted values 0 or 1. enable_soundTestFailed=1 Accepted values 0 or 1.
[audio_files] tftpserver=10.8.25.200 ringing=ringing.wav
[time] enabled=1 hostname=10.8.25.200 time_region=America time_zone=Denver
Amplifier Example
[sip] sip_id=0203 sip_domain=10.5.11.75 nick_name=CCP03 auth_user=0203 auth_pwd=Ashley77 [call] # Use 3 GPI as key matrix for DAK1-7 input_as_key_matrix=3 io_pin1=0 io_pin2=0 io_pin3=0 io_pin4=1 io_pin5=1 io_pin6=1 fast_blink_pattern=1011111 slow_blink_pattern=0000001000000 # handset w/offhook - normally closed accessory=6 # Allow speech mode to be overriden override_remote_ptt=1 # use DTMF 9 go to open duplex open_duplex_dtmf=9 # Allow maximum audio output poe_audio=1 # Use RFC2833 to send DTMF dtmf_style=1 # Disable tones tone_volume=-1 # Use PTT as default speech mode speech_mode=1 # auto answer enabled auto_answer_mode=1 # reduced mic sensitivity mic_sensitivity=4 # onhook send dtmf 8 in call onhook_in_call_function=2 onhook_dtmf_on=8 # Call 301 dak1_value=0401 dak1_in_call_function=0 dak2_value=401 dak2_in_call_function=0 dak3_value=501 dak3_in_call_function=0 dak4_value=203 dak4_in_call_function=0 dak5_value=510 dak5_in_call_function=0 dak6_value=502 dak6_in_call_function=0 [relays] gpio3_dtmf_activate=2 gpio3_dtmf_deactivate=0 gpio3_dtmf_flashing_slow=1 gpio4_dtmf_activate=5 gpio4_dtmf_deactivate=3 gpio4_dtmf_flashing_slow=4 gpio5_dtmf_activate=7 gpio5_dtmf_deactivate=6 Example - Amplifier [sip_ch1] nick_name=amp1_ch1_marius sip_id=0491 auth_user=0491 auth_pwd=Ashley77 sip_domain=10.5.11.75 playback_gain=-10 [sip_ch2] nick_name=Amp1_ch2_marius sip_id=0492 auth_user=0492 auth_pwd=Ashley77 sip_domain=10.5.11.75 playback_gain=-15