xref: /netbsd-src/share/man/man4/man4.evbarm/gxio.4 (revision 82d56013d7b633d116a93943de88e08335357a7c)
1.\" $NetBSD: gxio.4,v 1.1 2017/04/06 14:35:15 wiz Exp $
2.\"
3.\" Copyright (c) 2017 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Takashi Kiyohara.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd April 3, 2017
31.Dt GXIO 4
32.Os
33.Sh NAME
34.Nm gxio
35.Nd driver for Gumstix onboard I/O interface
36.Sh SYNOPSIS
37.Cd "gxio* at pxaip?"
38.Cd options GXIO_BLUETOOTH_ON_HWUART
39.Cd options GXIO_DEFAULT_EXPANSION
40.Sh DESCRIPTION
41The
42.Nm
43driver supports several different expansion boards.
44Those boards have to be configured either by kernel option or
45using boot time parameter.
46The supported extension boards is system specific.
47.Pp
48.Nm
49is available for OMAP based Overo/DouVero and Pepper
50as well as for XScale based Gumstix boards.
51To setup the expansion board on boot the parameter
52.Dq expansion
53for OMAP and XScale can be used.
54Additionally, some XScale systems can connect two expansion boards.
55The second board can be configured by the
56.Dq busheader
57boot parameter.
58The
59.Nm
60driver does not verify validity of both parameters.
61.Pp
62For Xscale boards the following drivers are available for the peripherals:
63.Bl -tag -width -pcdisplay -offset indent
64.It sm
65SMC91Cxx ethernet interface.
66.It smsh
67SMSC LAN9118/LAN9218 ethernet interface.
68.El
69.Sh OPTIONS
70.Bl -tag -width GXIO_BLUETOOTH_ON_HWUART -offset 3n
71.It Dv GXIO_BLUETOOTH_ON_HWUART
72Uses HWUART pins for Bluetooth module.
73.Pp
74The option only affects Xscale PXA250 based Gumstix boards.
75If set, the serial port HWUART is used to control Bluetooth module.
76Otherwise no Bluetooth module is configured for PXA250 boards.
77.It Dv GXIO_DEFAULT_EXPANSION
78Static configuration of expansion board.
79.Pp
80If configured, the
81.Nm
82of the processor is setup for the board.
83If a boot parameter is used, the boot value is used instead.
84.Pp
85For Xscale based boards the following values are supported:
86.Bl -column
87.It basix
88.It cfstix
89.It etherstix
90.It netcf
91.It netcf-vx
92.It netduo
93.It netduo-mmc
94.It netmicrosd
95.It netmicrosd-vx
96.It netwifimicrosd
97.It netmmc
98.It netpro-vx
99.It wfistix
100.It wfistix-cf
101.El
102.Pp
103For Overo the following values are supported:
104.Bl -column
105.It chestnut43
106.It gallop43
107.It summit
108.It tobi
109.It tobi-duo
110.El
111.Pp
112For DuoVero the following value is supported:
113.Bl -column
114.It parlor
115.El
116.Pp
117For Pepper the following values are supported:
118.Bl -column
119.It 43c
120.It 43r
121.It dvi
122.El
123.El
124.Sh SEE ALSO
125.Xr pxaip 4 ,
126.Xr sm 4 ,
127.Xr smsh 4
128.Sh HISTORY
129The
130.Nm
131driver first appeared in
132.Nx 4.0 .
133.Sh AUTHORS
134.An -nosplit
135The
136.Nm
137driver was written by
138.An Takashi Kiyohara
139.Aq Mt kiyohara@NetBSD.org
140and
141.An Susumu Miki for WIDE Project and SOUM Corporation .
142This manual page was contributed by
143.An Stephan Meisinger .
144