.\" Process this file with man -l ./README.src > README.\".de LINE-----------------------------------------------------------------.br...\".\".LINEDESCRIPTION.br.LINE.ta 1.5i 2.5i.in +1.5i.ti -1.5ivoice	Suite of programs to drive voice modems, itincludes a full-featured answering machine.Ready to go for Rockwell voice commands.Developed and tested under Linux, free software distributedunder GNU General Public License..sp.ti -1.5iVersion:	0.6.1		Jul 14 1999.sp.ti -1.5iAuthor:	Niccolo Rigacci <fd131@cleveland.freenet.edu>.in 0i.sp.sp.LINEQUICK INTRODUCTION.br.LINEI think that the simplest way to drive a modem is through a shellscript and a simple program like "chat" that allow interactionof the type: "send string" - "wait string"..brFor voice operation we must add some functionalities becauseit is not possible to give a stream of digitized voice onthe command line and we must capture the incoming voice toa file too..brBeside that we have to handle the "escaped chars" that themodem embed in the voice stream when we receive voice (tosignal silence, DTMF tones, etc.), and those we send to themodem when we send voice..brVoice Modem Control Porgram (vmcp) addresses all the problems:.sp - send to the modem a string specified on the command line - send to the modem a binary file - capture data from the modem to a file, stripping escaped chars - capture escaped chars from the modem to a second file - exit on receiving a string from the modem - exit on receiving a given escaped char from the modem - exit on timeout or keypress.spAll these functions can be enabled or disabled, see vmcp.8 manpage for command line options (you can read a man page withoutinstalling it with the command "man -l ./vmcp.8")..brIf you want fully understand how a voice modem works, read theRockwell voice commands guide, or the US-Robotics one.Relative URLs are in the Credits section below..brAs a working example of how vmcp can be used, you can find ans,a bash script that emulates a full-featured answering machine.It includes discrimination of incoming voice, fax or data calls,remote password protected retrieving of messages, changing ofpassword and greeting message..brAny feedback on this work will be greatly appreciated; send notes,suggestions and bug reports directly to the author..sp.sp.LINEWHAT YOU HAVE (ARCHIVE CONTENTS).br.LINE.ta 1.5iCOPYING		GNU General Public License.brMakefile	Script for compiling and installing everything.brREADME	This file.brREADME.src	Source file for README.brVOICE_FAQ	Answers to some frequently asked questions.brans	Bash script to emulate an answering machine.brans.8	Man page for ans.brpasswd	Contains the secret code for ans remote access.brvmcp.8	Man page for vmcp.brvmcp.c	Source code of the communication utility.brvoice.lsm	Linux Software Map entry for this package.brvplay	Bash script to play voice files.brvrec	Bash script to record a voice file.br.sp.sp.LINEWHAT YOU NEED.br.LINE.in +0.3i.ti -0.3i.ta 0.3i-	A voice modem. The scripts "ans", "vplay" and "vrec" are customizedto work with Rockwell voice commands, they should work with US-Roboticsmodems and many others. I think however you can edit them andadapt to any voice modem..ti -0.3i-	You must know which serial line your modem is connected toand you must have read-write rights on this device. Thescripts are ready for a modem on the first serial line(/dev/ttyS0), but you can easily edit them..ti -0.3i-	The modem must have a full-wired serial cable because programsuse RTS, CTS, DTR and CD signals to work properly. No problemswith internal modems..ti -0.3i-	If you want to handle incoming faxes, you must get a fax program,I suggest efax (see Credits section); the ans script is alreadyconfigured for it..ti -0.3i-	You must to know a little about how modems work: some ATcommands, etc..ti -0.3i-	You must be able to edit bash scripts :-)..in 0i.sp.sp.LINEGETTING NEW VERSIONS.br.LINEMy home page is at.brhttp://www.apsoftware.it/~niccolo/.brSorry but this is in Italian. If you want you can go directlyto the directory.brhttp://www.apsoftware.it/~niccolo/comp/software/voice/.brHere you can also find voicecmd.zip, a complete guideto voice commands for Rockwell modems (MS-Word 6 format)..brI also submitted version 0.6.1 to sunsite.unc.edu on 14 July 1999,look in the directory.br/pub/Linux/apps/serialcomm/modem or.br/pub/Linux/Incoming..br.sp.sp.LINECOMPILING AND INSTALLING FILES.br.LINE.ta 0.5iTo compile vmcp.c simply switch to the directorywhere you unpacked the archive and issue the command:.sp	make.spHopefully no editing to the source is needed. To create the requireddirectories and to copy the files in their subdirectories withappropriate rights, you must be root and execute:.sp	make install.spIf you want to know what directories are needed and to previewwhere files are scattered across your system, have a look at theMakefile. It is quite simple. You can also use the -n switch ofmake to have a preview of install operations.Directories structure, name and location of files are File SystemStandard compliant (see Linux Filesystem Structure, Release 1.2)..brThe installing procedure checks for the presence of many binary fileson which the ans script relies: if one of them is not found theinstallation fails..sp.sp.LINEQUICK TEST.br.LINEEdit vrec and vplay scripts adjusting the "TTYS=ttySn" to reflectyour modem's serial line. Also adjust the $VMCP path if needed.If you are unable to understand these scripts go away,read the man bash and come back within a week :-).sp.ta 2i.in +2i.ti -2ivrec\ testfile\	Start recording to a file. Speak throughthe microphone connected to the modem afterthe beep and stop the recording pressingthe ESC key..sp.ti -2ivplay\ testfile\	Playback the message through the modemspeaker..in 0i.spIf this does not work, don't go any further! You must take yourmodem manual and check every command sent to the modem via thevrec script. In the Output Samples section below you find theoutput you should get from the above test.Exit status should help to understand what is not working (seevmcp man page for an exit status table)..sp.sp.LINESCRIPTS CUSTOMIZATION.br.LINEThree files (ans, vplay and vrec) are bash scripts and may needsome editing to reflect your system peculiarities.Hopefully no changes are needed if you follow FSSTNDdirectives and you are using a Rockwell compatible voice modem on /dev/ttyS0.Check the begin of the three files for user configurable items.All the scripts are configured to use the modem on the firstserial line (ttyS0), change the "TTYS=ttyS0" statement if yourmodem is on a different device..brThe ans script need a bit more attention. It relies on manybinaries which should to be standard on every Unix-like system,check yours for the presence and location of such binaries(listed at the begin of the script too)..brAns script also relies on efax program, not included in thisarchive. Efax is called when an incoming fax is detected.If you want incoming faxes handling, you must get efax runningand then you *MUST* check the line beginning with $EFAX inthe ans script and edit it (at least to remove my phone numberas the fax ID!)..brYou see also many modem commands in the scripts, they all workswell on my internal modem (UMC chipset). Hopefully again noediting needed for Rockwell chipset based modems. If you haveanother modem you must find equivalent commands, see Creditssection for a pointer to Rockwell voice modems commands list..sp.sp.LINEABOUT THE SERIAL PORT.br.LINEOn Linux systems, serial ports are addressed via /dev/ttyS*devices. Old /dev/cua* are obsolete and should not be usedanymore. Most systems make a symlink /dev/modem pointing tothe ttyS, purists don't like it.See Linux Serial HOWTO for some hints..brDevice rights are not a problem, because I run all the scriptsas root. By the way this is my configuration:.sp.nfcrw-rw----   1 root    dialout  4,  64 Aug 22 10:35 /dev/ttyS0crw-rw----   1 root    dialout  4,  65 Aug 22 10:35 /dev/ttyS1 ....fi.sp.sp.LINERECORDING DEFAULT MESSAGES.br.LINE.ta 0.5iBefore using the ans script you *MUST* record some messages. Youcan use the script vrec with a command like:.sp	vrec greeting.msg.spThe messages must go in the appropriate directory.I think the best choice is/usr/local/lib/ans, see the LIBDIR setting in the ans script.Those are the messages needed and their contents. Append to the namethe extension ".msg" (as declared in the ans script)..sp.ta 2i.in +2i.ti -2iask_passwd.msg\	Please enter your password and terminateit with #..ti -2ich_greeting.msg\	Record the new greeting after the beep, press# to confirm, 9 to cancel.