CSR配置字典之BusinessTopoNode类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | BusinessTopoNode类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建BusinessTopoNode类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
BusinessTopoNode 类
属性 | 值 |
---|---|
类名称 | BusinessTopoNode |
功能描述 | 业务拓扑节点管理,主要用于UBC高速线缆检测功能,提供基础板拓扑信息和线缆检测能力 |
所属SIG组 | network |
所属组件 | topology |
责任人 | 网络拓扑管理组 |
最后更新 | 2025-01-27 |
状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
Slot | String | 0 | 数字 | - | 基础板BCU槽位号 | UBC高速线缆检测 | "${Slot}" | CSR配置 | 硬件 |
RefSmcChip | String | [] | 数组 | Smc_CpuBrdSMC | 基础板对应的smc芯片,代码中用来发送smc命令读取线缆信息 | UBC高速线缆检测 | "#/Smc_CpuBrdSMC" | CSR配置 | 硬件 |
Type | String | "" | 字符串 | - | 线缆检测类型 | UBC高速线缆检测 | "Compute" | CSR配置 | 硬件 |
可选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
UID | String | "" | 字符串 | - | 没用到 | 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"
}
}
🔧 使用指南
配置步骤
- 设置槽位号:配置Slot标识节点所在槽位
- 关联SMC芯片:通过RefSmcChip关联对应的SMC芯片对象
- 设置节点类型:配置Type标识节点的业务类型
- 可选配置UID:根据需要配置UID(当前未使用)
- 验证关联:确保SMC芯片对象已正确定义
注意事项
- SMC芯片关联:RefSmcChip必须关联有效的SMC芯片对象
- 节点类型:Type需要根据实际业务需求设置
- 槽位配置:Slot建议使用变量替换实现动态配置
- UID属性:当前UID属性未使用,可保持默认值
性能建议
- 合理配置类型:根据实际业务场景选择合适的Type
- 优化SMC通信:确保SMC芯片通信正常,避免线缆检测失败
- 槽位管理:使用变量替换实现灵活的槽位配置
故障排查
- 线缆检测失败:检查RefSmcChip关联的SMC芯片是否正常
- 节点识别错误:检查Slot和Type配置是否正确
- SMC通信异常:检查SMC芯片对象配置和硬件连接
UBC线缆检测
- 检测原理:通过SMC命令读取高速线缆连接信息
- 支持类型:主要支持Compute类型节点的线缆检测
- 检测范围:检测UBC高速线缆的连接状态和质量
- 故障诊断:提供线缆连接故障的诊断信息