Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ohphone(1)		    General Commands Manual		    ohphone(1)

NAME
       ohphone - initiate, or receive, a H.323 IP telephony call

SYNOPSIS
       ohphone -l|--listen [options]...

       ohphone [options]... address

DESCRIPTION
       ohphone	is  a  command line application	that can be used to listen for
       incoming	H.323 calls, or	to initiate a call to a	remote host.  Although
       originally  intended  as	 a test	harneess for the OpenH323 project (see
       http://www.openh323.org)	it has developed into a	fully functional H.323
       endpoint	 application.	ohphone	includes a simple menu that allows in-
       teractive control of functions, as well as allowing control of most di-
       alling and answer functions via a phone handset when used with a	Quick-
       net (see	http://www.quicknet.com) LineJack or PhoneJack.

       When used with the -l option, ohphone will wait for incoming calls.  If
       this  option  is	not specified, ohphone expects a hostname to be	speci-
       fied and	will attempt to	connect	to a H.323 client at that address.

OPTIONS
       All of the command line options to ohphone can  be  specified  in  long
       form,  and  the	most  commonly used options also have single character
       equivalents. The	long forms can also be used in the ohphone  configura-
       tion  file.  To disable or turn off a feature, use the long form	of the
       name with the prefix --no-, i.e.	--no-answer or --no-gsm.

       -a, --auto-answer
	      Automatically answer incoming calls.

       --autohook
	      Automatically handle hook	state for phone	 devices  that	appear
	      permanently  off-hook.  This option is intended for use with the
	      Quicknet PhoneCARD.

       --aec, level
	      Set the AEC (audio echo cancellation) level when using a	Quick-
	      net  card.   level must be in the	range 0	through	3. The default
	      value is 2.

       -b, --bandwidth bps
	      Limit bandwidth usage reported to	gatekeeper to bps bits/second.

       --callerid
	      Enable transmission of caller ID to phone	handset

       -d, --autodial host
	      Automatically dial host if phone goes off	hook.

       --dial-after-hangup
	      By default ohphone will present a	busy tone when a connection is
	      broken,  requiring  the  handset to be put on hook before	making
	      another call.  If	this flag is specified,	a new dialtone will be
	      presented,  allowing a new connection to be made without requir-
	      ing an hook transition.

       --disable-menu
	      Disable the internal menu.

       -e, --silence
	      Disable silence detection	 and  removal  for  GSM	 and  software
	      G.711.

       -f, --fast-disable
	      Do not request H323V2 FastConnect	when initiaiting a connection.

       -h, --h245tunnel-disable
	      Do not perform H245 tunneling when initiating a connection.

       -g, --gatekeeper	host
	      Upon  startup,  register with only with the specified gatekeeper
	      rather than attempting to	find a gatekeeper by using UDP	broad-
	      cast.

       --g711-ulaw
	      Set G.711	uLaw as	preferred codec.

       --g711-Alaw
	      Set G.711	ALaw as	preferred codec.

       --g7231
	      Set G.723.1 as preferred codec, when using a Quicknet card.

       --gsm  Use GSM 06.10 as preferred codec.

       --h261 device
	      This  option  has	 been deprecated in favour of the videoreceive
	      and videotransmit	options

       -i, --interface interface
	      Only bind	to the specified network interface  address.   By  de-
	      fault,  ohphone  automatically listens for incoming calls	on all
	      TCP/IP network interfaces	available on the host  machine.	  This
	      option  is  useful for running multiple copies of	ohphone	on the
	      same multi-homed machine,	or for ensuring	that only  calls  from
	      the external, or internal, network will be received on a partic-
	      ular handset.

       -j, --jitter delay
	      Set jitter buffer	to delay ms. By	default, the jitter buffer  is
	      set to 50	ms.

       -l, --listen
	      Listen for incoming calls.

       -n, --no-gatekeeper
	      Do  not  attempt	to  find  a gatetkeeper	upon startup using UDP
	      broadcast.

       -o, --output filename
	      Write trace output (enabled with the -t option) to the specified
	      file rather than to stdout.

       -p, --proxy host
	      Connect  to  the remote endpoint using the specified H.323 proxy
	      host, rather than	attempting to connect directly.

       --playvol vol
	      Set the playback volume. For sound cards,	 this  is  an  integer
	      value  from  0  through  100. For	Quicknet cards,	this is	a real
	      number from 0.0 through 16.0 (1.0	is normal volume)

       -q, --quicknet num
	      Use the specified	Linux telephony	device (/dev/phonenum)	rather
	      than a sound card. This overrides	the default of using the sound
	      card.

       --quicknet-playvol vol
	      Set the playback volume when a Quicknet card is used. This over-
	      rides the	value of --playvol (if set). The volume	is a real num-
	      ber from 0.0 through 16.0	(1.0 is	normal volume).

       --quicknet-recvol vol
	      Set the record volume when a Quicknet card is used.  This	 over-
	      rides  the value of --recvol (if set). The volume	is a real num-
	      ber from 0.0 through 16.0	(1.0 is	normal volume).

       -r, --require-gatekeeper
	      Exit if a	gatekeeper cannot be found.

       --recvol	vol
	      Set the record volume. For sound cards, this is an integer value
	      from  0  through	100. For Quicknet cards, this is a real	number
	      from 0.0 through 16.0 (1.0 is normal volume)

       --ringfile filename
	      Play the PCM data	in filename when an incoming call arrives.

       --ringdelay delay
	      If the --ringfile	option is specified, this option  defines  how
	      many  to delay between playing each ring.	If the delay is	speci-
	      fied as -1, then the file	is only	played once. If	 it  is	 zero,
	      then  the	file loops continuously	with no	delay. The default de-
	      lay is 5 seconds.

       -s, --sound device
	      Select the sound input and output	device.	The default  value  is
	      /dev/dsp0.

       --sound-mixer device
	      Select  the  sound  card	mixer  device.	The  default  value is
	      /dev/mixer0

       --sound-recchan device
	      Select the sound card record channel. By default,	the mic	 chan-
	      nel is used.

       --sound-in, --sound-out device
	      Select  the sound	input or output	device seperately. Only	needed
	      if different sound devices are needed for	input and output.

       --sound-playvol vol
	      Set the playback volume when a sound card	is  used.  This	 over-
	      rides  the value of --playvol (if	set). The volume is an integer
	      value from 0 through 100

       --sound-recol vol
	      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

       --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 as-
	      sist  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
	      stdout.

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

       --videoformat format
	      Set the video capture format. format must	be the string pal (de-
	      fault) 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
	      Enable tranmission of video in  H261  format.   The  size	 ofthe
	      video window is determined by the	--videosize option.  The video
	      input used is determined by the --videoinput option.  The	 video
	      format  used  is	determined  by	the  --videoformat option.  If
	      --videolocal is specified, then the local	video signal  will  be
	      displayed	in a seperate window.

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  [Op-
       tions],	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).   oh-
       phone  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 op-
       erations	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 op-
	      tional 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 using directly to another endpoint without a gate-
	      keeper

       ohphone -n ipaddress
	      Make a call using	directly to another endpoint without  a	 gate-
	      keeper

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

				  29 May 2000			    ohphone(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CONFIGURATION FILE | SPEED DIALS | DIALLING IP NUMBERS USING A HANDSET | INTERNAL MENU | EXAMPLES | FILES | USING MICRO TELCO WITH OHPHONE | BUGS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ohphone&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help