Page tree
Skip to end of metadata
Go to start of metadata

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.


freetdm.conf.xml

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

For each NFAS group, you will need a trunkgroup parameter in the profile section.
Format:
<param name="trunkgroupvalue="<trunkgroup name>, <number of spans>, <primary d-chan>, [<secondary d-chan>]"/>

For example, if you have a NFAS group with 16 T1's and the primary d-channel on span:wp8, and secondary d-channel on span: wp16.

<param name="trunkgroupvalue="nfas1, 16, wp8, wp16"/>

Spanmap

Format:
<param name="spanmapvalue="<trunkgroup name>, <logical span number>"/>

For example:

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

 

 

Configuration Options

  1. Sample FreeSWITCH Configuration files#Switchtype
  2. Sample FreeSWITCH Configuration files#Interface
  3. Sample FreeSWITCH Configuration files#Overlap
  4. Sample FreeSWITCH Configuration files#TEI
  5. Sample FreeSWITCH Configuration files#Facility
  6. Facility Timeout
  7. TON (Type of Number)
  8. Sample FreeSWITCH Configuration files#NPI (Numbering Plan Identification)
  9. Sample FreeSWITCH Configuration files#Bearer Capability - Information Transfer Capability
  10. Sample FreeSWITCH Configuration files#Bearer Capability - User Information Layer 1 Protocol
  11. MSN (Multiple Subscriber Number)
  12. Sample FreeSWITCH Configuration files#Early Media Override
  13. Q931 Trace
  14. Q921 Trace
  15. Sample FreeSWITCH Configuration files#Q931 Timers
  16. Channel ID invert Extended bit
  17. Sample FreeSWITCH Configuration files#Setup Arbitration
  18. Sample FreeSWITCH Configuration files#Sending RESTART on link up
  19. Sample FreeSWITCH Configuration files#Channel Restart Timeout
  20. Sample FreeSWITCH Configuration files#Force Sending Complete

  21. Force sending Caller ID Name
  22. Sample FreeSWITCH Configuration files#Caller ID Name Transmit Method 

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" />



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" />

 

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.

 

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" />

 

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" />

 

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" />

 

 

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" />

 

NPI (Numbering Plan Identification)

 

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" />

 


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" />

 


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" />

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" />
 

 

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" />
 
Q931 trace 
Enables Q.931 trace on start.

Default value:no
Possible values:yes/no

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


Q921 trace 
Enables Q.921 trace on start.

Default value:no
Possible values:yes/no

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

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




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" />

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" />
 
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" />
 
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" />
 

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

 

Freeswitch example: <param name="force-sending-completevalue="yes" />


Force Sending Caller ID Name
Forces the transmission for the Caller ID Name.
Note: Transmitting the  Caller ID Name from the CPE to the Network is usually not to spec.

Parameter name:send-cid-name

Default value:auto
Possible values:yes/no/auto

auto: Send the Caller ID Name if configured as Network side, and spec allows it.
no: Never send the Caller ID Name
yes: Always send the Caller ID Name


Freeswitch example: <param name="send-cid-name" value="yes" />

 

Caller ID Name Transmit Method
Specify which Information Element to use when sending the Caller ID Name.
Note: Transmitting the Caller ID Name using Display IE on NI-2(national) variant is not to spec.
Note: Transmitting the Caller ID Name using Facility IE on EuroISDN variant is not to spec.

Parameter name:cid-name-transmit-method

Default value:auto
Possible values:display-ie, facility-ie, user-user-ie

display-ie: Use the Display Information Element to transmit the Caller ID Name. This is the recommended method for EuroISDN - PRI.
facility-ie: Use the Facility Information Element to transmit the Caller ID Name. This is the recommended method for North American Variants.
user-user-ie: Use the user-user Information Element to transmit the Caller ID Name. This is the recommended method for EuroISDN - BRI.

Freeswitch example: <param name="cid-name-transmit-methodvalue="display-ie" />
  • No labels