en.4 revision 38702
1.Dd December 29, 1997
2.Dt EN 4
3.Os BSD
4.Sh NAME
5.Nm en
6.Nd
7device driver for Midway-based ATM interfaces
8.Sh SYNOPSIS
9.Cd "device en0"
10.Cd "pseudo-device atm"
11.Sh DESCRIPTION
12The 
13.Nm
14device driver supports Midway-based ATM interfaces including the
15Efficient Networks, Inc. ENI-155 and Adaptec ANA-59x0.
16Midway is an ALL5 SAR (Segmentation and Reassenbly) chip.
17.Pp
18The driver only supports ATM PVCs.  SVC or ATM-ARP is not supported.
19.Pp
20To configure the card for IP, use something like:
21.Dl # ifconfig en0 128.252.200.1 netmask 0xffffff00 up
22To add a PVC to a host you must use the ``route'' command:
23.Dl # route add -iface <remote IP address> -link en0:z.0.x.y
24where x and y are the byte encoding of the VCI to use, and z is the
25byte encoding of the following flags.
26.Dl 0x01 (use AAL5), 
27.Dl 0x02 (if using AAL5, use a LLCSNAP header)
28Thus, parameter 3 means AAL5 and LLC/SNAP encapsulation.
29Note that BPF works only with LLC/SNAP encapsulation.
30.Sh EXAMPLES
31Suppose you have 2 hosts 128.252.200.1 and 128.252.200.2 connected
32by ATM through PVC # 201 (0xc9).    
33To enable the link use the following commands:
34.Dl on host 128.252.200.1:
35.Dl	# ifconfig en0 128.252.200.1 netmask 0xffffff00 up
36.Dl	# route add -iface 128.252.200.2 -link en0:3.0.0.c9
37.Pp
38.Dl on host 128.252.200.2:
39.Dl	# ifconfig en0 128.252.200.2 netmask 0xffffff00 up
40.Dl	# route add -iface 128.252.200.1 -link en0:3.0.0.c9
41.Sh DIAGNOSTICS
42.Bl -diag
43.It	"en0 <Efficient Networks ENI-155p> rev 0 int a irq 5 on pci0:16"
44.It	"en0: ATM midway v0, board IDs 6.0, Utopia (pipelined), 512KB on-board RAM"
45.It	"en0: maximum DMA burst length = 64 bytes"
46.It	"en0: 7 32KB receive buffers, 8 32KB transmit buffers allocated"
47.El
48.Sh CAVEATS
49The driver extensively uses DMA on PCI. The first
50generation PCI chipsets do not work or exhibit poor performance.
51.Sh SEE ALSO
52.Xr ifconfig 8 , 
53.Xr pvcsif 8 , 
54.Xr pvctxctl 8 ,
55.Xr route 8
56.Sh AUTHORS
57Chuck Cranor of Washington University implemented EN driver
58in 1996 for NetBSD.
59