> 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/bge.4.md).

# bge.4

`bge` — Broadcom BCM57xx/BCM590x 千兆/快速以太网驱动

## 名称

`bge`

## 概要

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

> device miibus device bge

或者，要在引导时以模块形式加载该驱动，请在 [loader.conf(5)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man5/loader.conf.5.md) 中加入以下行：

```sh
if_bge_load="YES"
```

## 描述

`bge` 驱动为基于 Broadcom BCM570x、571x、572x、575x、576x、578x、5776x 和 5778x 千兆以太网控制器芯片以及 590x 和 5779x 快速以太网控制器芯片的各种 NIC 提供支持。

除 SysKonnect SK-9D41 仅支持多模光纤上的 1000Mbps 外，所有这些 NIC 都能通过 CAT5 铜缆以 10、100 和 1000Mbps 速率工作。BCM570x 建立在 Alteon Tigon II 技术之上。它具有两个 R4000 CPU 核心，兼容 PCI v2.2 和 PCI-X v1.0。它支持接收和发送的 IP、TCP 和 UDP 校验和卸载、用于 QoS 应用的多个 RX 和 TX DMA 环、基于规则的接收过滤，以及 VLAN 标签剥离/插入和 256 位多播哈希过滤器。可通过增值固件更新提供额外功能。BCM570x 支持 TBI（十位接口）和 GMII 收发器，意味着可用于铜缆或 1000baseX 光纤应用。但注意该设备在 TBI 模式下仅支持单一速率。

大多数基于 BCM5700 的卡还使用 Broadcom BCM5401 或 BCM5411 10/100/1000 铜缆千兆收发器，支持全双工或半双工下 10、100 和 1000Mbps 模式的自动协商。

BCM5700、BCM5701、BCM5702、BCM5703、BCM5704、BCM5714、BCM5717、BCM5719、BCM5720、BCM5780 和 BCM57765 还支持巨型帧，可通过接口 MTU 设置进行配置。使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 选择大于 1500 字节的 MTU 会将适配器配置为接收和发送巨型帧。使用巨型帧可大幅提升某些任务的性能，如文件传输和数据流。

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

**`autoselect`** 启用媒体类型和选项的自动选择。用户可通过在 [rc.conf(5)](/man/man5/rc.conf.5.md) 中添加媒体选项来手动覆盖自动选择的模式。

**`10baseT/UTP`** 设置 10Mbps 操作。也可使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 的 `mediaopt` 选项选择 `full-duplex` 或 `half-duplex` 模式。

**`100baseTX`** 设置 100Mbps（快速以太网）操作。也可使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 的 `mediaopt` 选项选择 `full-duplex` 或 `half-duplex` 模式。

**`1000baseTX`** 设置双绞线上的 1000baseTX 操作。仅支持 `full-duplex` 模式。

**`1000baseSX`** 设置 1000Mbps（千兆以太网）操作。支持 `full-duplex` 和 `half-duplex` 模式。

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

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

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

有关配置此设备的更多信息，请参见 [ifconfig(8)](/man/man8/ifconfig.8.md)。

## 硬件

`bge` 驱动为基于 Broadcom BCM570x 系列千兆以太网控制器芯片的各种 NIC 提供支持，包括：

