1.\" $NetBSD: ne.4,v 1.17 2012/08/03 21:25:46 rkujawa Exp $ 2.\" 3.\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility, 8.\" NASA Ames Research Center. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29.\" POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd August 3, 2012 32.Dt NE 4 33.Os 34.Sh NAME 35.Nm ne 36.Nd NE2000 and compatible Ethernet cards device driver 37.Sh SYNOPSIS 38.Ss ISA boards 39.Cd "ne0 at isa? port 0x280 irq 9" 40.Cd "ne1 at isa? port 0x300 irq 10" 41.Cd "ne* at isapnp?" 42.Ss MCA boards 43.Cd "ne* at mca? slot ?" 44.Ss PCI boards 45.Cd "ne* at pci? dev ? function ?" 46.Ss PCMCIA 47.Cd "ne* at pcmcia? function ?" 48.Ss acorn32 49.Cd "ne* at podulebus?" 50.Ss amiga 51.Cd "ne* at zbus0" # AriadneII 52.Cd "ne* at xsurfbus?" # X-Surf 53.Ss amigappc 54.Cd "ne* at zbus0" # AriadneII 55.Cd "ne* at xsurfbus?" # X-Surf 56.Ss atari 57.Cd "ne0 at mainbus0 # EtherNEC on Atari ROM cartridge slot" 58.Ss evbarm 59.Cd "ne0 at obio? addr 0x0e000200 intr 5 # on-board Asix AX88796" 60.Ss evbsh3 61.Cd "ne0 at mainbus? # Realtek RTL8019AS" 62.Ss x68k 63.Cd "ne* at intio0 addr 0xece300 intr 249 # Nereid Ethernet" 64.Cd "ne* at intio0 addr 0xeceb00 intr 248 # Nereid Ethernet" 65.Cd "neptune0 at intio0 addr 0xece000 intr 249 # Neptune-X" 66.Cd "neptune1 at intio0 addr 0xece400 intr 249 # Neptune-X at alt. addr." 67.Cd "ne* at neptune? addr 0x300" 68.Sh DESCRIPTION 69The 70.Nm 71device driver supports NE2000 and compatible (including NE1000) Ethernet 72cards. 73While the original NE2000 is designed for ISA bus, the compatible 74Realtek 8019 chip is widely used on various local busses and 75.Nm 76driver also supports such devices on various machines. 77.Sh MEDIA SELECTION 78The Realtek 8019 (ISA, ISAPnP, some PCMCIA) and Realtek 8029 (PCI) 79NE2000-compatible Ethernet chips include support for software media 80selection. 81If one of these chips is detected by the driver, the list 82of supported media will be displayed. 83.Pp 84For all other chips supported by the 85.Nm 86driver, media selection must be performed either via card jumper 87settings or by vendor-supplied configuration programs. 88.Sh DIAGNOSTICS 89.Bl -diag 90.It "ne0: where did the card go?" 91The driver found the card, but was unable to make the card respond 92to complete the configuration sequence. 93.El 94.Sh SEE ALSO 95.Xr ifmedia 4 , 96.Xr intro 4 , 97.Xr isa 4 , 98.Xr isapnp 4 , 99.Xr mca 4 , 100.Xr pci 4 , 101.Xr pcmcia 4 , 102.Xr ifconfig 8 103