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

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

DftVersion 类

属性
类名称DftVersion
功能描述装备版本号检测管理,用于硬件版本信息的检测和管理,目前处于预留状态
所属SIG组system
所属组件version
责任人系统管理组
最后更新2025-01-27
状态🔶 预留功能

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
FruIdMixed-U8Fru_CpuBoard目前暂未使用目前暂未使用"<=/Fru_CpuBoard.FruId"CSR软件
VersionTypeU8-U8-目前暂未使用目前暂未使用2CSR软件
VersionMixed-关联数据源CpuBoard_1目前暂未使用目前暂未使用"<=/CpuBoard_1.LogicVersion"CSR软件
UnitNumMixed-U32CpuBoard_1目前暂未使用目前暂未使用"<=/CpuBoard_1.LogicUnit"CSR软件
NeedUintNumU8-U8-目前暂未使用目前暂未使用1CSR软件

🔗 动态关联机制

语法规范

使用 <=/xxx 格式实现动态关联:

yaml
# FRU关联
FruId: "<=/Fru_CpuBoard.FruId"

# 版本信息关联
Version: "<=/CpuBoard_1.LogicVersion"
UnitNum: "<=/CpuBoard_1.LogicUnit"

关联说明

  • FruId: 关联FRU对象的FruId属性
  • Version: 关联硬件板卡的逻辑版本信息
  • UnitNum: 关联硬件板卡的逻辑单元编号

📂 分类标准

硬件属性

  • 定义:与硬件版本检测直接相关的参数
  • 特点:预留用于硬件版本管理功能
  • 示例:本类中暂无硬件属性

软件属性

  • 定义:用于软件逻辑控制和版本管理的参数
  • 特点:由CSR配置管理,用于版本检测逻辑
  • 示例FruId, VersionType, Version, UnitNum, NeedUintNum

📝 配置示例

标准CPU板卡版本检测配置

json
{
  "DftVersion": {
    "FruId": "<=/Fru_CpuBoard.FruId",
    "VersionType": 2,
    "Version": "<=/CpuBoard_1.LogicVersion",
    "UnitNum": "<=/CpuBoard_1.LogicUnit",
    "NeedUintNum": 1
  }
}

内存板卡版本检测配置

json
{
  "DftVersion": {
    "FruId": "<=/Fru_MemoryBoard.FruId",
    "VersionType": 3,
    "Version": "<=/MemoryBoard_1.LogicVersion",
    "UnitNum": "<=/MemoryBoard_1.LogicUnit",
    "NeedUintNum": 1
  }
}

扩展卡版本检测配置

json
{
  "DftVersion": {
    "FruId": "<=/Fru_ExpansionCard.FruId",
    "VersionType": 4,
    "Version": "<=/ExpansionCard_1.LogicVersion",
    "UnitNum": "<=/ExpansionCard_1.LogicUnit",
    "NeedUintNum": 2
  }
}

主板版本检测配置

json
{
  "DftVersion": {
    "FruId": "<=/Fru_MainBoard.FruId",
    "VersionType": 1,
    "Version": "<=/MainBoard_1.LogicVersion",
    "UnitNum": "<=/MainBoard_1.LogicUnit",
    "NeedUintNum": 1
  }
}

🔧 使用指南

配置步骤

  1. 关联FRU对象:通过FruId关联对应的FRU对象
  2. 设置版本类型:配置VersionType标识版本检测类型
  3. 关联版本信息:通过Version关联硬件板卡的版本信息
  4. 关联单元编号:通过UnitNum关联硬件板卡的单元编号
  5. 设置需求数量:配置NeedUintNum指定需要的单元数量
  6. 验证关联:确保所有关联的对象已正确定义

注意事项

  • 预留功能:当前所有属性均为预留状态,暂未投入实际使用
  • 关联对象:FruId、Version、UnitNum需要关联已存在的对象
  • 版本类型:VersionType需要根据实际硬件类型设置
  • 单元数量:NeedUintNum应与实际硬件配置匹配
  • 动态关联:使用<=/语法时需要确保目标对象存在

性能建议

  • 合理关联:避免过度复杂的关联关系
  • 类型匹配:确保VersionType与实际硬件类型匹配
  • 数量配置:NeedUintNum应根据实际需求设置
  • 预留扩展:为未来功能扩展预留配置空间

故障排查

  • 关联失败:检查FruId、Version、UnitNum关联的对象是否存在
  • 版本类型错误:检查VersionType配置是否正确
  • 单元数量异常:检查NeedUintNum配置是否合理
  • 配置无效:由于当前为预留功能,配置可能不会产生实际效果

未来扩展

  • 版本检测:未来可能用于硬件版本的自动检测和验证
  • 兼容性检查:可能用于硬件兼容性的检查和管理
  • 升级管理:可能用于硬件升级的版本管理
  • 故障诊断:可能用于基于版本信息的故障诊断

开发建议

  • 保持配置:虽然暂未使用,建议保持配置的完整性
  • 文档更新:当功能启用时,及时更新相关文档
  • 测试验证:功能启用前进行充分的测试验证
  • 兼容性考虑:确保新功能与现有系统的兼容性

⚠️ 重要说明

当前状态

  • 预留功能:DftVersion类当前处于预留状态
  • 暂未启用:所有属性描述均为"目前暂未使用"
  • 配置保留:虽然暂未使用,但建议保留配置以备未来扩展

使用建议

  • 配置完整:建议按照标准格式完成配置
  • 关注更新:关注后续版本中该功能的启用情况
  • 测试准备:为功能启用做好测试准备

技术支持

  • 咨询渠道:如需了解该功能的启用计划,请联系技术支持
  • 文档更新:功能启用时将及时更新相关文档
  • 培训支持:功能启用后将提供相应的培训支持