1.\" Copyright (c) 1983, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)dr.4 8.1 (Berkeley) 06/05/93 7.\" 8.Dd 9.Dt DR 4 tahoe 10.Os BSD 4.2 11.Sh NAME 12.Nm dr 13.Nd Ikon 14.Tn DR-11W 15interface 16.Sh SYNOPSIS 17.Cd "device dr0 at vba? csr 0xffff8000 vector drintr" 18.Sh DESCRIPTION 19The 20.Nm dr 21driver provides access 22to an Ikon 23.Tn DR-11W 24.Tn DMA 25controller. 26Each minor device is a different controller. 27.Pp 28In addition to reading and writing, the following 29.Xr ioctl 2 30requests are available: 31.Bl -tag -width DRSETNORSTALL 32.It Dv DRWAIT 33Wait for an attention interrupt from the associated device. 34.It Dv DRPIOW 35Write to the programmed 36.Tn I/O 37register. 38.It Dv DRPACL 39Write to the pulse register. 40.It Dv DRDACL 41Set the ``ac-low'' bit in the next command sent to the 42.Tn DR-11W . 43.It Dv DRPCYL 44Set the ``cycle'' bit in the next command sent to the 45.Tn DR-11W . 46.It Dv DRDFCN 47Hold the function bits until the next command is issused. 48.It Dv DRRATN 49Reset the attention flag. 50.It Dv DRRDMA 51Reset the 52.Tn DMA 53complete flag. 54.It Dv DRSFCN 55Set the function bits in the control status register and, 56as a side effect, clear the interrupt enable flag. 57.It Dv DRRPER 58Reset the parity error flag. 59.It Dv DRSETRSTALL 60Set ``no stall'' mode for all subsequent reads. 61In no stall mode the driver will abort 62read requests that fail to complete before a user 63specified timeout expires. 64.It Dv DRSETNORSTALL 65Disable no stall mode for reads. 66.It Dv DRGETRSTALL 67Return true if in no stall mode for reads. 68.It Dv DRSETRTIMEOUT 69Set the value of the timeout used in no stall mode for 70reads. The time is specified in tenths of seconds. 71.It Dv DRGETRTIMEOUT 72Return the time until (in tenths of seconds) before a read 73is timed out when in no stall mode. 74.It Dv DRSETWSTALL 75Set ``no stall'' mode for all subsequent writes. 76In no stall mode the driver will abort 77write requests that fail to complete before a user 78specified timeout expires. 79.It Dv DRSETNOWSTALL 80Disable no stall mode for writes. 81.It Dv DRGETWSTALL 82Return true if in no stall mode for writes. 83.It Dv DRSETWTIMEOUT 84Set the value of the timeout used in no stall mode for 85writes. The time is specified in tenths of seconds. 86.It Dv DRGETRTIMEOUT 87Return the time until (in tenths of seconds) before a write 88is timed out when in no stall mode. 89.It Dv DRWRITEREADY 90Return 1 if the device can accept data, 0 otherwise 91(this is really the 92.Tn DR-11W A 93status bit). 94.It Dv DRREADREADY 95Return 1 if the device has data for the host to read, 960 otherwise (this is really the 97.Tn DR-11W B 98status bit). 99.It Dv DRBUSY 100Return 1 if the device is busy, 0 otherwise. 101.It Dv DRRESET 102Reset the DR-11W. 103.It Dv DR11STAT 104Return the driver status and the contents of the 105.Tn DR-11W 106.Tn I/O registers. The 107eight words returned are, in order, the driver 108status flags, the contents of the control status 109register, the contents of the status register 110at the time of the last interrupt from the device, 111the contents of the programmed 112.Tn I/O data register, 113a combination of the address modifier used by the 114device in performing 115.Tn VERSAbus 116transfers and the 117interrupt vector used by the device, the contents 118of the range register, the contents of the rahi 119register, and the contents of the ralo register. 120.It Dv DR11LOOP 121Perform loopback testing (the loopback cable must 122be in place for this to work). 123.El 124.Sh FILES 125.Bl -tag -width /dev/dr[0-7]xx -compact 126.It Pa /dev/dr[0-7] 127standard devices 128.El 129.Sh DIAGNOSTICS 130Lots of them, none of them meaningful. 131.Sh HISTORY 132The 133.Nm 134driver appeared in 135.Bx 4.3 tahoe . 136.Sh BUGS 137This driver needs to be rewritten. 138