MTP2 API Configuration

The configuration files involved are:

wanpipeN.conf
Provides configuration parameters for Wanpipe Drivers.
freetdm.conf
Provides I/O configuration parameters to FreeTDM.
freetdm.conf.xml
Provides signalling configuration parameters to FreeTDM.

wanpipeN.conf

The Wanpipe configuration files are located in /etc/wanpipe/wanpipeN.conf. Each span T1/E1 port require 1 configuration file.

Sample LSL configuration file
Sample HSL configuration file

freetdm.conf

The freetdm.conf configuration file is located in /usr/local/freetdm (default). It contains I/O specific parameters.

General Format:

[span wanpipe <span name>]
d-channel => <span number>:<channels>

Sample freetdm.conf with 10 LSL links (using first 5 timeslots on two E1 lines)

Sample freetdm.conf with 2 HSL links

freetdm.conf.xml

The freetdm.conf.xml file is used by the sample application to generate span configuration parameters. The parameters are then passed to the FreeTDM library. The freetdm.conf.xml can be located in any directory, it is specified as an argument when running the sample application.

<configuration>
  <signaling_configs>
    <sngss7_configs>
      <sng_isup name="ss7config">
        <sng_gen>
          <param name="procId" value="1"/>
          <param name="operating_mode" value="MTP2_API" />
 <param name="license" value="/etc/wanpipe/license.txt" />
        </sng_gen>

        <mtp1_links>
          MTP1 Configuration Options
        </mtp1_links>

        <mtp2_links>
          MTP2 Configuration Options
        </mtp2_links>

      </sng_isup>
    </sngss7_configs>
  </signaling_configs>

  <sangoma_ss7_spans>
    Span configuration options 
  </sangoma_ss7_spans>
</configuration>

MTP1 Configuration Options

<mtp1_link name="mtp1-1">
  <param name="id" value="1"/>
  <param name="span_name" value=<span-name> />
  <param name="chan_no" value=<timeslot> />
</mtp1_link>

The "id" value should be unique for each MTP1 Link.
The "span_name" value should match the value specified in freetdm.conf
The "chan_no" value specifies which timeslot within the E1 is used. For HSL Links, the chan_no value is always 1.

MTP2 Configuration Options

<mtp2_link name="mtp2-1">
  <param name="id" value="1"/>
  <param name="mtp1Id" value="1"/>
  <param name="errorType" value="basic"/>
  <param name="lssuLength" value="1"/>
  <param name="linkType" value="itu92"/>
  <param name="sapType"  value="hsl" />
</mtp2_link>

The "id" value should be unique for each MTP2 Link.
The "mtp1Id" value specifies which MTP1 Link is used by this MTP2 Link.
The "errorType" value specifies the Error Correction method used. Valid values are "basic" for Basic Error Correction (BEC) and "PCR" for Preventive Cyclic Retransmission (PCR).
The "lssulength" value specifies the length of the Status Field (SF) in bytes. Valid values are 1 or 2.
The "linkType" value specifies the variant used by this mtp2 link. Valid values are: itu88, itu92, etsi, ansi88, ansi92.
The "sapType" value specified the type of the link. Valid values are: lsl, hsl, hsl-extended.

Span Configuration Options

The "name" parameter specifies which physical span is used. It should match the span name used in freetdm.conf.

Sample freetdm.conf.xml (4 LSL links on a single E1)

Telephony Cards