Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Note

Important Note Regarding FreeSwitch® and FreeTDM® Support

Support for FreeSwitch and FreeTDM for Sangoma telephony card products are no longer provided by Sangoma. All FreeSwitch drivers and applications are provided as-is with no warranty.  

Sangoma was previously involved in the FreeTDM and FreeSwitch projects, but has refocused its development efforts primarily on Asterisk-based platforms including FreePBX. The information on this page and other FreeSwitch- and FreeTDB-related pages on the Sangoma Wiki has been retained for historical and reference purposes, but should not be relied upon as reflecting Sangoma's current development efforts or support policies.

freetdm.conf

General File format

freetdm.conf

All I/O (b-channels) related parameters are set in freetdm.conf.
 

[span wanpipe <span name>]

trunk_type => <trunk type>
group => <group name>
b-channel => <physical span number>:<channels> 
d-channel => <physical span number>:<channel> 

 

trunk type: possible values are: t1, e1, bri (for point-to-point), bri_ptmp (for point-to-multipoint).
group name: any string.
physical span number: This should match the TDMV_SPAN  parameter in your /etc/wanpipe/wanpipeN.conf
channels: Specify which timeslots within this physical span you want to use.

...

All signalling related parameters are set in freetdm.conf.xml. Each span uses a configuration profile for signalling related parameters.
 

 

 name="freetdm.conf" description="FreeTDM Configuration">                 

<!-- General FreeTDM Configuration options -->
<settings>

<param name="crash-on-assert" value="no" />

</settings> 
<!-- Configuration profiles -->
<config_profiles>

<profile name="[profile name]">

<param name="[parameter key]" value="[parameter value]" />
<param name="[parameter key]" value="[parameter value]" />

</profile> 

</config_profiles>
<!-- list of PRI spans -->
<sangoma_pri_spans>

<span name="[span name]" cfgprofile="[profile name]">

<!-- switch related parameters -->
<param name="dialplan" value="XML" />
<param name="context" value="default" /> 

</span>

</sangoma_pri_spans>

<!-- list of BRI spans -->
<sangoma_bri_spans>

<span name="[span name]" cfgprofile="[profile name]">

<!-- switch related parameters -->
<param name="dialplan" value="XML" />
<param name="context" value="default" /> 

</span>

</sangoma_bri_spans> 

</configuration>

 

 

NFAS Configuration

Trunkgroup

...

<param name="spanmapvalue="nfas1, 0"/>

 

 

Configuration Options

  1. Switchtype78479831
  2. Interface78479831
  3. Overlap78479831
  4. TEI78479831
  5. Facility78479831
  6. Facility Timeout
  7. TON (Type of Number)
  8. NPI 78479831 (Numbering Plan Identification)
  9. Bearer Capability - Information Transfer Capability
  10. Bearer Capability - User Information Layer 1 Protocol78479831
  11. 78479831
  12. MSN (Multiple Subscriber Number)
  13. Early Media Override78479831
  14. Q931 Trace
  15. Q921 Trace
  16. Q931 Timers78479831
  17. Channel ID invert Extended bit
  18. Setup Arbitration
  19. Sending RESTART on link up
  20. Channel Restart Timeout
  21. Force Sending Complete78479831
  22. 78479831
  23. 78479831
  24. 78479831

  25. Force sending Caller ID NameCaller ID Name Transmit Method
  26. 78479831 

Anchor
Switchtype
Switchtype
Switchtype
This specifies the switch variant used.

Valid options for T1:

ni2 or nationalNational ISDN 2
5essLucent 5ESS
4essLucent 4ESS
dms100NTT DMS-100

 

Valid options for E1:

euroisdn or etsi EuroISDN/ETSI
qsigQSIG [coming soon!]

 

Valid options for BRI:

euroisdn or etsiEuroISDN/ETSI
insnetJapanese INS-NET

 

Valid options for J1:

insnetJapanese INS-NET [coming soon!]

 

Example: <param name="switchtypevalue="ni2" />



