1cspctl(1)                   General Commands Manual                  cspctl(1)
2
3
4

NAME

6       cspctl - Sound Blaster 16 ASP/CSP control program
7
8

SYNOPSIS

10       cspctl command [-options] <filename>
11
12

DESCRIPTION

14       cspctl  is  a  simple  CSP  microcode loader for Creative Sound Blaster
15       16ASP and some Sound Blaster AWE32 sound  cards  with  Creative  Signal
16       Processor (CSP) chip (CT1748A) installed.  cspctl can also be used as a
17       post-install function to snd-sb16-csp module to load default  codec  at
18       module  installation. If CSP chip is successfully detected and initial‐
19       ized, it will be installed as a hardware dependent device  hwC0D2  into
20       /dev/snd  directory.  Currently,  following codecs can be loaded to CSP
21       device:
22
23
24           wfm0001a.csp  QSound decoder
25           wfm0006a.csp  A-law codec
26           wfm0007a.csp  u-law codec
27           wfm0011a.csp  IMA ADPCM codec (distorted output for IMA test files)
28           wfm0200a.csp  Creative ADPCM codec (sounds like Intel/DVI IMA ADPCM compatible)
29           wfm0202a.csp  Fast Speech 8 codec
30           wfm0203a.csp  Fast Speech 10 codec
31
32       These codecs are not yet supported by ALSA:
33
34           wfm0201a.csp  Text2Speech decoder
35
36       Qsound microcode file has four functions, each function  is  a  decoder
37       for different sample rate. Rates for QSound functions #1, #2, #3 and #4
38       are 44100, 22050, 11025 and 8000Hz respectively. IMA  ADPCM  and  Fast‐
39       Speech codecs are formed of two functions, the first one is for capture
40       and the second one is for playback. A-law and u-law  codecs  have  only
41       one  function.   To  load for example function #2 from QSound microcode
42       file (decoder for 22050Hz), run as follows:
43
44           % cspctl load -f 2 -d QSound wfm0001a.csp
45
46       After successful loading, /proc/asound/SB16/cspD2 will show:
47
48
49           Creative Signal Processor [v1.0]
50           State: -x--L
51           Codec: QSound [func #2]
52           Sample rates: 22050Hz
53           QSound decoder disabled
54
55       With QSound decoder microcode loaded, all simple PCM file  formats  can
56       be played with QSound 180 degree positioning applied. QSound element is
57       dynamically added into mixer structure as 3DEffect1-space  element.  It
58       will  only show if support for CSP has been compiled into ALSA drivers,
59       CSP chip has been found, and QSound codec  is  loaded  into  CSP.  When
60       enabled,  QSound  position  can be dynamically changed by mixer slider,
61       and proc interface should follow the state of CSP chip and its  current
62       QSound position:
63
64
65           Creative Signal Processor [v1.0]
66           State: Qx-RL
67           Codec: QSound [func #2]
68           Sample rates: 22050Hz
69           QSound decoder enabled
70           Processing 16bit mono PCM samples
71           Qsound position: left = 0x9, right = 0x9
72
73       Driver  supports  autoloading  of  u-Law,  A-Law and Ima-ADPCM hardware
74       codecs. Autoloading is active only when there is no microcode loaded to
75       CSP, and there is no need to preload appropriate *.csp files. To unload
76       manually loaded microcode, you should run
77
78           % cspctl unload
79
80       If hardware codec microcode has been manually  loaded,  then  CSP  will
81       support  only  loaded  PCM  format and autoloading will be disabled. In
82       such case, proc interface will show loaded codec properties:
83
84
85           Creative Signal Processor [v1.0]
86           State: -x--L
87           Codec: IMA-ADPCM [func #2]
88           Sample rates: All
89           PCM format ID: 0x400000 (16bit/-) [mono/stereo] [playback/-]
90

COMMANDS

92       load   Load microcode from filename to CSP.
93
94       unload Unload microcode from CSP.
95

OPTIONS

97       -h, --help
98              Display a short help.
99
100       -c card
101              Select a card number. Option defaults to 0.
102
103       -f function
104              Select a function from microcode file. Option defaults to 1.
105
106       -d description
107              Optional microcode description string.
108
109

AUTHOR

111       Uros Bizjak <uros@kss-loka.si>.
112
113
114
115
116
117
118
119
120                                April 27, 2000                       cspctl(1)
Impressum