SNGTC module

Admin Guide

Overview

The Sangoma transcoding module offers the possibility of performing voice transcoding with the D-series transcoding cards manufactured by Sangoma. The module makes use of the Sangoma Transcoding API in order to manage transcoding sessions on the dedicated equipment. For the cards in the network to be detected, the Sangoma SOAP server must be up and running (sngtc_server daemon).

How it works

The module performs several modifications in the SDP body of SIP INVITE, 200 OK and ACK messages. In all transcoding scenarios, the UAC performs early SDP negotiation, while the UAS does late negotiation. This way, OpenSIPS becomes responsible for intersecting the codec offer and answer, together with the management of transcoding sessions on the Sangoma cards.

This scenario brings about a couple of restrictions:

• UACs MUST only perform early SDP negotiation
• UASs MUST support late SDP negotiation (rfc 3261 requirement)

Since the sngtc_node library performs several memory allocations with each newly created transcoding session, the module uses a dedicated process, responsible for the management of the above-mentioned sessions. The sangoma_worker process communicates with the OpenSIPS UDP receivers through a series of pipes.

Dependencies

OpenSIPS Modules

The following modules must be loaded before this module:

• dialog.

External Libraries or Applications

The following libraries or applications must be installed before running OpenSIPS with this module loaded:

• sngtc_node library - download from Sangoma, unpack, make, make install (required in order to compile this module).
• sngtc_server up and running (required in order for this module to properly work).

Exported Functions

sngtc_offer()

The function strips off the SDP offer from a SIP INVITE, thus asking for another SDP offer from the opposite endpoint (late negotiation).

The following error codes may be returned:

• -1 - SDP parsing error
• -3 - internal error / no more memory

The function can be used from REQUEST_ROUTE, ONREPLY_ROUTE.

sngtc_offer usage

...
  if (is_method("INVITE")) {
    t_newtran();
    create_dialog();
    sngtc_offer();
  }
...

sngtc_callee_answer([listen_if_A], [listen_if_B])

Handles the SDP offer from 200 OK responses, intersects both offers with the capabilities of the transcoding card and creates a new transcoding session on the card only if necessary. It then rewrites the 200 OK SDP so that it contains the information resulted from the codec intersection.

Parameters explained:

Since the D-series transcoding cards are connected through either a PCI slot or simply an Ethernet connector, they cannot be assigned global IPs. Consequently, the module will write the local, private IP of the card in the SDP answers sent to each of the endpoints. Since this will not work with non-local UAs, the optional parameters force the RTP listen interface for each UA. This way, the script writer can enforce a global IP for the incoming RTP (which can be port forwarded to a transcoding card).

• listen_if_A (string) - the interface where the UAC (the caller) will send RTP after the call is established (IP from the ‘c=’ SDP line(s))
• listen_if_B (string) - the interface where the UAS (the callee) will send RTP after the call is established (IP from the ‘c=’ SDP line(s))

The following error codes may be returned:

• -1 - SDP parsing error
• -2 - failed to create transcoding session
• -3 - internal error / no more memory

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE.

sngtc_callee_answer usage

...
onreply_route[1] {
  if ($rs == 200)
    sngtc_callee_answer("11.12.13.14", "11.12.13.14");
}
...

sngtc_caller_answer()

Attaches an SDP body to the caller’s ACK request, so that it matches the late SDP negotiation done by the UAS.

The following error codes may be returned:

• -3 - internal error / no more memory

This function can be used from REQUEST_ROUTE, ONREPLY_ROUTE.

sngtc_caller_answer usage

...
  if (has_totag()) {
    if (loose_route()) {
      ...
      if (is_method("ACK"))
        sngtc_caller_answer();
    }
    ...
  }
...

Contributors

By Commit Statistics

Top contributors by DevScore⁽¹⁾, authored commits⁽²⁾ and lines added/removed⁽³⁾

#	Name	DevScore	Commits	Lines++	Lines—
1.	Liviu Chircu (@liviuchircu)	34	14	2079	62
2.	Razvan Crainea (@razvancrainea)	10	8	16	13
3.	Bogdan-Andrei Iancu (@bogdan-iancu)	9	6	29	64
4.	Stefan Darius (@dariusstefan)	7	4	216	36
5.	Vlad Patrascu (@rvlad-patrascu)	6	4	28	28
6.	Peter Lemenkov (@lemenkov)	3	1	1	1

(1) DevScore = author_commits + author_lines_added / (project_lines_added / project_commits) + author_lines_deleted / (project_lines_deleted / project_commits)

(2) including any documentation-related commits, excluding merge commits

(3) ignoring whitespace edits, renamed files and auto-generated files

By Commit Activity

#	Name	Commit Activity
1.	Stefan Darius (@dariusstefan)	Jun 2026 - Jul 2026
2.	Razvan Crainea (@razvancrainea)	Aug 2015 - Jun 2026
3.	Bogdan-Andrei Iancu (@bogdan-iancu)	Oct 2014 - Mar 2020
4.	Vlad Patrascu (@rvlad-patrascu)	May 2017 - Apr 2019
5.	Liviu Chircu (@liviuchircu)	Aug 2013 - Jun 2018
6.	Peter Lemenkov (@lemenkov)	Jun 2018 - Jun 2018

(1) including any documentation-related commits, excluding merge commits

Documentation

Contributors

Last edited by: Razvan Crainea (@razvancrainea), Vlad Patrascu (@rvlad-patrascu), Liviu Chircu (@liviuchircu), Peter Lemenkov (@lemenkov).

License

All documentation files (i.e. .md extension) are licensed under the Creative Common License 4.0