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

Sangoma Wanpipe VoiceTime: USB Voice Sync Tool

 
The Wanpipe VoiceTime device provides a reliable hardware clock to Zaptel/Asterisk system. 
The VoiceTime USB stick replaces the Zaptel ztdummy kernel module.
Please note that Zaptel must be already installed on your system. 

  1. Hardware Installation
  2. Download Drivers
  3. Installation & Operation (Zaptel)
  4. Installation & Operation (Dahdi)
  5. Debugging 
  6. Trixbox Installation Instructions (Zaptel)
  7. Trixbox Installation Instructions (Dahdi)

NOTE: For best operation use a 2.6.25 or newer Linux kernel.  The USB sub-system has changed drastically and earlier kernels are not as stable


Hardware Installation

Simply plug in the VoiceTime USB Sync tool into your Asterisk Server.  And follow the installation instructions below.
 
Please note that hot plug functionality is not supported.  Unload drivers before removing the VoiceTime USB.
Wanpipe VoiceTime USB Sync Tool

 

Download Drivers

You will need to download the latest Wanpipe VoiceTime Driver
-> wanpipe-voicetime-1.0.9.tgz  (2009-04-23)   

-> ChangeLog 

 

Installation Instructions for Zaptel and USB Voice Sync Tool


  1. Insert the USB Wanpipe VoiceTime Device into the Server USB Port.  
  2. Make sure Zaptel has already been installed on your system
    -> Download from www.asterisk.org
    -> cd /usr/src
    -> tar xfz zaptel-<ver>.tgz
    -> cd zaptel-<ver>
    -> ./configure
    -> make
    -> make install
    -> make config  
  3. Download the Wanpipe Voicetime Driver
  4. Untar and change directory
    -> tar xfz wanpipe-voicetime-<ver>.tgz
    -> cd wanpipe-voicetime-<ver>  
  5. Build Wanpipe VoiceTime for Currently Running Zaptel Module
    -> make ZAPDIR=/usr/src/zaptel-<ver>

    ZAPDIR= location of zaptel source used to build and install zaptel
    By default ZAPDIR=/usr/src/zaptel  
  6. Install VoiceTime module into current system
    -> make install  
  7. Install bootup startup script for VoiceTime
    -> make boot

    The wanpipe_voicetime uses /etc/init.d/zaptel script. The zaptel startup script must be installed
    eg: cd /usr/src/zaptel-<version>
          make        #build zaptel
          make install    #install zaptel modules
          make config        #install zaptel boot script    
  8. Start Wanpipe VoiceTime using Zaptel Startup Script
    -> /etc/init.d/zaptel start  
  9. Confirm that VoiceTime Sync Tool is working
    -> zttest

 

 

 

Installation Instructions for Dahdi and USB Voice Sync Tool


  1. Insert the USB Wanpipe VoiceTime Device into the Server USB Port.  
  2. Make sure Dahdi has already been installed on your system
    -> Download Dahdi-Linux and Dahdi-tools from www.asterisk.org
    -> cd /usr/src
    -> tar xfz dahdl-linux<ver>.tar.gz
    -> cd dahdi-linux-<ver>
    -> make
    -> make install
  3. The wanpipe_voicetime uses /etc/init.d/dahdi script. The dahdi startup script must be installed
    ->  tar xfz dahd-tools-<ver>tar.gz
    ->./configure
    ->make
    ->make install
    ->make config
  4. Download the Wanpipe Voicetime Driver
  5. Untar and change directory
    -> tar xfz wanpipe-voicetime-<ver>.tgz
    -> cd wanpipe-voicetime-<ver>  
  6. Build Wanpipe VoiceTime for Currently Running Dahdi Module
    -> make DAHDI_DIR=/usr/src/dahdi-linux-<ver>

      DAHDI_DIR= location of dahdi source used to build and install dahdi module
                    By default DAHDI_DIR=/usr/src/dahdi

            Note: Make file will cache the DAHDI path so next time
                  one can recompile using just make.
  7. Install VoiceTime module into current system
    -> make install  
  8. Install bootup startup script for VoiceTime
    -> make boot
  9. Start Wanpipe VoiceTime using Zaptel Startup Script
    -> /etc/init.d/dahdi start  
  10. Confirm that VoiceTime Sync Tool is working
    -> dahdi_test

 

Trixbox Installation Instructions

a) Zaptel Method (Up to and including Trixbox 2.6)

1) Copy and paste the commands below into your SSH window and this will automatically get the required packages.

