WELCOME [ Log In · Register ]        SITE [ Search · Page Index · Recent Changes ]    RSS

Sangoma Wanpipe Signaling API - SigBoost

 

  1. Introduction
  2. Libsigboost library
  3. SigBoost Structures
  4. SigBoost Protocol Internals
  5. Example Code
  6. Real world application SMG
  7. Video Presentation of SMG Architecture


Introduction

Sangoma SIGBOOST protocol is an abstracted socket based protocol used to abstract various Sangoma PSTN signaling stacks.  The idea is to provide a uniform consistent interface for all PSTN stacks with a simple to use socket based API.

Sangoma PSTN Boost Abstracted Signalling Stacks:

  • ISUP SS7 (ss7box) 
  • BRI  (Netbricks)
  • PRI  (Telesoft)


Each Sangoma PSTN stack runs as its own standalone application/server.  The user configures the signaling pstn server based on sangoma hardware installed.   Each PSTN server communicates directly to the sangoma hardware via (libsangoma API) DCHAN device.  Incoming CALL events are abstracted into sigboost call structure and passed over the socket to a custom application.  Conversely if application wants to place a call, it creates a sigboost call structure and passes it to the signaling server.

Sigboost PSTN Signaling servers have been in production for over 3 years.  They currently work with Asterisk/Freeswitch and as part of a Sangoma Media gateway solution.

Video Presentation of SMG Architecture

 

Sangoma-Voice-Signaling-API.jpg

 

SIGBOOST API Library:  libsigboost

The sigboost protocol is currently being abstracted into a very simple portable C use-space library libsigboost.  Developer would use the library to talk to the signalling pstn server. (ISUP, BRI & PRI)

The libsigboost library is being stress tested at the moment and will be released mid April 2009

 

 

SIGBOOST protocol is based on sigboost C structures.

  • t_sigboost_callstart 
    Used to place initial call.
    Used to send extra out of order digits for an existing call.
    Call start structure containing call start fields.
    This structure has a fixed size + expandable size to accommodate all call start parameters if needed.    
                  ...
  • t_sigboost_short
    Call Ack/Nack/Stop/Restart structure.
    Used to send Ack/Nack/Stop/Restart events.      
                         ...
  • SIGBOOST header file containing the full structures and events.
    sigboost.h      (Version 1.00)

 

 

SIGBOOST Protocol

Sigboost protocol event diagrams.  

Note that libsigboost will abstract all the protocol handling from the developer.  This information should be used as view of how the sigboost protocol has been developed and tested. 

 

Example Code

Both libsigboost library and sample application using it is currently being developed.

For a real world vie of sigboost in action one can take a look at a sangoma media gateway below.

 

Example of SigBoost in Production

Sangoma Media Gateway uses sigboost to talk to a SS7-ISUP, BRI and PRI stacks.

sangoma_mgd svn
-> svn co https://www.sangomapbx.com/svn/sangoma_mgd/trunkd sangoma_mgd.trunk
-> it contains latest sigboost.h

user:pass: svnanon/svnanon

Sangoma Media Gateway Architecture Diagram
http://wiki.sangoma.com/files/wanpipe-linux-asterisk-ss7/Sangoma-SS7-Solution-For-Asterisk-LG.jpg

 

 

 

More Info

For more information please contact Sangoma.
Email: techdesk@sangoma.com 
Tel: 905 474 1990 x3


Video Presentation of SMG Architecture