| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  | Legacy audio driver for YMF7xx PCI cards. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | FIRST OF ALL | 
					
						
							|  |  |  | ============ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   This code references YAMAHA's sample codes and data sheets. | 
					
						
							| 
									
										
										
										
											2011-04-04 15:04:46 -07:00
										 |  |  |   I respect and thank for all people they made open the information | 
					
						
							| 
									
										
										
										
											2005-04-16 15:20:36 -07:00
										 |  |  |   about YMF7xx cards. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   And this codes heavily based on Jeff Garzik <jgarzik@pobox.com>'s | 
					
						
							|  |  |  |   old VIA 82Cxxx driver (via82cxxx.c). I also respect him. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | DISCLIMER | 
					
						
							|  |  |  | ========= | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  This driver is currently at early ALPHA stage. It may cause serious | 
					
						
							|  |  |  |  damage to your computer when used. | 
					
						
							|  |  |  |  PLEASE USE IT AT YOUR OWN RISK. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ABOUT THIS DRIVER | 
					
						
							|  |  |  | ================= | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   This code enables you to use your YMF724[A-F], YMF740[A-C], YMF744, YMF754 | 
					
						
							|  |  |  |  cards. When enabled, your card acts as "SoundBlaster Pro" compatible card. | 
					
						
							|  |  |  |  It can only play 22.05kHz / 8bit / Stereo samples, control external MIDI | 
					
						
							|  |  |  |  port. | 
					
						
							|  |  |  |  If you want to use your card as recent "16-bit" card, you should use | 
					
						
							|  |  |  |  Alsa or OSS/Linux driver. Of course you can write native PCI driver for | 
					
						
							|  |  |  |  your cards :) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | USAGE | 
					
						
							|  |  |  | ===== | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  # modprobe ymfsb (options) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | OPTIONS FOR MODULE | 
					
						
							|  |  |  | ================== | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   io           : SB base address     (0x220, 0x240, 0x260, 0x280) | 
					
						
							|  |  |  |   synth_io     : OPL3 base address   (0x388, 0x398, 0x3a0, 0x3a8) | 
					
						
							|  |  |  |   dma          : DMA number          (0,1,3) | 
					
						
							|  |  |  |   master_volume: AC'97 PCM out Vol   (0-100) | 
					
						
							|  |  |  |   spdif_out    : SPDIF-out flag      (0:disable 1:enable) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  These options will change in future... | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | FREQUENCY | 
					
						
							|  |  |  | ========= | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   When playing sounds via this driver, you will hear its pitch is slightly | 
					
						
							|  |  |  |  lower than original sounds. Since this driver recognizes your card acts | 
					
						
							|  |  |  |  with 21.739kHz sample rates rather than 22.050kHz (I think it must be | 
					
						
							|  |  |  |  hardware restriction). So many players become tone deafness. | 
					
						
							|  |  |  |  To prevent this, you should express some options to your sound player | 
					
						
							|  |  |  |  that specify correct sample frequency. For example, to play your MP3 file | 
					
						
							|  |  |  |  correctly with mpg123, specify the frequency like following: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   %  mpg123 -r 21739 foo.mp3 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | SPDIF OUT | 
					
						
							|  |  |  | ========= | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |   With installing modules with option 'spdif_out=1', you can enjoy your | 
					
						
							|  |  |  |  sounds from SPDIF-out of your card (if it had). | 
					
						
							|  |  |  |  Its Fs is fixed to 48kHz (It never means the sample frequency become  | 
					
						
							|  |  |  |  up to 48kHz. All sounds via SPDIF-out also 22kHz samples). So your | 
					
						
							|  |  |  |  digital-in capable components has to be able to handle 48kHz Fs. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | COPYING | 
					
						
							|  |  |  | ======= | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  This program is free software; you can redistribute it and/or modify | 
					
						
							|  |  |  |  it under the terms of the GNU General Public License as published by | 
					
						
							|  |  |  |  the Free Software Foundation; either version 2, or (at your option) | 
					
						
							|  |  |  |  any later version. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  This program is distributed in the hope that it will be useful, but | 
					
						
							|  |  |  |  WITHOUT ANY WARRANTY; without even the implied warranty of | 
					
						
							|  |  |  |  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU | 
					
						
							|  |  |  |  General Public License for more details. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  You should have received a copy of the GNU General Public License | 
					
						
							|  |  |  |  along with this program; if not, write to the Free Software | 
					
						
							|  |  |  |  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | TODO | 
					
						
							|  |  |  | ==== | 
					
						
							|  |  |  |  * support for multiple cards | 
					
						
							|  |  |  |    (set the different SB_IO,MPU_IO,OPL_IO for each cards) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  * support for OPL (dmfm) : There will be no requirements... :-< | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | AUTHOR | 
					
						
							|  |  |  | ====== | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  Daisuke Nagano <breeze.nagano@nifty.ne.jp> | 
					
						
							|  |  |  | 
 |