sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetA/translations/zh_CN/networking/device_drivers/ethernet/3com/3c509modnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/zh_TW/networking/device_drivers/ethernet/3com/3c509modnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/it_IT/networking/device_drivers/ethernet/3com/3c509modnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/ja_JP/networking/device_drivers/ethernet/3com/3c509modnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/ko_KR/networking/device_drivers/ethernet/3com/3c509modnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/sp_SP/networking/device_drivers/ethernet/3com/3c509modnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh[/var/lib/git/docbuild/linux/Documentation/networking/device_drivers/ethernet/3com/3c509.rsthKubhsection)}(hhh](htitle)}(hMLinux and the 3Com EtherLink III Series Ethercards (driver v1.18c and higher)h]hMLinux and the 3Com EtherLink III Series Ethercards (driver v1.18c and higher)}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hThis file contains the instructions and caveats for v1.18c and higher versions of the 3c509 driver. You should not use the driver without reading this file.h]hThis file contains the instructions and caveats for v1.18c and higher versions of the 3c509 driver. You should not use the driver without reading this file.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h release 1.0h]h release 1.0}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(h28 February 2002h]h28 February 2002}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubhdefinition_list)}(hhh]hdefinition_list_item)}(hGCurrent maintainer (corrections to): David Ruggiero h](hterm)}(h$Current maintainer (corrections to):h]h$Current maintainer (corrections to):}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhhubh definition)}(hhh]h)}(h!David Ruggiero h](hDavid Ruggiero <}(hjhhhNhNubh reference)}(hjdr@farfalle.comh]hjdr@farfalle.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:jdr@farfalle.comuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(hhh](h)}(h Introductionh]h Introduction}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhhhhhKubh)}(hXThe following are notes and information on using the 3Com EtherLink III series ethercards in Linux. These cards are commonly known by the most widely-used card's 3Com model number, 3c509. They are all 10mb/s ISA-bus cards and shouldn't be (but sometimes are) confused with the similarly-numbered PCI-bus "3c905" (aka "Vortex" or "Boomerang") series. Kernel support for the 3c509 family is provided by the module 3c509.c, which has code to support all of the following models:h]hXThe following are notes and information on using the 3Com EtherLink III series ethercards in Linux. These cards are commonly known by the most widely-used card’s 3Com model number, 3c509. They are all 10mb/s ISA-bus cards and shouldn’t be (but sometimes are) confused with the similarly-numbered PCI-bus “3c905” (aka “Vortex” or “Boomerang”) series. Kernel support for the 3c509 family is provided by the module 3c509.c, which has code to support all of the following models:}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjKhhubh block_quote)}(h- 3c509 (original ISA card) - 3c509B (later revision of the ISA card; supports full-duplex) - 3c589 (PCMCIA) - 3c589B (later revision of the 3c589; supports full-duplex) - 3c579 (EISA) h]h bullet_list)}(hhh](h list_item)}(h3c509 (original ISA card)h]h)}(hjyh]h3c509 (original ISA card)}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjwubah}(h]h ]h"]h$]h&]uh1juhjrubjv)}(h=3c509B (later revision of the ISA card; supports full-duplex)h]h)}(hjh]h=3c509B (later revision of the ISA card; supports full-duplex)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1juhjrubjv)}(h3c589 (PCMCIA)h]h)}(hjh]h3c589 (PCMCIA)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1juhjrubjv)}(h:3c589B (later revision of the 3c589; supports full-duplex)h]h)}(hjh]h:3c589B (later revision of the 3c589; supports full-duplex)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1juhjrubjv)}(h 3c579 (EISA) h]h)}(h 3c579 (EISA)h]h 3c579 (EISA)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjubah}(h]h ]h"]h$]h&]uh1juhjrubeh}(h]h ]h"]h$]h&]bullet-uh1jphhhKhjlubah}(h]h ]h"]h$]h&]uh1jjhhhKhjKhhubh)}(hXLarge portions of this documentation were heavily borrowed from the guide written the original author of the 3c509 driver, Donald Becker. The master copy of that document, which contains notes on older versions of the driver, currently resides on Scyld web server: http://www.scyld.com/.h](hX Large portions of this documentation were heavily borrowed from the guide written the original author of the 3c509 driver, Donald Becker. The master copy of that document, which contains notes on older versions of the driver, currently resides on Scyld web server: }(hjhhhNhNubj)}(hhttp://www.scyld.com/h]hhttp://www.scyld.com/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK"hjKhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hSpecial Driver Featuresh]hSpecial Driver Features}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hhhhhK)ubh)}(hOverriding card settingsh]hOverriding card settings}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hj"hhubh)}(hXThe driver allows boot- or load-time overriding of the card's detected IOADDR, IRQ, and transceiver settings, although this capability shouldn't generally be needed except to enable full-duplex mode (see below). An example of the syntax for LILO parameters for doing this::h]hXThe driver allows boot- or load-time overriding of the card’s detected IOADDR, IRQ, and transceiver settings, although this capability shouldn’t generally be needed except to enable full-duplex mode (see below). An example of the syntax for LILO parameters for doing this:}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hj"hhubh literal_block)}(hether=10,0x310,3,0x3c509,eth0h]hether=10,0x310,3,0x3c509,eth0}hjQsbah}(h]h ]h"]h$]h&]hhuh1jOhhhK2hj"hhubh)}(hXsThis configures the first found 3c509 card for IRQ 10, base I/O 0x310, and transceiver type 3 (10base2). The flag "0x3c509" must be set to avoid conflicts with other card types when overriding the I/O address. When the driver is loaded as a module, only the IRQ may be overridden. For example, setting two cards to IRQ10 and IRQ11 is done by using the irq module option::h]hXvThis configures the first found 3c509 card for IRQ 10, base I/O 0x310, and transceiver type 3 (10base2). The flag “0x3c509” must be set to avoid conflicts with other card types when overriding the I/O address. When the driver is loaded as a module, only the IRQ may be overridden. For example, setting two cards to IRQ10 and IRQ11 is done by using the irq module option:}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hj"hhubjP)}(hoptions 3c509 irq=10,11h]hoptions 3c509 irq=10,11}hjmsbah}(h]h ]h"]h$]h&]hhuh1jOhhhK;hj"hhubeh}(h]special-driver-featuresah ]h"]special driver featuresah$]h&]uh1hhhhhhhhK)ubh)}(hhh](h)}(hFull-duplex modeh]hFull-duplex mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK?ubh)}(hThe v1.18c driver added support for the 3c509B's full-duplex capabilities. In order to enable and successfully use full-duplex mode, three conditions must be met:h]hThe v1.18c driver added support for the 3c509B’s full-duplex capabilities. In order to enable and successfully use full-duplex mode, three conditions must be met:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjhhubh)}(hX(a) You must have a Etherlink III card model whose hardware supports full- duplex operations. Currently, the only members of the 3c509 family that are positively known to support full-duplex are the 3c509B (ISA bus) and 3c589B (PCMCIA) cards. Cards without the "B" model designation do *not* support full-duplex mode; these include the original 3c509 (no "B"), the original 3c589, the 3c529 (MCA bus), and the 3c579 (EISA bus).h](hX"(a) You must have a Etherlink III card model whose hardware supports full- duplex operations. Currently, the only members of the 3c509 family that are positively known to support full-duplex are the 3c509B (ISA bus) and 3c589B (PCMCIA) cards. Cards without the “B” model designation do }(hjhhhNhNubhemphasis)}(h*not*h]hnot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh support full-duplex mode; these include the original 3c509 (no “B”), the original 3c589, the 3c529 (MCA bus), and the 3c579 (EISA bus).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKEhjhhubh)}(h(b) You must be using your card's 10baseT transceiver (i.e., the RJ-45 connector), not its AUI (thick-net) or 10base2 (thin-net/coax) interfaces. AUI and 10base2 network cabling is physically incapable of full-duplex operation.h]h(b) You must be using your card’s 10baseT transceiver (i.e., the RJ-45 connector), not its AUI (thick-net) or 10base2 (thin-net/coax) interfaces. AUI and 10base2 network cabling is physically incapable of full-duplex operation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhjhhubh)}(hX:(c) Most importantly, your 3c509B must be connected to a link partner that is itself full-duplex capable. This is almost certainly one of two things: a full- duplex-capable Ethernet switch (*not* a hub), or a full-duplex-capable NIC on another system that's connected directly to the 3c509B via a crossover cable.h](h(c) Most importantly, your 3c509B must be connected to a link partner that is itself full-duplex capable. This is almost certainly one of two things: a full- duplex-capable Ethernet switch (}(hjhhhNhNubj)}(h*not*h]hnot}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhx a hub), or a full-duplex-capable NIC on another system that’s connected directly to the 3c509B via a crossover cable.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKQhjhhubh)}(h0Full-duplex mode can be enabled using 'ethtool'.h]h4Full-duplex mode can be enabled using ‘ethtool’.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjhhubhwarning)}(hXExtremely important caution concerning full-duplex mode Understand that the 3c509B's hardware's full-duplex support is much more limited than that provide by more modern network interface cards. Although at the physical layer of the network it fully supports full-duplex operation, the card was designed before the current Ethernet auto-negotiation (N-way) spec was written. This means that the 3c509B family ***cannot and will not auto-negotiate a full-duplex connection with its link partner under any circumstances, no matter how it is initialized***. If the full-duplex mode of the 3c509B is enabled, its link partner will very likely need to be independently _forced_ into full-duplex mode as well; otherwise various nasty failures will occur - at the very least, you'll see massive numbers of packet collisions. This is one of very rare circumstances where disabling auto- negotiation and forcing the duplex mode of a network interface card or switch would ever be necessary or desirable.h](h)}(h7Extremely important caution concerning full-duplex modeh]h7Extremely important caution concerning full-duplex mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhjubh)}(hXUnderstand that the 3c509B's hardware's full-duplex support is much more limited than that provide by more modern network interface cards. Although at the physical layer of the network it fully supports full-duplex operation, the card was designed before the current Ethernet auto-negotiation (N-way) spec was written. This means that the 3c509B family ***cannot and will not auto-negotiate a full-duplex connection with its link partner under any circumstances, no matter how it is initialized***. If the full-duplex mode of the 3c509B is enabled, its link partner will very likely need to be independently _forced_ into full-duplex mode as well; otherwise various nasty failures will occur - at the very least, you'll see massive numbers of packet collisions. This is one of very rare circumstances where disabling auto- negotiation and forcing the duplex mode of a network interface card or switch would ever be necessary or desirable.h](hXeUnderstand that the 3c509B’s hardware’s full-duplex support is much more limited than that provide by more modern network interface cards. Although at the physical layer of the network it fully supports full-duplex operation, the card was designed before the current Ethernet auto-negotiation (N-way) spec was written. This means that the 3c509B family }(hjhhhNhNubhstrong)}(h***cannot and will not auto-negotiate a full-duplex connection with its link partner under any circumstances, no matter how it is initialized***h]h*cannot and will not auto-negotiate a full-duplex connection with its link partner under any circumstances, no matter how it is initialized*}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX. If the full-duplex mode of the 3c509B is enabled, its link partner will very likely need to be independently _forced_ into full-duplex mode as well; otherwise various nasty failures will occur - at the very least, you’ll see massive numbers of packet collisions. This is one of very rare circumstances where disabling auto- negotiation and forcing the duplex mode of a network interface card or switch would ever be necessary or desirable.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK\hjubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]full-duplex-modeah ]h"]full-duplex modeah$]h&]uh1hhhhhhhhK?ubh)}(hhh](h)}(hAvailable Transceiver Typesh]hAvailable Transceiver Types}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhhhhhKlubh)}(hQFor versions of the driver v1.18c and above, the available transceiver types are:h]hQFor versions of the driver v1.18c and above, the available transceiver types are:}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjDhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jmhjjubjn)}(hhh]h}(h]h ]h"]h$]h&]colwidthKIuh1jmhjjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h0h]h0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hItransceiver type from EEPROM config (normally 10baseT); force half-duplexh]hItransceiver type from EEPROM config (normally 10baseT); force half-duplex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h1h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h AUI (thick-net / DB15 connector)h]h AUI (thick-net / DB15 connector)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h2h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h (undefined)h]h (undefined)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h3h]h3}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthj4ubah}(h]h ]h"]h$]h&]uh1jhj1ubj)}(hhh]h)}(h*10base2 (thin-net == coax / BNC connector)h]h*10base2 (thin-net == coax / BNC connector)}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjKubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h4h]h4}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjkubah}(h]h ]h"]h$]h&]uh1jhjhubj)}(hhh]h)}(h110baseT (RJ-45 connector); force half-duplex modeh]h110baseT (RJ-45 connector); force half-duplex mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjubah}(h]h ]h"]h$]h&]uh1jhjhubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h8h]h8}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hItransceiver type and duplex mode taken from card's EEPROM config settingsh]hKtransceiver type and duplex mode taken from card’s EEPROM config settings}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h12h]h12}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h110baseT (RJ-45 connector); force full-duplex modeh]h110baseT (RJ-45 connector); force full-duplex mode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]colsKuh1jhhjeubah}(h]h ]h"]h$]h&]uh1jchjDhhhhhNubh)}(hXPrior to driver version 1.18c, only transceiver codes 0-4 were supported. Note that the new transceiver codes 8 and 12 are the *only* ones that will enable full-duplex mode, no matter what the card's detected EEPROM settings might be. This insured that merely upgrading the driver from an earlier version would never automatically enable full-duplex mode in an existing installation; it must always be explicitly enabled via one of these code in order to be activated.h](hPrior to driver version 1.18c, only transceiver codes 0-4 were supported. Note that the new transceiver codes 8 and 12 are the }(hj hhhNhNubj)}(h*only*h]honly}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhXQ ones that will enable full-duplex mode, no matter what the card’s detected EEPROM settings might be. This insured that merely upgrading the driver from an earlier version would never automatically enable full-duplex mode in an existing installation; it must always be explicitly enabled via one of these code in order to be activated.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKzhjDhhubh)}(h4The transceiver type can be changed using 'ethtool'.h]h8The transceiver type can be changed using ‘ethtool’.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjDhhubh)}(hhh](h)}(h4Interpretation of error messages and common problemsh]h4Interpretation of error messages and common problems}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhhhhhKubh)}(hhh](h)}(hError Messagesh]hError Messages}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hhhhhKubh)}(hX^eth0: Infinite loop in interrupt, status 2011. These are "mostly harmless" message indicating that the driver had too much work during that interrupt cycle. With a status of 0x2011 you are receiving packets faster than they can be removed from the card. This should be rare or impossible in normal operation. Possible causes of this error report are:h]hXbeth0: Infinite loop in interrupt, status 2011. These are “mostly harmless” message indicating that the driver had too much work during that interrupt cycle. With a status of 0x2011 you are receiving packets faster than they can be removed from the card. This should be rare or impossible in normal operation. Possible causes of this error report are:}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj_hhubjk)}(hX6- a "green" mode enabled that slows the processor down when there is no keyboard activity. - some other device or device driver hogging the bus or disabling interrupts. Check /proc/interrupts for excessive interrupt counts. The timer tick interrupt should always be incrementing faster than the others. h]jq)}(hhh](jv)}(hYa "green" mode enabled that slows the processor down when there is no keyboard activity. h]h)}(hXa "green" mode enabled that slows the processor down when there is no keyboard activity.h]h\a “green” mode enabled that slows the processor down when there is no keyboard activity.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1juhjubjv)}(hsome other device or device driver hogging the bus or disabling interrupts. Check /proc/interrupts for excessive interrupt counts. The timer tick interrupt should always be incrementing faster than the others. h]h)}(hsome other device or device driver hogging the bus or disabling interrupts. Check /proc/interrupts for excessive interrupt counts. The timer tick interrupt should always be incrementing faster than the others.h]hsome other device or device driver hogging the bus or disabling interrupts. Check /proc/interrupts for excessive interrupt counts. The timer tick interrupt should always be incrementing faster than the others.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1juhjubeh}(h]h ]h"]h$]h&]jjuh1jphhhKhj~ubah}(h]h ]h"]h$]h&]uh1jjhhhKhj_hhubeh}(h]error-messagesah ]h"]error messagesah$]h&]uh1hhjNhhhhhKubh)}(hhh](h)}(hNo received packetsh]hNo received packets}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXeIf a 3c509, 3c562 or 3c589 can successfully transmit packets, but never receives packets (as reported by /proc/net/dev or 'ifconfig') you likely have an interrupt line problem. Check /proc/interrupts to verify that the card is actually generating interrupts. If the interrupt count is not increasing you likely have a physical conflict with two devices trying to use the same ISA IRQ line. The common conflict is with a sound card on IRQ10 or IRQ5, and the easiest solution is to move the 3c509 to a different interrupt line. If the device is receiving packets but 'ping' doesn't work, you have a routing problem.h]hXoIf a 3c509, 3c562 or 3c589 can successfully transmit packets, but never receives packets (as reported by /proc/net/dev or ‘ifconfig’) you likely have an interrupt line problem. Check /proc/interrupts to verify that the card is actually generating interrupts. If the interrupt count is not increasing you likely have a physical conflict with two devices trying to use the same ISA IRQ line. The common conflict is with a sound card on IRQ10 or IRQ5, and the easiest solution is to move the 3c509 to a different interrupt line. If the device is receiving packets but ‘ping’ doesn’t work, you have a routing problem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]no-received-packetsah ]h"]no received packetsah$]h&]uh1hhjNhhhhhKubh)}(hhh](h)}(h+Tx Carrier Errors Reported in /proc/net/devh]h+Tx Carrier Errors Reported in /proc/net/dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hIf an EtherLink III appears to transmit packets, but the "Tx carrier errors" field in /proc/net/dev increments as quickly as the Tx packet count, you likely have an unterminated network or the incorrect media transceiver selected.h]hIf an EtherLink III appears to transmit packets, but the “Tx carrier errors” field in /proc/net/dev increments as quickly as the Tx packet count, you likely have an unterminated network or the incorrect media transceiver selected.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]*tx-carrier-errors-reported-in-proc-net-devah ]h"]+tx carrier errors reported in /proc/net/devah$]h&]uh1hhjNhhhhhKubh)}(hhh](h)}(h=3c509B card is not detected on machines with an ISA PnP BIOS.h]h=3c509B card is not detected on machines with an ISA PnP BIOS.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hWhile the updated driver works with most PnP BIOS programs, it does not work with all. This can be fixed by disabling PnP support using the 3Com-supplied setup program.h]hWhile the updated driver works with most PnP BIOS programs, it does not work with all. This can be fixed by disabling PnP support using the 3Com-supplied setup program.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h];c509b-card-is-not-detected-on-machines-with-an-isa-pnp-biosah ]h"]=3c509b card is not detected on machines with an isa pnp bios.ah$]h&]uh1hhjNhhhhhKubh)}(hhh](h)}(h23c509 card is not detected on overclocked machinesh]h23c509 card is not detected on overclocked machines}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hhhhhKubh)}(hqIncrease the delay time in id_read_eeprom() from the current value, 500, to an absurdly high value, such as 5000.h]hqIncrease the delay time in id_read_eeprom() from the current value, 500, to an absurdly high value, such as 5000.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj>hhubeh}(h]1c509-card-is-not-detected-on-overclocked-machinesah ]h"]23c509 card is not detected on overclocked machinesah$]h&]uh1hhjNhhhhhKubeh}(h]4interpretation-of-error-messages-and-common-problemsah ]h"]4interpretation of error messages and common problemsah$]h&]uh1hhjDhhhhhKubh)}(hhh](h)}(h"Decoding Status and Error Messagesh]h"Decoding Status and Error Messages}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjmhhhhhKubh)}(h)The bits in the main status register are:h]h)The bits in the main status register are:}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjmhhubjd)}(hhh]ji)}(hhh](jn)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jmhjubjn)}(hhh]h}(h]h ]h"]h$]h&]colwidthK&uh1jmhjubhthead)}(hhh]j)}(hhh](j)}(hhh]h)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h descriptionh]h description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh](j)}(hhh]h)}(h0x01h]h0x01}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hInterrupt latchh]hInterrupt latch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x02h]h0x02}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj%ubah}(h]h ]h"]h$]h&]uh1jhj"ubj)}(hhh]h)}(hTx overrun, or Rx underrunh]hTx overrun, or Rx underrun}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj<ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x04h]h0x04}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj\ubah}(h]h ]h"]h$]h&]uh1jhjYubj)}(hhh]h)}(h Tx completeh]h Tx complete}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjsubah}(h]h ]h"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x08h]h0x08}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hTx FIFO room availableh]hTx FIFO room available}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x10h]h0x10}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h A complete Rx packet has arrivedh]h A complete Rx packet has arrived}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x20h]h0x20}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h!A Rx packet has started to arriveh]h!A Rx packet has started to arrive}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x40h]h0x40}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj8ubah}(h]h ]h"]h$]h&]uh1jhj5ubj)}(hhh]h)}(h%The driver has requested an interrupth]h%The driver has requested an interrupt}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjOubah}(h]h ]h"]h$]h&]uh1jhj5ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h0x80h]h0x80}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjoubah}(h]h ]h"]h$]h&]uh1jhjlubj)}(hhh]h)}(hStatistics counter nearly fullh]hStatistics counter nearly full}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhhjubah}(h]h ]h"]h$]h&]uh1jchjmhhhhhNubh)}(h.The bits in the transmit (Tx) status word are:h]h.The bits in the transmit (Tx) status word are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjmhhubjd)}(hhh]ji)}(hhh](jn)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jmhjubjn)}(hhh]h}(h]h ]h"]h$]h&]colwidthK,uh1jmhjubj)}(hhh]j)}(hhh](j)}(hhh]h)}(hvalueh]hvalue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h descriptionh]h description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh](j)}(hhh]h)}(h0x02h]h0x02}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj$ ubah}(h]h ]h"]h$]h&]uh1jhj! ubj)}(hhh]h)}(hOut-of-window collision.h]hOut-of-window collision.}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj; ubah}(h]h ]h"]h$]h&]uh1jhj! ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh](j)}(hhh]h)}(h0x04h]h0x04}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj[ ubah}(h]h ]h"]h$]h&]uh1jhjX ubj)}(hhh]h)}(h,Status stack overflow (normally impossible).h]h,Status stack overflow (normally impossible).}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjr ubah}(h]h ]h"]h$]h&]uh1jhjX ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh](j)}(hhh]h)}(h0x08h]h0x08}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h16 collisions.h]h16 collisions.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh](j)}(hhh]h)}(h0x10h]h0x10}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h+Tx underrun (not enough PCI bus bandwidth).h]h+Tx underrun (not enough PCI bus bandwidth).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh](j)}(hhh]h)}(h0x20h]h0x20}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h Tx jabber.h]h Tx jabber.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh](j)}(hhh]h)}(h0x40h]h0x40}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj7 ubah}(h]h ]h"]h$]h&]uh1jhj4 ubj)}(hhh]h)}(hTx interrupt requested.h]hTx interrupt requested.}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjN ubah}(h]h ]h"]h$]h&]uh1jhj4 ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh](j)}(hhh]h)}(h0x80h]h0x80}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjn ubah}(h]h ]h"]h$]h&]uh1jhjk ubj)}(hhh]h)}(h,Status is valid (this should always be set).h]h,Status is valid (this should always be set).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhjk ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhhjubah}(h]h ]h"]h$]h&]uh1jchjmhhhhhNubh)}(hKWhen a transmit error occurs the driver produces a status message such as::h]hJWhen a transmit error occurs the driver produces a status message such as:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjmhhubjP)}(h+eth0: Transmit error, Tx status register 82h]h+eth0: Transmit error, Tx status register 82}hj sbah}(h]h ]h"]h$]h&]hhuh1jOhhhKhjmhhubh)}(h'The two values typically seen here are:h]h'The two values typically seen here are:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjmhhubh)}(hhh](h)}(h0x82h]h0x82}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(hOut of window collision. This typically occurs when some other Ethernet host is incorrectly set to full duplex on a half duplex network.h]hOut of window collision. This typically occurs when some other Ethernet host is incorrectly set to full duplex on a half duplex network.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h]x82ah ]h"]0x82ah$]h&]uh1hhjmhhhhhKubh)}(hhh](h)}(h0x88h]h0x88}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(h16 collisions. This typically occurs when the network is exceptionally busy or when another host doesn't correctly back off after a collision. If this error is mixed with 0x82 errors it is the result of a host incorrectly set to full duplex (see above).h]h16 collisions. This typically occurs when the network is exceptionally busy or when another host doesn’t correctly back off after a collision. If this error is mixed with 0x82 errors it is the result of a host incorrectly set to full duplex (see above).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(h{Both of these errors are the result of network problems that should be corrected. They do not represent driver malfunction.h]h{Both of these errors are the result of network problems that should be corrected. They do not represent driver malfunction.}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h]x88ah ]h"]0x88ah$]h&]uh1hhjmhhhhhKubeh}(h]"decoding-status-and-error-messagesah ]h"]"decoding status and error messagesah$]h&]uh1hhjDhhhhhKubeh}(h]available-transceiver-typesah ]h"]available transceiver typesah$]h&]uh1hhhhhhhhKlubh)}(hhh](h)}(hRevision history (this file)h]hRevision history (this file)}(hjN hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjK hhhhhKubh)}(hJ28Feb02 v1.0 DR New; major portions based on Becker original 3c509 docsh]hJ28Feb02 v1.0 DR New; major portions based on Becker original 3c509 docs}(hj\ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjK hhubeh}(h]revision-history-this-fileah ]h"]revision history (this file)ah$]h&]uh1hhhhhhhhKubeh}(h]Klinux-and-the-3com-etherlink-iii-series-ethercards-driver-v1-18c-and-higherah ]h"]Mlinux and the 3com etherlink iii series ethercards (driver v1.18c and higher)ah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jw jt jjjj}jAj>jH jE jjjgjjjjjjj;j8jbj_j@ j= j j j8 j5 jo jl u nametypes}(jw jjjAjH jjjjjj;jbj@ j j8 jo uh}(jt hjjKj}j"j>jjE jDjgjNjj_jjjjj8jj_j>j= jmj j j5 j jl jK u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.