CSR配置字典之NCSICapabilities类
更新时间:2025/7/22
在Gitcode上查看源码

📋 文档信息

项目内容
文档标题NCSICapabilities类配置字典
版本v1.0
创建日期2025-01-27
最后更新2025-01-27
维护状态✅ 活跃维护

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建NCSICapabilities类配置字典全新文档系统管理员

🎯 类概览

NCSICapabilities 类

属性
类名称NCSICapabilities
功能描述PCIe标卡NCSI功能支持能力管理,提供NCSI线缆在位检测和功能支持查询
所属SIG组hardware
所属组件网络通信
责任人网络通信组
最后更新2025-01-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
PCIeNCSIEnabledU8-0或1-PCIe标卡NCSI线缆在位标记
0:NCSI线缆不在位
1:NCSI线缆在位
检测NCSI线缆连接状态1硬件检测硬件
PCIeNCSISupportedBoolean-true/false-主板对PCIe标卡NCSI功能支持能力
true:支持NCSI功能
false:不支持NCSI功能
生产环节查询主板NCSI支持能力trueCSR配置硬件

🔗 动态关联机制

语法规范

本类属性主要通过硬件检测和CSR配置管理,无复杂的动态关联:

yaml
# 基础配置示例
PCIeNCSIEnabled: 1                    # 硬件检测结果
PCIeNCSISupported: true              # CSR配置能力

关联说明

  • PCIeNCSIEnabled: 由硬件检测模块实时更新,反映当前NCSI线缆连接状态
  • PCIeNCSISupported: 在CSR中配置,表示主板硬件设计对NCSI功能的支持能力

📂 分类标准

硬件属性

  • 定义:与PCIe NCSI硬件功能直接相关的参数
  • 特点:反映硬件设计能力和实时连接状态
  • 示例PCIeNCSIEnabled, PCIeNCSISupported

软件属性

  • 定义:本类暂无纯软件属性
  • 特点:所有属性都与硬件状态直接相关
  • 示例:暂无

📝 配置示例

支持NCSI功能的主板配置

json
{
  "NCSICapabilities": {
    "PCIeNCSIEnabled": 1,
    "PCIeNCSISupported": true
  }
}

不支持NCSI功能的主板配置

json
{
  "NCSICapabilities": {
    "PCIeNCSIEnabled": 0,
    "PCIeNCSISupported": false
  }
}

支持NCSI但线缆未连接配置

json
{
  "NCSICapabilities": {
    "PCIeNCSIEnabled": 0,
    "PCIeNCSISupported": true
  }
}

生产测试环境配置

json
{
  "NCSICapabilities": {
    "PCIeNCSIEnabled": 1,
    "PCIeNCSISupported": true
  }
}

🔧 使用指南

配置步骤

  1. 确认硬件支持:检查主板设计是否支持PCIe NCSI功能
  2. 配置支持能力:在CSR中设置PCIeNCSISupported属性
  3. 监控连接状态:系统会自动检测并更新PCIeNCSIEnabled状态
  4. 生产测试验证:在生产环节查询和验证NCSI功能

注意事项

  • 硬件依赖:PCIeNCSISupported必须与主板硬件设计能力匹配
  • 实时更新:PCIeNCSIEnabled会根据线缆连接状态实时变化
  • 生产验证:主要用于生产环节的功能验证和测试

故障排除

  1. NCSI功能不工作

    • 检查PCIeNCSISupported是否为true
    • 确认PCIeNCSIEnabled状态是否正确
    • 验证NCSI线缆连接
  2. 状态检测异常

    • 检查硬件检测模块是否正常
    • 确认线缆连接的物理状态
    • 验证主板NCSI接口功能

性能优化

  • 检测频率:合理设置NCSI状态检测频率
  • 资源占用:优化状态检测的系统资源消耗
  • 响应时间:确保状态变化的及时响应

📚 相关文档