<< Indiva Home

Running Services

This chapter describes the services available in Indiva. Even though you normally launch these services through Indiva, the services can run as a standalone program.

Indiva Video Encoder (ive)

ive captures video off a capture card, encodes it into RTP packets and sends it into a specified session. It supports the following options:

-dest addr/port/ttl
Session specification of the destination. For example, 224.1.2.3/12000/16. If nothing is given, the default session 224.4.4.4/4444 is used.
-fmt format
The format to encode the video in. Possible values are "h261" or "jpeg". If not given, default to "h261".
-q quality
Quality of the encoding stream. The meaning of the value given depends on the format chosen. Default value is 80.
-bps bitrate
Maximum bit-rate of the encoded video. Default is 128000.
-fps framerate
Frame rate of the encoded video. Default to 15 fps.
-dev path
Path to the capture device. For example, /dev/video0. If not given, the first device returned by the system will be used.
-port port
Name of the input port on the capture device to used. If not specified, the first port given by the system will be used. The name of the input port must be exactly the same as the string returned by the device driver. For example, "Composite".
-transmit value
If value is set to 1, transmit immediately. Default is 0. If you run this as a stand-alone application, you probably want to set it to 1, otherwise nothing will be sent.
-norm norm
Norm of the captured signal. Can be "ntsc", "pal", "secam", or "auto". Must be supported by the capture device. The default is "ntsc".
-rtpname name
-rtpemail email
Use name and email as the name and e-mail address field in RTCP SDES packets.

Indiva Audio Encoder (iae)

iae captures audio off a sound card, encode it into RTP packets and sends it to a session. It supports the following options:

-dest addr/port/ttl
Session specification of the destination. For example, 224.1.2.3/12000/16. If no destination is specified, the default session 224.4.4.4/4446 is used.
-port port
Name of the input port on the sound card to used. The default value is "linein". Other possible values are: "mike" and "cd".
-transmit value
If value is set to 1, transmit immediately. Default is 0. If you run this as a stand-alone application, you probably want to set it to 1, otherwise nothing will be sent.
-rtpname name
-rtpemail email
Use these as the name and e-mail address field in RTCP SDES packets.

Indiva Routing Switcher (irs)

irs switches signal of a given routing matrix, from a given input port to a output port. The command line options available are:

-dev path
Path to the serial port the matrix is connected to. For example, /dev/ttyS0.
-id id
Name of the routing switcher, must corresponds to a subclass of Class RoutingSwitcher in Mash. Currently, the only valid values are "KnoxChameleon" and "EchoStar".
-type type
The type of signal to switch. For KnoxChameleon, valid values are "video", "audio" and "both". This option is ignored by EchoStar.
-in port
Input port number to switch from.
-out port
Output port to switch to. This must be an integer if id is KnoxChameleon. If id is EchoStar, possible values are "bcast" and "dish".

Note that in order to switch to output "dish" on EchoStar, you need to ensure that the executable channel is in your path.

For BMRC only: channel is located under /usr/local/tv/bin on video0.bmrc.berkeley.edu.

Indiva Kaleido Control (ikld)

ikld is the service interface to Miranda Kaleido device. It is not very useful to run this as a stand alone applications, as there are limited support for command line options.

-dev path
Path to the serial port the Miranda Kaleido is connected to. For example, /dev/ttyS0.

Common Command Line Options for Services

In additions to the specific command line options above, all Indiva services support the following options. These options are meaningful only when the services are launched as part of Indiva.

-imgr host[:port]
The host and port of the Indiva manager. Must be given as hostname[:port]. If no port is specified, the default port 9500 is used. If -imgr is omitted, then the service will not try to contact Indiva Manager.
-as_service [yes|no]
If value is yes, then Active Service is turned on. If value is no, AS1 Protocol will be turned off. This is useful if you want to run a service as a stand-alone application. Default is yes. To run a service as a stand alone application, do not specify -imgr and set -as_service to no.
-as_spec addr/port/ttl
The multicast channel and port to use for AS1 communication. Default is 224.4.5.24/50000/1
-as_bw bw
Bandwidth limit for AS1 messages in bps. Default is 50000.
-sid id
Use id is the unique identifier of a service running in Indiva. This should be set by ihm when it launches a service.