Cisco SPA2102 (SDS4)

Description

This resource allows to connect a Cisco SPA2102 analogue telephony adapter.

Release notes

Version 1.15.1 - Early deployment
  • Bugfix: Generate configuration files on all SOPs of a cluster (M8788)
  • Dependency:
    • Asterisk-1.2.x v2.30+
    • Cisco ATA support v1.5.2+
    • Communication Server v2.0.0+ (if T.38 support is required)

Version 1.15.0 - Deprecated
  • Feature: Added codec selection for fax pass-through (M8788)
  • Deprecated: This version does not create the configuration files on all SOPs of a cluster
  • Dependency:
    • Communication Server >= 2.1.0 (If T.38 is used)

Version 1.14.2 - Early deployment
  • Bugfix: Only write codec configuration on the selected SOP (M12881)
  • Dependency:
    • Asterisk-1.2.x v2.30+
    • Cisco ATA support v1.5.2+
    • Communication Server v2.0.0+ (if T.38 support is required)

Version 1.14.1 - Deprecated
  • Bugfix: 6693: When you dialed internal numbers (1000 or 1100), the Belgian dialplan called the emergency services (100) (M6693)
  • Bugfix: Display the correct RTP ToS/DiffServ Value for EF (M9791)
  • Deprecated: Affects codec settings on other SOP of a cluster (M12881)
  • Dependency:
    • Asterisk-1.2.x v2.30+
    • Cisco ATA support v1.5.2+
    • Communication Server v2.0.0+ (if T.38 support is required)

Version 1.14.0 - Deprecated
  • Potential update impact level 2 DONE: in the event this update contains a bug, it might have critical impact. Respect dependencies and retest your most important callflows and applicative integrations.: The default dialplan has changed from a US numbering plan to a Belgian numbering plan. Upgrading to this version should be tested before applying it on all devices.
  • Feature: Configurable dialplan to allow faster dialing after the number has been completed (M6063)
  • Deprecated: Affects codec settings on other SOP of a cluster (M12881)
  • Dependency:
    • Asterisk-1.2.x v2.30+
    • Cisco ATA support v1.5.2+
    • Communication Server v2.0.0+ (if T.38 support is required)

Version 1.13.2 - Deprecated
  • Bugfix: Receiving T38 faxes now also works (M0005958)
  • Improvement: Removed unsupported codecs from the codec selection list
  • Improvement: Set G711a as the preferred codec when no preferred codec is selected
  • Improvement: Refactored resource generation code to avoid code duplication
  • Deprecated: Affects codec settings on other SOP of a cluster (M12881)
  • Dependency:
    • Asterisk-1.2.x v2.30+
    • Cisco ATA support v1.5.2+
    • Communication Server v2.0.0+ (if T.38 support is required)

Version 1.13.1 - Deprecated
  • Deprecated: Receiving T38 faxes does not work (M0005958)
  • Bugfix: Proper support for T.38 (M5258)
  • Dependency:
    • Asterisk-1.2.x module v2.30+
    • Cisco ATA support v1.5.1+
    • Communication Server v2.0.0+ (if T.38 support is required)

Version 1.13 - General deployment
  • Feature: Support T.38 (M5258)
  • Dependency:
    • Asterisk-1.2.x module v2.30+
    • Cisco ATA support v1.4.0+

Version 1.12 - General deployment
  • Feature: Added active-active support (M0003637)
  • Feature: Support more tone configuration (M0005248)
  • Dependency:
    • Asterisk-1.2.x module v2.30+
    • Cisco ATA support v1.4.0+

Version 1.11 - General deployment
  • Feature: Added SIP overload control settings
  • Dependency:
    • Asterisk-1.2.x module v2.30+
    • Cisco ATA support v1.4.0+

Version 1.10 - General deployment
  • Improvement: Option to set dtmfmode to inband instead of rfc2833

Version 1.9 - General deployment
  • DHCP Server on the Ethernet Port can be disabled

Version 1.8 - General deployment
  • Syncs on all SOPs

Version 1.7 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)
  • Line 2 support added with same settings than line 1
  • T38 feature added
  • Hotline feature added for both line
  • SIP/RTP ToS/DiffServ settings added
  • SIP/RTP CoS settings added
  • SIP Port changeable
  • RTP Port Range changeable
  • Interdigit timeout setting added
  • ** prefixed numbers dialing added in the Dial Plan
  • Directed Call Pickup (*55) added
  • DTMF RFC2833 added

