Sangoma Windows Drivers and API

The Sangoma Windows Device Driver can be downloaded from this link: ftp://ftp.sangoma.com/WINDOWS/AFT.
The Driver supports the following models of Sangoma cards: 

• AFT A108 8 Port T1/E1 Board (with optional HW Echo Canceler)
• AFT A104 4 Port T1/E1 Board (with optional HW Echo Canceler)
• AFT A102 2 Port T1/E1 Board (with optional HW Echo Canceler)
• AFT A101 1 Port T1/E1 Board (with optional HW Echo Canceler)
• AFT A200 Analog FXO/FXS (with optional HW Echo Canceler)

1. WAN IP Networking
2. Data API
3. TDM Voice API (Span Based)
4. TDM Voice API (Channel Based - LibSangoma)

The detailed instructions on how to install and configure Sangoma Windows Device Driver for WAN IP Networking can be found here:"install.pdf".

-> HDLC or BitStream API over T1/E1 lines.
-> API supports full/fractional/channelized T1/E1 modes.
-> ioctl based (device per T1/E1 port or per T1/E1 channel group)

• Perform API installation as described in install.pdf
• After successful installation proceed to the Device Manager
• Locate Sangoma cards in Device Manager
• Click on Properties
• Change "Operational Mode" to "API"
• Select Apply

DATA API Code Example files are located in unzipped wanpipe release directory:
Please refer to the WindowsAPI PDF for code example demo.

cd AFT_6.0.4.7\API\Sample

Note:
DATA API and TDM VOICE API code examples are IDENTICAL.
What differs is the Driver Operational Mode configured during the install process.
The Driver Operational Mode is used to determine whether API is for DATA or for TDM VOICE.

The Driver operation & debugging is described here: Operation

 TDM Voice API (Span Based)

-> ioctl based API (kernel device per T1/E1 port or T1/E1 channel group)
-> supports uLaw over T1 and aLaw over E1
-> supports hardware echo canceler
-> dtmf detection
-> hardware HDLC D-Chan interface
    (used by signaling protocols such as PRI/MTP2: provided by customer)
-> RBS (a,b,c,d) bit control/access
-> Span based: one device per full T1/E1 span
    (user application must perform de-multiplexing of T1/E1 channels in software)
-> Good for high density applications greater than 4 T1/E1 spans per computer

Installation/Configuration

The detailed instructions for Sangoma Windows Device Driver installation can be found in this pdf "install.pdf" file.
-> Perform TDM VOICE API installation as described in install.pdf
-> After successful installation proceed to Device Manager
-> Locate Sangoma cards in Device Manager
-> Click on Properties
-> Change "OPERATION" mode to "TDM VOICE API"
-> Select Apply
  
At this point the Sangoma Windows Device Driver will be configured for TDM API (Span Based)
 

TDM API Code Example files are located in unzipped wanpipe release directory:
Please refer to the WindowsAPI PDF for code example demo.

cd AFT_6.0.4.7\API\Sample

The C/C++ header files for the API are located in AFT_6.0.4.7\include directory,
Visual Studio project file is included in Sample directory

Note:
DATA API and TDM VOICE API code examples are IDENTICAL.
What differs is the Driver Operational Mode configured during the install process.
The Driver Operational Mode is used to determine whether API is for DATA or for TDM VOICE.
 

 TDM Voice API (Channel Based - LibSangoma)
 

-> ioctl based API (kernel device per T1/E1 channel)
-> supports uLaw over T1 and aLaw over E1
-> supports hardware echo canceler
-> dtmf detection
-> hardware HDLC DCHAN interface
    (use by signaling protocols such as PRI/MTP2: provided by customer)
-> RBS (a,b,c,d) bit control
-> Easy to program/develop - but not scalable over 4 T1/E1 spans per computer.
-> LibSangoma API is also supported on Linux which provides easy cross platform portability.

Installation/Configuration

The detailed instructions for Sangoma Windows Device Driver installation can be found
in this pdf file: "API/LibSangoma".
-> Perform FULL installation as described in API/LibSangoma
-> After successful installation proceed to Device Manager
-> Locate Sangoma cards in Device Manager
-> Click on Properties
-> Change "OPERATION" mode to "LibSangoma API"
-> Select Apply
 
At this point the Sangoma Windows Device Driver will be configured for LibSangoma API (Channel Based) 

LibSangoma API Code Example files are located in unzipped wanpipe release directory:
The source code for LibSangoma is in 'voice_api_libsangoma\libsangoma',
the code example which utilizes capabilities of LibSangoma is in 'voice_api_libsangoma\libsangoma_sample'.
The result of compilation of LibSangoma is 'libsangoma.lib' static library. You application should be 'linked' against this library.

Please refer to the LibSangomaAPI PDF for code example demo.

cd AFT_6.0.4.7\api\Voice_API_LibSangoma

The C/C++ header files for the API are located in AFT_6.0.4.7\include directory.

The Driver operation & debugging is described here: Operation