MTP3 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>

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="mtp3api" value="yes" />
 <param name="license" value="/etc/wanpipe/license.txt" />
        </sng_gen>

        <mtp1_links>
          MTP1 Configuration Options
        </mtp1_links>

        <mtp2_links>
          MTP2 Configuration Options
        </mtp2_links>

 <mtp3_links>
          MTP3 Configuration Options
        </mtp3_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>

MTP3 Configuration Options

<mtp3_link name="mtp2-1">
TBD
</mtp2_link>

Span Configuration Options

<span name="wp1" cfgprofile="ss7config">
  <param name="ccSpanId" value="1"/>
</span>

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