Usage

Command line

<OSTK_ROOT>/bin/cats …

Default port

12345

Command line arguments

All command line arguments requiring values must be followed by an equal sign ('='), which is then followed by the value. No spaces are permitted before or after the equal sign.

Table 1. Command line arguments

switchoptionalargument typedefault valuedescription/constraints
-debugyesN/AN/AEnable debugging output.
-half_duplexyesN/AN/AEnable half duplex operation.
-nobargeyesN/AN/ADisable server-driven barge-in.
-nostreamingyesN/AN/ADisable streaming mode - force server to record a complete utterance, then send the utterance at once.
-playboxyesN/AN/AMIT playbox mode. Forces backward compatibility with the MIT playbox brokering protocol, to provide broker-level interoperability with legacy servers.
-pttyesN/AN/ADisable voice activity detection, allowing for push-to-talk operation.
-record_encodingyesstringPCM_SIGNEDEncoding used for recording. Supported formats: PCM_SIGNED, PCM_UNSIGNED, ULAW, ALAW. See the Java Sound Home Page for more information.
-record_sample_rateyesinteger8000Sample rate used for recording.
-record_sample_sizeyesinteger16Sample size in bits/sample used for recording.
-record_channelsyesinteger1Number of channels to record.
-record_little_endianyesN/AN/ARecord using little endian byte ordering rather than big endian.
-playback_encodingyesstringPCM_SIGNEDDefault encoding used for recording. Supported formats: PCM_SIGNED, PCM_UNSIGNED, ULAW, ALAW. May be overridden by the :encoding key of a broker frame - see receive_audio
-playback_sample_rateyesinteger8000Default sample rate used for playback. May be overridden by the :sample_rate key of a broker frame - see receive_audio
-playback_sample_sizeyesinteger16Default sample size in bits/sample used for playback. May be overridden by the :sample_rate key of a broker frame - see receive_audio
-playback_channelsyesinteger1Default number of channels to record. May be overridden by the :channels key of a broker frame - see receive_audio
-playback_little_endianyesN/AN/APlayback using little endian byte ordering rather than big endian. May be overridden by the :big_endian key of a broker frame - see receive_audio
-use_cfoneyesstring(no default value)If ComputerFone support is enabled via ENABLE_CFONE in the configuration file, this flag provides the name of the serial port (e.g., /dev/ttya) which the ComputerFone is attached to.
-outbound_brokersnoN/AN/AIn GCSI 4.0, the preferred way to issue backchannel data is via broker proxies instead of the lower-level brokers. If you want to force the lower-level brokers to be used, set this flag. If MIT playbox compatibility is enabled, this flag is ignored, because brokers are used anyway.