iecset.1 (2785B)
1 .TH iecset 1 "23 Oct 2003" 2 .SH NAME 3 iecset \- Set or dump IEC958 status bits 4 5 .SH SYNOPSIS 6 \fBiecset\fP [\fIoptions\fP] [\fIcmd\fP \fIarg\fP...] 7 8 .SH DESCRIPTION 9 \fBiecset\fP is a small utility to set or dump the IEC958 (or so-called 10 "S/PDIF") status bits of the specified sound card via ALSA control API. 11 12 When \fBiecset\fP is started without arguments except for options, 13 it will show the current IEC958 status in a human-readable form. 14 When the commands are given in the arguments, they are parsed 15 and the IEC958 status bits are updated. The resultant status is 16 shown as well. 17 18 The commands consist of the command directive and the argument. 19 As the boolean argument, \fIyes\fP, \fIno\fP, \fItrue\fP, \fIfalse\fP, 20 or a digit number is allowed. 21 22 .SH EXAMPLES 23 .TP 24 .BI iecset\ \-Dhw:1 25 Displays the current IEC958 status bits on the second card. 26 This is equivalent with \fI\-c 1\fP. 27 .TP 28 .BI iecset\ \-x 29 Displays the current IEC958 status bits in a style of the arguments 30 for the PCM stream. The output string can be passed to the \fIiec958\fP 31 (or \fIspdif\fP) PCM type as the optional argument. 32 .TP 33 .BI iecset\ pro\ off\ audio\ off 34 Sets the current status to the consumer-mode and turns on the 35 non-audio bit. The modified status will be shown, too. 36 37 .SH OPTIONS 38 .TP 39 \fI\-D\fP device 40 Specifies the device name of the control to open 41 .TP 42 \fI\-c\fP card 43 Specifies the card index to open. Equivalent with \fI\-Dhw:x\fP. 44 .TP 45 \fI\-n\fP index 46 Specifies the IEC958 control element index, in case you have multiple 47 IEC958 devices and need to choose one of them. 48 .TP 49 \fI\-x\fP 50 Dumps the status in the form of AESx bytes. 51 .TP 52 \fI\-i\fP 53 Reads the command sequences from stdin. 54 Each line has single command. 55 56 .SH COMMANDS 57 .TP 58 \fIprofessional\fP <bool> 59 The professional mode (true) or consumer mode (false). 60 61 .TP 62 \fIaudio\fP <bool> 63 The audio mode (true) or non-audio mode (false). 64 65 .TP 66 \fIrate\fP <int> 67 The sample rate in Hz. 68 69 .TP 70 \fIemphasis\fP <int> 71 The emphasis: 0 = none, 1 = 50/15us, 2 = CCITT. 72 73 .TP 74 \fIlock\fP <bool> 75 Rate lock: locked (true), unlocked (false). 76 This command is for the professional mode only. 77 78 .TP 79 \fIsbits\fP <int> 80 Sample bits: 2 = 20bit, 4 = 24bit, 6 = undefined. 81 This command is for the professional mode only. 82 83 .TP 84 \fIwordlength\fP <int> 85 Wordlength: 0 = No, 2 = 22-18 bit, 4 = 23-19 bit, 5 = 24-20 bit, 6 = 20-16 bit. 86 This command is for the professional mode only. 87 88 .TP 89 \fIcategory\fP <int> 90 Category: the value is from 0 to 0x7f. 91 This command is for the consumer mode only. 92 93 .TP 94 \fIcopyright\fP <bool> 95 Copyright: copyrighted (true), non-copyrighted (false). 96 This command is for the consumer mode only. 97 98 .TP 99 \fIoriginal\fP <boo> 100 Original flag: original (true), 1st generation (false). 101 This command is for the consumer mode only. 102 103 .SH AUTHOR 104 Takashi Iwai <tiwai@suse.de>