网卡驱动规范 ​

前置阅读：

• 《部件驱动 2.0 适配方案概述》：部件驱动开发简介
• 《部件驱动 2.0-设备驱动开发指南》：设备驱动开发指南

1. 概述 ​

本规范定义 PCIe 形态网卡（DeviceCategory: PCIeNicCard）南向驱动需实现的对象树与接口组合。部件按契约实现后，可被 devmon 挂载到 /bmc/dev/Systems/.../PCIeNicCard/... 设备树。

设备特有器件通常包括：

• NIC 板卡本身
• 网口（NetworkPort）
• 光口上的光模块（OpticalModule）

入库状态 ​

2. 设备树 ​

/bmc/dev/Systems/${SystemId}/PCIeNicCard/{NicId}
└── NetworkPort/{PortId}
    └── OpticalModule
        └── Channel/{ChannelId}    # CESA 表37 OpticalTransceiverChannel；DDS 可用 OpticalTransceiverChannel/${ChannelId}

3. 对象–接口矩阵 ​

3.1 PCIeNicCard ​

3.2 NetworkPort ​

bmc.dev.NetworkPort.LinkInfo.LinkStatus 按 CESA 表148 为可写。

3.3 OpticalModule ​

3.4 OpticalModuleChannel ​

通道是独立子对象，不挂在 OpticalModule 主对象上。规范属性名为 BiasCurrentMilliAmps；现网驱动仍用 TXBiasCurrentMilliAmps，dmc/gen 同时保留。

已入库接口的属性与方法细节请直接打开上表 intf 链接。

4. 相关文档 ​

• 3-DeviceMgmtContract.md
• 4.1 网卡驱动适配指南
• [4.7 使用 openUBMC Studio 进行网卡适配](https://gitcode.com/openUBMC/component_drivers/blob/main/docs/4.7-使用openUBMC Studio进行网卡适配.md)

5. 历史 RFC ​

• 社区公示（历史参考）：openUBMC 讨论区 若与本仓库 dmc 冲突，以 dmc 为准。