Matrix:Module-asihpi - Revision history

EliotBlennerhassett: add example volume control names

2012-04-30T23:36:41Z

add example volume control names

2012-04-26T21:08:17Z

update module parameters

2012-04-26T00:11:13Z

update ALSA to HPI name translation

2011-05-31T22:44:55Z

2011-05-31T22:43:24Z

mention merge with mainline kernel

2008-06-16T23:36:55Z

card master samplerate now set with clock LocalRate control

2008-01-24T11:53:56Z

Categories: x86; Template:Modinfo; Link to AudioScience driver fixed

2007-12-24T01:45:22Z

Update info about control naming

2007-08-31T08:50:06Z

more about controls

2007-08-31T08:26:08Z

expand linked streams info, provide example asoundrc

@@ Line 33: / Line 33: @@
 === Mixer ===
 ==== control names ====
-Controls use ALSA naming conventions that differ from AudioScience HPI names. The following table summarises the translation
+Controls use ALSA naming conventions that differ from AudioScience HPI names.
 {| border="1"
@@ Line 62: / Line 62: @@
 | Switch
 | Mute
 |}
-HPI "LineOut 0 Level" becomes ALSA "Line 0 Playback Level"
+For example HPI "LineOut 0 Level" becomes ALSA "Line 0 Playback Level"
 ==== setting card master samplerate ====

@@ Line 221: / Line 221: @@
 |id:ID string for AudioScience soundcard. (charp)
 |enable:Enable card(bool)
-|hpiDebugLevel:Debug level for Audioscience HPI 0:none..5:verbose (int)
+|enable_hpi_hwdep:ALSA enable HPI hwdep for AudioScience soundcard  (bool)
-|major:Device major number for HPI device(int)
+|hpi_debug_level:Debug level for Audioscience HPI 0:none..5:verbose (int)
-|bufsize:Buffer size to allocate for data transfer from HPI ioctl  (int)}}
+|prealloc_stream_buf:Preallocate size for per-adapter stream buffer (int)}}
 {{Matrix:Soundcard|name=AudioScience ASIxxxx|module=asihpi}}

@@ Line 33: / Line 33: @@
 === Mixer ===
 ==== control names ====
-By default the controls have names that follow AudioScience naming conventions. These reflect ASI documentation and will be familiar to users of the card via HPI or windows drivers.
+Controls use ALSA naming conventions that differ from AudioScience HPI names. The following table summarises the translation
-Main differences: OutStream == PCM Playback,  InStream == PCM Capture, AesIn == Digital in
+{| border="1"
-It is possible to build the driver with more ALSA-style names by editing asihpi.c and removing the definition ASI_STYLE_NAMES
+HPI "LineOut 0 Level" becomes ALSA "Line 0 Playback Level"
-−
-As of about 20071101 the controls no longer use indices (all have index=0).  The node indices have been assimilated into the control names. E.g. "Outstream to Lineout3", 4 has become Outstream3 to Lineout3.
-All indices are now zero-based, corresponding to PCM substream numbering.
 ==== setting card master samplerate ====

@@ Line 8: / Line 8: @@
 === Additional Installation notes===
-The asihpi driver was merged with mainline kernel at version 2.6.34.  However, to keep up with latest developments you may need to build from source.
+The asihpi driver was merged with mainline kernel at version 2.6.35.  However, to keep up with latest developments you may need to build from source.
 In addition to the alsa-driver source package, the matching alsa-firmware package must be downloaded, and run "make install" in the asihpi subdirectory.

@@ Line 7: / Line 7: @@
 ==Card Specific Information==
 === Additional Installation notes===
-The asihpi driver is not yet in the official kernel part of ALSA, so must be built from source.
 In addition to the alsa-driver source package, the matching alsa-firmware package must be downloaded, and run "make install" in the asihpi subdirectory.

@@ Line 44: / Line 44: @@
 Most cards will have a Sample Rate control.  This sets the master samplerate for the card.  The default rate will be 44100 or 48000.  Setting this to the same rate as your source material means that the card will not have to do sample rate conversion.
-Read the control <tt>amixer -c1 cget name='Clock0 Rate'</tt>
+Read the control <tt>amixer -c1 cget name='Clock0 LocalRate'</tt>
-Set a new rate <tt>amixer -c1 cset name='Clock0 Rate' 48000</tt>
+Set a new rate <tt>amixer -c1 cset name='Clock0 LocalRate' 48000</tt>
 ==== Level controls ====

@@ Line 1: / Line 1: @@
 Driver for cards from [[Matrix:Vendor-AudioScience]]
 {| align="right"
@@ Line 9: / Line 11: @@
 In addition to the alsa-driver source package, the matching alsa-firmware package must be downloaded, and run "make install" in the asihpi subdirectory.
-If you have installed the hpklinux driver available from [http://audioscience.com/internet/download/linux_drivers.htm|AudioScience website],  you will end up with two different drivers that can claim the cards.
+If you have installed the hpklinux driver available from [http://audioscience.com/internet/download/linux_drivers.htm AudioScience website],  you will end up with two different drivers that can claim the cards.
 To avoid unexpected behaviour, either remove one of the drivers or blacklist one or both E.g add "blacklist asihpi" to /etc/modprobe.d/blacklist.  If both drivers are blacklisted, it is still possible to load either of them manually using modprobe.
@@ Line 187: / Line 189: @@
 # Limited use of large on card buffers
-{{Template:Modinfo
+{{Modinfo
 |module=asihpi
 |description=AudioScience sound or tuner card

@@ Line 29: / Line 29: @@
 === Mixer ===
-# mixer controls, rationale for indexing
+==== control names ====
-# control names
+By default the controls have names that follow AudioScience naming conventions. These reflect ASI documentation and will be familiar to users of the card via HPI or windows drivers.
-# setting card master samplerate
 === Linked streams ===

@@ Line 34: / Line 34: @@
 === Linked streams ===
-which cards support HW linking, what to put in asoundrc
 === Capabilities and limitations ===