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

# vge.4

`vge` — VIA Networking Technologies Velocity 千兆以太网适配器驱动

## 名称

`vge`

## 概要

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

> device miibus device vge

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

```sh
if_vge_load="YES"
```

## 描述

`vge` 驱动为基于 VIA Technologies VT6120、VT6122、VT6130 和 VT6132 Velocity 系列 千兆以太网控制器芯片的各种网卡和嵌入式以太网接口提供支持。

VT6120/VT6122 是一款 33/66MHz 64 位 PCI 设备，将三速 MAC 与集成的 10/100/1000 铜质 PHY 结合在一起。（部分旧卡使用外部 PHY。）VT6130/VT6132 是 Velocity 系列的 PCI express 版本。MAC 支持 TCP/IP 硬件校验和（仅 IPv4）、TCP 大发送、VLAN 标签插入与剥离，以及 VLAN 过滤、64 项 CAM 过滤器和 64 项 VLAN 过滤器、64 位多播哈希过滤器、4 个独立发送 DMA 队列、流控和最大 16K 的巨型帧（VT6130/VT6132 不支持）。Velocity 系列控制器具有 16K 接收 FIFO 和 48K 发送 FIFO。

`vge` 驱动利用控制器的校验和卸载与 VLAN 打标签功能，以及巨型帧（VT6130/VT6132 除外）和 CAM 过滤器支持。CAM 过滤器用于多播地址过滤，提供 64 项完美多播地址过滤支持。如果接口需要加入超过 64 个多播组，驱动将切换到使用哈希过滤器。

通过将接口 MTU 设置为大于默认值 1500 字节的任意值（最大为 9000 字节），可启用巨型帧支持。VT6130/VT6132 控制器上禁用巨型帧，因为当尝试发送大于 4K 的帧时 TX MAC 会挂起。可使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 工具开启或关闭接收和发送校验和卸载支持。

`vge` 驱动支持以下介质类型：

**`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 操作。也可使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 的 `mediaopt` 选项选择 `full-duplex` 或 `half-duplex` 模式。

`vge` 驱动支持以下介质选项：

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

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

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

## 硬件

`vge` 驱动支持基于 VIA Networking VT6120、VT6122、VT6130 和 VT6132 的千兆以太网适配器，包括：

* VIA Networking 板载千兆以太网
* ZyXEL GN650-T 64 位 PCI 千兆以太网网卡（ZX1701）
* ZyXEL GN670-T 32 位 PCI 千兆以太网网卡（ZX1702）

## 加载器可调参数

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

**`hw.vge.msi_disable`** 此可调参数禁用以太网硬件上的 MSI 支持。默认值为 0。

## SYSCTL 变量

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

**`dev.vge.%d.int_holdoff`** 延迟中断的最大时间。有效范围为 0 到 5100，单位为 1us，默认值为 150（150us）。定时器的分辨率约为 20us，因此无法进行比 20us 更精细的调节。在变更生效前，应将接口先关闭再重新启用。

**`dev.vge.%d.rx_coal_pkt`** 触发接收完成中断的最大数据包数。有效范围为 1 到 255，默认值为 64。

**`dev.vge.%d.tx_coal_pkt`** 触发发送完成中断的最大数据包数。有效范围为 1 到 255，默认值为 128。

## 诊断

* vge%d: couldn't map memory。发生了致命的初始化错误。
* vge%d: couldn't map ports。发生了致命的初始化错误。
* vge%d: couldn't map interrupt。发生了致命的初始化错误。
* vge%d: failed to enable memory mapping!。驱动初始化 PCI 共享内存映射失败。如果卡未插在总线主控插槽中，可能发生此情况。
* vge%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)

## 历史

`vge` 设备驱动最早出现于 FreeBSD 5.3。

## 作者

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


---

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