Anchor
Interface
Interface
Interface
This specifies the switch emulation.
Valid options: 

 Customer Premises Equipment, when connected to a Telco
netNetwork Emulation, when emulating a Telco

Default value:CPE
Freeswitch example: <param name="interfacevalue="cpe" />

 

Anchor
Overlap
Overlap
Overlap

Enables/Disables Overlap Receive. 
Valid options:

 

yesEnables overlap receive
noOnly BLOC mode is supported


Default value:no
Freeswitch example: <param name="overlapvalue="yes" />

Note: Overlap sending is not supported.

 

Anchor
TEI
TEI
TEI

Specify the default TEI value. This parameter is ignored when in Point-to-multipoint mode.

 

Valid options:1-126

Default value: 0
Freeswitch example: <param name="teivalue="64" />

 

Anchor
Facility
Facility
Facility

Enables/Disables support for FACILITY messages. Enable this option if your Caller ID name is received in a FACILITY message instead of the SETUP message.

 

Valid options:

yesEnables support for FACILITY messages and FACILITY IE decoding
noDisables support for FACILITY messages and FACILITY IE decoding

Default value: no

Freeswitch example: <param name="facilityvalue="yes" />

 

Anchor
Facility timeout
Facility timeout
Facility timeout
If you are using the Facility option, and not all incoming SETUP messages are followed by FACILITY messages, you can specify a timeout for how long we will wait for the facility message, in milliseconds.

Default value: 0

Freeswitch example: <param name="facility-timeoutvalue="50" />

 

 

Anchor
TON
TON
TON (Type of Number)

Specify the default TON on outbound calls.
See table 4-14 of 
ITU-T Q.931 (05/98) for descriptions.


List of parameters:

outbound-called-tonModify the default TON for the Called Party Number
outbound-calling-tonModify the default TON for the Calling Party Number
outbound-rdnis-tonModify the default TON for the Redirecting Number

 

List of options:

unknownUnknown
internationalInternational number
nationalNational number
localSubscriber number


Freeswitch example: <param name="outbound-called-tonvalue="international" />

...

Specify the default TON on outbound calls.
See table 4-14 of ITU-T Q.931 (05/98) for descriptions.


List of parameters:

outbound-called-npiModify the default NPI for the Called Party Number
outbound-calling-npiModify the default NPI for the Calling Party Number
outbound-rdnis-npiModify the default NPI for the Redirection Number

 

List of options:

unknownUnknown
isdnISDN/telephony numbering plan (Recommendation E.164)
dataData numbering plan (Recommendation X.121)
telexTelex numbering plan (Recommendation F.69)
nationalNational standard numbering plan
privatePrivate numbering plan
reservedReserved

 

Freeswitch example: <param name="outbound-calling-npivalue="isdn" />

 


Anchor
Bearer Capability - Information Transfer Capability
Bearer Capability - Information Transfer Capability
Bearer Capability - Information Transfer Capability

 

Sets the default Information Transfer Capability on outbound calls.
See section 4.5.5 (octet 3) of ITU-T Q.931 (05/98) for descriptions.

speechSpeech
unrestricted-digitalUnrestricted digital information
3.1khz3.1 kHz audio


Default value: speech
Freeswitch example: <param name="outbound-bc-transfer-cap" value="3.1khz" />

 


Anchor
Bearer Capability - User Information Layer 1 Protocol
Bearer Capability - User Information Layer 1 Protocol
Bearer Capability - User Information Layer 1 Protocol

 

Sets the default User information Layer 1 protocol on outbound calls.
See section 4.5.5 (octet 5) of ITU-T Q.931 (05/98) for descriptions.

v110ITU-T Standardized rate adaptation V.110, I.460 and X.30
ulawRecommendation G.711 mu-law
alawRecommendation G.711 A-law


Freeswitch example: <param name="outbound-bc-user-layer1value="ulaw" />

Anchor
MSN (Multiple Subscriber Number)
MSN (Multiple Subscriber Number)
MSN (Multiple Subscriber Number)

Valid for BRI CPE Point-to-multipoint only. Assign a local number to this span. Sangoma ISDN Library will not respond to calls where the called number does not match the local number.

