source: multimedia/libdriv/alsa-tools.xml@ c70ab7e

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since c70ab7e was c70ab7e, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Adapt alsa-tools to changes in alsa-lib. Remove the ld10k1/sb16_csp utilities for the time being, re-examine and add back at freeze or once the next version of alsa-lib is released, whichever comes first. This isn't ideal because ld10k1 is used to control Creative cards through HD Audio.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22565 af4574ff-66df-0310-9fd7-8a98e5e911e0

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