ohphone.1

openh323_1.1.2.2.zip； 2. 把pwlib_1.52.zip 、openh323_1.1.2.2.zip分别展开到目录e:h323sourcepwlib及e:h323sourc

Set the record volume when a sound card is used. This overrides the value of \-\-recvol (if set). The volume is an integer value from 0 through 100

.TP
\fB\-\-stun\fR \fIstun_server\fR
Set to use the specified STUN server.  STUN (Simple Traversal of UDP Through NAT) is a protocol that allows a mahine behind NAT to figure out the public IP address and port number of a UDP socket, by querying a STUN server running on the Internet. ohohone then uses this public IP address and port number for H.323 signaling.  If you are behind a NAT or firewall, and know the IP address of a STUN server, to get ohphone to work you do not need to set up port forwarding or put your machine in DMZ, ohphone will utilize the STUN server to use the correct IP address and port numbers for signaling.  For example, typing `ohphone -n --stun stun.somewhere.com friend.otherplace.com' starts ohphone to call the machine friend.otherplace.com and uses the STUN server at stun.somewhere.com.

.TP
\fB\-t\fR, \fB\-\-trace\fR 
Enable debug tracing, which displays messages at run\-time to assist in debugging or problem identification.
Specifying this option multiple time increases the amount of information displayed. 
.B ohphone 
has trace statements up to level 5. Use the \fB\-o\fR option to write the
trace information to a file rather than to stderr.

.TP
\fB\-\-tos\fR \fIvalue\fR          
Set the Type Of Service in outgoing RTP packets to the specified value.

.TP
\fB\-u\fR, \fB\-\-user\fR \fIname\fR          
Set local endpoint alias name. Can be used multiple times to add multiple aliases.
By default, the alias list contains a single entry with the current user's login name.

.TP
\fB\-v\fR, \fB\-\-verbose\fR \fIn\fR
Set amount of information displayed (0=none).

.TP
\fB\-\-videotxdevice\fR \fIdev\fR
Select video capture device to be used for capturing (transmitting) video. The default device will depend on
the driver selected using \-\-videotransmit

.TP
\fB\-\-videorxdevice\fR \fIdev\fR
Select video capture device to be used for displaying (receiving) video. The default device will depend on
the driver selected using \-\-videoreceive

\fB\-\-videofill\fR \fIn\fR
Set the number of updated background blocks per frame to \fIn\fR, default is
2. \fIn\fR has to be between 2 and 99.

.TP
\fB\-\-videoformat\fR \fIformat\fR    
Set the video capture format. \fIformat\fR must be the string \fIpal\fR (default) or \fIntsc\fR

.TP
\fB\-\-videolocal\fR
Enable display of the local video input. If \-\-videopip is specified, this will be displayed as subwindow
inside the received video window.

.TP
\fB\-\-videoinput\fR \fIinput\fR    
Set input port used for video. The default value is 0 - the maximum value is determined by the video device

.TP
\fB\-\-videopip\fR
Enable picture in picture for local video window and received video window

.TP
\fB\-\-videoquality\fR \fIquality\fR    
Set the video qualty requested from the remote endpoint. \fIquality\fR must be in the range 0 to  31.

.TP
\fB\-\-videoreceive\fR \fIdevice\fR    
Enable reception of video data in H.261 format.
The \fIdevice\fR specifies the device to be used to display the received video information. 
Permitted values of \fIdevice\fR are:
.RS
.TP
null
do nothing (useful for debugging)
.TP
ppm
Create a numbered sequence of PPM files
.TP
svga256
Write directly to the console in 256 colour VGA mode (Linux only)
.TP
svga
Write directly to the console in full-colour VGA mode (Linux only)
.TP
x11
Write received data to an X11 window usng shared memory extensions.
Can also specify x1124, x1116 or X118 to force visual depth.
Add an 's' to the device to specify shared memory (i.e. x1124s).
.RE

.TP
\fB\-\-videosize\fR \fIsize\fR    
Set the size of the transmitted video signal. \fIsize\fR must be the string \fIsmall\fR (default) or \fIlarge\fR

.TP
\fB\-\-videotransmit\fR \fIdriver\fR
Enable tranmission of video using the specified driver package. The available drivers
is determined by the plugins available on the host system, but the following should
always be avaiable:
.RS
.TP
YUVFile
Read video from a file containing multiple YUV frames. The \-\-videochannel option changes the 
behaviour at end of file as follows: 0 = close device at end of file, 1 = repeat file, 2 = repeat last frame, 3 = display black
.TP
FakeVideo
Generate various test patterns. The \-\-videochannel option determines which patter is generated, as follows:
0 = moving blocks, 1 = moving line, 2 = bouncing boxes, 3 = blank image, 4 = alternate moving blocks, 5 = display text, 6 = display standard colour bars
.RE

.TP
\fB\-\-videotxfps\fR \fIn\fR
Set maximum number of transmited video frames per seceond to \fIn\fR,
default is 10. \fIn\fR has to be between 2 and 30.

.TP
\fB\-\-videotxquality\fR \fIn\fR
Select sent video quality, defaults to 9. 1(good)<=n<=31

.SH CONFIGURATION FILE
.PP
.B ohphone 
options and speed dials can be set in the ohphone configuration file
.B ~/.pwlib_config/ohphone.ini .
This config file is divided into sections, with each section indentified by a header enclosed in square brackets.
Options must be located in the section prefixed with [Options], whilst speed dials must be located in the section prefixed [Speedial].
The long form of any command line option specified above can be specified in the configuration file, in the format:
.TP
\fIoption\fR = \fIvalue\fR

.SH SPEED DIALS
.PP
.B ohphone
can be configured to dial an IP address upon entering a speed dial code
conisisting of an integer followed by the hash (#) character. Speed dial codes
are available via the menu "C" command (see the
.B MENU
section) or via the phone handset (if a Quicknet card is used).
.B ohphone
Speed dials are configured using the menu "D" command, or can be added directly to the [SpeedDials] section of the configuration file (see below).

Speed dials can also contain wild card characters which allow groups of numbers to be assigned to specific gateways. The following examples show the use of wild cards:

.TP
7??  @192.168.5.3
Dial three digit numbers starting with 7 through the gateway at 192.168.5.3

.TP
9*   %192.168.7.1
Dial any number starting with 9 through the gateway at 192.168.6.3, but strip the leading 9 before dialling.

The following special speed dials can also be used:
.TP
#
Redial the previously dialled number

.TP
*#
Dial the previous caller

.SH DIALLING IP NUMBERS USING A HANDSET
An IP number can be dialled using a phone handset connected to a Quicknet card.
This is done by pushing the star (*) button, and then entering the IP number using the star (*) button to seperate each of the four parts of the IP address, and then pressing the (#) button.
For example, the sequence below can be used to dial the IP address 192.168.64.5:
.RS
*192*168*64*5#
.RE

.SH INTERNAL MENU
.PP
.B ohphone
allows the user to perform various operations whilst listening for an
incoming connection, or whilst a call is in progress. These operations are
accessed via single line commands which each start with a single character
identifying the function. The available commands are:
.TP
\fBQ\fR or \fBX\fR
Hangup any active calls and exit the program.
.TP
\fBH\fR
Hangup any active calls.
.TP
\fBC\fR \fIaddress\fR [\fIgateway\fR]
Initiate a call to the specified host or IP address. If the optional getway paramater is used, then the specified gateway will be used to make the call. If the address ends with the hash (#) character, it is assumed to be a Speed Dial code.
.TP
\fBL\fR
List all current speed dial codes
.TP
\fBD\fR \fIcode\fR \fIaddress\fR
Create a new speed dial for \fIaddress\fR using \fIcode\fR.
.TP
\fBS\fR
Print statistics of the call in progress.
.TP
\fBP\fR
Toggle between speakerphone and normal mode
.TP
\fBA\fR
Turn AEC up by one level (Quicknet cards only)
.TP
\fBa\fR
Turn AEC down by one level (Quicknet cards only)
.TP
\fB[\fR
Turn play volume up by one level.
.TP
\fB]\fR
Turn play volume down by one level.
.TP
\fB}\fR
Turn record volume up by one level.
.TP
\fB{\fR
Turn record volume down by one level.
.TP
\fBV\fR
Display current volume settings
.TP
\fBE\fR
Toggle silence supression
.TP
\fBI\fR
Show last 16 calls made
.TP
\fBi\fR
Show last 16 calls received

.SH EXAMPLES
.PP

.TP
ohphone -l
Find a gatekeeper on the local network, register with it, and then listen for incoming calls.

.TP
ohphone -ln
Listen for calls without registering with a gatekeeper.

.TP
ohphone -ln -q0 --callerid
Listen for calls without registering with a gatekeeper, using /dev/phone0 (a Quicknet card) as the sound device, and enabling transmission of caller ID to the handset on incoming calls.

.TP
ohphone -n \fIipaddress\fR
Make a call directly to another endpoint without a gatekeeper

.SH FILES
.PP
~/.pwlib_config/ohphone.ini

.SH USING MICRO TELCO WITH OHPHONE
.PP
Use of microtelco only happens if you have a valid microtelco account and
a quicknet card installed on your computer. 
Add to the command line the following four entitites.
  
.PP 
  -u microtelco_account_number

.PP
   --password microtelco_pin_number

.PP
  -g gk.microtelco.com

.PP 
 Specify a quicknet card, say, -q0, to get /dev/phone0. 

.SH BUGS
.PP
Picking up a handset after initiating a call using the menu C comment sometimes produces odd results

.PP
Quicknet cards seem to change playback volume when calls are started - sometimes!

.SH "SEE ALSO"
None