1.\" 2.\" Copyright (c) 1996 Jonathan Stone. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. All advertising materials mentioning features or use of this software 14.\" must display the following acknowledgement: 15.\" This product includes software developed by Jonathan Stone. 16.\" 4. The name of the author may not be used to endorse or promote products 17.\" derived from this software without specific prior written permission 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 20.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 21.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 22.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 23.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 24.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 28.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29.\" 30.\" $NetBSD: intro.4,v 1.22 2017/07/28 16:11:03 wiz Exp $ 31.\" 32.Dd July 28, 2017 33.Dt INTRO 4 pmax 34.Os 35.Sh NAME 36.Nm intro 37.Nd introduction to pmax special files and hardware support 38.Sh DESCRIPTION 39This section describes the special files, related driver functions, 40and networking support available in the system. 41In this part of the manual, the 42.Tn SYNOPSIS 43section of each configurable device gives a sample specification 44for use in constructing a system description for the 45.Xr config 1 46program. 47The 48.Tn DIAGNOSTICS 49section lists messages which may appear on the console 50and/or in the system error log 51.Pa /var/log/messages 52due to errors in device operation; see 53.Xr syslogd 8 54for more information. 55.Pp 56This section contains both devices which may be configured into 57the system and network related information. 58The networking support is introduced in 59.Xr netintro 4 . 60.Sh DEVICE SUPPORT 61This section describes the hardware supported on the pmax 62(MIPS-based DECstation/DECsystem) platform. 63Software support for these devices comes in two forms. 64A hardware device may be supported with a character or block 65.Em device driver , 66or it may be used within the networking subsystem and have a 67.Em network interface driver . 68Block and character devices are accessed through files in the file 69system of a special type; see 70.Xr mknod 8 . 71Network interfaces are indirectly accessed through the interprocess 72communication facilities provided by the system; see 73.Xr socket 2 . 74.Pp 75A hardware device is identified to the system at configuration time 76and the appropriate device or network interface driver is then compiled 77into the system. 78When the resultant system is booted, the autoconfiguration facilities 79in the system probe for the device and, if found, enable the software 80support for it. 81If a device does not respond at autoconfiguration 82time it is not accessible at any time afterwards. 83To enable a device which did not autoconfigure, 84the system must be rebooted. 85.Pp 86The autoconfiguration system is described in 87.Xr pmax/autoconf 4 . 88A list of the supported devices is given below. 89.Sh SEE ALSO 90.Xr config 1 , 91.Xr pmax/autoconf 4 92.Sh SUPPORTED SYSTEMS 93The following systems are supported: 94.Pp 95.Bl -tag -width speaker -offset indent -compact 96.It DECstation 2100 and 3100 97also known as "PMIN" and "PMAX". 98The 2100 and 3100 differ only in CPU clock 99speed. 100.It DECsystem 5100 101also known as "MIPSMATE". 102.It DECstation 5000/200 103also known as "3MAX". 104The 5000/200 has a 25 MHz R3000 and is the first-generation TURBOchannel 105platform. 106.It DECstation 5000/1xx 107also known as "3MIN" or "kmin". 108The 5000/1xx comes in 20 MHz, 25 MHz, and 33 MHz versions and is 109numbered appropriately. 110Two 12.5 MHz 111TURBOchannel slots are provided. 112.It DECstation 5000/xx 113also known as "Personal DECstation" or "MAXINE". 114The 5000/xx comes in 20 MHz, 25 MHz, and 33 MHz variants. 115A baseboard 1024x786 framebuffer, and two 12.5 MHz TURBOchannel slots 116are provided. 117.It DECstation 5000/240 and DECsystem 5900 118also known as "3MAXPLUS". 119These systems have a 40 MHz R3400 CPU and three 25 MHz TURBOchannel slots. 120The 5900 is an expanded-cabinet version of the 5000/240. 121.El 122.Pp 123TURBOchannel systems (except the 5000/200) can be upgraded to an 124R4000 or R4400 CPU by upgrading the CPU daughterboard. 125.Pp 126The Qbus-based DECsystem 5400 and 5500 are not supported. 127.Pp 128The multi-processor XMI-bus DECsystem 5800 is not supported. 129.Sh LIST OF DEVICES 130The devices listed below are supported in this incarnation of the system. 131Devices are indicated by their functional interface. 132Not all supported devices are listed. 133.Pp 134.Bl -tag -width speaker -offset indent -compact 135.It asc 136NCR 53c94-based SCSI interface, either on DECstation 5000-series 137baseboard or PMAZ-AA SCSI option card. 138.It bba 139baseboard audio on 5000/xx systems. 140.It dz 141serial driver for DEC custom four-port serial device (dc7085 DZ-11 clone) 142on the baseboard of DECstation 2100/3100, 5100, and 5000/200 systems. 143.It zsc 144serial driver for Zilog SCC asynchronous/synchronous devices on the 145baseboard of DECstation 5000-series systems (excluding 5000/200). 146.It le 147Ethernet driver for baseboard or TURBOchannel option cards. 148.It ioasic 149Adaptor for the baseboard IO ASIC on second-generation TURBOchannel 150machines. 151An ioasic must be configured on a 5000/1xx, 5000/xx, and 5000/240 152if support for baseboard devices or the TURBOchannel bus is desired. 153.It wsdisplay 154Pseudo-device driver supporting glass-tty console emulation on DEC 155framebuffers, DEC mice, and LK-201 family keyboards. 156.It sii 157DEC custom SCSI adaptor on DECstation 2100, 3100, and 5100. 158.It pm 159DECstation 2100/3100 baseboard framebuffer 160.It tc 161Adaptor for the TURBOchannel I/O expansion bus. 162This must be included if any TURBOchannel option cards are supported, 163or for the baseboard Ethernet and SCSI devices on a 5000/200. 164.It cfb 165PMAG-B TURBOchannel 1024x876 unaccelerated 2-D framebuffer. 166.It sfb 167PMAGB-BA TURBOchannel 1280x1024 accelerated framebuffer. 168.It mfb 169PMAG-AA TURBOchannel 1280x1024 mono/greyscale unaccelerated framebuffer. 170.It tfb 171PMAG-JA and PMAG-RO TURBOchannel 1280x1024 unaccelerated framebuffer. 172.It px 173PMAG-C TURBOchannel 2-D accelerated graphics board. 174.It pxg 175PMAG-D, E and F TURBOchannel 2-D/3-D accelerated graphics boards. 176.El 177.Sh UNSUPPORTED DEVICES 178The following devices are not supported, due to unavailability of 179either documentation or sample hardware: 180.Pp 181.Bl -tag -width speaker -offset indent -compact 182.It LoFi 183DEC Western Research Labs audio card 184.El 185.Pp 186The floppy-disk drive on the MAXINE baseboard is currently not 187supported. 188.Sh HISTORY 189This 190.Tn pmax 191.Nm intro 192appeared in 193.Nx 1.2 . 194