> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NIC 与 SR-IOV — 基于 KVM 的 RT

## **Intel X550 NIC 与 SR-IOV 支持**

Qualcomm 已在以下平台上验证了支持 SR-IOV 的 Intel X550 NIC 网卡：

| 设备 | 板卡名称 |
| - | - |
| QCS9100 Ride-Sx | LeMans |
| IQ9075-EVK | QCS9075-EVK |

***

### 所需内核配置

| 配置项 | 说明 |
| - | - |
| `CONFIG_IXGBE=y` | Intel 10GbE PCI Express 驱动 |
| `CONFIG_IXGBEVF=y` | Intel 10GbE 虚拟功能驱动（SR-IOV 必需） |
| `CONFIG_VIRTIO_IOMMU=y` | 面向客户机 VM 的半虚拟化 IOMMU 设备（SR-IOV 透传必需） |

***

### 启用内核配置

#### 方法 1 — BSP 配置片段

编辑并追加到以下文件：

```
<Workspace_Path>/meta-qcom/recipes-kernel/linux/linux-qcom-6.18/configs/bsp-additions.cfg
```

```
CONFIG_IXGBE=y
CONFIG_IXGBEVF=y
CONFIG_VIRTIO_IOMMU=y
```

#### 方法 2 — 内核补丁

将补丁文件复制到内核配方目录，并在 `linux-qcom_6.18.bb` 中将其添加到 `SRC_URI`：

```
SRC_URI = " \
    git://github.com/qualcomm-linux/kernel.git;${SRCBRANCH};protocol=https \
    file://0001-arm64-boot-dts-qcom-Update-iommu-map-for-sriov-endpoints.patch \
"

SRC_URI += " \
    file://configs/bsp-additions.cfg \
"
```

***

### Intel NIC SR-IOV 的 PCIe IOMMU-Map

必须将网卡的 PCIe IOMMU 映射添加到板卡的 `.dtsi` 文件中，才能枚举 SR-IOV 虚拟功能。所采用的方法是**稀疏点映射** — 每个设备一个 IOMMU 条目（`count = 1`），可避免 SMMUv2 中的 SID 耗尽。

**`iommu-map` 的工作原理：**

```
iommu-map = <rid_base  &smmu_phandle  sid_base  count>;
```

当 `count = 1` 时：

```
RID == rid_base  →  SID = sid_base
```

**RID 计算公式：** `RID = (Bus << 8) | (Device << 3) | Function`

#### 补丁示例 — IQ-9075 EVK `pcie1`（13 个 SR-IOV 条目）

此补丁为 IQ-9075 EVK `pcie1` 上的 Intel X550 SR-IOV 虚拟功能添加 `iommu-map` 条目：

```diff theme={null}
diff --git a/arch/arm64/boot/dts/qcom/lemans-evk.dts b/arch/arm64/boot/dts/qcom/lemans-evk.dts
--- a/arch/arm64/boot/dts/qcom/lemans-evk.dts
+++ b/arch/arm64/boot/dts/qcom/lemans-evk.dts
@@ -725,6 +725,19 @@ &pcie1 {
 	pinctrl-0 = <&pcie1_default_state>;
 	pinctrl-names = "default";

+	iommu-map = <0x0 &pcie_smmu 0x80 0x1>,
+		    <0x100 &pcie_smmu 0x81 0x1>,
+		    <0x101 &pcie_smmu 0x82 0x1>,
+		    <0x280 &pcie_smmu 0x83 0x1>,
+		    <0x282 &pcie_smmu 0x84 0x1>,
+		    <0x284 &pcie_smmu 0x85 0x1>,
+		    <0x286 &pcie_smmu 0x86 0x1>,
+		    <0x288 &pcie_smmu 0x87 0x1>,
+		    <0x28a &pcie_smmu 0x88 0x1>,
+		    <0x28c &pcie_smmu 0x89 0x1>,
+		    <0x28e &pcie_smmu 0x90 0x1>,
+		    <0x290 &pcie_smmu 0x91 0x1>,
+		    <0x292 &pcie_smmu 0x92 0x1>;
 	status = "okay";
 };
```

这会将 RC（RID `0x0`）以及十二个 SR-IOV 端点 RID 映射到 `pcie1` SMMU 子范围内的十二个连续 SID（`0x80`–`0x92`）。

***

### 验证

```bash theme={null}
# Verify kernel configs are active
root@iq-9075-evk:/# zcat /proc/config.gz | grep -E "CONFIG_IXGBE=|CONFIG_IXGBEVF=|CONFIG_VIRTIO_IOMMU="
CONFIG_IXGBE=y
CONFIG_IXGBEVF=y
CONFIG_VIRTIO_IOMMU=y

# Verify NIC card detection
root@iq-9075-evk:~# lspci
0000:00:00.0 PCI bridge: Qualcomm Technologies, Inc Device 0115
0000:01:00.0 Network controller: Qualcomm Technologies, Inc QCNFA765 Wireless Network Adapter (rev 01)
0001:00:00.0 PCI bridge: Qualcomm Technologies, Inc Device 0115
0001:01:00.0 Ethernet controller: Intel Corporation Ethernet Controller X550 (rev 01)
0001:01:00.1 Ethernet controller: Intel Corporation Ethernet Controller X550 (rev 01)
```

***

### 诊断缺失的 `iommu-map` 条目

当某个设备的 RID 没有匹配的条目时，内核会输出以下日志：

```
OF: /pci@1c10000: no iommu-map translation for id 0x281 on (null)
vfio-pci: probe of 0001:02:10.1 failed with error -22
```

解码 RID：

```bash theme={null}
RID=0x281; printf "Bus=%d Dev=%d Fn=%d\n" \
    $(( (RID >> 8) & 0xFF )) \
    $(( (RID >> 3) & 0x1F )) \
    $(( RID & 0x07 ))
# Bus=2 Dev=16 Fn=1
```

使用 `count = 1` 和一个空闲 SID 添加缺失的条目，然后重新构建 DTB 并通过 `dmesg` 进行验证。

> [!NOTE]
>
> `lspci` 直接读取 PCI 配置空间，无论 IOMMU 映射如何都会显示设备。请使用 `dmesg`（而非 `lspci`）确认缺失的条目已修复。

***

> [card] [VM 管理](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rt-with-kvm-vm-management.md)
>
> Virsh 设置及 domain XML 示例文件

> [card] [构建 — 基于 KVM 的 RT](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/rt-with-kvm-build.md)
>
> KAS 构建命令
