Matrix:Module-asihpi - Revision history

EliotBlennerhassett: add example volume control names

2012-04-30T23:36:41Z

add example volume control names

← Older revision		Revision as of 23:36, 30 April 2012
Line 33:		Line 33:
	=== Mixer ===		=== Mixer ===
	==== control names ====		==== 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"		{\| border="1"
Line 62:		Line 62:
	\| Switch		\| Switch
	\| Mute		\| Mute
			\|-
			\| Volume, Level, Meter
			\| same
	\|}		\|}

	HPI "LineOut 0 Level" becomes ALSA "Line 0 Playback Level"		For example HPI "LineOut 0 Level" becomes ALSA "Line 0 Playback Level"

			The general format for an ALSA control name is "SOURCE SINK DIRECTION TYPE". Some examples<br>
			"PCM 0 Playback Volume" = master volume of player 0<br>
			"PCM 0 Line 0 Playback Volume" = matrix volume between player 0 and output 0<br>
			"Line 0 Line 0 Monitor Playback Volume" = feedthrough volume from input 0 to output 0<br>
			"PCM 0 Capture Route" = select one source for recorder 0 (more common)<br>
			"Line 0 PCM 0 Capture Volume" = matrix volume between input 0 and recorder 0 (less common alternative to capture route)

	==== setting card master samplerate ====		==== setting card master samplerate ====

EliotBlennerhassett: update module parameters

2012-04-26T21:08:17Z

update module parameters

← Older revision		Revision as of 21:08, 26 April 2012
Line 221:		Line 221:
	\|id:ID string for AudioScience soundcard. (charp)		\|id:ID string for AudioScience soundcard. (charp)
	\|enable:Enable card(bool)		\|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}}		{{Matrix:Soundcard\|name=AudioScience ASIxxxx\|module=asihpi}}

EliotBlennerhassett: update ALSA to HPI name translation

2012-04-26T00:11:13Z

update ALSA to HPI name translation

@@ 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"
 ==== setting card master samplerate ====

EliotBlennerhassett at 22:44, 31 May 2011

2011-05-31T22:44:55Z

← Older revision		Revision as of 22:44, 31 May 2011
Line 8:		Line 8:
	=== Additional Installation notes===		=== 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.		In addition to the alsa-driver source package, the matching alsa-firmware package must be downloaded, and run "make install" in the asihpi subdirectory.

EliotBlennerhassett: mention merge with mainline kernel

2011-05-31T22:43:24Z

mention merge with mainline kernel

← Older revision		Revision as of 22:43, 31 May 2011
Line 7:		Line 7:
	==Card Specific Information==		==Card Specific Information==
	=== Additional Installation notes===		=== Additional Installation notes===
	The asihpi driver ~~is not yet in the official~~ kernel ~~part of ALSA~~, ~~so must be built~~ from source.
			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.

	In addition to the alsa-driver source package, the matching alsa-firmware package must be downloaded, and run "make install" in the asihpi subdirectory.		In addition to the alsa-driver source package, the matching alsa-firmware package must be downloaded, and run "make install" in the asihpi subdirectory.

EliotBlennerhassett: card master samplerate now set with clock LocalRate control

2008-06-16T23:36:55Z

card master samplerate now set with clock LocalRate control

← Older revision		Revision as of 23:36, 16 June 2008
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.		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 ====		==== Level controls ====

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

2008-01-24T11:53:56Z

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

← Older revision		Revision as of 11:53, 24 January 2008
Line 1:		Line 1:
			[[Category:Architecture-x86]]

	Driver for cards from [[Matrix:Vendor-AudioScience]]		Driver for cards from [[Matrix:Vendor-AudioScience]]
	{\| align="right"		{\| 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.		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.		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		# Limited use of large on card buffers

	{{~~Template:~~Modinfo		{{Modinfo
	\|module=asihpi		\|module=asihpi
	\|description=AudioScience sound or tuner card		\|description=AudioScience sound or tuner card

EliotBlennerhassett: Update info about control naming

2007-12-24T01:45:22Z

Update info about control naming

← Older revision		Revision as of 01:45, 24 December 2007
Line 36:		Line 36:
	It is possible to build the driver with more ALSA-style names by editing asihpi.c and removing the definition ASI_STYLE_NAMES		It is possible to build the driver with more ALSA-style names by editing asihpi.c and removing the definition ASI_STYLE_NAMES

	~~==== rationale for indexing ====~~		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.
	~~Controls with~~ the ~~same name~~ have ~~indices starting at '1'. This is because '''alsamixer''' displays controls with~~ index=0 ~~differently~~. Eg "~~OutStream" not "OutStream 0~~"~~. In addition~~, ~~the cables/breakout boxes supplied with the cards are numbered starting from 1~~.		All indices are now zero-based, corresponding to PCM substream numbering.

	~~However~~, ~~this can lead~~ to ~~confusion where control 1 corresponds to alsa stream 0~~. :(

	==== setting card master samplerate ====		==== setting card master samplerate ====
	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.		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 ~~iface=MIXER,~~name='~~Clock~~ Rate'~~,index=1~~</tt>		Read the control <tt>amixer -c1 cget name='Clock0 Rate'</tt>

	Set a new rate <tt>amixer -c1 cset ~~iface=MIXER,~~name='~~Clock~~ Rate'~~,index=1~~ 48000</tt>		Set a new rate <tt>amixer -c1 cset name='Clock0 Rate' 48000</tt>

	==== Level controls ====		==== Level controls ====

EliotBlennerhassett: more about controls

2007-08-31T08:50:06Z

more about controls

@@ 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 ===

EliotBlennerhassett: expand linked streams info, provide example asoundrc

2007-08-31T08:26:08Z

expand linked streams info, provide example asoundrc

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