USBFXO on FreeSwitch

1. Linux: Package requirements prior to Wanpipe installation
2. Linux: Wanpipe-Zaptel Install for FreeSwitch
3. Linux : FreeSwitch Installation
4. Configuration

Zaptel/Wanpipe Installation

Note: Zaptel Source Can be downloaded from http://downloads.asterisk.org/pub/telephony/zaptel/releases/ 

1. Zaptel Installation

Download Zaptel into arbitrary directory (/usr/src) and  untar it.
#>tar xvfz zaptel-<version>
#>cd zaptel-<version>
#>./configure
#>make
#>make install

2. Wanpipe Driver Installation

Wanpipe TDM/Zaptel Installation (Linux)

1. Download the Wanpipe Driver --> wanpipe-3.5.4.tgz
   --
2. Untar wanpipe release in arbitrary directory (/usr/src/ is recommended).
   

   #>tar xvfz wanpipe-<version>.tgz
   #>cd wanpipe-<version>

   After untarring WANPIPE®, the wanpipe<version>/ directory will be created.
   ---
3. Run ./Setup install from the newly created wanpipe-<version> directory
      
            #>./Setup zaptel
       or
            #>./Setup zaptel --64bit_4GB 
                (in case X86_64bit & 4GB memory or more)
    
   Proceed with installation Select "Y" for each option.
   Under compilation mode:  Select "TDM Only drivers" (Option #2).
   
   Setup will auto-detect zaptel sources in /usr/src directory?
   [By default Setup will look in /usr/src]
   
   
4. Proceed with Defaults for the rest of the compilation.  
   ---
5. Last step in installation will ask you to configure wanpipe cards for Zaptel SSelect "No" for this step
   If any errors are encountered during the compilation of the utilities, click here for assistance.

 
Confirm Successful Wanpipe/Zaptel Installation

1. Confirm successful Wanpipe/zaptel installation run:
   

   #>wanrouter hwprobe
   Example:
   # wanrouter hwprobe
   
   -------------------------------
   | Wanpipe Hardware Probe Info |
   -------------------------------
   1 . U100       : BUSID=4-1 : V=00
   
   Card Cnt: A101-2=0 A104=0 B700=0 U100=1 B600=0
   
   

   
   This command will load the wanpipe and zaptel modules and will print out list of all Sangoma hardware installed on the system. 

Linux: FreeSwitch Installation

 Installing FreeSwitch requires the following:

On Centos 5.X:

#> yum install subversion autoconf bison flex make gcc gcc-c++ libtool automake ncurses-devel

On debian or ubuntu:

•  Install tools needed before packaging:
  #> apt-get install devscripts pbuilder gcc make bison automake autoconf flex libtool
• Let freeswitch handlerequired dependencies from the source with pbuilder

Now you can either user the release tarballs or check out the latest development version from the freeswitch repository:

For the latest release tarballs go to http://files.freeswitch.org/ and download the latest source package. Change into the directory you want to place the sources in and unpack the sources, for example:

#> cd /usr/src
#> tar xvfz freeswitch-1.0.1.tar.gz

To get the source of the latest development source, do the following:

• Decide where you will place the sources (we use /usr/src/freeswitch)
• Go to the parent directory of where you want to place the sources: cd /usr/src
• Check out trunk with subversion:
  # svn checkout http://svn.freeswitch.org/svn/freeswitch/trunk freeswitch
  # svn checkout http://svn.freeswitch.org:81/svn/freeswitch/trunk freeswitch
• Subversion will download all required files and place hem in the freeswitch subdirectory

Now lets proceed to building freeswitch.

 Install FreeSwitch/OpenZAP via Source without packaging

• Change into the freeswitch build directory
  #> cd freeswitch
• If you downloaded the tar file, skip this step, otherwhise bootstrap the source
  #> ./bootstrap.sh
• Configure the buildsystem
  #> ./configure --prefix=/opt/freeswitch --enable-core-libedit --with-openssl
• Select the modules to be build. The most important is to uncomment the opezap line (#../../libs/openzap/mod_openzap)
  #> vi modules.conf
• Build
  #> make all install
  #> make samples
  #> make sounds-install (to install the default sound files)
  #> make moh-install (to install default music on hold files)
• Proceed to the Configuration Page

Install FreeSwitch/OpenZAP as package

  On Centos 5.X:

•  you will require rpm build tools
  #> yum install rpm-build
• Now just run:
  #> rpmbuild -tb freeswitch-1.0.1.tar.gz
• Your rpm will be created, You will have to install it using rpm

 On Debian/Ubuntu: 

• Change into the freeswitch directory:
  #> cd freeswitch
• Call pbuilder to satisfy dependencies :
  #> sudo  /usr/lib/pbuilder/pbuilder-satisfydepends
• Call the package builder to create the .deb packages:
  #> debuild
• Use dpkg to install the resulting packages:
  #> cd ..
  #> sudo dpkg -i *.deb
• Proceed to the Configuration page

Configuration

1. Run the command "wancfg_zaptel --no-zapata" to configure USB FXO for Zaptel mode this will create /etc/wanpipe/wnapipe1.conf and /etc/zaptel.conf for USB FXO
2. Manually create openzap.conf for FreeSwitch( Location: /opt/freeswitch/conf)
   Sample configuration file:
   ----------cut here------------
   [span zt usbfxo]
   name => OpenZAP
   number => 1
   fxo-channel => 1,2
   --------cut here----------
3. Add analog Span configuration in openzap.conf.xml (/opt/freeswitch/conf/autoload_configs)
   
   Sample Configuration
   ---------------------- cut here---------------------------------------------
   <configuration name="openzap.conf" description="OpenZAP Configuration">
     <settings>
       <param name="debug" value="0"/>
       <!--<param name="hold-music" value="$${moh_uri}"/>-->
       <!--<param name="enable-analog-option" value="call-swap"/>-->
       <!--<param name="enable-analog-option" value="3-way"/>-->
     </settings>
     <!-- one entry here per openzap span -->
     <analog_spans>
       <span id="1">
         <!--<param name="hold-music" value="$${moh_uri}"/>-->
         <!--<param name="enable-analog-option" value="call-swap"/>-->
         <!--<param name="enable-analog-option" value="3-way"/>-->
         <param name="tonegroup" value="us"/>
         <param name="digit-timeout" value="2000"/>
         <param name="max-digits" value="11"/>
         <param name="dialplan" value="XML"/>
         <param name="context" value="default"/>
         <!--<param name="enable-callerid" value="true"/>-->
         <!-- regex to stop dialing when it matches -->
         <!--<param name="dial-regex" value="5555"/>-->
         <!-- regex to stop dialing when it does not match -->
         <!--<param name="fail-dial-regex" value="^5"/>-->
       </span>
     </analog_spans>
   </configuration>
   ---------------------- cut here---------------------------------------------