readme.src

控制语音Modem的程序

.ti -2i
get_msgs_mnu.msg\	Press 4 to rewind, 6 to forward, 9 to delete
message, # to stop.
.ti -2i
greeting.msg\	This is the (phone #), leave a message after
the beep.
.ti -2i
msg_deleted.msg\	Message deleted.
.ti -2i
passwd_ch.msg\	Password changed successfully.
.ti -2i
passwd_not_ch.msg\	Password not changed.
.ti -2i
remote_menu.msg\	Press 1 to listen the messages, 2 to listen
the greeting, 3 to change it and 4 to change
the password.
.ti -2i
wrong_passwd.msg\	Wrong password.
.in 0i
.sp
.sp
.LINE
RUNNING ans
.br
.LINE
.ta 0.5i
You can start ans from the command line, log messages are
displayed to the screen. You can redirect standard output
and standard error messages to a file and put the process
running in the background with the command:
.sp
	ans >> /var/log/ans 2>&1 &
.sp
If you want init to start ans every time the system is booted,
add a line to /etc/inittab like this:
.sp
	d1:12456:respawn:/usr/local/bin/ans >> /var/log/ans 2>&1
.sp
This instructs init to start ans whenever it enters runlevels
1, 2, 4, 5 or 6. Default runlevel is 5 on my system.
The "respawn" keyword means that if ans is terminated (after a
call is answered, due an error, because you killed it),
init restarts the script again. The label "d1" identify the line
in the file, so it must be different from the existing ones.
You can choose two characters you prefere.
See init(8) and inittab(5) man pages.
.br
Once ans is running, you can issue the following commands (see
ans man page for more details):
.sp
.ta 0.5i 2i
.in +2i
.ti -2i
	ans\ play\	play received messages
.ti -2i
	ans\ delete\	delete received messages
.ti -2i
	ans\ now\	force the running ans process to answer a call
immediately
.ti -2i
	ans\ stop\	prevent the running ans process from
answering the phone
.ti -2i
	ans\ start\	resume the running ans process answering
the phone
.in 0i
.sp
To terminate a running ans process you must:
.ta 0.3i
.in +0.3i
.ti -0.3i
-	issue an "ans stop" command: it creates a stop file and kills
the vmcp process which is waiting for the RING,
.ti -0.3i
-	kill the running ans process,
.ti -0.3i
-	issue an "ans start" command to remove the stop file.
.in 0i
If ans is respawned by init you must first change inittab and
restart init, of course!
.sp
If you want to use the vplay or vrec scripts while ans is
waiting for a call, you must first release the ttySn device
with the "ans stop" command.
.br
Remember that if you issued an "ans stop" command, a stop file
is created and ans will never answer a call again untill you
issue an "ans start" command. The stop file remains even if you
kill and restart the ans process.
.sp
.sp
.LINE
RECEIVING FAXES AND REMOTE LOGIN
.br
.LINE
Ans is able to discriminate incoming faxes or data calls, but it
relies on auxiliary programs to handle them.
.br 
To receive incoming faxes you must have /usr/bin/efax installed
(I use version 0.7a of efax avaliable from Sunsite, see Credits
section), check the command line that starts efax in the
fax_call() function of the ans script.
.br
To handle incoming data calls (remote logins) I use agetty. It is
standard on my Linux box (Slackware).
See data_call() function in the ans script for the command that
starts agetty.
.br
After the user has logged in, he/she can also switch the line to
SLIP or PPP.
.sp
.sp
.LINE
OUTPUT SAMPLES
.br
.LINE
.sp
.nf
Message record/playback with vrec/vplay
---------------------------------------
.ta 3i
prompt# vrec greeting.msg

Resetting the serial line	(3 seconds pause)
Sending AT&F1 0x0d
Exit code 0
Sending AT#CLS=8 0x0d
Exit code 0
Sending AT#VBS=4 0x0d
Exit code 0
Sending ATS30=60 0x0d
Exit code 0
Sending AT#BDR=16 0x0d
Exit code 0
Sending AT#VSP=20 0x0d
Exit code 0
Sending AT#VSS=2 0x0d
Exit code 0
Sending AT#VSD=1 0x0d
Exit code 0
Sending AT#VLS=2 0x0d
Exit code 0
Sending AT#VBT=5#VTS=# 0x0d	(Play a beep from the speaker)
Exit code 0
Sending AT#VLS=3 0x0d
Exit code 0
Sending AT#VRX 0x0d	(Start talking in the microphone)
Exit code 1	(Exit on silence or ESC keypress)
Sending  0x0a
Exit code 0
Sending ATH 0x0d
Exit code 0

prompt# vplay greeting.msg

Resetting the serial line	(3 seconds pause)
Sending AT&F1 0x0d
Exit code 0
Sending AT#CLS=8 0x0d
Exit code 0
Sending AT#VBS=4 0x0d
Exit code 0
Sending AT#BDR=16 0x0d
Exit code 0
Sending AT#VSD=1 0x0d
Exit code 0
Sending AT#VLS=2 0x0d
Exit code 0
Sending AT#VTX 0x0d
Exit code 0
Playing greeting.msg...	(Start playing through the speaker)
Exit code 0
Sending  0x10 0x03
Exit code 0
Sending ATH 0x0d
Exit code 0

prompt#
.fi
.sp
.sp
.LINE
CREDITS
.br
.LINE
.in 0.5i
.ti -0.5i
Wolfgang Henke <[e-mail]>
.br
He made available an invaluable guide to voice commands
for Rockwell chipset modem.
.br
ftp://ftp.whnet.com/rockwell/voice.commands
.br
See also http://www.nb.rockwell.com/ref/reference.html (?)
.sp
.ti -0.5i
Kenneth J. Hendrickson <[e-mail], [e-mail]>
.br
For its modem-stats 0.9, a simple program to send
commands to a modem. It was the starting point
for this work.
.br
ftp://sunsite.unc.edu/pub/Linux/apps/comm/modem-stats.tar.gz (?)
.sp
.ti -0.5i
Daniel Chouinard <[e-mail]>
.br
For its dcon 0.9, a scripting language interpreter for
establishing communications on serial lines.
Here I found some hints for programming the modem device.
.br
ftp://sunsite.unc.edu/pub/Linux/system/serial/dcon0.91.tgz
.sp
.ti -0.5i
Vernon C. Hoxie <[e-mail]>
.br
For detailed information about termios and serial
device locking. Many hints are included in his
.br
ftp://scicom.alphacdc.com/pub/linux/serial_suite.tgz
.sp
.ti -0.5i
Ed Casas <[e-mail]>
.br
For efax version 0.7a, a program to send and receive faxes
using any Class 1 or Class 2 fax modem. I use his program
to handle incoming faxes and I found many hints in his code.
.br
ftp://sunsite.unc.edu/pub/Linux/apps/serialcomm/fax/efax08a.tar.gz
.sp
.ti -0.5i
Daniel Quinlan <[e-mail]>
.br
For version 1.2 of the Linux Filesystem Structure (FSSTND).
It is - AFAIK - the unique attempt to define a standard for
directories structure and files location for a Linux system.
.br
ftp://sunsite.unc.edu/pub/Linux/docs/fsstnd/
.sp
.ti -0.5i
U.S. Robotics PCD Applications Engineering
.br
For the Technical Reference page they made available on the Internet.
.br
http://ae.pcd.usr.com/
.sp
.ti -0.5i
Robert de Bath <[e-mail]>
.br
For contributing many ideas and code, enhancing vmcp. He is developing
a more enhanced version of vmcp, with many new options. Check his web
page at http://www.cix.co.uk/~mayday. 
.in 0i
.sp
.sp
.LINE
HISTORY
.br
.LINE
.in 0.5i
.ti -0.5i
14 Jul 1999: voice-0.6.1.tar.gz
.br
Vmcp: fixed some things causing compiling trouble or warning:
termios.h included file is in linux subdir,
main function is int not void.
.sp
.in 0.5i
.ti -0.5i
8 Sep 1997: voice-0.6.tar.gz
.br
Vmcp: fixed a bug causing an ioctl(2) error when vmcp was run from inittab or
in the background (thanks to Robert Hawkins <[e-mail]>).
Added -W option to work with US-Robotics modems. Added -z option to use
only one program to do everything, eliminating linres. Added escaped chars
conversion on -c,
-w and -W strings (thanks to Robert de Bath <[e-mail]>).
.sp
.in 0.5i
.ti -0.5i
4 Jan 1997: voice-0.5.tar.gz
.br
Option "now" added to the ans script: it forces a running ans process
to answer a call immediately.
.sp
.in 0.5i
.ti -0.5i
23 Oct 1996: voice-0.4.tar.gz
.br
Bug fixed for modems that do not assert CD during voice operation.
Some improvement to the ans script.
.sp
.ti -0.5i
31 Aug 1996: voice-0.3.tar.gz
.br
First public release.