1README for MIPS AU1XXX IDE driver - Released 2005-07-15
  2
  3ABOUT
  4-----
  5This file describes the 'drivers/ide/au1xxx-ide.c', related files and the
  6services they provide.
  7
  8If you are short in patience and just want to know how to add your hard disc to
  9the white or black list, go to the 'ADD NEW HARD DISC TO WHITE OR BLACK LIST'
 10section.
 11
 12
 13LICENSE
 14-------
 15
 16Copyright (c) 2003-2005 AMD, Personal Connectivity Solutions
 17
 18This program is free software; you can redistribute it and/or modify it under
 19the terms of the GNU General Public License as published by the Free Software
 20Foundation; either version 2 of the License, or (at your option) any later
 21version.
 22
 23THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
 24INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 25FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR
 26BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 27CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 28SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 29INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 30CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 31ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 32POSSIBILITY OF SUCH DAMAGE.
 33
 34You should have received a copy of the GNU General Public License along with
 35this program; if not, write to the Free Software Foundation, Inc.,
 36675 Mass Ave, Cambridge, MA 02139, USA.
 37
 38Note: for more information, please refer "AMD Alchemy Au1200/Au1550 IDE
 39      Interface and Linux Device Driver" Application Note.
 40
 41
 42FILES, CONFIGS AND COMPATIBILITY
 43--------------------------------
 44
 45Two files are introduced:
 46
 47  a) 'arch/mips/include/asm/mach-au1x00/au1xxx_ide.h'
 48     contains : struct _auide_hwif
 49                 timing parameters for PIO mode 0/1/2/3/4
 50                 timing parameters for MWDMA 0/1/2
 51
 52  b) 'drivers/ide/mips/au1xxx-ide.c'
 53     contains the functionality of the AU1XXX IDE driver
 54
 55Following extra configs variables are introduced:
 56
 57  CONFIG_BLK_DEV_IDE_AU1XXX_PIO_DBDMA    - enable the PIO+DBDMA mode
 58  CONFIG_BLK_DEV_IDE_AU1XXX_MDMA2_DBDMA  - enable the MWDMA mode
 59
 60
 61SUPPORTED IDE MODES
 62-------------------
 63
 64The AU1XXX IDE driver supported all PIO modes - PIO mode 0/1/2/3/4 - and all
 65MWDMA modes - MWDMA 0/1/2 -. There is no support for SWDMA and UDMA mode.
 66
 67To change the PIO mode use the program hdparm with option -p, e.g.
 68'hdparm -p0 [device]' for PIO mode 0. To enable the MWDMA mode use the option
 69-X, e.g. 'hdparm -X32 [device]' for MWDMA mode 0.
 70
 71
 72PERFORMANCE CONFIGURATIONS
 73--------------------------
 74
 75If the used system doesn't need USB support enable the following kernel configs:
 76
 77CONFIG_IDE=y
 78CONFIG_BLK_DEV_IDE=y
 79CONFIG_IDE_GENERIC=y
 80CONFIG_BLK_DEV_IDEPCI=y
 81CONFIG_BLK_DEV_GENERIC=y
 82CONFIG_BLK_DEV_IDEDMA_PCI=y
 83CONFIG_BLK_DEV_IDE_AU1XXX=y
 84CONFIG_BLK_DEV_IDE_AU1XXX_MDMA2_DBDMA=y
 85CONFIG_BLK_DEV_IDEDMA=y
 86
 87Also define 'IDE_AU1XXX_BURSTMODE' in 'drivers/ide/mips/au1xxx-ide.c' to enable
 88the burst support on DBDMA controller.
 89
 90If the used system need the USB support enable the following kernel configs for
 91high IDE to USB throughput.
 92
 93CONFIG_IDE_GENERIC=y
 94CONFIG_BLK_DEV_IDEPCI=y
 95CONFIG_BLK_DEV_GENERIC=y
 96CONFIG_BLK_DEV_IDEDMA_PCI=y
 97CONFIG_BLK_DEV_IDE_AU1XXX=y
 98CONFIG_BLK_DEV_IDE_AU1XXX_MDMA2_DBDMA=y
 99CONFIG_BLK_DEV_IDEDMA=y
100
101Also undefine 'IDE_AU1XXX_BURSTMODE' in 'drivers/ide/mips/au1xxx-ide.c' to
102disable the burst support on DBDMA controller.
103
104
105ACKNOWLEDGMENTS
106---------------
107
108These drivers wouldn't have been done without the base of kernel 2.4.x AU1XXX
109IDE driver from AMD.
110
111Additional input also from:
112Matthias Lenk <matthias.lenk@amd.com>
113
114Happy hacking!
115Enrico Walther <enrico.walther@amd.com>