1*61588Sbostic.\" Copyright (c) 1983, 1991, 1993 2*61588Sbostic.\" The Regents of the University of California. All rights reserved. 330225Ssam.\" 447673Scael.\" %sccs.include.redist.man% 530225Ssam.\" 6*61588Sbostic.\" @(#)dr.4 8.1 (Berkeley) 06/05/93 747673Scael.\" 847673Scael.Dd 947673Scael.Dt DR 4 tahoe 1047673Scael.Os BSD 4.2 1147673Scael.Sh NAME 1247673Scael.Nm dr 1347673Scael.Nd Ikon 1447673Scael.Tn DR-11W 1547673Scaelinterface 1647673Scael.Sh SYNOPSIS 1747673Scael.Cd "device dr0 at vba? csr 0xffff8000 vector drintr" 1847673Scael.Sh DESCRIPTION 1930225SsamThe 2047673Scael.Nm dr 2130225Ssamdriver provides access 2247673Scaelto an Ikon 2347673Scael.Tn DR-11W 2447673Scael.Tn DMA 2547673Scaelcontroller. 2630225SsamEach minor device is a different controller. 2747673Scael.Pp 2830225SsamIn addition to reading and writing, the following 2947673Scael.Xr ioctl 2 3030225Ssamrequests are available: 3147673Scael.Bl -tag -width DRSETNORSTALL 3247673Scael.It Dv DRWAIT 3330225SsamWait for an attention interrupt from the associated device. 3447673Scael.It Dv DRPIOW 3547673ScaelWrite to the programmed 3647673Scael.Tn I/O 3747673Scaelregister. 3847673Scael.It Dv DRPACL 3930225SsamWrite to the pulse register. 4047673Scael.It Dv DRDACL 4147673ScaelSet the ``ac-low'' bit in the next command sent to the 4247673Scael.Tn DR-11W . 4347673Scael.It Dv DRPCYL 4447673ScaelSet the ``cycle'' bit in the next command sent to the 4547673Scael.Tn DR-11W . 4647673Scael.It Dv DRDFCN 4730225SsamHold the function bits until the next command is issused. 4847673Scael.It Dv DRRATN 4930225SsamReset the attention flag. 5047673Scael.It Dv DRRDMA 5147673ScaelReset the 5247673Scael.Tn DMA 5347673Scaelcomplete flag. 5447673Scael.It Dv DRSFCN 5530225SsamSet the function bits in the control status register and, 5630225Ssamas a side effect, clear the interrupt enable flag. 5747673Scael.It Dv DRRPER 5830225SsamReset the parity error flag. 5947673Scael.It Dv DRSETRSTALL 6030225SsamSet ``no stall'' mode for all subsequent reads. 6130225SsamIn no stall mode the driver will abort 6230225Ssamread requests that fail to complete before a user 6330225Ssamspecified timeout expires. 6447673Scael.It Dv DRSETNORSTALL 6530225SsamDisable no stall mode for reads. 6647673Scael.It Dv DRGETRSTALL 6730225SsamReturn true if in no stall mode for reads. 6847673Scael.It Dv DRSETRTIMEOUT 6930225SsamSet the value of the timeout used in no stall mode for 7030225Ssamreads. The time is specified in tenths of seconds. 7147673Scael.It Dv DRGETRTIMEOUT 7230225SsamReturn the time until (in tenths of seconds) before a read 7330225Ssamis timed out when in no stall mode. 7447673Scael.It Dv DRSETWSTALL 7530225SsamSet ``no stall'' mode for all subsequent writes. 7630225SsamIn no stall mode the driver will abort 7730225Ssamwrite requests that fail to complete before a user 7830225Ssamspecified timeout expires. 7947673Scael.It Dv DRSETNOWSTALL 8030225SsamDisable no stall mode for writes. 8147673Scael.It Dv DRGETWSTALL 8230225SsamReturn true if in no stall mode for writes. 8347673Scael.It Dv DRSETWTIMEOUT 8430225SsamSet the value of the timeout used in no stall mode for 8530225Ssamwrites. The time is specified in tenths of seconds. 8647673Scael.It Dv DRGETRTIMEOUT 8730225SsamReturn the time until (in tenths of seconds) before a write 8830225Ssamis timed out when in no stall mode. 8947673Scael.It Dv DRWRITEREADY 9030225SsamReturn 1 if the device can accept data, 0 otherwise 9147673Scael(this is really the 9247673Scael.Tn DR-11W A 9347673Scaelstatus bit). 9447673Scael.It Dv DRREADREADY 9530225SsamReturn 1 if the device has data for the host to read, 9647673Scael0 otherwise (this is really the 9747673Scael.Tn DR-11W B 9847673Scaelstatus bit). 9947673Scael.It Dv DRBUSY 10030225SsamReturn 1 if the device is busy, 0 otherwise. 10147673Scael.It Dv DRRESET 10230225SsamReset the DR-11W. 10347673Scael.It Dv DR11STAT 10430225SsamReturn the driver status and the contents of the 10547673Scael.Tn DR-11W 10647673Scael.Tn I/O registers. The 10730225Ssameight words returned are, in order, the driver 10830225Ssamstatus flags, the contents of the control status 10930225Ssamregister, the contents of the status register 11030225Ssamat the time of the last interrupt from the device, 11147673Scaelthe contents of the programmed 11247673Scael.Tn I/O data register, 11330225Ssama combination of the address modifier used by the 11447673Scaeldevice in performing 11547673Scael.Tn VERSAbus 11647673Scaeltransfers and the 11730225Ssaminterrupt vector used by the device, the contents 11830225Ssamof the range register, the contents of the rahi 11930225Ssamregister, and the contents of the ralo register. 12047673Scael.It Dv DR11LOOP 12130225SsamPerform loopback testing (the loopback cable must 12230225Ssambe in place for this to work). 12347673Scael.El 12447673Scael.Sh FILES 12547673Scael.Bl -tag -width /dev/dr[0-7]xx -compact 12647673Scael.It Pa /dev/dr[0-7] 12747673Scaelstandard devices 12847673Scael.El 12947673Scael.Sh DIAGNOSTICS 13030225SsamLots of them, none of them meaningful. 13147673Scael.Sh HISTORY 13247673ScaelThe 13347673Scael.Nm 13447673Scaeldriver appeared in 13547673Scael.Bx 4.3 tahoe . 13647673Scael.Sh BUGS 13730225SsamThis driver needs to be rewritten. 138