📋 文档信息

项目	内容
文档标题	OpticalModule类配置字典
版本	v1.0
创建日期	2026-05-27
最后更新	2026-05-27
维护状态	待完善

📋 变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2026-05-27	初始版本	创建OpticalModule类配置字典	全新文档	待定

🎯 类概览

OpticalModule 类

属性	值
类名称	`OpticalModule`
功能描述	光模块管理对象，提供光模块基本信息、厂商信息、温度监控、功率监控、偏置电流监控和诊断信息管理
所属SIG组	hardware
所属组件	network_adapter
责任人	网卡管理组
最后更新	2026-05-27
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`PortID`	U8	-	U8	-	端口ID，主键	BMC内部使用	`1`	CSR配置	软件
`NetworkAdapterId`	String	-	String	-	网卡ID，主键	BMC内部使用	`"NIC1"`	CSR配置	软件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Name`	String	-	String	-	名称	BMC接口展示	`"OpticalModule1"`	CSR配置	软件
`Manufacturer`	String	-	String	-	厂商名称	BMC接口展示	`"Huawei"`	硬件提供	硬件
`PartNumber`	String	-	String	-	厂商部件名称	BMC接口展示	`"PN123"`	硬件提供	硬件
`SerialNumber`	String	-	String	-	序列号	BMC接口展示	`"SN123456"`	硬件提供	硬件
`RevisionNumber`	String	-	String	-	产品修订版本号, ASCII字符串, 长度为2字符	BMC接口展示	`"1.0"`	硬件提供	硬件
`ProductionDate`	String	-	String	-	生产日期	BMC接口展示	`"2025-01-01"`	硬件提供	硬件
`TransceiverType`	String	-	String	-	收发器类型	BMC接口展示	`"SFP+"`	硬件提供	硬件
`FiberConnectionType`	String	-	String	-	传输模式	BMC接口展示	`"LC"`	硬件提供	硬件
`WaveLengthNanometer`	U16	-	U16	-	波长，单位纳米	BMC接口展示	`1310`	硬件提供	硬件
`Type`	String	-	String	-	类型	BMC接口展示	`"QSFP28"`	硬件提供	硬件
`SupportedSpeedsMbps`	String	-	String	-	支持的速率	BMC接口展示	`"10000,25000"`	硬件提供	硬件
`Presence`	U8	255	U8	-	光模块是否在位	BMC接口展示	0	硬件提供	硬件
`Health`	String	-	String	-	健康状态	BMC接口展示	`"OK"`	BMC内部设置	软件
`Identifier`	String	-	String	-	识别码	BMC接口展示	`"QSFP"`	硬件提供	硬件
`ConnectorType`	String	-	String	-	连接器类型	BMC接口展示	`"LC"`	硬件提供	硬件
`MediumType`	String	""	String	-	介质类型	BMC接口展示	`"Fiber"`	硬件提供	硬件
`TransmissionDistance`	String	-	String	-	传输距离	BMC接口展示	`"10km"`	硬件提供	硬件
`RxLossState`	Boolean	-	Boolean	-	接收端信号是否丢失	BMC接口展示	`false`	硬件提供	硬件
`TxLossState`	Boolean	-	Boolean	-	发送端信号是否丢失	BMC接口展示	`false`	硬件提供	硬件
`TxFaultState`	Boolean	-	Boolean	-	发送端是否故障	BMC接口展示	`false`	硬件提供	硬件
`TypeMatch`	Boolean	true	Boolean	-	类型是否匹配	BMC接口展示	`true`	BMC内部设置	软件
`SpeedMatch`	Boolean	true	Boolean	-	速率是否匹配	BMC接口展示	`true`	BMC内部设置	软件
`FaultState`	String	-	String	-	故障状态	BMC接口展示	0	BMC内部设置	软件
`TemperatureCelsius`	U16	65535	U16	-	光模块温度（用于告警）	BMC接口展示	0	硬件提供	硬件
`PowerState`	U8	0	U8	-	功率异常标志位（用于告警）	BMC接口展示	0	硬件提供	硬件
`IsSupportedType`	U8	0	U8	-	网卡支持速率与光模块速率不匹配标志位（用于告警）	BMC接口展示	0	BMC内部设置	软件
`HostSNR`	String	-	String	-	主机侧信噪比	BMC接口展示	-	硬件提供	硬件
`MediaSNR`	String	-	String	-	介质侧信噪比	BMC接口展示	-	硬件提供	硬件
`RxSNR`	String	-	String	-	端口接收信噪比	BMC接口展示	-	硬件提供	硬件
`Accessible`	Boolean	-	Boolean	-	光模块是否可访问,0为不可访问,1为可访问	BMC接口展示	`true`	BMC内部设置	软件
`ModuleState`	U8	255	U8	-	光模块当前运行状态, 默认值为255, 1: ModuleLowPwr, 2: ModulePwrUp, 3: ModuleReady, 4: ModulePwrDn, 5: ModuleFault, 其余取值为光模块厂家自定义状态	BMC接口展示	`255`	硬件提供	硬件
`ChannelNum`	U8	-	U8	-	光模块内部通道数	BMC接口展示	`4`	硬件提供	硬件
`RelatedNetworkPorts`	String	-	String	-	光模块关联的网口Id	BMC接口展示	`"Port1"`	BMC内部设置	软件
`Id`	U8	255	U8	-	该光模块在当前网卡下的逻辑ID，从0开始	BMC接口展示	`255`	CSR配置	软件
`SilkText`	String	-	String	-	光模块丝印信息	BMC接口展示	`"Port1"`	CSR配置	软件
`PfID`	U8	255	U8	-	PF ID(只读)	BMC内部使用	`255`	硬件提供	硬件
`CreatedByDeviceObject`	Boolean	false	Boolean	-	是否由设备对象创建	BMC内部使用	`false`	BMC内部设置	软件
`LogicalId`	U8	255	U8	-	逻辑ID(只读)	BMC内部使用	`255`	硬件提供	硬件
`TXBiasCurrentMilliAmps`	U16	-	U16	-	发送偏置电流(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent1MilliAmps`	U16	-	U16	-	发送偏置电流1(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent2MilliAmps`	U16	-	U16	-	发送偏置电流2(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent3MilliAmps`	U16	-	U16	-	发送偏置电流3(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent4MilliAmps`	U16	-	U16	-	发送偏置电流4(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent5MilliAmps`	U16	-	U16	-	发送偏置电流5(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent6MilliAmps`	U16	-	U16	-	发送偏置电流6(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent7MilliAmps`	U16	-	U16	-	发送偏置电流7(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrent8MilliAmps`	U16	-	U16	-	发送偏置电流8(mA)	BMC接口展示	`100`	硬件提供	硬件
`TXBiasCurrentStatus`	String	-	String	-	发送偏置电流状态	BMC接口展示	`"Normal"`	BMC内部设置	软件
`BC_TXLowerThresholdCritical`	U16	65535	U16	-	发送偏置电流下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`BC_TXUpperThresholdCritical`	U16	65535	U16	-	发送偏置电流上限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`BiasCurrentTXUpperThresholdWarning`	U16	65535	U16	-	发送偏置电流上限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`BiasCurrentTXLowerThresholdWarning`	U16	65535	U16	-	发送偏置电流下限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`RXInputPowerMilliWatts`	U16	-	U16	-	接收功率(mW)	BMC接口展示	`100`	硬件提供	硬件
`RXInputPowerStatus`	String	-	String	-	接收功率状态	BMC接口展示	`"Normal"`	BMC内部设置	软件
`RXLowerThresholdCritical`	U16	65535	U16	-	接收功率下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`RXUpperThresholdCritical`	U16	65535	U16	-	接收功率上限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`TXOutputPowerMilliWatts`	U16	-	U16	-	发送功率(mW)	BMC接口展示	`100`	硬件提供	硬件
`TXOutputPowerStatus`	String	-	String	-	发送功率状态	BMC接口展示	`"Normal"`	BMC内部设置	软件
`Power_TXLowerThresholdCritical`	U16	65535	U16	-	发送功率下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`Power_TXUpperThresholdCritical`	U16	65535	U16	-	发送功率上限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`PowerTXUpperThresholdWarning`	U16	65535	U16	-	发送功率上限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`PowerTXLowerThresholdWarning`	U16	65535	U16	-	发送功率下限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`PowerRXUpperThresholdWarning`	U16	65535	U16	-	接收功率上限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`PowerRXLowerThresholdWarning`	U16	65535	U16	-	接收功率下限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`PowerClass`	U8	255	U8	-	功率等级	BMC接口展示	`255`	硬件提供	硬件
`PowerCapacityWatts`	U32	-	U32	-	功率容量(W)	BMC接口展示	-	硬件提供	硬件
`ReadingCelsius`	U16	65535	U16	-	温度读数(摄氏度)	BMC接口展示	`65535`	硬件提供	硬件
`Temp_LowerThresholdCritical`	U16	65535	U16	-	温度下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`Temp_UpperThresholdCritical`	U16	65535	U16	-	温度上限临界阈值	BMC接口展示	125	硬件提供	硬件
`TemperatureLowerThresholdCritical`	U16	65535	U16	-	温度下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`TemperatureUpperThresholdCritical`	U16	65535	U16	-	温度上限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`TemperatureLowerThresholdWarning`	U16	65535	U16	-	温度下限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`TemperatureUpperThresholdWarning`	U16	65535	U16	-	温度上限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`SupplyVoltage`	U16	65535	U16	-	供电电压	BMC接口展示	0	硬件提供	硬件
`Vol_LowerThresholdCritical`	U16	65535	U16	-	电压下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`Vol_UpperThresholdCritical`	U16	65535	U16	-	电压上限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`VoltageLowerThresholdCritical`	U16	65535	U16	-	电压下限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`VoltageUpperThresholdCritical`	U16	65535	U16	-	电压上限临界阈值	BMC接口展示	`65535`	硬件提供	硬件
`VoltageLowerThresholdWarning`	U16	65535	U16	-	电压下限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`VoltageUpperThresholdWarning`	U16	65535	U16	-	电压上限告警阈值	BMC接口展示	`65535`	硬件提供	硬件
`RxLossOfLock`	Boolean	-	Boolean	-	接收失锁	BMC接口展示	`false`	硬件提供	硬件
`TxLossOfLock`	Boolean	-	Boolean	-	发送失锁	BMC接口展示	`false`	硬件提供	硬件
`LaserRuntimeSeconds`	U32	-	U32	-	激光运行时间(s)	BMC接口展示	`1000`	硬件提供	硬件
`LaserTemperatureCelsius`	U16	-	U16	-	激光温度(摄氏度)	BMC接口展示	`45`	硬件提供	硬件
`PowerOnCount`	U32	-	U32	-	上电次数	BMC接口展示	`100`	硬件提供	硬件
`UptimeSeconds`	U32	-	U32	-	运行时间(s)	BMC接口展示	`1000`	硬件提供	硬件
`PowerStatus`	String	-	String	-	电源状态	BMC接口展示	`"On"`	硬件提供	硬件
`OdspDieTemperatureCelsius`	U16	-	U16	-	ODSP芯片温度(摄氏度)	BMC接口展示	`45`	硬件提供	硬件
`OdspHighTempRuntimeSeconds`	U32	-	U32	-	ODSP高温运行时间(s)	BMC接口展示	`100`	硬件提供	硬件
`SelfTestStatus`	String	-	String	-	自检状态	BMC接口展示	`"OK"`	硬件提供	硬件
`MediaInterfaceFaultStatus`	String	-	String	-	介质接口故障状态	BMC接口展示	`"None"`	硬件提供	硬件
`HostInterfaceFaultStatus`	String	-	String	-	主机接口故障状态	BMC接口展示	`"None"`	硬件提供	硬件
`RxLoS`	Boolean	-	Boolean	-	接收信号丢失	BMC接口展示	`false`	硬件提供	硬件
`TxLoS`	Boolean	-	Boolean	-	发送信号丢失	BMC接口展示	`false`	硬件提供	硬件
`TxFault`	Boolean	-	Boolean	-	发送故障	BMC接口展示	`false`	硬件提供	硬件
`PRBSTestSupported`	Boolean	-	Boolean	-	是否支持PRBS测试	BMC接口展示	`true`	硬件提供	硬件
`FiberDirtyDetected`	Boolean	-	Boolean	-	光纤脏污检测	BMC接口展示	`false`	BMC内部设置	软件
`FiberLoosenessDetected`	Boolean	-	Boolean	-	光纤松动检测	BMC接口展示	`false`	BMC内部设置	软件
`ContaminationDetectionSupported`	Boolean	-	Boolean	-	是否支持污染检测	BMC接口展示	`true`	硬件提供	硬件
`AssetType`	String	-	String	-	资产类型	BMC接口展示	`"OpticalModule"`	CSR配置	软件
`AssetName`	String	-	String	-	资产名称	BMC接口展示	`"OpticalModule1"`	CSR配置	软件
`InventorySerialNumber`	String	-	String	-	库存序列号	BMC接口展示	`"SN123456"`	硬件提供	硬件
`InventoryFirmwareVersion`	String	-	String	-	库存固件版本	BMC接口展示	`"1.0.0"`	硬件提供	硬件
`PCBVersion`	String	-	String	-	PCB版本	BMC接口展示	`"A01"`	硬件提供	硬件
`InventoryManufacturer`	String	-	String	-	库存厂商	BMC接口展示	`"Huawei"`	硬件提供	硬件
`AssetTag`	String	-	String	-	资产标签	BMC接口展示	`"Tag1"`	CSR配置	软件
`InventoryPartNumber`	String	-	String	-	库存部件编号	BMC接口展示	`"PN123"`	硬件提供	硬件
`ManufactureDate`	String	-	String	-	制造日期	BMC接口展示	`"2025-01-01"`	硬件提供	硬件
`Slot`	U8	-	U8	-	槽位	BMC接口展示	`1`	CSR配置	软件
`Model`	String	-	String	-	型号	BMC接口展示	`"QSFP28"`	硬件提供	硬件

📝 配置示例

json

{
            "@Parent": "NetworkPort_1",
            "TemperatureCelsius": 0,
            "PowerState": 0,
            "Presence": 0,
            "IsSupportedType": 0,
            "Temp_UpperThresholdCritical": 125,
            "FaultState": 0,
            "SupplyVoltage": 0
        }

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

OpticalModule 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

📝 配置示例 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

OpticalModule 类

📊 属性定义详表

必选属性

可选属性

📝 配置示例