source: multimedia/libdriv/alsa-tools.xml@ 44621c7

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 44621c7 was 858803f, checked in by Douglas R. Reno <renodr@…>, 4 years ago

alsa-tools: Fix the build of cspctl. ld10k1 will have to wait until after 9.1 is released (fixed as part of alsa-lib1.2.2 I think)

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