linux/Documentation/sound/oss
Linus Torvalds faa38b5e0e Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/tiwai/sound-2.6
* 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/tiwai/sound-2.6: (214 commits)
  ALSA: hda - Add pin-fix for HP dc5750
  ALSA: als4000: Fix potentially invalid DMA mode setup
  ALSA: als4000: enable burst mode
  ALSA: hda - Fix initial capsrc selection in patch_alc269()
  ASoC: TWL4030: Capture route runtime DAPM ordering fix
  ALSA: hda - Add PC-beep whitelist for an Intel board
  ALSA: hda - More relax for pending period handling
  ALSA: hda - Define AC_FMT_* constants
  ALSA: hda - Fix beep frequency on IDT 92HD73xx and 92HD71Bxx codecs
  ALSA: hda - Add support for HDMI HBR passthrough
  ALSA: hda - Set Stream Type in Stream Format according to AES0
  ALSA: hda - Fix Thinkpad X300 so SPDIF is not exposed
  ALSA: hda - FIX to not expose SPDIF on Thinkpad X301, since it does not have the ability to use SPDIF
  ASoC: wm9081: fix resource reclaim in wm9081_register error path
  ASoC: wm8978: fix a memory leak if a wm8978_register fail
  ASoC: wm8974: fix a memory leak if another WM8974 is registered
  ASoC: wm8961: fix resource reclaim in wm8961_register error path
  ASoC: wm8955: fix resource reclaim in wm8955_register error path
  ASoC: wm8940: fix a memory leak if wm8940_register return error
  ASoC: wm8904: fix resource reclaim in wm8904_register error path
  ...
2010-08-07 17:07:31 -07:00
..
ALS
AudioExcelDSP16
btaudio
CMI8330
ESS
ESS1868
Introduction
MultiSound
mwave
OPL3
Opti
oss-parameters.txt sound: move driver parameters to their own files 2010-06-08 16:40:35 +02:00
PAS16
PSS
PSS-updates
README.modules
README.OSS Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
README.ymfsb
Soundblaster
SoundPro
Tropez+
ultrasound
VIBRA16
vwsnd
WaveArtist

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>