source: multimedia/libdriv/alsa-tools.xml

trunk
Last change on this file was 181e069f, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Tag all perl modules
  • Property mode set to 100644
File size: 16.6 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY alsa-tools-download-http "&alsa-download-http;/tools/alsa-tools-&alsa-tools-version;.tar.bz2">
8 <!ENTITY alsa-tools-download-ftp " ">
9 <!ENTITY alsa-tools-md5sum "bc5f5e5689f46a9d4a0b85dc6661732c">
10 <!ENTITY alsa-tools-size "1.8 MB">
11 <!ENTITY alsa-tools-buildsize "18 MB">
12 <!ENTITY alsa-tools-time "0.3 SBU">
13]>
14
15<sect1 id="alsa-tools" xreflabel="alsa-tools-&alsa-tools-version;">
16 <?dbhtml filename="alsa-tools.html"?>
17
18
19 <title>alsa-tools-&alsa-tools-version;</title>
20
21 <indexterm zone="alsa-tools">
22 <primary sortas="a-alsa-tools">alsa-tools</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to ALSA Tools</title>
27
28 <para>
29 The <application>ALSA Tools</application> package
30 contains advanced tools for certain sound cards.
31 </para>
32
33 &lfs121_checked;
34
35 <bridgehead renderas="sect3">Package Information</bridgehead>
36 <itemizedlist spacing="compact">
37 <listitem>
38 <para>
39 Download (HTTP): <ulink url="&alsa-tools-download-http;"/>
40 </para>
41 </listitem>
42 <listitem>
43 <para>
44 Download (FTP): <ulink url="&alsa-tools-download-ftp;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download MD5 sum: &alsa-tools-md5sum;
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download size: &alsa-tools-size;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Estimated disk space required: &alsa-tools-buildsize;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated build time: &alsa-tools-time;
65 </para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">ALSA Tools Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required">
73 <xref linkend="alsa-lib"/>
74 </para>
75
76 <bridgehead renderas="sect4">Optional</bridgehead>
77 <para role="optional">
78 <xref linkend="gtk2"/>
79 (to build <command>echomixer</command>,
80 <command>envy24control</command> and
81 <command>rmedigicontrol</command>),
82 <xref linkend="gtk3"/>
83 (to build <command>hdajackretask</command>) and
84 <xref linkend="fltk"/>
85 (to build <command>hdspconf</command> and
86 <command>hdspmixer</command>)
87 </para>
88
89 </sect2>
90
91 <sect2 role="installation">
92 <title>Installation of ALSA Tools</title>
93
94&as_root;
95
96 <para>
97 First, start a subshell that will exit on error:
98 </para>
99
100<screen><userinput>bash -e</userinput></screen>
101
102 <para>
103 Now, remove a tool that needs <application>Qt2 or 3</application> and two
104 unneeded files (for the BLFS instructions below):
105 </para>
106
107 <screen><userinput>rm -rf qlo10k1 Makefile gitcompile</userinput></screen>
108
109 <para>
110 The <application>ALSA Tools</application> package is only needed by those
111 with advanced requirements for their sound card. The tools can be built
112 all together at once, but if only a subset is needed, you need to
113 <command>cd</command> into the directory of each tool you wish to compile
114 and run the commands. Here, we present instructions to build all tools.
115 </para>
116
117 <para>
118 Install all <application>ALSA Tools</application> by running the
119 following commands:
120 </para>
121
122<screen><userinput>for tool in *
123do
124 case $tool in
125 seq )
126 tool_dir=seq/sbiload
127 ;;
128 * )
129 tool_dir=$tool
130 ;;
131 esac
132
133 pushd $tool_dir
134 ./configure --prefix=/usr
135 make
136 as_root make install
137 as_root /sbin/ldconfig
138 popd
139
140done
141unset tool tool_dir</userinput></screen>
142
143 <para>
144 Finally, exit the shell that was started earlier:
145 </para>
146
147<screen><userinput>exit</userinput></screen>
148
149 </sect2>
150
151 <sect2 role="content">
152 <title>Contents</title>
153
154 <segmentedlist>
155 <segtitle>Installed Programs</segtitle>
156 <segtitle>Installed Library</segtitle>
157 <segtitle>Installed Directories</segtitle>
158
159 <seglistitem>
160 <seg>
161 as10k1, cspctl, dl10k1, echomixer, envy24control, hda-verb, hdajackretask,
162 hdajacksensetest, hdspconf, hdsploader, hdspmixer, hwmixvolume,
163 init_audigy, init_audigy_eq10, init_live, lo10k1, ld10k1, ld10k1d,
164 mixartloader, pcxhrloader,
165 rmedigicontrol, sbiload, sscape_ctl, us428control,
166 usx2yloader, and vxloader
167 </seg>
168 <seg>
169 liblo10k1.so
170 </seg>
171 <seg>
172 /etc/hotplug,
173 /usr/include/lo10k1,
174 /usr/share/ld10k1, and
175 /usr/share/sounds
176 </seg>
177 </seglistitem>
178 </segmentedlist>
179
180 <variablelist>
181 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
182 <?dbfo list-presentation="list"?>
183 <?dbhtml list-presentation="table"?>
184
185 <varlistentry id="as10k1">
186 <term><command>as10k1</command></term>
187 <listitem>
188 <para>
189 is an assembler for the emu10k1 DSP chip present in the
190 Creative SB Live, PCI 512, and emu APS sound cards. It is used
191 to make audio effects such as a flanger, chorus or reverb
192 </para>
193 <indexterm zone="alsa-tools as10k1">
194 <primary sortas="b-as10k1">as10k1</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="cspctl">
200 <term><command>cspctl</command></term>
201 <listitem>
202 <para>
203 is an SB16/AWE32 Creative Signal Processor (ASP/CSP) control
204 program
205 </para>
206 <indexterm zone="alsa-tools cspctl">
207 <primary sortas="b-cspctl">cspctl</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="echomixer">
213 <term><command>echomixer</command></term>
214 <listitem>
215 <para>
216 is the Linux equivalent of the Echoaudio console application
217 from Echoaudio. It is a tool to control all the features of any
218 Echoaudio soundcard. This includes clock sources, input and output
219 gains, mixers, etc
220 </para>
221 <indexterm zone="alsa-tools echomixer">
222 <primary sortas="b-echomixer">echomixer</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="envy24control">
228 <term><command>envy24control</command></term>
229 <listitem>
230 <para>
231 is a control tool for Envy24 (ice1712) based sound cards
232 </para>
233 <indexterm zone="alsa-tools envy24control">
234 <primary sortas="b-envy24control">envy24control</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="hdajackretask">
240 <term><command>hdajackretask</command></term>
241 <listitem>
242 <para>
243 is a GUI to make it easy to retask your jacks - e g, turn your Mic
244 jack into an extra Headphone, or why not make them both line outs
245 and connect them to your surround receiver
246 </para>
247 <indexterm zone="alsa-tools hdajackretask">
248 <primary sortas="b-hdajackretask">hdajackretask</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="hda-verb">
254 <term><command>hda-verb</command></term>
255 <listitem>
256 <para>
257 is a small program to send HD-audio commands to the given
258 ALSA hwdep device on the hd-audio interface
259 </para>
260 <indexterm zone="alsa-tools hda-verb">
261 <primary sortas="b-hda-verb">hda-verb</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="hdspconf">
267 <term><command>hdspconf</command></term>
268 <listitem>
269 <para>
270 is a GUI to control the Hammerfall
271 HDSP Alsa Settings. Up to four hdsp cards are supported
272 </para>
273 <indexterm zone="alsa-tools hdspconf">
274 <primary sortas="b-hdspconf">hdspconf</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="hdsploader">
280 <term><command>hdsploader</command></term>
281 <listitem>
282 <para>
283 is used to load the firmware required by the Hammerfall
284 HDSP sound cards
285 </para>
286 <indexterm zone="alsa-tools hdsploader">
287 <primary sortas="b-hdsploader">hdsploader</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="hdspmixer">
293 <term><command>hdspmixer</command></term>
294 <listitem>
295 <para>
296 is the Linux equivalent of the Totalmix application from RME.
297 It is a tool to control the advanced routing features of the RME
298 Hammerfall DSP soundcard series
299 </para>
300 <indexterm zone="alsa-tools hdspmixer">
301 <primary sortas="b-hdspmixer">hdspmixer</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="hwmixvolume">
307 <term><command>hwmixvolume</command></term>
308 <listitem>
309 <para>
310 allows you to control the volume of individual streams on sound
311 cards that use hardware mixing
312 </para>
313 <indexterm zone="alsa-tools hwmixvolume">
314 <primary sortas="b-hwmixvolume">hwmixvolume</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="init_audigy_progs">
320 <term><command>init_audigy*</command></term>
321 <listitem>
322 <para>
323 are tools used to initialize Creative Sound Blaster Audigy-series
324 cards
325 </para>
326 <indexterm zone="alsa-tools init_audigy_progs">
327 <primary sortas="b-init_audigy_progs">init_audigy*</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="init_live">
333 <term><command>init_live</command></term>
334 <listitem>
335 <para>
336 is a tool used to initialize Creative Sound Blaster Live cards
337 </para>
338 <indexterm zone="alsa-tools init_live">
339 <primary sortas="b-init_live">init_live</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="ld10k1">
345 <term><command>ld10k1</command></term>
346 <listitem>
347 <para>
348 is the server of a EMU10K{1,2} patch loader for ALSA
349 </para>
350 <indexterm zone="alsa-tools ld10k1">
351 <primary sortas="b-ld10k1">ld10k1</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="lo10k1">
357 <term><command>lo10k1</command></term>
358 <listitem>
359 <para>
360 is the client of a EMU10K{1,2} patch loader for ALSA
361 </para>
362 <indexterm zone="alsa-tools lo10k1">
363 <primary sortas="b-lo10k1">lo10k1</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="dl10k1">
369 <term><command>dl10k1</command></term>
370 <listitem>
371 <para>
372 loads config dumps generated by <command>lo10k1</command>
373 and <command>ld10k1</command>
374 </para>
375 <indexterm zone="alsa-tools dl10k1">
376 <primary sortas="b-dl10k1">dl10k1</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="ld10k1d">
382 <term><command>ld10k1d</command></term>
383 <listitem>
384 <para>
385 is an init script for the <command>ld10k1</command>
386 patch loader
387 </para>
388 <indexterm zone="alsa-tools ld10k1d">
389 <primary sortas="b-ld10k1d">ld10k1d</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <!-- No longer installed due to Qt2/3 dependency.
395 <varlistentry id="qlo10k1">
396 <term><command>qlo10k1</command></term>
397 <listitem>
398 <para>
399 is a <application>Qt</application> GUI for the
400 <command>ld10k1</command> patch loader.
401 </para>
402 <indexterm zone="alsa-tools qlo10k1">
403 <primary sortas="b-qlo10k1">qlo10k1</primary>
404 </indexterm>
405 </listitem>
406 </varlistentry>
407 -->
408
409 <varlistentry id="mixartloader">
410 <term><command>mixartloader</command></term>
411 <listitem>
412 <para>
413 is a helper program to load the firmware binaries onto the
414 Digigram's miXart board sound drivers. The following modules
415 require this program: snd-mixart. These drivers don't work
416 properly at all until the certain firmware files are loaded, i.e. no
417 PCM nor mixer devices will appear
418 </para>
419 <indexterm zone="alsa-tools mixartloader">
420 <primary sortas="b-mixartloader">mixartloader</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="pcxhrloader">
426 <term><command>pcxhrloader</command></term>
427 <listitem>
428 <para>
429 is a helper program to load the firmware binaries onto
430 Digigram's pcxhr compatible board sound drivers. The following
431 modules require this program: snd-pcxhr. These drivers don't work
432 properly at all until certain firmware files are loaded, i.e. no PCM
433 nor mixer devices will appear
434 </para>
435 <indexterm zone="alsa-tools pcxhrloader">
436 <primary sortas="b-pcxhrloader">pcxhrloader</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="rmedigicontrol">
442 <term><command>rmedigicontrol</command></term>
443 <listitem>
444 <para>
445 is a control tool for RME Digi32 and RME Digi96 sound cards.
446 It provides a graphical frontend for all the sound card controls
447 and switches
448 </para>
449 <indexterm zone="alsa-tools rmedigicontrol">
450 <primary sortas="b-rmedigicontrol">rmedigicontrol</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 <varlistentry id="sbiload">
456 <term><command>sbiload</command></term>
457 <listitem>
458 <para>
459 is an OPL2/3 FM instrument loader for the ALSA sequencer
460 </para>
461 <indexterm zone="alsa-tools sbiload">
462 <primary sortas="b-sbiload">sbiload</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="sscape_ctl">
468 <term><command>sscape_ctl</command></term>
469 <listitem>
470 <para>
471 is an ALSA SoundScape control utility
472 </para>
473 <indexterm zone="alsa-tools sscape_ctl">
474 <primary sortas="b-sscape_ctl">sscape_ctl</primary>
475 </indexterm>
476 </listitem>
477 </varlistentry>
478
479 <varlistentry id="us428control">
480 <term><command>us428control</command></term>
481 <listitem>
482 <para>
483 is a Tascam US-428 control program
484 </para>
485 <indexterm zone="alsa-tools us428control">
486 <primary sortas="b-us428control">us428control</primary>
487 </indexterm>
488 </listitem>
489 </varlistentry>
490
491 <varlistentry id="usx2yloader">
492 <term><command>usx2yloader</command></term>
493 <listitem>
494 <para>
495 is a helper program to load the 2nd Phase firmware binaries onto
496 the Tascam USX2Y USB sound cards. It has proven to work so far for
497 the US122, US224 and US428. The snd-usb-usx2y module requires this
498 program
499 </para>
500 <indexterm zone="alsa-tools usx2yloader">
501 <primary sortas="b-usx2yloader">usx2yloader</primary>
502 </indexterm>
503 </listitem>
504 </varlistentry>
505
506 <varlistentry id="vxloader">
507 <term><command>vxloader</command></term>
508 <listitem>
509 <para>
510 is a helper program to load the firmware binaries onto the
511 Digigram's VX-board sound drivers. The following modules require
512 this program:
513 snd-vx222, snd-vxpocket, snd-vxp440. These drivers don't work properly at all
514 until the certain firmware files are loaded, i.e. no PCM nor mixer devices will
515 appear
516 </para>
517 <indexterm zone="alsa-tools vxloader">
518 <primary sortas="b-vxloader">vxloader</primary>
519 </indexterm>
520 </listitem>
521 </varlistentry>
522
523 </variablelist>
524
525 </sect2>
526
527</sect1>
Note: See TracBrowser for help on using the repository browser.