[linux-2.6-block.git] / Documentation / sound / oss / PSS

The PSS cards and other ECHO based cards provide an onboard DSP with 
downloadable programs and also has an AD1848 "Microsoft Sound System" 
device. The PSS driver enables MSS and MPU401 modes of the card. SB 
is not enabled since it doesn't work concurrently with MSS. 

If you build this driver as a module then the driver takes the following
parameters

pss_io. 	The I/O base the PSS card is configured at (normally 0x220
		or 0x240)

mss_io		The base address of the Microsoft Sound System interface.
		This is normally 0x530, but may be 0x604 or other addresses.

mss_irq		The interrupt assigned to the Microsoft Sound System
		emulation. IRQ's 3,5,7,9,10,11 and 12 are available. If you
		get IRQ errors be sure to check the interrupt is set to 
		"ISA/Legacy" in the BIOS on modern machines.

mss_dma		The DMA channel used by the Microsoft Sound System.
		This can be 0, 1, or 3. DMA 0 is not available on older 
		machines and will cause a crash on them.

mpu_io		The MPU emulation base address. This sets the base of the
		synthesizer. It is typically 0x330 but can be altered.

mpu_irq		The interrupt to use for the synthesizer. It must differ
		from the IRQ used by the Microsoft Sound System port.


The mpu_io/mpu_irq fields are optional. If they are not specified the 
synthesizer parts are not configured.

When the module is loaded it looks for a file called 
/etc/sound/pss_synth. This is the firmware file from the DOS install disks.
This fil holds a general MIDI emulation. The file expected is called
genmidi.ld on newer DOS driver install disks and synth.ld on older ones.

You can also load alternative DSP algorithms into the card if you wish. One
alternative driver can be found at http://www.mpg123.de/
Commit	Line	Data
1da177e4 LT	1	The PSS cards and other ECHO based cards provide an onboard DSP with
	2	downloadable programs and also has an AD1848 "Microsoft Sound System"
	3	device. The PSS driver enables MSS and MPU401 modes of the card. SB
	4	is not enabled since it doesn't work concurrently with MSS.
	5
	6	If you build this driver as a module then the driver takes the following
	7	parameters
	8
	9	pss_io. The I/O base the PSS card is configured at (normally 0x220
	10	or 0x240)
	11
	12	mss_io The base address of the Microsoft Sound System interface.
	13	This is normally 0x530, but may be 0x604 or other addresses.
	14
	15	mss_irq The interrupt assigned to the Microsoft Sound System
	16	emulation. IRQ's 3,5,7,9,10,11 and 12 are available. If you
	17	get IRQ errors be sure to check the interrupt is set to
	18	"ISA/Legacy" in the BIOS on modern machines.
	19
	20	mss_dma The DMA channel used by the Microsoft Sound System.
	21	This can be 0, 1, or 3. DMA 0 is not available on older
	22	machines and will cause a crash on them.
	23
	24	mpu_io The MPU emulation base address. This sets the base of the
	25	synthesizer. It is typically 0x330 but can be altered.
	26
	27	mpu_irq The interrupt to use for the synthesizer. It must differ
	28	from the IRQ used by the Microsoft Sound System port.
	29
	30
	31	The mpu_io/mpu_irq fields are optional. If they are not specified the
	32	synthesizer parts are not configured.
	33
	34	When the module is loaded it looks for a file called
	35	/etc/sound/pss_synth. This is the firmware file from the DOS install disks.
	36	This fil holds a general MIDI emulation. The file expected is called
	37	genmidi.ld on newer DOS driver install disks and synth.ld on older ones.
	38
	39	You can also load alternative DSP algorithms into the card if you wish. One
	40	alternative driver can be found at http://www.mpg123.de/
	41