Version 1.6 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)
  • Line 2 support added with same settings than line 1
  • T38 feature added
  • Hotline feature added for both line
  • SIP/RTP ToS/DiffServ settings added
  • SIP/RTP CoS settings added
  • SIP Port changeable
  • RTP Port Range changeable
  • Interdigit timeout setting added
  • ** prefixed numbers dialing added in the Dial Plan
  • Directed Call Pickup (*55) added

Version 1.5 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)
  • Line 2 support added with same settings than line 1
  • T38 feature added
  • Hotline feature added for both line
  • SIP/RTP ToS/DiffServ settings added
  • SIP/RTP CoS settings added
  • SIP Port changeable
  • RTP Port Range changeable
  • Interdigit timeout setting added
  • ** prefixed numbers dialing added in the Dial Plan

Version 1.4 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)
  • Line 2 support added with same settings than line 1
  • T38 feature added
  • Hotline feature added for both line
  • SIP/RTP ToS/DiffServ settings added
  • SIP/RTP CoS settings added
  • SIP Port changeable
  • RTP Port Range changeable

Version 1.3 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)
  • Line 2 support added with same settings than line 1
  • T38 feature added
  • Hotline feature added for both line

Version 1.2 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)
  • Line 2 support added with same settings than line 1
  • T38 feature added

Version 1.1 - General deployment
  • Should be used on the WAN Ethernet port
  • Tone parameters added
  • Line 1 preferences added (echo canceler, jitter, codecs, ...)

Version 1.0 - General deployment
  • Should be use on the WAN Ethernet port

Resource configuration interface

GUI unavailable.

Tone configuration format:

A tone is a mini-script of up to 127 characters that specifies the frequency, level and cadence parameters of a call progress tone. May contain up to 127 characters.

  • Syntax: FreqScript;Z1[;Z2].
    • Z1 = D1(oni,1/offi,1/fi,1[,oni,2/offi,2/fi,2 [,oni,3/offi,3/fi,3[,oni,4/offi,4/fi,4[,oni,5/offi,5/fi,5[,oni,6/offi,6/fi,6]]]]]), where fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]] and 1 < nk < 6 indicates which of the frequency components given in the FreqScript are used in that segment; if more than one frequency component is used in a segment, the components are summed together.
    • FreqScript has the Syntax: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]. Where F1–F6 are frequency in Hz (unsigned integers only) and L1–L6 are corresponding levels in dBm (with up to 1 decimal places).

