misc/52137: man page gxio

[smesgr%gmail.com@localhost]

>Number:         52137
>Category:       misc
>Synopsis:       man page gxio
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Apr 03 20:10:00 +0000 2017
>Originator:     Stephan Meisinger
>Release:        NetBSD 7.1
>Organization:
>Environment:
>Description:
man page for Gumstix gxio
>How-To-Repeat:
man gxio ;-)
>Fix:
Index: distrib/sets/lists/man/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/man/mi,v
retrieving revision 1.1551
diff -u -r1.1551 mi
--- distrib/sets/lists/man/mi	6 Mar 2017 13:14:25 -0000	1.1551
+++ distrib/sets/lists/man/mi	3 Apr 2017 20:00:48 -0000
@@ -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
Index: share/man/man4/pxaip.4
===================================================================
RCS file: /cvsroot/src/share/man/man4/pxaip.4,v
retrieving revision 1.3
diff -u -r1.3 pxaip.4
--- share/man/man4/pxaip.4	6 Mar 2017 22:29:35 -0000	1.3
+++ share/man/man4/pxaip.4	3 Apr 2017 20:02:09 -0000
@@ -82,6 +82,7 @@
 .El
 .Sh SEE ALSO
 .Xr com 4 ,
+.Xr gxio 4 ,
 .Xr ohci 4 ,
 .Xr sm 4
 .Sh HISTORY
Index: share/man/man4/man4.evbarm/Makefile
===================================================================
RCS file: /cvsroot/src/share/man/man4/man4.evbarm/Makefile,v
retrieving revision 1.6
diff -u -r1.6 Makefile
--- share/man/man4/man4.evbarm/Makefile	23 Apr 2014 07:04:01 -0000	1.6
+++ share/man/man4/man4.evbarm/Makefile	3 Apr 2017 20:02:09 -0000
@@ -1,6 +1,6 @@
 #	$NetBSD: Makefile,v 1.6 2014/04/23 07:04:01 kardel 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
 
Index: share/man/man4/man4.evbarm/gxio.4
===================================================================
RCS file: share/man/man4/man4.evbarm/gxio.4
diff -N share/man/man4/man4.evbarm/gxio.4
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ share/man/man4/man4.evbarm/gxio.4	3 Apr 2017 20:02:09 -0000
@@ -0,0 +1,139 @@
+.\"
+.\" 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 board. The second board can be configured by
+.Dq busheader
+boot parameter. The
+.Nm
+driver does not verify vadility 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
+Option does only affect 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 .