1.\" $NetBSD: intro.4,v 1.2 2004/01/20 16:42:05 wiz Exp $ 2.\" 3.\" Copyright (c) 2003 ARM Ltd 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. The name of the company may not be used to endorse or promote 15.\" products derived from this software without specific prior written 16.\" permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY ARM LTD ``AS IS'' AND 19.\" 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 ARM LTD 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 September 7, 2003 31.Dt INTRO 4 evbarm 32.Os 33.Sh NAME 34.Nm intro 35.Nd introduction to evbarm special files and hardware support 36.Sh DESCRIPTION 37The evbarm port is really a collection of ports of 38.Nx 39to a range of development and evaluation boards based on the ARM Architecture. 40.Pp 41This section describes the supported boards, the special files, 42related driver functions, and networking support available in each system. 43In this part of the manual, the 44.Tn SYNOPSIS 45section of 46each configurable device gives a sample specification 47for use in constructing a system description for the 48.Xr config 8 49program. 50The 51.Tn DIAGNOSTICS 52section lists messages which may appear on the console 53and/or in the system error log 54.Pa /var/log/messages 55due to errors in device operation; 56see 57.Xr syslogd 8 58for more information. 59.Pp 60This section contains both devices 61which may be configured into the system 62and network related information. 63The networking support is introduced in 64.Xr netintro 4 . 65.Sh SUPPORTED BOARDS 66Each supported board requires a custom kernel for that board. 67.Pp 68The following boards are currently supported by the evbarm configuration: 69.Pp 70.Bl -tag -width Integrator -offset indent -compact 71.It Integrator 72The Integrator/AP development system from ARM Ltd. 73Supported processor boards 74include the CM10200E and CM920T. 75.It IQ80310 76The reference platform for the XScale-based IOP310 I/O processor from Intel. 77.It IQ80321 78The reference platform for the XScale-based IOP321 I/O processor from Intel. 79.It Npwr 80The Npwr board, from Team ASA, is based on the IOP310 processor from Intel and 81targetted at the network-attached storage space. 82.It IXM1200 83The reference platform for the XScale-based IXP1200 Network processor from 84Intel. 85.It SMDK2410 86The reference platform for the ARM920T-based S3C2410 processor from Samsung. 87.It SMDK2800 88The reference platform for the ARM920T-based S3C2800 processor from Samsung. 89.It BRH 90The BRH (Big Red Head) is an evaluation and development platform from ADI 91Engineering, based on the XScale-based I80200 processor 92.It NTNP425B 93An evaluation and development platform from NOVATEC, using the XScale-based 94IXP425 processor. 95.It DBPXA250 96An evaluation and development platfrom from Intel, using the XScale-based 97PXA250 processor. 98.El 99.Sh DEVICE SUPPORT 100This section describes some of the hardware supported on the various boards. 101Software support for these devices comes in two forms. 102A hardware 103device may be supported with a character or block 104.Em device driver , 105or it may be used within the networking subsystem and have a 106.Em network interface driver . 107Block and character devices are accessed through files in the file 108system of a special type; see 109.Xr mknod 8 . 110Network interfaces are indirectly accessed through the interprocess 111communication facilities provided by the system; see 112.Xr socket 2 . 113.Pp 114A hardware device is identified to the system at configuration time 115and the appropriate device or network interface driver is then compiled 116into the system. 117When the resultant system is booted, the 118autoconfiguration facilities in the system probe for the device 119and, if found, enable the software support for it. 120If a device does not respond at autoconfiguration 121time it is not accessible at any time afterwards. 122To enable a device which did not autoconfigure, 123the system must be rebooted. 124.Pp 125The autoconfiguration system is described in 126.Xr autoconf 4 . 127A list of the supported devices is given below. 128.Sh LIST OF DEVICES 129The devices listed below are supported in this incarnation of 130the system. 131Devices are indicated by their functional interface. 132Not all supported devices are listed. 133.Pp 134On the Integrator: 135.Pp 136.Bl -tag -width speaker -offset indent -compact 137.It plcom 138The PrimeCell PL010 UART. 139.It plrtc 140The PrimeCell PL030 Real-time Clock 141.It fxp 142Intel i82559 Ethernet PCI card. 143.It ahc 144Adaptec aic7880 SCSI controller. 145.El 146Other PCI based cards may also work, but have not been tested. 147.Pp 148On the IQ80310: 149.Pp 150.Bl -tag -width speaker -offset indent -compact 151.It fxp 152On-board Intel i82559 Ethernet 153.It com 154On-board NS16550-compatible serial ports 155.El 156Other PCI devices in the PCI expansion slots. 157On the IQ80321: 158.Pp 159.Bl -tag -width speaker -offset indent -compact 160.It wm 161On-board Intel i82544EI Gigabit Ethernet 162.It com 163On-board NS16550-compatible serial port 164.It iopaau 165On-chip Application Accelerator Unit 166.It iopwdog 167On-chip watchdog timer. 168.El 169Other devices in the PCI expansion slots. 170.Pp 171On Npwr: 172.Pp 173.Bl -tag -width speaker -offset indent -compact 174.It wm 175On-board Intel i82544EI Gigabit Ethernet 176.It siop 177On-board LSI Logic 53c1010 Ultra160 SCSI 178.It com 179On-board NS16550-compatible serial port 180.El 181.Pp 182On the IXM1200: 183.Pp 184.Bl -tag -width speaker -offset indent -compact 185.It fxp 186On-board Intel i82559 Ethernet 187.It nppb 188On-board Intel i21555 Non-Transparent PCI-PCI Bridge 189.It ixpcom 190On-chip serial port 191.El 192.Pp 193On the SMDK2410: 194.Pp 195.Bl -tag -width speaker -offset indent -compact 196.It sscom 197On-chip serial ports 198.It ohci 199On-chip USB host controller 200.El 201.Pp 202On the SMDK2800: 203.Pp 204.Bl -tag -width speaker -offset indent -compact 205.It sscom 206On-chip serial ports 207.It sspci 208On-chip Host-PCI bridge 209.El 210Other devices in the PCI expansion slots. 211.Pp 212On the BRH: 213.Pp 214.Bl -tag -width speaker -offset indent -compact 215.It com 216On-board NS16550-compatible serial ports 217.It fxp 218On-board i82559 Ethernet controller 219.El 220Other devices in the PCI expansion slots. 221.Pp 222On the NtNP425B: 223.Pp 224.Bl -tag -width speaker -offset indent -compact 225.It ixpcom 226On-chip serial ports 227.It ixpwdog 228On-chip watchdog timer 229.El 230Other devices in the PCI/mPCI slot. 231.Pp 232On the DBPXA250: 233.Pp 234.Bl -tag -width speaker -offset indent -compact 235.It com 236On-board NS16550-compatible serial port 237.It sm 238On-board SMC91C96 Ethernet controller 239.It sacc 240On-board SA-1111 StrongARM companion chip 241.It pckbd 242PS/2 keyboard 243.It lcd 244640x480 LCD 245.El 246Other devices in the PCMCIA and CF card slots. 247.Sh SEE ALSO 248.Xr autoconf 4 , 249.Xr config 8 250.Sh HISTORY 251The 252.Tn evbarm 253.Nm intro 254appeared in 255.Nx 2.0 . 256