[src/trunk]: src Add evbarm/gxio(4).

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

details:   https://anonhg.NetBSD.org/src/rev/d573d6b323af
branches:  trunk
changeset: 822783:d573d6b323af
user:      wiz <wiz%NetBSD.org@localhost>
date:      Thu Apr 06 14:35:15 2017 +0000

description:
Add evbarm/gxio(4).

Based on PR 52137 by Stephan Meisinger, with some man page improvements
by myself.

diffstat:

 distrib/sets/lists/man/mi           |    5 +-
 share/man/man4/man4.evbarm/Makefile |    4 +-
 share/man/man4/man4.evbarm/gxio.4   |  143 ++++++++++++++++++++++++++++++++++++
 share/man/man4/pxaip.4              |    3 +-
 4 files changed, 151 insertions(+), 4 deletions(-)

diffs (209 lines):

diff -r 99f818bfdd3a -r d573d6b323af distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Thu Apr 06 14:01:27 2017 +0000
+++ b/distrib/sets/lists/man/mi Thu Apr 06 14:35:15 2017 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1551 2017/03/06 13:14:25 maya Exp $
+# $NetBSD: mi,v 1.1552 2017/04/06 14:35:15 wiz Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -1068,6 +1068,7 @@
 ./usr/share/man/cat4/evbarm/bcmgpio.0          man-sys-catman          .cat
 ./usr/share/man/cat4/evbarm/cpsw.0             man-sys-catman          .cat
 ./usr/share/man/cat4/evbarm/epgpio.0           man-sys-catman          .cat
+./usr/share/man/cat4/evbarm/gxio.0             man-sys-catman          .cat
 ./usr/share/man/cat4/evbarm/intro.0            man-sys-catman          .cat
 ./usr/share/man/cat4/evbarm/iopaau.0           man-sys-catman          .cat
 ./usr/share/man/cat4/evbarm/iopwdog.0          man-sys-catman          .cat
@@ -4177,6 +4178,7 @@
 ./usr/share/man/html4/evbarm/bcmgpio.html      man-sys-htmlman         html
 ./usr/share/man/html4/evbarm/cpsw.html         man-sys-htmlman         html
 ./usr/share/man/html4/evbarm/epgpio.html       man-sys-htmlman         html
+./usr/share/man/html4/evbarm/gxio.html         man-sys-htmlman         html
 ./usr/share/man/html4/evbarm/intro.html                man-sys-htmlman         html
 ./usr/share/man/html4/evbarm/iopaau.html       man-sys-htmlman         html
 ./usr/share/man/html4/evbarm/iopwdog.html      man-sys-htmlman         html
@@ -7058,6 +7060,7 @@
 ./usr/share/man/man4/evbarm/bcmgpio.4          man-sys-man             .man
 ./usr/share/man/man4/evbarm/cpsw.4             man-sys-man             .man
 ./usr/share/man/man4/evbarm/epgpio.4           man-sys-man             .man
+./usr/share/man/man4/evbarm/gxio.4             man-sys-man             .man
 ./usr/share/man/man4/evbarm/intro.4            man-sys-man             .man
 ./usr/share/man/man4/evbarm/iopaau.4           man-sys-man             .man
 ./usr/share/man/man4/evbarm/iopwdog.4          man-sys-man             .man
diff -r 99f818bfdd3a -r d573d6b323af share/man/man4/man4.evbarm/Makefile
--- a/share/man/man4/man4.evbarm/Makefile       Thu Apr 06 14:01:27 2017 +0000
+++ b/share/man/man4/man4.evbarm/Makefile       Thu Apr 06 14:35:15 2017 +0000
@@ -1,6 +1,6 @@
-#      $NetBSD: Makefile,v 1.6 2014/04/23 07:04:01 kardel Exp $
+#      $NetBSD: Makefile,v 1.7 2017/04/06 14:35:15 wiz Exp $
 
-MAN=   bcmgpio.4 cpsw.4 epgpio.4 intro.4 iopaau.4 iopwdog.4
+MAN=   bcmgpio.4 cpsw.4 epgpio.4 gxio.4 intro.4 iopaau.4 iopwdog.4
 
 MANSUBDIR=/evbarm
 
