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

 


Wanpipe Driver

  1. Introduction
  2. Download:
       -> Linux Driver
       -> Windows Driver
  3. Installation
  4. Configuration
  5. Operation
  6. Port Identification on T1/E1 Cards
  7. Wanpipe How-To
  8. Wanpipe Debugging


Introduction


What is Wanpipe?

Wanpipe is a suite of drivers and utilities that enable all Sangoma hardware (except for Sangoma Transcoding).  Sangoma kernel device driver (WanpipeTM) is a unified linux & windows code base that works with all sangoma hardware devices.

The unified device driver core provides application support for:
    -> Dahdi/Zaptel 
      Provides API support for dahdi/zaptel with Asterisk.
    -> TDM API
      Provides libsangoma API support over voice b-chan and d-chan, used for FreeSWITCH
    -> WAN IP mode
      Provides IP/WAN support via WAN protocols (PPP,CHDLC,Frame Relay...)
    -> DATA API
      Provides libsangoma API support over HDLC.  (non-voice mode)
    -> Legacy API
      Linux and Windows specific Data API mode (not supported any more)

The driver is very flexible and allows multiple applications to run over single Sangoma hardware.
For example one can run Asterisk on T1 channels 10-23+24dchan, and WAN/IP over channels 1-9.

In other words, you must install the Wanpipe Driver to use your Sangoma hardware :)
-----------

Wanpipe Linux Package

Wanpipe package for Linux contains:

-> Linux device drivers for all kernel versions, all dahdi/zaptel versions and all sangoma hardware.
-> User space utilities and scripts that are used to start,stop and debug the driver.

The wanpipe kernel driver is separated into 5 separate kernel modules.

- sdladrv         - hw abstraction layer
- wanrouter    - user interface layer and proc file system
- wanec          - echo canceller layer
- wanpipe       - core and application layer : dahdi, tdmapi, data api, legacy api
- wanpipe_lip - WAN protocol layer: PPP,CHDLC,Frame Relay  
                          (Optional: not compiled for dahdi only mode)

 


Installation

Click below to install Wanpipe for the following application:

-> Asterisk

-> FreeSWITCH

-> API mode

Once Wanpipe is installed for your application, proceed to the Configuration section


Configuration


Once the Wanpipe driver is installed for your application, you must configure the driver for use.  Click the appropriate application below to configure:

-> Asterisk

-> FreeSWITCH

-> API mode


Operation

The Wanpipe Driver contains many scripts, utilities and applications to control its operation.  Below are a list of the typically used ones.  Click HERE for a complete list

wanrouter : Wanpipe operation script used to start/stop/restart Wanpipe drivers

i.e. wanrouter stop : stops the driver, including all interfaces/ports  (Asterisk/FreeSWITCH
                                  or your application must be stopped prior to stopping the driver)
      wanrouter start : starts the driver and brings up all interfaces/ports
      wanrouter restart: first stops the wanpipe driver and all interfaces/ports,
                                     then starts up again

      wanrouter status: Checks the current state of all wanpipe interfaces/ports
                                    ("connected", or "disconnected)

      wanrouter hwprobe: detects the Sangoma hardware on the system and displays the card type,
                                        slot/bus location, firmware version and hardware echo cancellation info

wanpipemon : Wanpipe debugging application used to debug the hardware, drivers and sync line

i.e. wanpipemon -i <if name> -c Ta: used to check for Alarms on the line. Typically used if
                                                    "wanrouter status" displays "disconnected" when a line is plugged in
      
wanpipemon -i <if name> -c ehw
: used to monitor Hardware Echo Cancellation
       wanpipemon -i <if name> -c trd: Raw trace on the line.  Used to verify D-channel signaling on
                                                           PRI/BRI, and MTP2 for SS7


wancfg: Wanpipe Configuration tool

               i.e. wancfg_dahdi: script used to configure Sangoma card(s) with DAHDI for Asterisk use
                     
wancfg_fs: script used to configure Sangoma card(s) with FreeSWITCH
                     
wancfg_smg: script used to configure Sangoma card(s) with SMG
                     
wancfg: script used to configure Sangoma card(s) for API/WAN, HDLC streaming