[src/trunk]: src/share/man/man4 Fix port-i386/9683 ("No doc on pcmcia IO spac...

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

details:   https://anonhg.NetBSD.org/src/rev/72bb367ee557
branches:  trunk
changeset: 484863:72bb367ee557
user:      jhawk <jhawk%NetBSD.org@localhost>
date:      Thu Apr 13 19:40:02 2000 +0000

description:
Fix port-i386/9683 ("No doc on pcmcia IO space conflicts").
Note the usage and existance of options PCIC_ISA_ALLOC_IOBASE and
PCIC_ISA_ALLOC_IOSIZE.

diffstat:

 share/man/man4/options.4 |  17 +++++++++++++++--
 share/man/man4/pcmcia.4  |  32 ++++++++++++++++++++++++++++++--
 2 files changed, 45 insertions(+), 4 deletions(-)

diffs (102 lines):

diff -r e701e49574e3 -r 72bb367ee557 share/man/man4/options.4
--- a/share/man/man4/options.4  Thu Apr 13 18:40:27 2000 +0000
+++ b/share/man/man4/options.4  Thu Apr 13 19:40:02 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: options.4,v 1.102 2000/03/31 05:58:57 tsarna Exp $
+.\"    $NetBSD: options.4,v 1.103 2000/04/13 19:40:02 jhawk Exp $
 .\"
 .\" Copyright (c) 1996
 .\"    Perry E. Metzger.  All rights reserved.
@@ -30,7 +30,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd June 26, 1998
+.Dd April 13, 2000
 .Os
 .Dt OPTIONS 4
 .Sh NAME
@@ -1446,6 +1446,18 @@
 for this option to take effect, option
 .Em CYRIX_CACHE_WORKS must also be specified.
 .El
+.Ss isa-specific Options
+Options specific to
+.Xr isa 4
+busses.
+.Bl -ohang
+.It Cd options PCIC_ISA_ALLOC_IOBASE=address, PCIC_ISA_ALLOC_IOSIZE=size
+Control the section of IO bus space used for PCMCIA bus space mapping.
+Ideally the probed defaults are satisfactory, however in practice
+that is not always the case. See
+.Xr pcmcia 4
+for details.
+.El
 .Ss m68k-specific Options
 .Bl -ohang
 .It Cd options FPU_EMULATE
@@ -1574,6 +1586,7 @@
 .Xr lkm 4 ,
 .Xr inet 4 ,
 .Xr ns 4 ,
+.Xr pcmcia 4 ,
 .Xr iso 4 ,
 .Xr mrouted 8 ,
 .Xr mount_lfs 8 ,
diff -r e701e49574e3 -r 72bb367ee557 share/man/man4/pcmcia.4
--- a/share/man/man4/pcmcia.4   Thu Apr 13 18:40:27 2000 +0000
+++ b/share/man/man4/pcmcia.4   Thu Apr 13 19:40:02 2000 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pcmcia.4,v 1.14 2000/03/20 18:28:28 augustss Exp $
+.\" $NetBSD: pcmcia.4,v 1.15 2000/04/13 19:40:03 jhawk Exp $
 .\"
 .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 12, 2000
+.Dd April 13, 2000
 .Dt PCMCIA 4
 .Os
 .Sh NAME
@@ -113,6 +113,7 @@
 .\"
 .Sh SEE ALSO
 .Xr intro 4 ,
+.Xr options 4 ,
 .Xr aic 4 ,
 .Xr awi 4 ,
 .Xr cardbus 4 ,
@@ -137,3 +138,30 @@
 .Nm
 driver appeared in
 .Nx 1.3 .
+.Sh BUGS
+.Ss IO space conflicts
+.Nx 
+probes the pcmcia IO bus width and uses that information to decide
+where to map PCMCIA IO space. For 10-bit wide cards, 0x300-0x3ff is
+used, and this is satisfactory. For 12-bit wide cards, however,
+it would nice to use 0x400-0xfff, however this causes some problems
+for some specific PCMCIA devices, as well as some specific laptops;
+consequently, 0x300-0x3ff is used.
+.Pp
+Unfortunately, the choice of 0x300-0x3ff causes problems as well.
+In particular, a number of video devices are mapped in that range,
+and may conflict. In the event that pcmcia devices are mapped
+in 0x300 and appear to be nonfunctional, remapping to 0x400-0xfff
+may be appropriate; consult 
+.Cd options PCIC_ISA_ALLOC_IOBASE
+and
+.Cd options PCIC_ISA_ALLOC_IOSIZE
+in
+.Xr options 4 .
+Example:
+.Bd -literal -offset indent
+# Avoid pcmcia bus space conflicts with the default io space
+# allocation on 12-bit wide busses (base 0x300 size 0xff).
+options PCIC_ISA_ALLOC_IOBASE=0x400
+options PCIC_ISA_ALLOC_IOSIZE=0xbff
+.Ed