iecset

iecset(1)							    iecset(1)



NAME
       iecset - Set or dump IEC958 status bits


SYNOPSIS
       iecset [options] [cmd arg...]


DESCRIPTION
       iecset  is  a  small  utility  to set or dump the IEC958 (or so-called
       "S/PDIF") status bits of the specified sound  card  via	ALSA  control
       API.

       When  iecset  is started without arguments except for options, it will
       show the current IEC958 status in a  human-readable  form.   When  the
       commands	 are  given  in the arguments, they are parsed and the IEC958
       status bits are updated.	 The resultant status is shown as well.

       The commands consist of the command directive and  the  argument.   As
       the  boolean  argument,	yes,  no,  true,  false, or a digit number is
       allowed.


EXAMPLES
       iecset -Dhw:1
	      Displays the current IEC958 status bits  on  the	second	card.
	      This is equivalent with -c 1.

       iecset -x
	      Displays the current IEC958 status bits in a style of the argu-
	      ments for the PCM stream.	 The output string can be  passed  to
	      the iec958 (or spdif) PCM type as the optional argument.

       iecset pro off audio off
	      Sets  the	 current status to the consumer-mode and turns on the
	      non-audio bit.  The modified status will be shown, too.


OPTIONS
       -D device
	      Specifies the device name of the control to open

       -c card
	      Specifies the card index to open.	 Equivalent with -Dhw:x.

       -x     Dumps the status in the form of AESx bytes.

       -i     Reads the command sequences from stdin.  Each line  has  single
	      command.


COMMANDS
       professional <bool>
	      The professional mode (true) or consumer mode (false).


       audio <bool>
	      The audio mode (true) or non-audio mode (false).


       rate <int>
	      The sample rate in Hz.


       emphasis <int>
	      The emphasis: 0 = none, 1 = 50/15us, 2 = CCITT.


       lock <bool>
	      Rate  lock:  locked  (true), unlocked (false).  This command is
	      for the professional mode only.


       sbits <int>
	      Sample bits:  2 = 20bit, 4 = 24bit, 6 = undefined.   This	 com-
	      mand is for the professional mode only.


       wordlength <int>
	      Wordlength:  0  =	 No,  2 = 22-18 bit, 4 = 23-19 bit, 5 = 24-20
	      bit, 6 = 20-16 bit.  This command is for the professional	 mode
	      only.


       category <int>
	      Category: the value is from 0 to 0x7f.  This command is for the
	      consumer mode only.


       copyright <bool>
	      Copyright: copyrighted (true), non-copyrighted  (false).	 This
	      command is for the consumer mode only.


       original <boo>
	      Original	flag:  original (true), 1st generation (false).	 This
	      command is for the consumer mode only.


AUTHOR
       Takashi Iwai <tiwai@suse.de>



				 23 Oct 2003			    iecset(1)