Sangoma Wanpipe High Performance TDM SPAN Voice API
The Sangoma HP TDM API is based on a TDM SPAN architecture where wanpipe device driver exposes a single kernel device per span. The SPAN based architecture greatly improves system performance by reducing the number of kernel context switching in a system.
The HP TDM API user space library runs on top of the low level SPAN kernel devices and provides application developer a channelized API mode. This greatly simplifies the user development experience over the SPAN based architecture.
HP TDM API - SPAN Based Architecture
| User Application - Channelized Architecture |
| LibSangoma HP TDM API - user space - library |
Wanpipe SPAN API - kernel
|
Wanpipe Drivers - Core - kernel
|
| AFT Hardware [T1/E1/Analog/BRI] - hardware |
Driver Download & Installation
- Download Wanpipe Release
-> wanpipe-3.3.12.1.tgz
- Install Wanpipe driver
-> tar xfz wanpipe-<ver>.tgz
-> cd wanpipe-<ver>.tgz
-> ./Setup install
Choose ALL Default options OR TDM API compile option
- Confirm Driver installation
-> wanrouter hwprobe
-> wanrouter version
- Note that libsangoma library has already been installed during wanpipe installation.
HP TDM API Driver Configuration
- Currently the wancfg_tdmapi does not support HP TDM API configuration
- One has to create a configuration file manually - wanpipe1.conf
Note: This will be fixed by this week! (2008-08-18)
HP TDM API Library: libsangoma
- Locate LibSangoma HP TDM API Library
-> cd wanpipe-<ver>
-> cd api/libsangoma
-> Sources: libhpsangoma.c libhpsangoma_priv.c
-> Public Headers: libhpsangoma.h
-> Private Headers: libhpsangoma_priv.h
- To Rebuild LibSangoma Library
-> ./configure --prefix=/usr
-> make clean
-> make
-> make install
- Doxygen Documentation - LibSangoma HP TDM API
-> cd wanpipe-<ver>/api/libsangoma/docs/doxygen
-> open index.html in your browser.
-> firefox index.html
HP TDM API Sample Code & Documentation
- Locate HP TDM API Sample Code
-> cd wanpipe-<ver>
-> cd api/libsangoma
-> cd examples
-> cd hptdm_api
-> vi aft_tdm_hp.c
The aft_tdm_hp.c is a fully documented application.
The aft_tdm_hp will start all spans and channels currently configured.
- To build sample application
-> make clean
-> make
-> ./aft_tdm_hp <enter>
- Doxygen Documentation - Sample Applicatoin
-> cd wanpipe-<ver>/api/libsangoma/examples/hptdm_api/docs/doxygen
-> open index.html in your browser.
-> firefox index.html
| 
