89 lines
		
	
	
	
		
			4.8 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
		
		
			
		
	
	
			89 lines
		
	
	
	
		
			4.8 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
| 
								 | 
							
									This file contains notes for users of PSS sound cards who wish to use the 
							 | 
						||
| 
								 | 
							
								newly added features of the newest version of this driver.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									The major enhancements present in this new revision of this driver is the 
							 | 
						||
| 
								 | 
							
								addition of two new module parameters that allow you to take full advantage of 
							 | 
						||
| 
								 | 
							
								all the features present on your PSS sound card.  These features include the 
							 | 
						||
| 
								 | 
							
								ability to enable both the builtin CDROM and joystick ports.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								pss_enable_joystick
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									This parameter is basically a flag.  A 0 will leave the joystick port 
							 | 
						||
| 
								 | 
							
								disabled, while a non-zero value would enable the joystick port.  The default 
							 | 
						||
| 
								 | 
							
								setting is pss_enable_joystick=0 as this keeps this driver fully compatible 
							 | 
						||
| 
								 | 
							
								with systems that were using previous versions of this driver.  If you wish to 
							 | 
						||
| 
								 | 
							
								enable the joystick port you will have to add pss_enable_joystick=1 as an 
							 | 
						||
| 
								 | 
							
								argument to the driver.  To actually use the joystick port you will then have 
							 | 
						||
| 
								 | 
							
								to load the joystick driver itself.  Just remember to load the joystick driver 
							 | 
						||
| 
								 | 
							
								AFTER the pss sound driver.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								pss_cdrom_port
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									This parameter takes a port address as its parameter.  Any available port 
							 | 
						||
| 
								 | 
							
								address can be specified to enable the CDROM port, except for 0x0 and -1 as 
							 | 
						||
| 
								 | 
							
								these values would leave the port disabled.  Like the joystick port, the cdrom 
							 | 
						||
| 
								 | 
							
								port will require that an appropriate CDROM driver be loaded before you can make 
							 | 
						||
| 
								 | 
							
								use of the newly enabled CDROM port.  Like the joystick port option above, 
							 | 
						||
| 
								 | 
							
								remember to load the CDROM driver AFTER the pss sound driver.  While it may 
							 | 
						||
| 
								 | 
							
								differ on some PSS sound cards, all the PSS sound cards that I have seen have a 
							 | 
						||
| 
								 | 
							
								builtin Wearnes CDROM port.  If this is the case with your PSS sound card you 
							 | 
						||
| 
								 | 
							
								should load aztcd with the appropriate port option that matches the port you 
							 | 
						||
| 
								 | 
							
								assigned to the CDROM port when you loaded your pss sound driver.  (ex. 
							 | 
						||
| 
								 | 
							
								modprobe pss pss_cdrom_port=0x340 && modprobe aztcd aztcd=0x340)  The default 
							 | 
						||
| 
								 | 
							
								setting of this parameter leaves the CDROM port disabled to maintain full 
							 | 
						||
| 
								 | 
							
								compatibility with systems using previous versions of this driver.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									Other options have also been added for the added convenience and utility 
							 | 
						||
| 
								 | 
							
								of the user.  These options are only available if this driver is loaded as a 
							 | 
						||
| 
								 | 
							
								module.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								pss_no_sound
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									This module parameter is a flag that can be used to tell the driver to 
							 | 
						||
| 
								 | 
							
								just configure non-sound components.  0 configures all components, a non-0 
							 | 
						||
| 
								 | 
							
								value will only attept to configure the CDROM and joystick ports.  This 
							 | 
						||
| 
								 | 
							
								parameter can be used by a user who only wished to use the builtin joystick 
							 | 
						||
| 
								 | 
							
								and/or CDROM port(s) of his PSS sound card.  If this driver is loaded with this 
							 | 
						||
| 
								 | 
							
								parameter and with the parameter below set to true then a user can safely unload 
							 | 
						||
| 
								 | 
							
								this driver with the following command "rmmod pss && rmmod ad1848 && rmmod 
							 | 
						||
| 
								 | 
							
								mpu401 && rmmod sound && rmmod soundcore" and retain the full functionality of 
							 | 
						||
| 
								 | 
							
								his CDROM and/or joystick port(s) while gaining back the memory previously used 
							 | 
						||
| 
								 | 
							
								by the sound drivers.  This default setting of this parameter is 0 to retain 
							 | 
						||
| 
								 | 
							
								full behavioral compatibility with previous versions of this driver.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								pss_keep_settings
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									This parameter can be used to specify whether you want the driver to reset 
							 | 
						||
| 
								 | 
							
								all emulations whenever its unloaded.  This can be useful for those who are 
							 | 
						||
| 
								 | 
							
								sharing resources (io ports, IRQ's, DMA's) between different ISA cards.  This 
							 | 
						||
| 
								 | 
							
								flag can also be useful in that future versions of this driver may reset all 
							 | 
						||
| 
								 | 
							
								emulations by default on the driver's unloading (as it probably should), so 
							 | 
						||
| 
								 | 
							
								specifying it now will ensure that all future versions of this driver will 
							 | 
						||
| 
								 | 
							
								continue to work as expected.  The default value of this parameter is 1 to 
							 | 
						||
| 
								 | 
							
								retain full behavioral compatibility with previous versions of this driver.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								pss_firmware
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
									This parameter can be used to specify the file containing the firmware 
							 | 
						||
| 
								 | 
							
								code so that a user could tell the driver where that file is located instead 
							 | 
						||
| 
								 | 
							
								of having to put it in a predefined location with a predefined name.  The 
							 | 
						||
| 
								 | 
							
								default setting of this parameter is "/etc/sound/pss_synth" as this was the 
							 | 
						||
| 
								 | 
							
								path and filename the hardcoded value in the previous versions of this driver.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Examples:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Normal PSS sound card system, loading of drivers.
							 | 
						||
| 
								 | 
							
								# Should be specified in an rc file (ex. Slackware uses /etc/rc.d/rc.modules).
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/sbin/modprobe pss pss_io=0x220 mpu_io=0x338 mpu_irq=9 mss_io=0x530 mss_irq=10 mss_dma=1 pss_cdrom_port=0x340 pss_enable_joystick=1
							 | 
						||
| 
								 | 
							
								/sbin/modprobe aztcd aztcd=0x340
							 | 
						||
| 
								 | 
							
								/sbin/modprobe joystick
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# System using the PSS sound card just for its CDROM and joystick ports.
							 | 
						||
| 
								 | 
							
								# Should be specified in an rc file (ex. Slackware uses /etc/rc.d/rc.modules).
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/sbin/modprobe pss pss_io=0x220 pss_cdrom_port=0x340 pss_enable_joystick=1 pss_no_sound=1
							 | 
						||
| 
								 | 
							
								/sbin/rmmod pss && /sbin/rmmod ad1848 && /sbin/rmmod mpu401 && /sbin/rmmod sound && /sbin/rmmod soundcore  # This line not needed, but saves memory.
							 | 
						||
| 
								 | 
							
								/sbin/modprobe aztcd aztcd=0x340
							 | 
						||
| 
								 | 
							
								/sbin/modprobe joystick
							 |