1.\" $NetBSD: intro.4,v 1.4 2017/02/17 22:24:46 christos Exp $ 2.\" 3.\" Copyright (c) 2010 NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This file is derived from work contributed by Microsoft Corporation. 7.\" 8.\" Redistribution and use in source and binary forms, with or without 9.\" modification, are permitted provided that the following conditions 10.\" are met: 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" notice, this list of conditions and the following disclaimer in the 15.\" documentation and/or other materials provided with the distribution. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 22.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27.\" 28.Dd February 17, 2017 29.Dt INTRO 4 emips 30.Os 31.Sh NAME 32.Nm intro 33.Nd introduction to emips special files and hardware support 34.Sh DESCRIPTION 35This section describes the special files, related driver functions, 36and networking support available in the system. 37In this part of the manual, the 38.Tn SYNOPSIS 39section of each configurable device gives a sample specification 40for use in constructing a system description for the 41.Xr config 1 42program. 43The 44.Tn DIAGNOSTICS 45section lists messages which may appear on the console 46and/or in the system error log 47.Pa /var/log/messages 48due to errors in device operation; see 49.Xr syslogd 8 50for more information. 51.Pp 52This section contains both devices which may be configured into 53the system and network related information. 54The networking support is introduced in 55.Xr netintro 4 . 56.Sh DEVICE SUPPORT 57This section describes the hardware supported on eMIPS 58(Microsoft Extensible MIPS processor)-based platforms. 59Software support for these devices comes in two forms. 60A hardware device may be supported with a character or block 61.Em device driver , 62or it may be used within the networking subsystem and have a 63.Em network interface driver . 64Block and character devices are accessed through files in the file 65system of a special type; see 66.Xr mknod 8 . 67Network interfaces are indirectly accessed through the interprocess 68communication facilities provided by the system; see 69.Xr socket 2 . 70.Pp 71A hardware device is identified to the system at configuration time 72and the appropriate device or network interface driver is then compiled 73into the system. 74When the resultant system is booted, the autoconfiguration facilities 75in the system probe for the device and, if found, enable the software 76support for it. 77If a device does not respond at autoconfiguration 78time it is not accessible at any time afterwards. 79To enable a device which did not autoconfigure, 80the system must be rebooted. 81.Pp 82The autoconfiguration system is described in 83.Xr emips/autoconf 4 . 84A list of the supported devices is given below. 85.Sh SEE ALSO 86.Xr config 1 , 87.Xr emips/autoconf 4 88.Sh SUPPORTED SYSTEMS 89The following systems are supported: 90.Pp 91.Bl -tag -width speaker -offset indent -compact 92.It BeSquare BErkeley Emulation System-3 FPGA development board 93known as the "BEE3". 94This is a quad-chip FPGA system where eMIPS can run on each FPGA separately, 95on multiple FPGAs in concert, and in multi-processor configurations. 96.It Xilinx University Program board 97known as "XUP". 98This is the Xilinx reference board for the Virtex-5 series chips. 99It can use the same XL110T FPGA chip present on the BEE3. 100.It Xilinx ML402 101Xilinx reference board for the Virtex-4 series chip, including the SX35. 102.It Xilinx ML401 103Same as the above, but with the smaller LX25 chip. 104.El 105.Sh LIST OF DEVICES 106The devices listed below are supported in this incarnation of the system. 107Devices are indicated by their functional interface. 108Not all supported devices are listed. 109.Pp 110.Bl -tag -width speaker -offset indent -compact 111.It ace 112Xilinx SystemACE interface for Compact-FLASH cards, bears similarities to the IDE interface. 113Present on XUP and ML40x boards. 114Not present on BEE3. 115.It dz 116serial driver for the eMIPS console serial device. 117Present on all systems. 118.It enic 119Ethernet driver for the eNIC device. 120Present on XUP and BEE3 systems. 121Not present on ML40x systems. 122.It eclock 123System clock, must be configured on all systems. 124.It ebus 125Extensible BUS, present on all systems. 126.El 127.Sh HISTORY 128This 129.Tn eMIPS 130.Nm intro 131appeared in 132.Nx 6.0 . 133