AMD Geode(TM) LX/GX Processor and AMD Geode(TM) CS5536/CS5535 Companion Device
Linux ALSA Audio Driver - Release Notes
Version: 01.00.0500, General Release
Release Date: July 21, 2005

--------------------------------------------------------------------------------
PRODUCT INFORMATION  
--------------------------------------------------------------------------------
Developed under Linux Kernel 2.6.11 

This product includes: 
- os_inc.c
- os_inc.h
- amd_geode.c
- amd_geode.h
- configure.ac
- Makefile.in
- README (this file)
- AUTHORS
- COPYING


Features
--------
- Playback of audio files in all formats including MP3 files
- Recording of audio files in all formats
- AC97 interface 
- Compatible with AD1819 codec
- Compatible with 2.6.x Kernel

Applications Tested:

Playback:

- XMMS
- gmplayer (1.06pre-RPKM-3.4.2 over OSS )
- noatun
- aumix
- XINE player
- alsaplayer
- QuakeII 
- aplay
- sox play

Recording:  
- arecord
- sox rec 


Dependencies 
------------
- Linux Kernel 2.6.11
- ALSA rel. 1.6
- kernel patch v01.01.0302 or later (AC97 support,pcm_oss.c patch).
- To support OSS-based applications which use MMAP (like quake2) it is 
  necessary to patch the file pcm_oss.c in the kernel tree at 
  "/linux-2.6.11/sound/core/oss".   Without this, the application is not 
  able to open the driver correctly!


Functional Changes
------------------
- Bug #2825:  MIC Mixer at 0, MIC not muted [ALSA]
- Bug #3761:  linux 2.6 l-16.001-036 ALSA garbled playback of recorded cd, 
  line, mic files
- Bug #2707   README corrections [ALSA]


Defects Corrected
-----------------
Issue: PBZ#2825 MIC Mixer at 0,  MIC not muted [ALSA]
Description: 
The Mixer sliders in alsamixer and aumix for PCM, LINE, CD, and MIC devices 
move audio consistently down from 100 to 50 (although 50 drops the volume to 
silent).  At 49, the volume jumps back up to Full volume and then keeps moving 
down as you move to 0.  
Resolution: 
Corrected an ALSA layer probing problem.

Issue: PBZ#3761 ALSA garbled playback of recorded cd, line, mic files
Description: 
At 12000 Hz, files recorded using arecord/ALSA and played back with a
play/ALSA have "garbled" playback. Playback was not garbled during play/OSS 
emulation playback.
Resolution: 
Under any circumstances arecord chooses non-integer values for buffer-size and 
period-size. This leads to a moving interrupt pointer which was still not 
implemented for capturing.

Known Errata
------------
PBZ#5989 MPLAYER - A/V Sync is off, Video ahead of Audio

--------------------------------------------------------------------------------
VALIDATION ENVIRONMENT
--------------------------------------------------------------------------------
Validated on AMD Geode(TM) Norwich Development Board - Rev 2 Rework H and
Rev 3 Rework E with:

Processor:		AMD Geode LX processor, silicon rev. C1 @ 433 MHz
Chipset:		AMD Geode CS5536, silicon rev. B1
PCI Bus Speed:		66 MHz
Memory:			256 MB PC3200 RAM
CRT:			NEC MultiSync FP2141SB
Flat Panel:		Samsung LTM213U3-L07 1600x1200 2-channel LVDS,
Keyboard/Mouse:		PS/2 on Moray 1.1
	
BIOS:			GeodeROM 1.06.06
Operating System:	Gentoo 2005.0
Kernel:			v2.6.11
Kernel Patch:		LX Kernel Patch v02.02.0100
Graphics Driver:	LX Xorg Graphics driver v03.00.0100
Audio Driver:		5536 ALSA Audio driver v01.00.0500
AES Driver: 		LX AES driver v02.01.0100
AccessBus Driver: 	LX ACB Driver v01.00.0401
Video4Linux2 Driver: 	LX Video4Linux2 driver v03.02.0100
Other Software:		N/A	

--------------------------------------------------------------------------------
INSTALLATION INSTRUCTIONS  
--------------------------------------------------------------------------------

