readme.vpb

multi-line Adjunct Communication Server

README for ACS vpb subdirectory
David Rowe 31/10/99

This directory contains a VPB4 port of the ACS program umd.

Notes:
------

1. The library libvpb.a was built using the vpb1.5.zip software.
2. This version of umd only supports wave files, the .au files
   in ../aaprompts have been converted to .wav versions to support
   this.
3. The wait ACS script function currently acts like the sleep function.
4. vpb.o is the device driver for VPB.
5. vpbmain.out is the firmware for the VPB4.
6. This version is hard coded for 1 line (easy to change).
7. This version has call progress tones hard coded for a Nortel Studio 308
   PBX, use the tone detector vpbapi functions to change this.  This
   only affects hangup detection at this stage.
8. Not all of the script functions have been converted, but the playrec
   script works OK.
9. The vpb library is configured to throw exceptions if something goes
   wrong (eg file not found during play).  This makes the code fairly
   brittle, but takes you straight to the problem.  The error handling
   needs to be improved to make things a little more robust, this could
   be done by trapping the exceptions, or using another error mode
   (see vpb windows help file), eg returning an error number rather than
   throwing an exception.

Installation and Running
------------------------

1. Use make in this directory to create the umd executable.
2. Install the vpb device driver (which can also be built from vpb1.5):
	insmod vpb.o
3. Copy the firmare vpbmain.out to /etc/vpb.  This path (and a whole lot
   of other configuration data for the VPB) is hard coded in vpbregLinux.cpp,
   part of vpb1.5.  You need to recompile libvpb.a if you wish to change
   this (base address stored there too, this version uses base of 0x310).
4. start umd with the demo script:
	./umd -t playrec

Differences between acs-0_3_2_tar.gz & this version
---------------------------------------------------

1. Entire vpb directory
2. *.wav in aaprompts