xref: /csrg-svn/share/man/man4/man4.vax/np.4 (revision 47674)
1*47674Scael.\" Copyright (c) 1986, 1991 The Regents of the University of California.
236756Sbostic.\" All rights reserved.
326209Ssklower.\"
443582Strent.\" %sccs.include.redist.man%
526209Ssklower.\"
6*47674Scael.\"     @(#)np.4	6.6 (Berkeley) 03/27/91
736756Sbostic.\"
8*47674Scael.Dd
9*47674Scael.Dt NP 4 vax
10*47674Scael.Os BSD 4.2
11*47674Scael.Sh NAME
12*47674Scael.Nm np
13*47674Scael.Nd Interlan Np100 10 Mb/s Ethernet interface
14*47674Scael.Sh SYNOPSIS
15*47674Scael.Cd "device np0 at uba0 csr 166000 vector npintr"
16*47674Scael.Sh DESCRIPTION
1726209SsklowerThe
18*47674Scael.Nm np
1928257Skarelsdevice provides access to an Interlan Np100 Ethernet interface
2026209Ssklowerfor control functions.
21*47674Scael.Pp
2226209SsklowerThis interface is unusual in that it requires loading firmware
2328257Skarelsinto the controller before it may be used as a network link-level interface.
2426209SsklowerThis is accomplished by opening a character special device,
2526209Ssklowerand writing data to it.
2626209SsklowerIt is also possible to do post-mortem debugging of firmware failures
2726209Ssklowerby reading the local memory of the device.
28*47674Scael.\" .Pp
29*47674Scael.\" A program to load the image is provided in
30*47674Scael.\" .Pa /usr/src/new/np100 .
31*47674Scael.\" The sequence of commands would be:
32*47674Scael.\" .Bd -literal -offset indent
33*47674Scael.\" # ./npload np.image [/dev/np00]
34*47674Scael.\" # sleep 10
35*47674Scael.\" # ifconfig ix0 ...
36*47674Scael.\" .Ed
37*47674Scael.Pp
3828257SkarelsMultiple control processes are allowed by opening separate
3926209Ssklowerminor devices; secondary interfaces are specified by shifting
4026209Ssklowerthe interface number by 4 bits.
41*47674Scael.Pp
4226209SsklowerThe device also responds to commands passed through the driver
43*47674Scaelby the following
44*47674Scael.Xr ioctl 2 Ns s :
45*47674Scael.Bl -tag -width NPNETBOOT
46*47674Scael.It Dv NPRESET
4728257Skarelskills off all active network processes.
48*47674Scael.It Dv NPSTART
49*47674Scaelbegins execution of the board at the specified address (usually
50*47674Scael.Li 0x400 ) .
51*47674Scael.It Dv NPNETBOOT
5226209Ssklowerdownloads the image from a server on the network.
53*47674Scael[Contact
54*47674Scael.Tn MICOM-INTERLAN
55*47674Scaelfor details.]
56*47674Scael.El
57*47674Scael.Sh DIAGNOSTICS
58*47674Scael.Bl -diag
59*47674Scael.It np%d: Bad Maintenance command: %x!
60*47674ScaelAn invalid
61*47674Scael.Xr ioctl
62*47674Scaelwas passed to the np driver.
63*47674Scael.Pp
64*47674Scael.It np%d: Panic NP100 bad buffer chain.
6526209SsklowerAn error occurred in an read or write operation causing it to
6626209Ssklowerrun out of buffers before it finished the operation.
6726209SsklowerThis indicates a kernel failure rather than a device failure.
68*47674Scael.Pp
69*47674Scael.It NP100 unit %d not found!
7028331SanneA failure occurred during initialization, such that the unibus
7126209Sskloweraddress expected for the board was found to be bad.
7226209SsklowerProbably indicates hardware problems with the board, as do the following:
73*47674Scael.Pp
74*47674Scael.Bd -filled -offset indent -compact
75*47674Scael.It NP100 Unit %d timed out!
76*47674Scael.It NP100 Unit %d Failed diagnostics!
77*47674Scael.It Status from CSR0: %x.
78*47674Scael.Ed
79*47674Scael.Pp
80*47674Scael.It "Panic from NP100 unit %d!"
81*47674Scael.It "Panic Message: %s."
8228331SanneAn occurrence on the board was deemed serious enough
8326209Ssklowerto have the vax print it out.
84*47674Scael.Pp
85*47674Scael.It NP100 unit #%d available!
8628331SanneThe board was successfully loaded and started.
87*47674Scael.Pp
88*47674Scael.It np%d: Bad Req: %x.
8926209SsklowerThe board made a maintenance request to the vax that it did not
9026209Ssklowerunderstand.
91*47674Scael.Pp
92*47674Scael.It np%d: No more room on Command Queue!
9326209SsklowerThe np driver allowed an internal resource to be exhausted.
9426209SsklowerThis should never happen.
95*47674Scael.El
96*47674Scael.Pp
9726209SsklowerThere are 110 other diagnostic messages that can be enabled
9826209Ssklowerby setting bits in a debugging mask.
9926209SsklowerConsult the driver for details.
100*47674Scael.Sh SEE ALSO
101*47674Scael.Xr netintro 4 ,
102*47674Scael.Xr inet 4 ,
103*47674Scael.Xr arp 4 ,
104*47674Scael.Xr ix 4
105*47674Scael.Sh HISTORY
106*47674ScaelThe
107*47674Scael.Nm
108*47674Scaeldriver appeared in
109*47674Scael.Bx 4.3 .
110