[src/trunk]: src Document the 'wdc at isa' flags.

[bouyer <bouyer%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/bb6f082e94a3
branches:  trunk
changeset: 473082:bb6f082e94a3
user:      bouyer <bouyer%NetBSD.org@localhost>
date:      Wed May 19 14:41:54 1999 +0000

description:
Document the 'wdc at isa' flags.

diffstat:

 share/man/man4/wdc.4             |   9 ++++++---
 sys/arch/i386/conf/GENERIC       |   9 ++++++---
 sys/arch/i386/conf/INSTALL       |   9 ++++++---
 sys/arch/i386/conf/INSTALL_SMALL |  11 +++++++----
 sys/arch/i386/conf/INSTALL_TINY  |  11 +++++++----
 5 files changed, 32 insertions(+), 17 deletions(-)

diffs (126 lines):

diff -r 426d0f95d36c -r bb6f082e94a3 share/man/man4/wdc.4
--- a/share/man/man4/wdc.4      Wed May 19 14:41:25 1999 +0000
+++ b/share/man/man4/wdc.4      Wed May 19 14:41:54 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: wdc.4,v 1.3 1999/03/16 01:19:19 garbled Exp $
+.\"    $NetBSD: wdc.4,v 1.4 1999/05/19 14:44:02 bouyer Exp $
 .\"
 .\" Copyright (c) 1998 Manuel Bouyer.
 .\"
@@ -39,8 +39,8 @@
 .Nd WD100x compatible hard disk controllers driver
 .Sh SYNOPSIS
 .Ss ISA and ISA plug'n'play controllers
-.Cd "wdc0 at isa? port 0x1f0 irq 14"
-.Cd "wdc1 at isa? port 0x170 irq 15"
+.Cd "wdc0 at isa? port 0x1f0 irq 14 flags 0x00"
+.Cd "wdc1 at isa? port 0x170 irq 15 flags 0x00"
 .Cd "wdc* at isapnp?"
 .Ss PCMCIA controllers
 .Cd "wdc* at pcmcia? function ?"
@@ -60,6 +60,9 @@
 but the
 .Xr pciide 4
 driver may provide more functionalities.
+
+For the ISA front-end, the 0x01 flag enables the 32 bits I/O negociation in
+the driver. This is known to cause problems with some motherboards.
 .Sh SEE ALSO
 .Xr intro 4
 .Xr wd 4
diff -r 426d0f95d36c -r bb6f082e94a3 sys/arch/i386/conf/GENERIC
--- a/sys/arch/i386/conf/GENERIC        Wed May 19 14:41:25 1999 +0000
+++ b/sys/arch/i386/conf/GENERIC        Wed May 19 14:41:54 1999 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: GENERIC,v 1.234 1999/05/06 16:29:26 christos Exp $
+#      $NetBSD: GENERIC,v 1.235 1999/05/19 14:41:54 bouyer Exp $
 #
 #      GENERIC -- everything that's currently supported
 #
@@ -374,8 +374,11 @@
 wdc*   at pcmcia? function ?
 
 # ISA ST506, ESDI, and IDE controllers
-wdc0   at isa? port 0x1f0 irq 14
-wdc1   at isa? port 0x170 irq 15
+# Use flags 0x01 if you want to try to use 32bits data I/O (the driver will
+# fall back to 16bits I/O if 32bits I/O are not functionnal).
+# Some controllers pass the initial 32bit test, but will fail later.
+wdc0   at isa? port 0x1f0 irq 14 flags 0x00
+wdc1   at isa? port 0x170 irq 15 flags 0x00
 
 # IDE drives
 # Flags are used only with controllers that support DMA operations
diff -r 426d0f95d36c -r bb6f082e94a3 sys/arch/i386/conf/INSTALL
--- a/sys/arch/i386/conf/INSTALL        Wed May 19 14:41:25 1999 +0000
+++ b/sys/arch/i386/conf/INSTALL        Wed May 19 14:41:54 1999 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: INSTALL,v 1.116 1999/05/06 17:12:26 christos Exp $
+#      $NetBSD: INSTALL,v 1.117 1999/05/19 14:41:54 bouyer Exp $
 #
 #      INSTALL - Installation kernel.
 #
@@ -332,8 +332,11 @@
 wdc*    at pcmcia? function ?   
 
 # ISA ST506, ESDI, and IDE controllers
-wdc0   at isa? port 0x1f0 irq 14       # ST506, ESDI, and IDE controllers
-wdc1   at isa? port 0x170 irq 15
+# Use flags 0x01 if you want to try to use 32bits data I/O (the driver will
+# fall back to 16bits I/O if 32bits I/O are not functionnal).
+# Some controllers pass the initial 32bit test, but will fail later.
+wdc0   at isa? port 0x1f0 irq 14 flags 0x00
+wdc1   at isa? port 0x170 irq 15 flags 0x00
 
 # IDE drives
 # Flags are used only with controllers that support DMA operations
diff -r 426d0f95d36c -r bb6f082e94a3 sys/arch/i386/conf/INSTALL_SMALL
--- a/sys/arch/i386/conf/INSTALL_SMALL  Wed May 19 14:41:25 1999 +0000
+++ b/sys/arch/i386/conf/INSTALL_SMALL  Wed May 19 14:41:54 1999 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: INSTALL_SMALL,v 1.38 1999/03/27 07:04:36 explorer Exp $
+#      $NetBSD: INSTALL_SMALL,v 1.39 1999/05/19 14:41:54 bouyer Exp $
 #
 #      INSTALL_SMALL - Small Installation kernel.
 #
@@ -308,9 +308,12 @@
 
 # IDE and related devices
 
-# ISA IDE controllers
-wdc0   at isa? port 0x1f0 irq 14       # ST506, ESDI, and IDE controllers
-wdc1   at isa? port 0x170 irq 15
+# ST506, ESDI, and ISA IDE controllers
+# Use flags 0x01 if you want to try to use 32bits data I/O (the driver will
+# fall back to 16bits I/O if 32bits I/O are not functionnal).
+# Some controllers pass the initial 32bit test, but will fail later.
+wdc0   at isa? port 0x1f0 irq 14 flags 0x00
+wdc1   at isa? port 0x170 irq 15 flags 0x00
 
 # IDE drives
 wd*    at wdc? drive ?                 # the drives themselves
diff -r 426d0f95d36c -r bb6f082e94a3 sys/arch/i386/conf/INSTALL_TINY
--- a/sys/arch/i386/conf/INSTALL_TINY   Wed May 19 14:41:25 1999 +0000
+++ b/sys/arch/i386/conf/INSTALL_TINY   Wed May 19 14:41:54 1999 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: INSTALL_TINY,v 1.7 1999/03/27 07:04:36 explorer Exp $
+#      $NetBSD: INSTALL_TINY,v 1.8 1999/05/19 14:41:54 bouyer Exp $
 #
 #      INSTALL_TINY - Tiny Installation kernel, suitable for 4M machines.
 #
@@ -307,9 +307,12 @@
 
 # IDE and related devices
 
-# ISA IDE controllers
-wdc0   at isa? port 0x1f0 irq 14       # ST506, ESDI, and IDE controllers
-wdc1   at isa? port 0x170 irq 15
+# ST506, ESDI, and ISA IDE controllers
+# Use flags 0x01 if you want to try to use 32bits data I/O (the driver will
+# fall back to 16bits I/O if 32bits I/O are not functionnal).
+# Some controllers pass the initial 32bit test, but will fail later.
+wdc0   at isa? port 0x1f0 irq 14 flags 0x00
+wdc1   at isa? port 0x170 irq 15 flags 0x00
 
 # IDE drives
 wd*    at wdc? drive ?                 # the drives themselves