xref: /csrg-svn/share/man/man4/man4.vax/np.4 (revision 61599)
1*61599Sbostic.\" Copyright (c) 1986, 1991, 1993
2*61599Sbostic.\"	The Regents of the University of California.  All rights reserved.
326209Ssklower.\"
443582Strent.\" %sccs.include.redist.man%
526209Ssklower.\"
6*61599Sbostic.\"     @(#)np.4	8.1 (Berkeley) 06/05/93
736756Sbostic.\"
847674Scael.Dd
947674Scael.Dt NP 4 vax
1047674Scael.Os BSD 4.2
1147674Scael.Sh NAME
1247674Scael.Nm np
1347674Scael.Nd Interlan Np100 10 Mb/s Ethernet interface
1447674Scael.Sh SYNOPSIS
1547674Scael.Cd "device np0 at uba0 csr 166000 vector npintr"
1647674Scael.Sh DESCRIPTION
1726209SsklowerThe
1847674Scael.Nm np
1928257Skarelsdevice provides access to an Interlan Np100 Ethernet interface
2026209Ssklowerfor control functions.
2147674Scael.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.
2847674Scael.\" .Pp
2947674Scael.\" A program to load the image is provided in
3047674Scael.\" .Pa /usr/src/new/np100 .
3147674Scael.\" The sequence of commands would be:
3247674Scael.\" .Bd -literal -offset indent
3347674Scael.\" # ./npload np.image [/dev/np00]
3447674Scael.\" # sleep 10
3547674Scael.\" # ifconfig ix0 ...
3647674Scael.\" .Ed
3747674Scael.Pp
3828257SkarelsMultiple control processes are allowed by opening separate
3926209Ssklowerminor devices; secondary interfaces are specified by shifting
4026209Ssklowerthe interface number by 4 bits.
4147674Scael.Pp
4226209SsklowerThe device also responds to commands passed through the driver
4347674Scaelby the following
4447674Scael.Xr ioctl 2 Ns s :
4547674Scael.Bl -tag -width NPNETBOOT
4647674Scael.It Dv NPRESET
4728257Skarelskills off all active network processes.
4847674Scael.It Dv NPSTART
4947674Scaelbegins execution of the board at the specified address (usually
5047674Scael.Li 0x400 ) .
5147674Scael.It Dv NPNETBOOT
5226209Ssklowerdownloads the image from a server on the network.
5347674Scael[Contact
5447674Scael.Tn MICOM-INTERLAN
5547674Scaelfor details.]
5647674Scael.El
5747674Scael.Sh DIAGNOSTICS
5847674Scael.Bl -diag
5947674Scael.It np%d: Bad Maintenance command: %x!
6047674ScaelAn invalid
6147674Scael.Xr ioctl
6247674Scaelwas passed to the np driver.
6347674Scael.Pp
6447674Scael.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.
6847674Scael.Pp
6947674Scael.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:
7347674Scael.Pp
7447674Scael.Bd -filled -offset indent -compact
7547674Scael.It NP100 Unit %d timed out!
7647674Scael.It NP100 Unit %d Failed diagnostics!
7747674Scael.It Status from CSR0: %x.
7847674Scael.Ed
7947674Scael.Pp
8047674Scael.It "Panic from NP100 unit %d!"
8147674Scael.It "Panic Message: %s."
8228331SanneAn occurrence on the board was deemed serious enough
8326209Ssklowerto have the vax print it out.
8447674Scael.Pp
8547674Scael.It NP100 unit #%d available!
8628331SanneThe board was successfully loaded and started.
8747674Scael.Pp
8847674Scael.It np%d: Bad Req: %x.
8926209SsklowerThe board made a maintenance request to the vax that it did not
9026209Ssklowerunderstand.
9147674Scael.Pp
9247674Scael.It np%d: No more room on Command Queue!
9326209SsklowerThe np driver allowed an internal resource to be exhausted.
9426209SsklowerThis should never happen.
9547674Scael.El
9647674Scael.Pp
9726209SsklowerThere are 110 other diagnostic messages that can be enabled
9826209Ssklowerby setting bits in a debugging mask.
9926209SsklowerConsult the driver for details.
10047674Scael.Sh SEE ALSO
10147674Scael.Xr netintro 4 ,
10247674Scael.Xr inet 4 ,
10347674Scael.Xr arp 4 ,
10447674Scael.Xr ix 4
10547674Scael.Sh HISTORY
10647674ScaelThe
10747674Scael.Nm
10847674Scaeldriver appeared in
10947674Scael.Bx 4.3 .
110