* 3Com 3c996-SX（1000baseSX）
* 3Com 3c996-T（10/100/1000baseTX）
* Apple Thunderbolt Display（10/100/1000baseTX）
* Apple Thunderbolt to Gigabit Ethernet Adapter（10/100/1000baseTX）
* Dell PowerEdge 1750 integrated BCM5704C NIC（10/100/1000baseTX）
* Dell PowerEdge 2550 integrated BCM5700 NIC（10/100/1000baseTX）
* Dell PowerEdge 2650 integrated BCM5703 NIC（10/100/1000baseTX）
* Dell PowerEdge R200 integrated BCM5750 NIC（10/100/1000baseTX）
* Dell PowerEdge R300 integrated BCM5722 NIC（10/100/1000baseTX）
* IBM x235 server integrated BCM5703x NIC（10/100/1000baseTX）
* HP Compaq dc7600 integrated BCM5752 NIC（10/100/1000baseTX）
* HP ProLiant NC7760 embedded Gigabit NIC（10/100/1000baseTX）
* HP ProLiant NC7770 PCI-X Gigabit NIC（10/100/1000baseTX）
* HP ProLiant NC7771 PCI-X Gigabit NIC（10/100/1000baseTX）
* HP ProLiant NC7781 embedded PCI-X Gigabit NIC（10/100/1000baseTX）
* Netgear GA302T（10/100/1000baseTX）
* SysKonnect SK-9D21（10/100/1000baseTX）
* SysKonnect SK-9D41（1000baseSX）

## 加载器可调参数

以下可调参数可在引导内核前于 [loader(8)](/man/man8/loader.8.md) 提示符下设置，或存储在 loader.conf(5) 中。

**`hw.bge.allow_asf`** 允许 ASF 功能与 IPMI 协同工作。在少数系统上可能导致系统锁定问题。默认启用。

**`dev.bge.%d.msi`** 非零值在以太网硬件上启用 MSI 支持。默认值为 1。

## SYSCTL 变量

以下变量同时作为 [sysctl(8)](/man/man8/sysctl.8.md) 变量和 [loader(8)](/man/man8/loader.8.md) 可调参数可用：

**`dev.bge.%d.forced_collapse`** 允许将多个发送缓冲区合并为单个缓冲区，以增加发送性能，但代价是消耗 CPU 周期。默认值为 0，即禁用发送缓冲区合并。

**`dev.bge.%d.forced_udpcsum`** 即使控制器可能生成校验和值为 0 的 UDP 数据报，也启用 UDP 发送校验和卸载。校验和值为 0 的 UDP 数据报可能使接收方主机困惑，因为这表示发送方未计算 UDP 校验和。默认值为 0，即禁用 UDP 发送校验和卸载。更改生效前需将接口先关闭再重新启用。

## 诊断

* bge%d: couldn't map memory：发生致命初始化错误。
* bge%d: couldn't map ports：发生致命初始化错误。
* bge%d: couldn't map interrupt：发生致命初始化错误。
* bge%d: no memory for softc struct!：驱动在初始化期间无法为每设备实例信息分配内存。
* bge%d: failed to enable memory mapping!：驱动无法初始化 PCI 共享内存映射。这可能发生在卡不在总线主控插槽中的情况。
* bge%d: firmware handshake timed out, found 0xffffffff：设备已从系统物理断开，或设备存在问题导致其停止响应所连接的主机。
* bge%d: no memory for jumbo buffers!：驱动在初始化期间无法为巨型帧分配内存。
* bge%d: watchdog timeout：设备已停止响应网络，或网络连接（电缆）存在问题。

## 参见

[altq(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/altq.4.md), arp(4), [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), [vlan(4)](/man/man4/vlan.4.md), [ifconfig(8)](/man/man8/ifconfig.8.md)

## 历史

`bge` 设备驱动首次出现于 FreeBSD 4.5。

## 作者

`bge` 驱动由 Bill Paul <wpaul@windriver.com> 编写。

## 缺陷

FreeBSD 当前不支持热插拔，因此在 Apple 系统上，Thunderbolt 接口必须在系统开机前连接，接口才能被检测到。同时，由于缺乏热插拔支持，系统运行期间不得移除基于 Thunderbolt 的接口，因为内核当前无法处理 `bge` 接口消失的情况。

UDP 发送校验和卸载默认禁用，参见 `dev.bge.%d.forced_udpcsum`。为避免接口作为 [bridge(4)](/man/man4/bridge.4.md) 接口成员时出现问题，这种情况下所有发送校验和卸载初始均为禁用。可使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 启用发送校验和卸载。


---

# 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/bge.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.