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

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

BusinessTopoNode 类

属性
类名称BusinessTopoNode
功能描述业务拓扑节点管理,主要用于UBC高速线缆检测功能,提供基础板拓扑信息和线缆检测能力
所属SIG组network
所属组件topology
责任人网络拓扑管理组
最后更新2025-01-27
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SlotString0数字-基础板BCU槽位号UBC高速线缆检测"${Slot}"CSR配置硬件
RefSmcChipString[]数组Smc_CpuBrdSMC基础板对应的smc芯片,代码中用来发送smc命令读取线缆信息UBC高速线缆检测"#/Smc_CpuBrdSMC"CSR配置硬件
TypeString""字符串-线缆检测类型UBC高速线缆检测"Compute"CSR配置硬件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
UIDString""字符串-没用到UBC高速线缆检测""CSR配置硬件

🔗 动态关联机制

语法规范

使用 #/xxx 和变量替换语法实现动态关联:

yaml
# SMC芯片关联
RefSmcChip: "#/Smc_CpuBrdSMC"

# 槽位变量替换
Slot: "${Slot}"

关联说明

  • RefSmcChip: 关联SMC芯片对象,用于发送SMC命令读取线缆信息
  • Slot: 使用槽位变量实现动态槽位配置

📂 分类标准

硬件属性

  • 定义:与硬件拓扑和线缆检测直接相关的参数
  • 特点:用于UBC高速线缆检测功能
  • 示例Slot, UID, RefSmcChip, Type

软件属性

  • 定义:用于软件逻辑控制和管理的参数
  • 特点:本类中暂无纯软件属性
  • 示例:无

📝 配置示例

标准计算节点配置

json
{
  "BusinessTopoNode": {
    "Slot": "${Slot}",
    "UID": "",
    "RefSmcChip": "#/Smc_CpuBrdSMC",
    "Type": "Compute"
  }
}

存储节点配置

json
{
  "BusinessTopoNode": {
    "Slot": "1",
    "UID": "",
    "RefSmcChip": "#/Smc_CpuBrdSMC",
    "Type": "Storage"
  }
}

网络节点配置

json
{
  "BusinessTopoNode": {
    "Slot": "2",
    "UID": "",
    "RefSmcChip": "#/Smc_CpuBrdSMC",
    "Type": "Network"
  }
}

🔧 使用指南

配置步骤

  1. 设置槽位号:配置Slot标识节点所在槽位
  2. 关联SMC芯片:通过RefSmcChip关联对应的SMC芯片对象
  3. 设置节点类型:配置Type标识节点的业务类型
  4. 可选配置UID:根据需要配置UID(当前未使用)
  5. 验证关联:确保SMC芯片对象已正确定义

注意事项

  • SMC芯片关联:RefSmcChip必须关联有效的SMC芯片对象
  • 节点类型:Type需要根据实际业务需求设置
  • 槽位配置:Slot建议使用变量替换实现动态配置
  • UID属性:当前UID属性未使用,可保持默认值

性能建议

  • 合理配置类型:根据实际业务场景选择合适的Type
  • 优化SMC通信:确保SMC芯片通信正常,避免线缆检测失败
  • 槽位管理:使用变量替换实现灵活的槽位配置

故障排查

  • 线缆检测失败:检查RefSmcChip关联的SMC芯片是否正常
  • 节点识别错误:检查Slot和Type配置是否正确
  • SMC通信异常:检查SMC芯片对象配置和硬件连接

UBC线缆检测

  • 检测原理:通过SMC命令读取高速线缆连接信息
  • 支持类型:主要支持Compute类型节点的线缆检测
  • 检测范围:检测UBC高速线缆的连接状态和质量
  • 故障诊断:提供线缆连接故障的诊断信息