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

# jme.4

`jme` — JMicron 千兆/快速以太网驱动

## 名称

`jme`

## 概要

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

> device miibus device jme

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

```sh
if_jme_load="YES"
```

## 描述

`jme` 设备驱动为 JMicron JMC25x PCI Express 千兆以太网控制器和 JMicron JMC26x PCI Express 快速以太网控制器提供支持。

`jme` 驱动支持的所有 LOM 在发送和接收方向均具有 TCP/UDP/IP 校验和卸载、TCP 分段卸载（TSO）、硬件 VLAN 标签剥离/插入功能、网络唤醒（WOL）、中断合并/调制机制以及 64 位多播哈希过滤器。

JMC25x 还支持 Jumbo 帧（最大 9216 字节），可通过接口 MTU 设置进行配置。使用 [ifconfig(8)](/man/man8/ifconfig.8.md) 工具选择大于 1500 字节的 MTU 可将适配器配置为接收和发送 Jumbo 帧。

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

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

**`10baseT/UTP`** 设置 10Mbps 操作。

**`100baseTX`** 设置 100Mbps（快速以太网）操作。

**`1000baseTX`** 设置通过双绞线进行的 1000baseTX 操作。

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

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

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

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

## 硬件

`jme` 设备驱动为以下以太网控制器提供支持：

* JMicron JMC250 PCI Express 千兆以太网控制器
* JMicron JMC251 PCI Express 带读卡器主机的千兆以太网控制器
* JMicron JMC260 PCI Express 快速以太网控制器
* JMicron JMC261 PCI Express 带读卡器主机的千兆以太网控制器

## 加载器可调参数

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

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

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

## SYSCTL 变量

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

**`dev.jme.%d.tx_coal_to`** 此变量设置在发送 Tx 完成中断前延迟的最长时间，以微秒为单位。接受范围为 1 至 65535；默认值为 100（100 微秒）。

**`dev.jme.%d.tx_coal_pkt`** 此变量设置可合并到单个 Tx 完成中断中的最大传出数据包数。接受范围为 1 至 255；默认值为 8。

**`dev.jme.%d.rx_coal_to`** 此变量设置在触发 Rx 完成中断前等待额外数据包到达（用于可能的数据包合并）的最长时间，以微秒为单位。接受范围为 1 至 65535；默认值为 100（100 微秒）。

**`dev.jme.%d.rx_coal_pkt`** 此变量设置可合并到单个 Rx 完成中断中的最大传入数据包数。接受范围为 1 至 255；默认值为 2。

**`dev.jme.%d.process_limit`** 此变量设置在处理程序重新入队到 taskqueue 之前，单批处理中要处理的最大事件数。接受范围为 10 至 255；默认值为 128 个事件。更改此值后无需将接口关闭再重新打开即可生效。

## 参见

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

## 历史

`jme` 驱动由 Pyun YongHyeon <yongari@FreeBSD.org> 编写。最早出现于 FreeBSD 7.1。

## 注意事项

`jme` 驱动尽量避免对使用 eFuse 存储站地址的控制器进行不必要的站地址重编程。eFuse 可安全重编程的次数最多为 16 次。此外，一旦通过 eFuse 重编程了站地址，就无法恢复出厂默认的站地址。强烈建议不要重编程站地址，管理员有责任在更改站地址时将原始站地址存储在安全的地方。

JMC25x 存在两个已知的 1000baseT 链路建立问题。如果 JMC25x 控制器的全掩码修订号小于或等于 4，且链路伙伴启用了 IEEE 802.3az 节能以太网功能，则控制器将无法建立 1000baseT 链路。此外，如果电缆长度超过 120 米，控制器也无法建立 1000baseT 链路。这些问题的已知解决方法是使用 100baseTX 强制手动链路配置，而非依赖自动协商。控制器的全掩码修订号可通过详细的内核引导选项查看。使用芯片修订号的低四位来获取控制器的全掩码修订号。


---

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