| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | Legacy audio driver for YMF7xx PCI cards. |
| 2 | |
| 3 | |
| 4 | FIRST OF ALL |
| 5 | ============ |
| 6 | |
| 7 | This code references YAMAHA's sample codes and data sheets. |
| 8 | I respect and thank for all people they made open the informations |
| 9 | about YMF7xx cards. |
| 10 | |
| 11 | And this codes heavily based on Jeff Garzik <jgarzik@pobox.com>'s |
| 12 | old VIA 82Cxxx driver (via82cxxx.c). I also respect him. |
| 13 | |
| 14 | |
| 15 | DISCLIMER |
| 16 | ========= |
| 17 | |
| 18 | This driver is currently at early ALPHA stage. It may cause serious |
| 19 | damage to your computer when used. |
| 20 | PLEASE USE IT AT YOUR OWN RISK. |
| 21 | |
| 22 | |
| 23 | ABOUT THIS DRIVER |
| 24 | ================= |
| 25 | |
| 26 | This code enables you to use your YMF724[A-F], YMF740[A-C], YMF744, YMF754 |
| 27 | cards. When enabled, your card acts as "SoundBlaster Pro" compatible card. |
| 28 | It can only play 22.05kHz / 8bit / Stereo samples, control external MIDI |
| 29 | port. |
| 30 | If you want to use your card as recent "16-bit" card, you should use |
| 31 | Alsa or OSS/Linux driver. Of course you can write native PCI driver for |
| 32 | your cards :) |
| 33 | |
| 34 | |
| 35 | USAGE |
| 36 | ===== |
| 37 | |
| 38 | # modprobe ymfsb (options) |
| 39 | |
| 40 | |
| 41 | OPTIONS FOR MODULE |
| 42 | ================== |
| 43 | |
| 44 | io : SB base address (0x220, 0x240, 0x260, 0x280) |
| 45 | synth_io : OPL3 base address (0x388, 0x398, 0x3a0, 0x3a8) |
| 46 | dma : DMA number (0,1,3) |
| 47 | master_volume: AC'97 PCM out Vol (0-100) |
| 48 | spdif_out : SPDIF-out flag (0:disable 1:enable) |
| 49 | |
| 50 | These options will change in future... |
| 51 | |
| 52 | |
| 53 | FREQUENCY |
| 54 | ========= |
| 55 | |
| 56 | When playing sounds via this driver, you will hear its pitch is slightly |
| 57 | lower than original sounds. Since this driver recognizes your card acts |
| 58 | with 21.739kHz sample rates rather than 22.050kHz (I think it must be |
| 59 | hardware restriction). So many players become tone deafness. |
| 60 | To prevent this, you should express some options to your sound player |
| 61 | that specify correct sample frequency. For example, to play your MP3 file |
| 62 | correctly with mpg123, specify the frequency like following: |
| 63 | |
| 64 | % mpg123 -r 21739 foo.mp3 |
| 65 | |
| 66 | |
| 67 | SPDIF OUT |
| 68 | ========= |
| 69 | |
| 70 | With installing modules with option 'spdif_out=1', you can enjoy your |
| 71 | sounds from SPDIF-out of your card (if it had). |
| 72 | Its Fs is fixed to 48kHz (It never means the sample frequency become |
| 73 | up to 48kHz. All sounds via SPDIF-out also 22kHz samples). So your |
| 74 | digital-in capable components has to be able to handle 48kHz Fs. |
| 75 | |
| 76 | |
| 77 | COPYING |
| 78 | ======= |
| 79 | |
| 80 | This program is free software; you can redistribute it and/or modify |
| 81 | it under the terms of the GNU General Public License as published by |
| 82 | the Free Software Foundation; either version 2, or (at your option) |
| 83 | any later version. |
| 84 | |
| 85 | This program is distributed in the hope that it will be useful, but |
| 86 | WITHOUT ANY WARRANTY; without even the implied warranty of |
| 87 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 88 | General Public License for more details. |
| 89 | |
| 90 | You should have received a copy of the GNU General Public License |
| 91 | along with this program; if not, write to the Free Software |
| 92 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
| 93 | |
| 94 | |
| 95 | TODO |
| 96 | ==== |
| 97 | * support for multiple cards |
| 98 | (set the different SB_IO,MPU_IO,OPL_IO for each cards) |
| 99 | |
| 100 | * support for OPL (dmfm) : There will be no requirements... :-< |
| 101 | |
| 102 | |
| 103 | AUTHOR |
| 104 | ====== |
| 105 | |
| 106 | Daisuke Nagano <breeze.nagano@nifty.ne.jp> |
| 107 | |