No empty .Rs/.Re
[netbsd-mini2440.git] / share / man / man4 / man4.hpcarm / intro.4
blob70d881d29c8e47e42e85b3df3a8d134ab34b7344
1 .\"     $NetBSD$
2 .\"
3 .\" Copyright (c) 2004 Valeriy E. Ushakov
4 .\" Copyright (c) 1994 Christopher G. Demetriou
5 .\" All rights reserved.
6 .\"
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
9 .\" are met:
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\"    notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\"    notice, this list of conditions and the following disclaimer in the
14 .\"    documentation and/or other materials provided with the distribution.
15 .\" 3. All advertising materials mentioning features or use of this software
16 .\"    must display the following acknowledgement:
17 .\"          This product includes software developed for the
18 .\"          NetBSD Project.  See http://www.NetBSD.org/ for
19 .\"          information about NetBSD.
20 .\" 4. The name of the author may not be used to endorse or promote products
21 .\"    derived from this software without specific prior written permission.
22 .\"
23 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
24 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
27 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
28 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
32 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 .\"
34 .\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
35 .\"
36 .Dd June 25, 2006
37 .Dt INTRO 4 hpcarm
38 .Os
39 .Sh NAME
40 .Nm intro
41 .Nd introduction to hpcarm special files and hardware support
42 .Sh DESCRIPTION
43 This section describes the special files, related driver functions,
44 and networking support
45 available in the system.
46 In this part of the manual, the
47 .Tn SYNOPSIS
48 section of
49 each configurable device gives a sample specification
50 for use in constructing a system description for the
51 .Xr config 1
52 program.
53 The
54 .Tn DIAGNOSTICS
55 section lists messages which may appear on the console
56 and/or in the system error log
57 .Pa /var/log/messages
58 due to errors in device operation;
59 see
60 .Xr syslogd 8
61 for more information.
62 .Pp
63 This section contains both devices
64 which may be configured into the system
65 and network related information.
66 The networking support is introduced in
67 .Xr netintro 4 .
68 .Sh DEVICE SUPPORT
69 This section describes the hardware supported on the hpcarm platform.
70 Software support for these devices comes in two forms.  A hardware
71 device may be supported with a character or block
72 .Em device driver ,
73 or it may be used within the networking subsystem and have a
74 .Em network interface driver .
75 Block and character devices are accessed through files in the file
76 system of a special type; see
77 .Xr mknod 8 .
78 Network interfaces are indirectly accessed through the interprocess
79 communication facilities provided by the system; see
80 .Xr socket 2 .
81 .Pp
82 A hardware device is identified to the system at configuration time
83 and the appropriate device or network interface driver is then compiled
84 into the system.  When the resultant system is booted, the
85 autoconfiguration facilities in the system probe for the device
86 and, if found, enable the software support for it.
87 If a device does not respond at autoconfiguration
88 time it is not accessible at any time afterwards.
89 To enable a device which did not autoconfigure,
90 the system must be rebooted.
91 .Pp
92 The autoconfiguration system is described in
93 .Xr autoconf 4 .
94 A list of the supported devices is given below.
95 .Sh SUPPORTED SYSTEMS
96 The hpcarm port supports
97 .Tn StrongARM
98 based Windows\ CE PDA machines.
99 The current supports models are:
101 HP Jornada series
102 .Bl -bullet -offset indent -compact
104 HP Jornada 710, 720, 728, 820
107 Compaq iPAQ series
108 .Bl -bullet -offset indent -compact
110 iPAQ H3600
113 .Sh LIST OF DEVICES
114 The devices listed below are supported in this incarnation of the system.
115 Devices are indicated by their functional interface.
116 Not all supported devices are listed.
118 Standard SA-11x0 on-chip peripheral devices:
119 .Bl -tag -width "xxxxxxxx" -compact -offset indent
120 .It sacom
121 Serial communication interface
122 .It sacpcic
123 PCMCIA controller
124 .It saip
125 Bus for integrated peripheral devices
126 .It saost
127 Operating System timer
130 Network interfaces:
131 .Bl -tag -width "xxxxxxxx" -compact -offset indent
132 .It an
133 Aironet 4500/4800 and Cisco 340/350 wireless network devices
134 .It ep
135 3Com EtherLink III Ethernet devices
136 .It ne
137 NE2000 and compatible Ethernet devices
138 .It wi
139 WaveLAN/IEEE and PRISM-II 802.11 wireless network devices
142 Pointer devices:
143 .Bl -tag -width "xxxxxxxx" -compact -offset indent
144 .It j720lcd
145 LCD screen control of the HP Jornada 7xx series machines
146 .It j720tp
147 Touch screen of the HP Jornada 7xx series machines
150 .Sh SEE ALSO
151 .Xr config 1 ,
152 .Xr autoconf 4
153 .Sh BUGS
154 This manual page is incomplete.