ohphone.man

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

	      the  value  of --recvol (if set). The volume is an integer value
	      from 0 through 100


       --stun stun_server
	      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. oho-
	      hone 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.


       -t, --trace
	      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  dis-
	      played.	ohphone has trace statements up to level 5. Use the -o
	      option to write the trace information to a file rather  than  to
	      stderr.


       --tos value
	      Set the Type Of Service in outgoing RTP packets to the specified
	      value.


       -u, --user name
	      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.


       -v, --verbose n
	      Set amount of information displayed (0=none).


       --videotxdevice dev
	      Select video capture device to be used for capturing  (transmit-
	      ting)  video.  The  default  device  will	 depend	 on the driver
	      selected using --videotransmit


       --videorxdevice dev
	      Select video capture device to be used for  displaying  (receiv-
	      ing)  video.  The	 default  device  will	depend	on  the driver
	      selected using --videoreceive

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


       --videoformat format
	      Set  the	video  capture	format.	 format must be the string pal
	      (default) or ntsc


       --videolocal
	      Enable display of the local video input. If --videopip is speci-
	      fied,  this  will	 be displayed as subwindow inside the received
	      video window.


       --videoinput input
	      Set input port used for video. The default value is 0 - the max-
	      imum value is determined by the video device


       --videopip
	      Enable  picture  in  picture for local video window and received
	      video window


       --videoquality quality
	      Set the video qualty requested from the remote endpoint. quality
	      must be in the range 0 to	 31.


       --videoreceive device
	      Enable  reception	 of  video  data  in H.261 format.  The device
	      specifies the device to be used to display  the  received	 video
	      information.  Permitted values of device are:

	      null   do nothing (useful for debugging)

	      ppm    Create a numbered sequence of PPM files

	      svga256
		     Write  directly  to  the  console	in 256 colour VGA mode
		     (Linux only)

	      svga   Write directly to the console  in	full-colour  VGA  mode
		     (Linux only)

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


       --videosize size
	      Set the size of the transmitted video signal. size must  be  the
	      string small (default) or large


       --videotransmit driver
	      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:

	      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

	      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


       --videotxfps n
	      Set maximum number of transmited video frames per seceond to  n,
	      default is 10. n has to be between 2 and 30.


       --videotxquality n
	      Select sent video quality, defaults to 9. 1(good)<=n<=31


CONFIGURATION FILE
       ohphone options and speed dials can be set in the ohphone configuration
       file ~/.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:

       option = value


SPEED DIALS
       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 MENU
       section) or via the  phone  handset  (if	 a  Quicknet  card  is	used).
       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:


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


       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:

       #      Redial the previously dialled number


       *#     Dial the previous caller


DIALLING IP NUMBERS USING A HANDSET
       An IP number can be dialled using a phone handset connected to a Quick-
       net card.  This is done by pushing the star (*) button, and then enter-
       ing  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:
	      *192*168*64*5#


INTERNAL MENU
       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:

       Q or X Hangup any active calls and exit the program.

       H      Hangup any active calls.

       C address [gateway]
	      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.

       L      List all current speed dial codes

       D code address
	      Create a new speed dial for address using code.

       S      Print statistics of the call in progress.

       P      Toggle between speakerphone and normal mode

       A      Turn AEC up by one level (Quicknet cards only)

       a      Turn AEC down by one level (Quicknet cards only)

       [      Turn play volume up by one level.

       ]      Turn play volume down by one level.

       }      Turn record volume up by one level.

       {      Turn record volume down by one level.

       V      Display current volume settings

       E      Toggle silence supression

       I      Show last 16 calls made

       i      Show last 16 calls received


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


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


       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.


       ohphone -n ipaddress
	      Make a call directly to another endpoint without a gatekeeper


FILES
       ~/.pwlib_config/ohphone.ini


USING MICRO TELCO WITH OHPHONE
       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.


	 -u microtelco_account_number


	  --password microtelco_pin_number


	 -g gk.microtelco.com


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


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


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


SEE ALSO
       None



				  25 Mar 2006			    ohphone(1)