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
   
4. Debugging

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.

Download Drivers

You will need to download the latest Wanpipe VoiceTime Driver
-> wanpipe-voicetime-1.0.3.tgz  (2008-09-30)   

-> ChangeLog 

 

Installation Instructions

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
   -> wanpipe-voicetime-1.0.3.tgz    
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

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.

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" 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".