xref: /csrg-svn/share/man/man4/man4.vax/dmf.4 (revision 47674)
1*47674Scael.\" Copyright (c) 1983, 1991 Regents of the University of California.
2*47674Scael.\" All rights reserved.
320712Smckusick.\"
4*47674Scael.\" %sccs.include.redist.man%
520712Smckusick.\"
6*47674Scael.\"     @(#)dmf.4	6.5 (Berkeley) 03/27/91
7*47674Scael.\"
8*47674Scael.Dd
9*47674Scael.Dt DMF 4 vax
10*47674Scael.Os BSD 4.2
11*47674Scael.Sh NAME
12*47674Scael.Nm dmf
13*47674Scael.Nd
14*47674Scael.Tn DMF-32
15*47674Scaelterminal multiplexor
16*47674Scael.Sh SYNOPSIS
17*47674Scael.Cd "device dmf0 at uba? csr 0160340 vector dmfsrint dmfsxint dmfdaint dmfdbint dmfrint dmfxint dmflint"
18*47674Scael.Sh DESCRIPTION
19*47674ScaelThe
20*47674Scael.Nm dmf
2127454Sdonndevice provides 8 lines of asynchronous serial line support.
2227454SdonnThe first two of these have full modem control.
2327454SdonnThe device also provides a line printer port
24*47674Scaelsimilar to the
25*47674Scael.Tn LP-11 .
26*47674ScaelOther features of the
27*47674Scael.Tn DMF-32
28*47674Scaelare not supported.
29*47674ScaelDuring autoconfiguration, the driver examines the configuration of each
30*47674Scael.Tn DMF-32
3128259Skarelsand adjusts the interrupt vectors so that fewer vector locations are used
3228259Skarelsif possible.
33*47674Scael.Pp
34*47674ScaelAn optional argument
35*47674Scael.Ar flags
36*47674Scaelmay be supplied with the device specification
37*47674Scaelin the config file indicating
38*47674Scaelthat the line corresponding to
39*47674Scaelbit number
40*47674Scael.Ar i
41*47674Scaelis not properly
42*47674Scaelconnected, and should be treated as hard-wired with carrier
43*47674Scaelalways present.  Thus specifying
44*47674Scael.Ql flags 0x04
45*47674Scaelfor
46*47674Scael.Li dmf0
47*47674Scaelwould cause line
48*47674Scael.Pa ttyA2
49*47674Scaelto be treated in this way.
5028259SkarelsFlags should be set for all lines without hardware support for modem control.
51*47674Scael.Pp
52*47674ScaelNormal
53*47674Scael.Tn I/O
54*47674Scaelcontrol parameters for individual lines are managed by
55*47674Scael.Xr ioctl 2
56*47674Scaelcalls.
57*47674ScaelLine speeds may be initiated via
58*47674Scael.Xr getty 8
59*47674Scaeland
60*47674Scael.Xr stty 1
61*47674Scaelor may be communicated by other programs which
62*47674Scaelutilize
63*47674Scael.Xr ioctl
64*47674Scaelsuch as
65*47674Scael.Xr ifcongif 8 ,
66*47674Scaelsee
67*47674Scael.Xr tty 4  .
68*47674Scael.Pp
6927454SdonnThe serial line part of the
70*47674Scael.Nm dmf
7128259Skarelsdriver normally enables the input silos with a short timeout
7228259Skarels(30 milliseconds); this allows multiple characters to be received
7328259Skarelsper interrupt during periods of high-speed input.
74*47674Scael.Pp
75*47674ScaelA line printer port on a
76*47674Scael.Nm dmf
7727454Sdonnis designated by
78*47674Scaela minor device number of the form
79*47674Scael.Pf 128+ Ns Ar n .
80*47674ScaelSee
81*47674Scael.Xr MAKEDEV 8 .
82*47674ScaelColumn and lines per page may be changed from the default
8327454Sdonn132 columns and 66 lines by encoding the number of columns
8427454Sdonnin bits 8-15 of flags and the number of lines in bits 16-23.
8527454SdonnThis device does not provide the fancy output canonicalization
8627454Sdonnfeatures of the
87*47674Scael.Xr lp 4
8827454Sdonndriver.
89*47674Scael.Sh FILES
90*47674Scael.Bl -tag -width "/dev/tty[A-CE-I][0-7]" -compact
91*47674Scael.It Pa /dev/tty[A-CE-I][0-7]
92*47674Scael.It Pa /dev/ttyd[0-7]
93*47674Scael.It Pa /dev/lp
94*47674Scael.El
95*47674Scael.Sh DIAGNOSTICS
96*47674Scael.Bl -diag
97*47674Scael.It dmf%d: NXM line %d.
98*47674ScaelNo response from
99*47674Scael.Tn UNIBUS
100*47674Scaelon a DMA transfer
101*47674Scaelwithin a timeout period.  This is often followed by a
102*47674Scael.Tn UNIBUS
103*47674Scaeladapter
104*47674Scaelerror.  This occurs most frequently when the
105*47674Scael.Tn UNIBUS
106*47674Scaelis heavily loaded
107*47674Scaeland when devices which hog the bus (such as
108*47674Scael.Tn RK07 Ns s )
109*47674Scaelare present.
11020712SmckusickIt is not serious.
111*47674Scael.Pp
112*47674Scael.It dmf%d: silo overflow.
11320712SmckusickThe character input silo overflowed
11420712Smckusickbefore it could be serviced.  This can happen if a hard error occurs
115*47674Scaelwhen the
116*47674Scael.Tn CPU
117*47674Scaelis running with elevated priority, as the system will
11827454Sdonnthen print a message on the console with interrupts disabled.
11920712SmckusickIt is not serious.
120*47674Scael.Pp
121*47674Scael.It dmfsrint, dmfsxint, dmfdaint, dmfdbint.
12220712SmckusickOne of the unsupported parts of the dmf interrupted; something
12320712Smckusickis amiss, check your interrupt vectors for a conflict with another
12420712Smckusickdevice.
125*47674Scael.El
126*47674Scael.Sh SEE ALSO
127*47674Scael.Xr tty 4
128*47674Scael.Sh HISTORY
129*47674ScaelThe
130*47674Scael.Nm
131*47674Scaeldriver appeared in
132*47674Scael.Bx 4.2 .
133*47674Scael.Sh BUGS
13428259SkarelsIt should be possible to set the silo timeout with a configuration file option,
13528259Skarelsas the value is a trade-off between efficiency and response time for flow
13628259Skarelscontrol and character echo.
137