1.\" $NetBSD: ne.4,v 1.21 2013/08/14 17:42:03 wiz 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 14, 2013 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.Cd "ne* at xshbus?" # X-Surf 100 54.Ss amigappc 55.Cd "ne* at zbus0" # AriadneII 56.Cd "ne* at xsurfbus?" # X-Surf 57.Cd "ne* at xshbus?" # X-Surf 100 58.Ss atari 59.Cd "ne0 at mainbus0 # EtherNEC on Atari ROM cartridge slot" 60.Ss evbarm 61.Cd "ne0 at obio? addr 0x0e000200 intr 5 # on-board Asix AX88796" 62.Ss evbsh3 63.Cd "ne0 at mainbus? # Realtek RTL8019AS" 64.Ss x68k 65.Cd "ne* at intio0 addr 0xece300 intr 249 # Nereid Ethernet" 66.Cd "ne* at intio0 addr 0xeceb00 intr 248 # Nereid Ethernet" 67.Cd "neptune0 at intio0 addr 0xece000 intr 249 # Neptune-X" 68.Cd "neptune1 at intio0 addr 0xece400 intr 249 # Neptune-X at alt. addr." 69.Cd "ne* at neptune? addr 0x300" 70.Sh DESCRIPTION 71The 72.Nm 73device driver supports NE2000 and compatible (including NE1000) Ethernet 74cards. 75While the original NE2000 is designed for ISA bus, the compatible 76Realtek 8019 chip is widely used on various local busses and 77.Nm 78driver also supports such devices on various machines. 79.Sh MEDIA SELECTION 80The Realtek 8019 (ISA, ISAPnP, some PCMCIA) and Realtek 8029 (PCI) 81NE2000-compatible Ethernet chips include support for software media 82selection. 83.Pp 84Some cards based on AX88x9x chips (like X-Surf 100) also support media 85selection and link auto negotiation through the 86.Xr mii 4 87interface. 88.Pp 89If one of the above chips is detected by the driver, the list of supported 90media will be displayed. 91.Pp 92For all other chips supported by the 93.Nm 94driver, media selection must be performed either via card jumper 95settings or by vendor-supplied configuration programs. 96.Sh DIAGNOSTICS 97.Bl -diag 98.It "ne0: where did the card go?" 99The driver found the card, but was unable to make the card respond 100to complete the configuration sequence. 101.El 102.Sh SEE ALSO 103.Xr ifmedia 4 , 104.Xr intro 4 , 105.Xr isa 4 , 106.Xr isapnp 4 , 107.Xr mca 4 , 108.Xr pci 4 , 109.Xr pcmcia 4 , 110.Xr ifconfig 8 111