CSR配置字典之NCSICapabilities类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | NCSICapabilities类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建NCSICapabilities类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
NCSICapabilities 类
属性 | 值 |
---|---|
类名称 | NCSICapabilities |
功能描述 | PCIe标卡NCSI功能支持能力管理,提供NCSI线缆在位检测和功能支持查询 |
所属SIG组 | hardware |
所属组件 | 网络通信 |
责任人 | 网络通信组 |
最后更新 | 2025-01-27 |
状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
PCIeNCSIEnabled | U8 | - | 0或1 | - | PCIe标卡NCSI线缆在位标记 0:NCSI线缆不在位 1:NCSI线缆在位 | 检测NCSI线缆连接状态 | 1 | 硬件检测 | 硬件 |
PCIeNCSISupported | Boolean | - | true/false | - | 主板对PCIe标卡NCSI功能支持能力 true:支持NCSI功能 false:不支持NCSI功能 | 生产环节查询主板NCSI支持能力 | true | CSR配置 | 硬件 |
🔗 动态关联机制
语法规范
本类属性主要通过硬件检测和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
}
}
🔧 使用指南
配置步骤
- 确认硬件支持:检查主板设计是否支持PCIe NCSI功能
- 配置支持能力:在CSR中设置PCIeNCSISupported属性
- 监控连接状态:系统会自动检测并更新PCIeNCSIEnabled状态
- 生产测试验证:在生产环节查询和验证NCSI功能
注意事项
- 硬件依赖:PCIeNCSISupported必须与主板硬件设计能力匹配
- 实时更新:PCIeNCSIEnabled会根据线缆连接状态实时变化
- 生产验证:主要用于生产环节的功能验证和测试
故障排除
NCSI功能不工作:
- 检查PCIeNCSISupported是否为true
- 确认PCIeNCSIEnabled状态是否正确
- 验证NCSI线缆连接
状态检测异常:
- 检查硬件检测模块是否正常
- 确认线缆连接的物理状态
- 验证主板NCSI接口功能
性能优化
- 检测频率:合理设置NCSI状态检测频率
- 资源占用:优化状态检测的系统资源消耗
- 响应时间:确保状态变化的及时响应