yum -y install kernel-devel-$(uname -r);
yum -y install libtool;
yum -y install gcc;
yum -y install patch;
yum -y install perl;
yum -y install bison;
yum -y install gcc-c++;
yum -y install ncurses;
yum -y install ncurses-devel;
yum -y install flex;
yum -y install libtermcap-devel;
yum -y install lksctp-tools-devel ;
rpm -qa | grep zaptel

2) Then you should see the following output on the screen.Now the Zaptel version is 1.4.12.1 in the following example, it is not 1.4.12.1-1 because the "-1" is a Trixbox version and we are just considered about the Zaptel version.

zaptel-1.4.12.1-1_trixbox
zaptel-modules-1.4.12.1-1_trixbox.2.6.18_128.1.10.el5

3) Once we have the Zaptel version go to http://downloads.asterisk.org/pub/telephony/zaptel/releases/ and look for the version from the previous step. So in this case the file would be called zaptel-1.4.12.1.tar.gz. So to download this file simply run the commands below.

  •     cd /usr/src/
  •     wget http://downloads.asterisk.org/pub/telephony/zaptel/releases/zaptel-1.4.12.1.tar.gz    *NOTE: Change this for your Zaptel Version

4) Next untar and install zaptel using the commands below.

  • tar xvfz zaptel-<version>.tar.gz
  • cd zaptel-<version>
  • ./configure
  • make
  • make install
  • make config

5) Download the Wanpipe Voicetime Driver
Untar and change directory

-> tar xfz wanpipe-voicetime-<ver>.tgz

-> cd wanpipe-voicetime-<ver>

7) Build Wanpipe VoiceTime for Currently Running Zaptel Module

-> make ZAPDIR=/usr/src/zaptel-<version>

ZAPDIR= location of zaptel source used to build and install zaptel
By default ZAPDIR=/usr/src/zaptel  

8) Install VoiceTime module into current system

-> make install  

9) Install bootup startup script for VoiceTime

-> make boot

The wanpipe_voicetime uses /etc/init.d/zaptel script. The zaptel startup script must be installed
eg: cd /usr/src/zaptel-<version>
      make        #build zaptel
      make install    #install zaptel modules
      make config        #install zaptel boot script    

10) Start Wanpipe VoiceTime using Zaptel Startup Script

-> /etc/init.d/zaptel start  

11) Confirm that VoiceTime Sync Tool is working

-> zttest

b) Dahdi Method (Trixbox 2.8 and greater)

1) Copy and paste the commands below into your SSH window and this will automatically get the required packages.

yum -y install kernel-devel-$(uname -r);
yum -y install libtool;
yum -y install gcc;
yum -y install patch;
yum -y install perl;
yum -y install bison;
yum -y install gcc-c++;
yum -y install ncurses;
yum -y install ncurses-devel;
yum -y install flex;
yum -y install libtermcap-devel;
yum -y install lksctp-tools-devel ;
rpm -qa | grep dahdi

2) Then you should see the following output on the screen.Now the Dahdi-Linux version is 2.2.0 in the following example, it is not 2.2.0-4 because the "-4" is a Trixbox version and we are just considered about the Dahdi-Linux version. Also as you can see the dahdi-tools version is 2.2.0 as well.

dahdi-tools-doc-2.2.0-4_trixbox
dahdi-tools-2.2.0-4_trixbox
asterisk16-dahdi-1.6.0.10-1_trixbox
dahdi-linux-2.2.0-4_trixbox
kmod-dahdi-linux-2.2.0-4_trixbox.2.6.18_128.1.10.el5

3) Once we have the Dahdi-Linux version go to http://downloads.asterisk.org/pub/telephony/dahdi-linux/releases/ and look for the version from the previous step. So in this case the file would be called dahdi-linux-2.2.0.tar.gz. Now for the Dahdi-Tools you can get this from http://downloads.asterisk.org/pub/telephony/dahdi-tools/releases/, so for Dahdi-Tools 2.2.0 go to http://downloads.asterisk.org/pub/telephony/dahdi-tools/releases/dahdi-tools-2.2.0.tar.gz. So to download this file simply run the commands below.

  •     cd /usr/src/
  •     wget http://downloads.asterisk.org/pub/telephony/dahdi-linux/releases/dahdi-linux-2.2.0.tar.gz    *NOTE: Change this for your Dahdi-Linux Version
  •     wget http://downloads.asterisk.org/pub/telephony/dahdi-tools/releases/dahdi-tools-2.2.0.tar.gz   *NOTE: Change this for your Dahdi-Tools  Version

