> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man4/xl.4.md).

# xl.4

`xl` — 3Com Etherlink XL 和 Fast Etherlink XL 以太网设备驱动

## 名称

`xl`

## 概要

`要将此驱动编译进内核，请将以下行放入你的内核配置文件：`

> device miibus device xl

`或者，要在引导时以模块形式加载驱动，请将以下行放入 loader.conf(5)：`

```sh
if_xl_load="YES"
```

## 描述

`xl` 驱动为基于 3Com “boomerang”、“cyclone”、“hurricane”和“tornado”总线主控 Etherlink XL 芯片的 PCI 以太网适配器和嵌入式控制器提供支持。

Etherlink XL 芯片支持内置的 10baseT、10base2 和 10base5 收发器，以及用于外接 PHY 收发器的 MII 总线。3c905 系列通常使用 National Semiconductor NS 83840A 10/100 PHY，在全双工或半双工下支持 10/100 Mbps。3c905B 适配器具有内置的自动协商逻辑，映射到 MII 上以与先前的驱动兼容。Fast Etherlink XL 适配器（如 3c905-TX 和 3c905B-TX）能够以全双工或半双工模式进行 10 或 100Mbps 数据速率，可以手动配置为任何支持的模式，或与链路伙伴自动协商尽可能高的模式。

`xl` 驱动支持以下媒体类型：

**autoselect** 启用媒体类型和选项的自动选择。注意此选项仅适用于带有外部 PHY 或内置自动协商逻辑的 3c905 和 3c905B 适配器。对于 3c900 适配器，驱动将选择 EEPROM 中指定的模式。用户可以通过在 **`/etc/rc.conf`** 文件中添加媒体选项来更改此设置。

**10baseT/UTP** 设置 10Mbps 操作。还可以使用 `mediaopt` 选项选择 `full-duplex` 或 `half-duplex` 模式。

**100baseTX** 设置 100Mbps（快速以太网）操作。还可以使用 `mediaopt` 选项选择 `full-duplex` 或 `half-duplex` 模式。

**10base5/AUI** 启用 AUI 收发器（仅在 COMBO 卡上可用）。

**10base2/BNC** 启用 BNC 同轴收发器（仅在 COMBO 卡上可用）。

`xl` 驱动支持以下媒体选项：

**full-duplex** 强制全双工操作。

**half-duplex** 强制半双工操作。

注意，100baseTX 媒体类型仅在适配器支持时可用。有关配置此设备的更多信息，请参见 [ifconfig(8)](/man/man8/ifconfig.8.md)。

## 硬件

`xl` 驱动支持以下硬件：

* 3Com 3c900-TPO
* 3Com 3c900-COMBO
* 3Com 3c905-TX
* 3Com 3c905-T4
* 3Com 3c900B-TPO
* 3Com 3c900B-TPC
* 3Com 3c900B-FL
* 3Com 3c900B-COMBO
* 3Com 3c905B-T4
* 3Com 3c905B-TX
* 3Com 3c905B-FX
* 3Com 3c905B-COMBO
* 3Com 3c905C-TX
* 3Com 3c980、3c980B 和 3c980C 服务器适配器
* 3Com 3cSOHO100-TX OfficeConnect 适配器
* 3Com 3c450 HomeConnect 适配器
* 3Com 3c555、3c556 和 3c556B mini-PCI 适配器
* 3Com 3C3SH573BT、3C575TX、3CCFE575BT、3CXFE575BT、3CCFE575CT、3CXFE575CT、3CCFEM656、3CCFEM656B 和 3CCFEM656C、3CXFEM656、3CXFEM656B 和 3CXFEM656C CardBus 适配器
* 3Com 3c905-TX、3c905B-TX 3c905C-TX、3c920B-EMB 和 3c920B-EMB-WNM 嵌入式适配器

3C656 系列 CardBus 卡和 3C556 系列 MiniPCI 卡都具有内置的专用调制解调器。`xl` 驱动和其他 FreeBSD 驱动均不支持此调制解调器。

## 诊断

* xl%d: couldn't map memory 发生了致命的初始化错误。
* xl%d: couldn't map interrupt 发生了致命的初始化错误。
* xl%d: device timeout 设备已停止响应网络，或网络连接（电缆）存在问题。
* xl%d: no memory for rx list 驱动未能为接收环分配 mbuf。
* xl%d: no memory for tx list 驱动在分配填充缓冲区或将 mbuf 链折叠到集群中时，未能为发送环分配 mbuf。
* xl%d: command never completed! 向 3c90x ASIC 发出的某些命令需要时间完成：驱动应在继续之前等待状态寄存器中的“command in progress”位清除。在极少数情况下，此位可能不会清除。为避免陷入无限等待循环，驱动只会在放弃之前轮询该位有限次数，此时发出此消息。在较慢的机器上，驱动初始化期间可能会打印此消息。如果你看到此消息但驱动继续正常工作，则可能可以忽略此消息。
* xl%d: chip is in D3 power state -- setting to D0 此消息仅适用于支持电源管理的 3c905B 适配器。某些操作系统在关闭时将 3c905B 置于低功率模式，而某些 PCI BIOS 在配置之前未能将芯片从此状态中唤醒。3c905B 在 D3 状态下会丢失其所有 PCI 配置，因此如果 BIOS 未及时将其设置回全功率模式，将无法正确配置。驱动尝试检测此情况并将适配器恢复到 D0（全功率）状态，但这可能不足以使驱动恢复到完全可操作的状态。如果你在引导时看到此消息且驱动未能将设备附加为网络接口，则需要执行第二次热启动以正确配置设备。注意，此情况仅在从其他操作系统热启动时发生。如果在引导 FreeBSD 之前关闭系统电源，则应正确配置卡。
* xl%d: WARNING: no media options bits set in the media options register! 在某些带有内置 3c905-TX 适配器的 Dell Latitude 扩展坞上使用驱动时，可能会出现此警告。无论出于何种原因，此特定设备上媒体选项寄存器中的“MII available”位未设置，尽管它应该被设置（3c905-TX 总是使用外部 PHY 收发器）。驱动将尝试根据 PCI 设备 ID 字猜测正确的媒体类型。驱动对此情况发出大量噪音，因为作者认为这是制造缺陷。
* xl%d: transmission error: %d
* xl%d: tx underrun, increasing tx start threshold to %d bytes 此消息可能在适配器在各种负载下调整其发送缓冲区时出现，基本无害。忽略它们可能是安全的。

## 参见

[altq(4)](/man/man4/altq.4.md), arp(4), [cardbus(4)](/man/man4/cardbus.4.md), [miibus(4)](/man/man4/miibus.4.md), [netintro(4)](/man/man4/netintro.4.md), [ng\_ether(4)](/man/man4/ng_ether.4.md), [polling(4)](/man/man4/polling.4.md), [ifconfig(8)](/man/man8/ifconfig.8.md)

## 历史

`xl` 设备驱动首次出现于 FreeBSD 3.0。

## 作者

`xl` 驱动由 Bill Paul <wpaul@ctr.columbia.edu> 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man4/xl.4.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.