diff -r 99f818bfdd3a -r d573d6b323af share/man/man4/man4.evbarm/gxio.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.evbarm/gxio.4 Thu Apr 06 14:35:15 2017 +0000
@@ -0,0 +1,143 @@
+.\" $NetBSD: gxio.4,v 1.1 2017/04/06 14:35:15 wiz Exp $
+.\"
+.\" Copyright (c) 2017 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Takashi Kiyohara.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd April 3, 2017
+.Dt GXIO 4
+.Os
+.Sh NAME
+.Nm gxio
+.Nd driver for Gumstix onboard I/O interface
+.Sh SYNOPSIS
+.Cd "gxio* at pxaip?"
+.Cd options GXIO_BLUETOOTH_ON_HWUART
+.Cd options GXIO_DEFAULT_EXPANSION
+.Sh DESCRIPTION
+The
+.Nm
+driver supports several different expansion boards.
+Those boards have to be configured either by kernel option or
+using boot time parameter.
+The supported extension boards is system specific.
+.Pp
+.Nm
+is available for OMAP based Overo/DouVero and Pepper
+as well as for XScale based Gumstix boards.
+To setup the expansion board on boot the parameter
+.Dq expansion
+for OMAP and XScale can be used.
+Additionally, some XScale systems can connect two expansion boards.
+The second board can be configured by the
+.Dq busheader
+boot parameter.
+The
+.Nm
+driver does not verify validity of both parameters.
+.Pp
+For Xscale boards the following drivers are available for the peripherals:
+.Bl -tag -width -pcdisplay -offset indent
+.It sm
+SMC91Cxx ethernet interface.
+.It smsh
+SMSC LAN9118/LAN9218 ethernet interface.
+.El
+.Sh OPTIONS
+.Bl -tag -width GXIO_BLUETOOTH_ON_HWUART -offset 3n
+.It Dv GXIO_BLUETOOTH_ON_HWUART
+Uses HWUART pins for Bluetooth module.
+.Pp
+The option only affects Xscale PXA250 based Gumstix boards.
+If set, the serial port HWUART is used to control Bluetooth module.
+Otherwise no Bluetooth module is configured for PXA250 boards.
+.It Dv GXIO_DEFAULT_EXPANSION
+Static configuration of expansion board.
+.Pp
+If configured, the
+.Nm
+of the processor is setup for the board.
+If a boot parameter is used, the boot value is used instead.
+.Pp
+For Xscale based boards the following values are supported:
+.Bl -column
+.It basix
+.It cfstix
+.It etherstix
+.It netcf
+.It netcf-vx
+.It netduo
+.It netduo-mmc
+.It netmicrosd
+.It netmicrosd-vx
+.It netwifimicrosd
+.It netmmc
+.It netpro-vx
+.It wfistix
+.It wfistix-cf
+.El
+.Pp
+For Overo the following values are supported:
+.Bl -column
+.It chestnut43
+.It gallop43
+.It summit
+.It tobi
+.It tobi-duo
+.El
+.Pp
+For DuoVero the following value is supported:
+.Bl -column
+.It parlor
+.El
+.Pp
+For Pepper the following values are supported:
+.Bl -column
+.It 43c
+.It 43r
+.It dvi
+.El
+.El
+.Sh SEE ALSO
+.Xr pxaip 4 ,
+.Xr sm 4 ,
+.Xr smsh 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Nx 4.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Takashi Kiyohara
+.Aq Mt kiyohara%NetBSD.org@localhost
+and
+.An Susumu Miki for WIDE Project and SOUM Corporation .
+This manual page was contributed by
+.An Stephan Meisinger .
diff -r 99f818bfdd3a -r d573d6b323af share/man/man4/pxaip.4
--- a/share/man/man4/pxaip.4    Thu Apr 06 14:01:27 2017 +0000
+++ b/share/man/man4/pxaip.4    Thu Apr 06 14:35:15 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pxaip.4,v 1.3 2017/03/06 22:29:35 wiz Exp $
+.\"    $NetBSD: pxaip.4,v 1.4 2017/04/06 14:35:15 wiz Exp $
 .\"
 .\" Copyright (c) 2017 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -82,6 +82,7 @@
 .El
 .Sh SEE ALSO
 .Xr com 4 ,
+.Xr evbarm/gxio 4 ,
 .Xr ohci 4 ,
 .Xr sm 4
 .Sh HISTORY