Cisco SPA2102 : Resource configuration parameters

  • DialTone: Dial tone configuration
  • BusyTone: Busy tone configuration
  • Reorder Tone: Reorder tone configuration
  • Off Hook Warning Tone: Reorder Tone configuration
  • Ring Back Tone: Ring Back Tone configuration
  • Line configuration: The ATA can buffer incoming voice packets to minimize the impact of variable network delays. This process is known as jitter buffering. The size of the jitter buffer adjusts to changing network conditions. The ATA has a Network Jitter Level control setting for each line of service. The jitter level determines how aggressively the ATA tries to shrink the jitter buffer over time to achieve a lower overall delay. If the jitter level is higher, it shrinks more gradually. If jitter level is lower, it shrinks more quickly
    • Network_Jitter Level: Determines how jitter buffer size is adjusted by the ATA. Jitter buffer size is adjusted dynamically. The minimum jitter buffer size is 30 milliseconds or (10 milliseconds + current RTP frame size), whichever is larger, for all jitter level settings. However, the starting jitter buffer size value is larger for higher jitter levels. This setting controls the rate at which the jitter buffer size is adjusted to reach the minimum. Select the appropriate setting: low, medium, high, very high, or extremely high. Default setting: high
    • Jitter Buffer Adjustment: Advanced use. See sipura administration guide for more information
    • Call Waiting Serv: Enable Call Waiting Service. Default setting: No
    • Three Way Conf Serv: Enable Three Way Calling Service. Three Way Calling is required for Three Way Conference and Attended Transfer. Default setting: No
    • Echo Canc Enable: Enable the use of the echo canceller, select yes. Otherwise, select no. Default setting: No. Disable this if a fax is connected on the line.
    • Echo Canc Adapt Enable: To enable the echo canceller to adapt, select yes. Otherwise, select no. Default setting: No. Disable this if a fax is connected on the line.
    • Echo Supp Enable: To enable the use of the echo suppressor, select yes. Otherwise, select no. Default setting: Yes. Disable this if a fax is connected on the line.
    • Preferred Codec: Preferred codec for all calls. (The actual codec used in a call still depends on the outcome of the codec negotiation protocol.) Select one of the following: G711u, G711a, G726-32, or G729a. Default setting: G711u
    • Use Pref Codec Only: To use only the preferred codec for all calls, select yes. (The call fails if the far end does not support this codec.) Otherwise, select no. Default setting: no
    • Hotline Number: Number dialed in case of hotline. Indicate nothing to don't configure hotline.
    • Hotline dialing delay: Used only in case of hotline configured.
    • SIP ToS/DiffServ Value: TOS/DiffServ field value in UDP IP packets carrying a SIP message. Default setting: 0x68.
    • RTP ToS/DiffServ Value: TOS/DiffServ field value in UDP IP packets carrying RTP data. Default setting: 0xb8
    • SIP CoS Value: CoS value for SIP messages. Default setting: 3.
    • RTP CoS Value: CoS value for RTP data. Default setting: 6.
    • SIP Port Value: Port number of the SIP message listening and transmission port. Default setting: 5060.
    • SIP Server: Indicate here the IP address where to register. By default, it will be the IP address of SOP 1.
  • Line: Indicate the line to configure.
  • T38: Indicate if T38 must be enbaled
  • RTP Parameters: Indicate the range of RTP UDP port
  • Interdigit Long Timer:Long timeout between entering digits when dialing. The interdigit timer values are used as defaults when dialing. The Interdigit_Long_Timer is used after any one digit, if all valid matching sequences in the dial plan are incomplete as dialed. Range: 0–64 seconds. This setting can only be used in the first line identity and as global accross the device. Default setting: 10.
  • Interdigit Short Timer:Short timeout between entering digits when dialing. The Interdigit_Short_Timer specifies the default maximum time (in seconds) allowed between dialed digits, when at least one candidate digit sequence is complete as dialed. Range: 0–64 seconds. This setting can only be used in the first line identity and as global accross the device. Default setting: 3.
  • Dialplan: The Dialplan parameter contains the actual dial plan scripts for each of the identities. The default setting is good for an installation in Belgium with a 0 prefix to dial outside and 4 digit internal extensions. For more information concerning the dialplan parameter, please refer to the excellent documentation of Cisco. Default value: ([1-9]xxxS0|1[01]x|1[2]xx|004[6789]xxxxxxxS0|00[789]xxxxxxxS0|00[1-35-9]xxxxxxxS0|004xxxxxxxS2|000xx.)
  • DHCP Server: The status of the DHCP server: Enabled or Disabled.
  • DTMF mode: default (as indicated in communication server), RFC2833 or inband
  • DNS settings:
    • Whether to use DNS SRV lookup for Proxy and Outbound Proxy. Default setting: no.
    • If enabled, the ATA will automatically prepend the Proxy or Outbound Proxy name with _sip._udp when performing a DNS SRV lookup on that name. Default setting: no.

  • SIP server feature:
    • SIP Overload Control: 'Default' has currently the same function as 'Disabled' (planned for future use), 'Enable' to use the settings defined in this resource and 'Disabled' to deactivate the sip overload control
    • Max Call per period: The maximum number of call allowed during polling period. If the maximum is reached the SIP requests will be rejected with the a SIP error 480 Temporarily unavailable'
    • Polling period: Period during which the maximum number of calls is to be checked. At the end of each period the overload control counters are reset.
    • SIP blacklisting: 'Default' to keep settings defined in asterisk module, 'Enable' to use the settings defined in this resource and 'Disabled' to deactivate the sip blacklisting
    • Blacklisting time after overload: The time after the overload during which the IP address of incoming SIP requests will be blacklisted
    • IP blacklisted time: The time during which the IP address will remain blacklisted
    • Register Expires:

  • SecondDialTone: Second dial tone configuration
  • OutsideDialTone: Outside dial tone configuration
  • PromptTone: Prompt tone configuration

Example of doorphone integration:

In certain country, doorphone needs to have specific tone set to the country specific tones. For example Fastel doorphone requires Belgian tones:

  • Dialtone: 480@-19,620@-19;10(.25/.25/1+2)
  • Reorder Tone: 425@-5;10(.5/.5/1)
  • Off Hook Warning Tone: 425@-5;10(.5/.5/1)
  • Ring Back Tone: 425@-5;10(3/1/1)
  • Busy Tone: 425@-5;10(.5/.5/1)
Copyright © Escaux SA