4) Next untar and install Dahdi using the commands below.

  • tar xvfz dahdi-linux-<version>.tar.gz
  • tar xvfz dahdi-tools-<version>.tar.gz
  • cd dahdi-linux-<version>
  • make
  • make install
  • cd ../dahdi-tools-<version>
  • ./configure
  • make
  • make install
  • make config

5) Download the Wanpipe Voicetime Driver
Untar and change directory

-> tar xfz wanpipe-voicetime-<ver>.tgz
-> cd wanpipe-voicetime-<ver>  

6) Build Wanpipe VoiceTime for Currently Running Dahdi Module

-> make DAHDI_DIR=/usr/src/dahdi-linux-<version>

  DAHDI_DIR= location of dahdi source used to build and install dahdi module
                By default DAHDI_DIR=/usr/src/dahdi

        Note: Make file will cache the DAHDI path so next time
              one can recompile using just make.

7) Install VoiceTime module into current system

-> make install  

8) Install bootup startup script for VoiceTime

-> make boot

9) Start Wanpipe VoiceTime using Zaptel Startup Script

-> /etc/init.d/dahdi start  

10) Confirm that VoiceTime Sync Tool is working

-> dahdi_test

Debugging

1) First you should check is that the USB device is being detected by the PC, so you should see the following lines in the /var/log/messages when the device is unplugged and plugged in.

Unplugging will show something similar to the following:

Oct  6 22:57:30 localhost kernel: usb 4-2: USB disconnect, address 4

Plugging in the device will show something similar to the following:

Oct  6 22:57:34 localhost kernel: usb 4-2: new full speed USB device using uhci_hcd and address 5
Oct  6 22:57:35 localhost kernel: usb 4-2: configuration #1 chosen from 1 choice

If this does not show up then run the command  "lspci | grep USB" and it will show something similar to the following.  This indicates that your USB controller on the motherboard is enabled and recognized by your kernel.  If you do not see any devices start by confirming that you have enabled the USB boards in your BIOS

00:1a.0 USB Controller: Intel Corporation 82801I (ICH9 Family) USB UHCI Controller #4 (rev 02)
00:1a.1 USB Controller: Intel Corporation 82801I (ICH9 Family) USB UHCI Controller #5 (rev 02)
00:1a.2 USB Controller: Intel Corporation 82801I (ICH9 Family) USB UHCI Controller #6 (rev 02)
00:1a.7 USB Controller: Intel Corporation 82801I (ICH9 Family) USB2 EHCI Controller #2 (rev 02)
00:1d.0 USB Controller: Intel Corporation 82801I (ICH9 Family) USB UHCI Controller #1 (rev 02)
00:1d.1 USB Controller: Intel Corporation 82801I (ICH9 Family) USB UHCI Controller #2 (rev 02)
00:1d.2 USB Controller: Intel Corporation 82801I (ICH9 Family) USB UHCI Controller #3 (rev 02)
00:1d.7 USB Controller: Intel Corporation 82801I (ICH9 Family) USB2 EHCI Controller #1 (rev 02)

2) Second, you should be able to run "cat /proc/zaptel/1" after running " /etc/init.d/zaptel start" and see the voice time device loaded, below is a sample output.
     In case of Dahdi, use "cat /proc/dahdi/1" after running "/etc/init.d/dahdi start".

Span 1: WANVTIME/1 "WANVTIME/1 (source: wanpipe_voicetime) 1" (MASTER)

If you do not see this output then please check your /var/log/messages and insure you see the following 3 lines:

Oct  6 23:15:58 localhost kernel: wanpipe_voicetime: Loading WANPIPE USB Voice Sync Timer Driver - v1.0.3
Oct  6 23:15:58 localhost kernel: wanpipe_voicetime: Probing WANPIPE USB Voice Sync Timer Driver on 5...
Oct  6 23:15:58 localhost kernel: usbcore: registered new driver wanpipe_voicetime

3) Once everything is showing up then run "asterisk -r" and then run the command "zap show status" (In case of dahdi use "dahdi show status") and this should be the same as the output below

zap show status
Description                              Alarms     IRQ        bpviol     CRC4
WANVTIME/1 (source: wanpipe_voicetime)   UNCONFIGUR 0          0          0

4) To test that the device is working properly run the Zaptel utility "zttest". In case of Dahdi use "dahdi_test"