Kernel Configuration
---------------------
- In order to use audio drivers under Linux, the ALSA
  modules have to be installed.  

  How to build the Kernel with the ALSA installed:

     1.  Type: "cd /usr/src/linux"
     2.  Type: "make menuconfig"
     3.  Select "Loadable module support" and un-check 
         "Module versioning support" if set.
     4.  Select "Device Drivers" option
     5.  Select "Sound" 
     6.  Select "Advanced Linux Sound Architecture" 
     7.  Select "PCI Devices"
     8.  Check "AC97" (press M to include as a module) 
     9.  From the main menu select exit, when prompted to save config, 
         say yes."  This will separate the enabling sound step from the 
         exit/save step and the build step.
         Save configuration and exit

     Build kernel/modules and install as described in README.kernel.txt


Compiling and installing the driver (standalone):
-----------------------------------------------------------------------    
- After unpacking the tarball, which contains the files listed above
  in a plain directory,  run :
  1. autoconf  (builds .configure)
  2. ./configure --with-kernel-path= "your path to the kernel sources"
  3. make install

    You need to have root permissions to build and install the driver.
  Follow the instructions of the install script
  The built driver will be located in the local directory as well as in
  /lib/modules/$kernel-path/kernel/drivers/misc
  (Make sure that module support is enabled in the kernel configuration)
         
  !!!! Additionally it's required to build the kernel with enabled 
  ALSA - ac97 driver.  When the ac97 driver is not available, the amd_geode 
  audio driver cannot be loaded!!
  (see above) 

- run alsaconf  

The OSS emulation documentation can be found under 
$(KERNELDIR)/Documentation/sound/oss or on the internet at 
http://www.alsa-project.org/~iwai/OSS-Emulation.html

--------------------------------------------------------------------------------
RELEASE HISTORY (Previous Version)
--------------------------------------------------------------------------------
Version: 01.00.0405
Release Date: May 26, 2005


Dependencies 
------------
- Linux Kernel 2.6.11
- ALSA rel. 1.6
- kernel patch v01.01.0302 or later (AC97 support,pcm_oss.c patch).
- To support OSS-based applications that use MMAP (like quake2) it's necessary
to patch the file pcm_oss.c in the kernel tree at "/linux-2.6.11/sound/core/oss"
Without this, the application is not able to open the driver correctly!


Functional Changes
------------------
- First release

Defects Corrected
-----------------
- First release

Known Errata
------------
Issue: #2825 MIC Mixer at 0,  MIC not muted [ALSA]
Description: 
The Mixer sliders in alsamixer and aumix for PCM, LINE, CD, and MIC devices move
audio consistently down from 100 to 50 (although 50 drops the volume to silent).  
At 49, the volume jumps back up to Full volume and then keeps moving down as 
you move to 0.
Resolution: 
Driver issue to be fixed with the next release.

Issue: #3761 ALSA garbled playback of recorded cd, line, mic files
Description: 
At 12000 Hz, files recorded using arecord/ALSA and played back with aplay/ALSA 
have "garbled" playback. Playback was not garbled during play/OSS emulation 
playback.
Resolution: 
Driver issue to be fixed with the next release.

================================================================================
Copyright
---------
Copyright 2005 Advanced Micro Devices, Inc. All rights reserved.
The contents of this document are provided in connection with Advanced Micro 
Devices, Inc. ("AMD") products. AMD makes no representations or warranties 
with respect to the accuracy or completeness of the contents of this 
publication and reserves the right to make changes to specifications and
product descriptions at any time without notice. No license, whether express,
implied, arising by estoppel or otherwise, to any intellectual property rights
is granted by this publication. Except as set forth in AMD's Standard Terms
and Conditions of Sale, AMD assumes no liability whatsoever, and disclaims any
express or implied warranty, relating to its products including, but not
limited to, the implied warranty of merchantability, fitness for a particular
purpose, or infringement of any intellectual property right. AMD's products
are not designed, intended, authorized or warranted for use as components in
systems intended for surgical implant into the body, or in other applications
intended to support or sustain life, or in any other application in which the
failure of AMD's product could create a situation where personal injury, death,
or severe property or environmental damage may occur. AMD reserves the right
to discontinue or make changes to its products at any time without notice.


Trademarks
----------
AMD, the AMD Arrow logo, and combinations thereof, and Geode are trademarks 
of Advanced Micro Devices, Inc.

Other product names used in this publication are for identification purposes
only and may be trademarks of their respective companies.
================================================================================
