xref: /netbsd-src/share/man/man4/man4.evbarm/gxio.4 (revision 5e697dbfa92549e95f2ce6f7fcdeb14aecbe9021)
1.\" $NetBSD: gxio.4,v 1.2 2022/10/29 13:10:26 jmcneill 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 October 29, 2022
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 XScale based Gumstix boards.
50To setup the expansion board on boot the parameter
51.Dq expansion
52can be used.
53Additionally, some XScale systems can connect two expansion boards.
54The second board can be configured by the
55.Dq busheader
56boot parameter.
57The
58.Nm
59driver does not verify validity of both parameters.
60.Pp
61For Xscale boards the following drivers are available for the peripherals:
62.Bl -tag -width -pcdisplay -offset indent
63.It sm
64SMC91Cxx ethernet interface.
65.It smsh
66SMSC LAN9118/LAN9218 ethernet interface.
67.El
68.Sh OPTIONS
69.Bl -tag -width GXIO_BLUETOOTH_ON_HWUART -offset 3n
70.It Dv GXIO_BLUETOOTH_ON_HWUART
71Uses HWUART pins for Bluetooth module.
72.Pp
73The option only affects Xscale PXA250 based Gumstix boards.
74If set, the serial port HWUART is used to control Bluetooth module.
75Otherwise no Bluetooth module is configured for PXA250 boards.
76.It Dv GXIO_DEFAULT_EXPANSION
77Static configuration of expansion board.
78.Pp
79If configured, the
80.Nm
81of the processor is setup for the board.
82If a boot parameter is used, the boot value is used instead.
83.Pp
84For Xscale based boards the following values are supported:
85.Bl -column
86.It basix
87.It cfstix
88.It etherstix
89.It netcf
90.It netcf-vx
91.It netduo
92.It netduo-mmc
93.It netmicrosd
94.It netmicrosd-vx
95.It netwifimicrosd
96.It netmmc
97.It netpro-vx
98.It wfistix
99.It wfistix-cf
100.El
101.El
102.Sh SEE ALSO
103.Xr pxaip 4 ,
104.Xr sm 4 ,
105.Xr smsh 4
106.Sh HISTORY
107The
108.Nm
109driver first appeared in
110.Nx 4.0 .
111.Sh AUTHORS
112.An -nosplit
113The
114.Nm
115driver was written by
116.An Takashi Kiyohara
117.Aq Mt kiyohara@NetBSD.org
118and
119.An Susumu Miki for WIDE Project and SOUM Corporation .
120This manual page was contributed by
121.An Stephan Meisinger .
122