Each span can have up to 8 local numbers.

Default value:<none>

Freeswitch example: <param name="local-numbervalue="12356" />
 

 

Anchor
Early Media Override
Early Media Override
Early Media Override

 On incoming calls, this option will enable early media, even if the remote switch does not indicate "In-band information or an appropriate pattern is now available" in the Progress Indicator Information Element.

See section 4.5.23 (octet 4) of ITU-T Q.931 (05/98) for descriptions.
Default value:<none>

on-proceedEarly media enabled when PROCEED message is received
on-alertEarly media enabled when ALERT message is received
on-progressEarly media enabled when PROGRESS message is received

 

Freeswitch example: <param name="early-media-overridevalue="on-progress" />
 

...



Anchor
Q921 trace
Q921 trace
Q921 trace 
Enables Q.921 trace on start.

Default value:no
Possible values:yes/no

Freeswitch example: <param name="q921-tracevalue="yes" />

Anchor
Q931 Timers
Q931 Timers
Q931 Timers

For description of Q.931 timers, see section 9.1 and 9.2 of ITU-T Q.931 (05/98) .
Set to 0 to use default values.
Values are in seconds. 

TimerParameterDefault value in CPE modeDefault value in NET mode
T301timer-t301180180
T302timer-t30215 (N/A for US variants)15 (N/A for US variants)
T303timer-t30344
T304timer-t3043030
T305timer-t3053030
T306timer-t3063535
T307timer-t3073535
T308timer-t30844
T310timer-t31010120
T312timer-t312T303 + 2N/A
T313timer-t31344
T314timer-t3143535
T316timer-t316120120
T318timer-t31844
T319timer-t31944
T322timer-t32244




Anchor
Channel Id Invert Extended Bit
Channel Id Invert Extended Bit
Channel Id Invert Extended Bit
Inverts the Channel-Id extended bit in the Channel Id IE when switchtype is DMS-100.

Note: This is a global parameter. This option will apply to all spans configured as DMS-100.

Default value:no
Possible values:yes/no

Freeswitch example: <param name="channel-id-invert-extend-bitvalue="yes" />

Anchor
Sending RESTART on link up
Sending RESTART on link up
Sending RESTART on link up
Forces the transmission of RESTART messages for each channel after the Q.921 layer is up.

 

Default values:
switchtypedefault value in CPE modedefault value in NET mode
NI-2noyes
dms100noyes
5essnoyes
4essnoyes
euroisdnnoyes
insnetnoyes
qsignono

 


Possible values:yes/no

Freeswitch example: <param name="channel-restart-on-link-upvalue="yes" />
 
Anchor
Setup Arbitration
Setup Arbitration
Setup Arbitration

Whether or not this node should be the arbiter for the Q.921 link. The arbiter is the side that sends SABME's when the link is down, and RR's once the Q.921 link is up.

Default value: yes for CPE, no for NET.
Freeswitch example: <param name="setup-arbitrationvalue="yes" />
 
Anchor
Channel Restart Timeout
Channel Restart Timeout
Channel Restart Timeout

Once FreeTDM is loaded, if we do not receive a RESTART message withing this timeout, we will send a RESTART message on all idle channels within that span. This option is useful if FreeTDM is quickly reloaded, causing the remote side's Q.921 layer to say in connected state, and therefore have inconsistent channels. 

 
Default value:0 (disabled)
Possible values:1-any (in milliseconds)

Freeswitch example: <param name="channel-restart-timeout" value="yes" />
 

Anchor
Force Sending Complete
Force Sending Complete
Force Sending Complete
Forces the transmission of the Sending Complete Information Element on NI-2 and 5ESS switchtypes. 

The Sending Complete Information Element is automatically included for EuroISDN variant.

Note: Transmitting the Sending Complete IE on NI-2 and 5ESS is not to specifications,  and you should only enable this option if the remote switch is responding to outgoing SETUP messages with SETUP ACKNOWLEDGE when its not supposed to be.
Default value:no
Possible values:yes/no

 

...