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

10.0 10.1 11.0 11.1 11.2 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since c1c6b2e was c1c6b2e, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Fix the build of HDSPMixer in alsa-tools

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

  • Property mode set to 100644
File size: 16.9 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 &amp;&amp;
125sed -i -e '39 s/uint32_t/__u32/' hdspmixer/src/HDSPMixerWindow.cxx &amp;&amp;
126sed -i -e '40 s/uint64_t/__u64/' hdspmixer/src/HDSPMixerWindow.cxx</userinput></screen>
127
128 <para>
129 The <application>ALSA Tools</application> package is only needed by those
130 with advanced requirements for their sound card. The tools can be built
131 all together at once, but if only a subset is needed, you need to
132 <command>cd</command> into the directory of each tool you wish to compile
133 and run the commands. Here, we present instructions to build all tools.
134 </para>
135
136 <para>
137 Install all <application>ALSA Tools</application> by running the
138 following commands:
139 </para>
140
141<screen><userinput>for tool in *
142do
143 case $tool in
144 seq )
145 tool_dir=seq/sbiload
146 ;;
147 * )
148 tool_dir=$tool
149 ;;
150 esac
151
152 pushd $tool_dir
153 ./configure --prefix=/usr
154 make
155 as_root make install
156 as_root /sbin/ldconfig
157 popd
158
159done
160unset tool tool_dir</userinput></screen>
161
162 <para>Finally, exit the shell that was started earlier:</para>
163
164<screen><userinput>exit</userinput></screen>
165
166 </sect2>
167
168 <sect2 role="content">
169 <title>Contents</title>
170
171 <segmentedlist>
172 <segtitle>Installed Programs</segtitle>
173 <segtitle>Installed Library</segtitle>
174 <segtitle>Installed Directories</segtitle>
175
176 <seglistitem>
177 <seg>
178 as10k1, cspctl, dl10k1, echomixer, envy24control, hda-verb, hdajackretask,
179 hdajacksensetest, hdspconf, hdsploader, hdspmixer, hwmixvolume,
180 init_audigy, init_audigy_eq10, init_live, lo10k1, ld10k1, ld10k1d,
181 mixartloader, pcxhrloader,
182 rmedigicontrol, sbiload, sscape_ctl, us428control,
183 usx2yloader, and vxloader
184 </seg>
185 <seg>
186 liblo10k1.so
187 </seg>
188 <seg>
189 /etc/hotplug,
190 /usr/include/lo10k1,
191 /usr/share/ld10k1, and
192 /usr/share/sounds
193 </seg>
194 </seglistitem>
195 </segmentedlist>
196
197 <variablelist>
198 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
199 <?dbfo list-presentation="list"?>
200 <?dbhtml list-presentation="table"?>
201
202 <varlistentry id="as10k1">
203 <term><command>as10k1</command></term>
204 <listitem>
205 <para>is an assembler for the emu10k1 DSP chip present in the
206 Creative SB Live, PCI 512, and emu APS sound cards. It is used
207 to make audio effects such as a flanger, chorus or reverb.</para>
208 <indexterm zone="alsa-tools as10k1">
209 <primary sortas="b-as10k1">as10k1</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="cspctl">
215 <term><command>cspctl</command></term>
216 <listitem>
217 <para>is an SB16/AWE32 Creative Signal Processor
218 (ASP/CSP) control program.</para>
219 <indexterm zone="alsa-tools cspctl">
220 <primary sortas="b-cspctl">cspctl</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="echomixer">
226 <term><command>echomixer</command></term>
227 <listitem>
228 <para>is the Linux equivalent of the Echoaudio console application
229 from Echoaudio. It is a tool to control all the features of any Echoaudio
230 soundcard. This includes clock sources, input and output gains, mixers,
231 etc.</para>
232 <indexterm zone="alsa-tools echomixer">
233 <primary sortas="b-echomixer">echomixer</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="envy24control">
239 <term><command>envy24control</command></term>
240 <listitem>
241 <para>is a control tool for Envy24 (ice1712) based sound cards.</para>
242 <indexterm zone="alsa-tools envy24control">
243 <primary sortas="b-envy24control">envy24control</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 <varlistentry id="hdajackretask">
249 <term><command>hdajackretask</command></term>
250 <listitem>
251 <para>
252 is a GUI to make it easy to retask your jacks - e g, turn your Mic
253 jack into an extra Headphone, or why not make them both line outs
254 and connect them to your surround receiver.
255 </para>
256 <indexterm zone="alsa-tools hdajackretask">
257 <primary sortas="b-hdajackretask">hdajackretask</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="hda-verb">
263 <term><command>hda-verb</command></term>
264 <listitem>
265 <para>
266 is a small program to send HD-audio commands to the given
267 ALSA hwdep device on the hd-audio interface.
268 </para>
269 <indexterm zone="alsa-tools hda-verb">
270 <primary sortas="b-hda-verb">hda-verb</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="hdspconf">
276 <term><command>hdspconf</command></term>
277 <listitem>
278 <para>is a GUI to control the Hammerfall
279 HDSP Alsa Settings. Up to four hdsp cards are supported.</para>
280 <indexterm zone="alsa-tools hdspconf">
281 <primary sortas="b-hdspconf">hdspconf</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="hdsploader">
287 <term><command>hdsploader</command></term>
288 <listitem>
289 <para>is used to load the firmware required by the Hammerfall
290 HDSP sound cards.</para>
291 <indexterm zone="alsa-tools hdsploader">
292 <primary sortas="b-hdsploader">hdsploader</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 <varlistentry id="hdspmixer">
298 <term><command>hdspmixer</command></term>
299 <listitem>
300 <para>is the Linux equivalent of the Totalmix application from RME.
301 It is a tool to control the advanced routing features of the RME
302 Hammerfall DSP soundcard series.</para>
303 <indexterm zone="alsa-tools hdspmixer">
304 <primary sortas="b-hdspmixer">hdspmixer</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="hwmixvolume">
310 <term><command>hwmixvolume</command></term>
311 <listitem>
312 <para>
313 allows you to control the volume of individual streams on sound
314 cards that use hardware mixing
315 </para>
316 <indexterm zone="alsa-tools hwmixvolume">
317 <primary sortas="b-hwmixvolume">hwmixvolume</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="init_audigy_progs">
323 <term><command>init_audigy*</command></term>
324 <listitem>
325 <para>
326 are tools used to initialize Creative Sound Blaster Audigy-series cards.
327 </para>
328 <indexterm zone="alsa-tools init_audigy_progs">
329 <primary sortas="b-init_audigy_progs">init_audigy*</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="init_live">
335 <term><command>init_live</command></term>
336 <listitem>
337 <para>
338 is a tool used to initialize Creative Sound Blaster Live cards.
339 </para>
340 <indexterm zone="alsa-tools init_live">
341 <primary sortas="b-init_live">init_live</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="ld10k1">
347 <term><command>ld10k1</command></term>
348 <listitem>
349 <para>is the server of a EMU10K{1,2} patch loader for ALSA.</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>is the client of a EMU10K{1,2} patch loader for ALSA.</para>
360 <indexterm zone="alsa-tools lo10k1">
361 <primary sortas="b-lo10k1">lo10k1</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="dl10k1">
367 <term><command>dl10k1</command></term>
368 <listitem>
369 <para>loads config dumps generated by <command>lo10k1</command>
370 and <command>ld10k1</command>.</para>
371 <indexterm zone="alsa-tools dl10k1">
372 <primary sortas="b-dl10k1">dl10k1</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 <varlistentry id="ld10k1d">
378 <term><command>ld10k1d</command></term>
379 <listitem>
380 <para>is an init script for the <command>ld10k1</command>
381 patch loader.</para>
382 <indexterm zone="alsa-tools ld10k1d">
383 <primary sortas="b-ld10k1d">ld10k1d</primary>
384 </indexterm>
385 </listitem>
386 </varlistentry>
387
388 <!-- No longer installed due to Qt2/3 dependency.
389 <varlistentry id="qlo10k1">
390 <term><command>qlo10k1</command></term>
391 <listitem>
392 <para>is a <application>Qt</application> GUI for the
393 <command>ld10k1</command> patch loader.</para>
394 <indexterm zone="alsa-tools qlo10k1">
395 <primary sortas="b-qlo10k1">qlo10k1</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399 -->
400
401 <varlistentry id="mixartloader">
402 <term><command>mixartloader</command></term>
403 <listitem>
404 <para>is a helper program to load the firmware binaries onto the
405 Digigram's miXart board sound drivers. The following modules require this
406 program: snd-mixart. These drivers don't work properly at all until the
407 certain firmwares are loaded, i.e. no PCM nor mixer devices will
408 appear.</para>
409 <indexterm zone="alsa-tools mixartloader">
410 <primary sortas="b-mixartloader">mixartloader</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="pcxhrloader">
416 <term><command>pcxhrloader</command></term>
417 <listitem>
418 <para>is a helper program to load the firmware binaries onto
419 Digigram's pcxhr compatible board sound drivers. The following modules
420 require this program: snd-pcxhr. These drivers don't work properly at all
421 until the certain firmwares are loaded, i.e. no PCM nor mixer devices will
422 appear.</para>
423 <indexterm zone="alsa-tools pcxhrloader">
424 <primary sortas="b-pcxhrloader">pcxhrloader</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 <varlistentry id="rmedigicontrol">
430 <term><command>rmedigicontrol</command></term>
431 <listitem>
432 <para>is a control tool for RME Digi32 and RME Digi96 sound cards.
433 It provides a graphical frontend for all the sound card controls and
434 switches.</para>
435 <indexterm zone="alsa-tools rmedigicontrol">
436 <primary sortas="b-rmedigicontrol">rmedigicontrol</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 <varlistentry id="sbiload">
442 <term><command>sbiload</command></term>
443 <listitem>
444 <para>is an OPL2/3 FM instrument loader for the
445 ALSA sequencer.</para>
446 <indexterm zone="alsa-tools sbiload">
447 <primary sortas="b-sbiload">sbiload</primary>
448 </indexterm>
449 </listitem>
450 </varlistentry>
451
452 <varlistentry id="sscape_ctl">
453 <term><command>sscape_ctl</command></term>
454 <listitem>
455 <para>is an ALSA SoundScape control utility.</para>
456 <indexterm zone="alsa-tools sscape_ctl">
457 <primary sortas="b-sscape_ctl">sscape_ctl</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 <varlistentry id="us428control">
463 <term><command>us428control</command></term>
464 <listitem>
465 <para>is a Tascam US-428 control program.</para>
466 <indexterm zone="alsa-tools us428control">
467 <primary sortas="b-us428control">us428control</primary>
468 </indexterm>
469 </listitem>
470 </varlistentry>
471
472 <varlistentry id="usx2yloader">
473 <term><command>usx2yloader</command></term>
474 <listitem>
475 <para>is a helper program to load the 2nd Phase firmware binaries
476 onto the Tascam USX2Y USB sound cards. It has proven to work so far for the
477 US122, US224 and US428. The snd-usb-usx2y module requires this program.</para>
478 <indexterm zone="alsa-tools usx2yloader">
479 <primary sortas="b-usx2yloader">usx2yloader</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="vxloader">
485 <term><command>vxloader</command></term>
486 <listitem>
487 <para>is a helper program to load the firmware binaries onto the
488 Digigram's VX-board sound drivers. The following modules require this program:
489 snd-vx222, snd-vxpocket, snd-vxp440. These drivers don't work properly at all
490 until the certain firmwares are loaded, i.e. no PCM nor mixer devices will
491 appear.</para>
492 <indexterm zone="alsa-tools vxloader">
493 <primary sortas="b-vxloader">vxloader</primary>
494 </indexterm>
495 </listitem>
496 </varlistentry>
497
498 </variablelist>
499
500 </sect2>
501
502</sect1>
Note: See TracBrowser for help on using the repository browser.