1da177e4c3
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
108 lines
3.1 KiB
Plaintext
108 lines
3.1 KiB
Plaintext
Legacy audio driver for YMF7xx PCI cards.
|
|
|
|
|
|
FIRST OF ALL
|
|
============
|
|
|
|
This code references YAMAHA's sample codes and data sheets.
|
|
I respect and thank for all people they made open the informations
|
|
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>
|
|
|