xref: /csrg-svn/share/man/man4/man4.vax/tu.4 (revision 61600)
1*61600Sbostic.\" Copyright (c) 1980, 1991, 1993
2*61600Sbostic.\"	The Regents of the University of California.  All rights reserved.
320690Smckusick.\"
447674Scael.\" %sccs.include.redist.man%
520690Smckusick.\"
6*61600Sbostic.\"     @(#)tu.4	8.1 (Berkeley) 06/05/93
747674Scael.\"
847674Scael.Dd
947674Scael.Dt TU 4 vax
1047674Scael.Os BSD 4
1147674Scael.Sh NAME
1247674Scael.Nm tu
1347674Scael.Nd
1447674Scael.Tn VAX-11/730
1547674Scaeland
1647674Scael.Tn VAX-11/750
1747674Scael.Tn TU58
1847674Scaelconsole cassette interface
1947674Scael.Sh SYNOPSIS
2047674Scael.Cd "options MRSP"
2147674Scael(for
2247674Scael.Tn VAX-11/750 Ns 's
2347674Scaelwith an
2447674Scael.Tn MRSP
2547674Scaelprom)
2647674Scael.Sh DESCRIPTION
2720691SmckusickThe
2847674Scael.Nm tu
2947674Scaelinterface provides access to the
3047674Scael.Tn VAX
3147674Scael11/730 and 11/750
3247674Scael.Tn TU58
3347674Scaelconsole
3420691Smckusickcassette drive(s).
3547674Scael.Pp
3647674ScaelThe interface supports only block
3747674Scael.Tn I/O
3847674Scaelto the
3947674Scael.Tn TU58
4047674Scaelcassettes.
4120691SmckusickThe devices are normally manipulated with the
4247674Scael.Xr arff 8
4320691Smckusickprogram using the ``f'' and ``m'' options.
4447674Scael.Pp
4520691SmckusickThe device driver is automatically included when a
4620691Smckusicksystem is configured to run on an 11/730 or 11/750.
4747674Scael.Pp
4847674ScaelThe
4947674Scael.Tn TU58
5047674Scaelon an 11/750 uses the Radial Serial Protocol
5147674Scael.Pq Tn RSP
5220691Smckusickto communicate with the cpu over a serial line.  This
5320691Smckusickprotocol is inherently unreliable as it has no flow
5420691Smckusickcontrol measures built in.  On an 11/730 the Modified
5520691SmckusickRadial Serial Protocol is used.  This protocol incorporates
5620691Smckusickflow control measures which insure reliable data transfer
5720691Smckusickbetween the cpu and the device.  Certain 11/750's have
5847674Scaelbeen modified to use the
5947674Scael.Tn MRSP
6047674Scaelprom used in the 11/730.
6147674ScaelTo reliably use the console
6247674Scael.Tn TU58
6347674Scaelon an 11/750 under
6447674Scael.Tn UNIX ,
6547674Scaelthe
6647674Scael.Tn MRSP
6747674Scaelprom is required.  For those 11/750's without
6847674Scaelan
6947674Scael.Tn MRSP
7047674Scaelprom, an unreliable but often
7120691Smckusickuseable interface has been developed.
7220691SmckusickThis interface uses an assembly language ``pseudo-dma'' routine
7320691Smckusickto minimize the receiver interrupt service latency.
7420691SmckusickTo include this code in
7547674Scaelthe system, the configuration must
7647674Scael.Em not
7747674Scaelspecify the
7847674Scaelsystem will run on an 11/730 or use an
7947674Scael.Tn MRSP
8047674Scaelprom.
8120691SmckusickThis unfortunately makes it impossible to configure a
8247674Scaelsingle system which will properly handle
8347674Scael.Tn TU58 Ns 's
8447674Scaelon both an 11/750
8547674Scaeland an 11/730 (unless both machines have
8647674Scael.Tn MRSP
8747674Scaelproms).
8847674Scael.Sh FILES
8947674Scael.Bl -tag -width /dev/tu0xx -compact
9047674Scael.It Pa /dev/tu0
9147674Scael.It Pa /dev/tu1
9247674Scael(only on a
9347674Scael.Tn VAX Ns \-11/730)
9447674Scael.El
9547674Scael.Sh DIAGNOSTICS
9647674Scael.Bl -diag
9747674Scael.It tu%d: no bp, active %d.
9820691SmckusickA transmission complete interrupt was received with no outstanding
9947674Scael.Tn I/O
10047674Scaelrequest.  This indicates a hardware problem.
10147674Scael.Pp
10247674Scael.It "tu%d protocol error, state=%s, op=%x, cnt=%d, block=%d."
10320691SmckusickThe driver entered an illegal state.  The information printed
10420691Smckusickindicates the illegal state, operation currently being executed,
10547674Scaelthe
10647674Scael.Tn I/O
10747674Scaelcount, and the block number on the cassette.
10847674Scael.Pp
10947674Scael.It "tu%d receive state error, state=%s, byte=%x."
11020691SmckusickThe driver entered an illegal state in the receiver finite
11120691Smckusickstate machine.  The state is shown along with the control
11220691Smckusickbyte of the received packet.
11347674Scael.Pp
11447674Scael.It tu%d: read stalled.
11520691SmckusickA timer watching the controller detected no interrupt for
11620691Smckusickan extended period while an operation was outstanding.
11720691SmckusickThis usually indicates that one or more receiver interrupts
11820691Smckusickwere lost and the transfer is restarted (11/750 only).
11947674Scael.Pp
12047674Scael.It tu%d: hard error bn%d, pk_mod %o.
12120691SmckusickThe device returned a status code indicating a hard error. The
12220691Smckusickactual error code is shown in octal. No retries are attempted
12320691Smckusickby the driver.
12447674Scael.El
12547674Scael.Sh SEE ALSO
12647674Scael.Xr arff 8
12747674Scael.Sh HISTORY
12847674ScaelThe
12947674Scael.Nm
13047674Scaeldriver appeared in
13147674Scael.Bx 4.1 .
13247674Scael.Sh BUGS
13347674ScaelThe
13447674Scael.Tn VAX Ns \-11/750
13547674Scaelconsole interface without
13647674Scael.Tn MRSP
13747674Scaelprom is unuseable
13820691Smckusickwhile the system is multi-user; it should be used only with
13920691Smckusickthe system running single-user and, even then, with caution.
140