CSR配置字典之DftVersion类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | DftVersion类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建DftVersion类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
DftVersion 类
属性 | 值 |
---|---|
类名称 | DftVersion |
功能描述 | 装备版本号检测管理,用于硬件版本信息的检测和管理,目前处于预留状态 |
所属SIG组 | system |
所属组件 | version |
责任人 | 系统管理组 |
最后更新 | 2025-01-27 |
状态 | 🔶 预留功能 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
FruId | Mixed | - | U8 | Fru_CpuBoard | 目前暂未使用 | 目前暂未使用 | "<=/Fru_CpuBoard.FruId" | CSR | 软件 |
VersionType | U8 | - | U8 | - | 目前暂未使用 | 目前暂未使用 | 2 | CSR | 软件 |
Version | Mixed | - | 关联数据源 | CpuBoard_1 | 目前暂未使用 | 目前暂未使用 | "<=/CpuBoard_1.LogicVersion" | CSR | 软件 |
UnitNum | Mixed | - | U32 | CpuBoard_1 | 目前暂未使用 | 目前暂未使用 | "<=/CpuBoard_1.LogicUnit" | CSR | 软件 |
NeedUintNum | U8 | - | U8 | - | 目前暂未使用 | 目前暂未使用 | 1 | CSR | 软件 |
🔗 动态关联机制
语法规范
使用 <=/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
}
}
🔧 使用指南
配置步骤
- 关联FRU对象:通过FruId关联对应的FRU对象
- 设置版本类型:配置VersionType标识版本检测类型
- 关联版本信息:通过Version关联硬件板卡的版本信息
- 关联单元编号:通过UnitNum关联硬件板卡的单元编号
- 设置需求数量:配置NeedUintNum指定需要的单元数量
- 验证关联:确保所有关联的对象已正确定义
注意事项
- 预留功能:当前所有属性均为预留状态,暂未投入实际使用
- 关联对象:FruId、Version、UnitNum需要关联已存在的对象
- 版本类型:VersionType需要根据实际硬件类型设置
- 单元数量:NeedUintNum应与实际硬件配置匹配
- 动态关联:使用<=/语法时需要确保目标对象存在
性能建议
- 合理关联:避免过度复杂的关联关系
- 类型匹配:确保VersionType与实际硬件类型匹配
- 数量配置:NeedUintNum应根据实际需求设置
- 预留扩展:为未来功能扩展预留配置空间
故障排查
- 关联失败:检查FruId、Version、UnitNum关联的对象是否存在
- 版本类型错误:检查VersionType配置是否正确
- 单元数量异常:检查NeedUintNum配置是否合理
- 配置无效:由于当前为预留功能,配置可能不会产生实际效果
未来扩展
- 版本检测:未来可能用于硬件版本的自动检测和验证
- 兼容性检查:可能用于硬件兼容性的检查和管理
- 升级管理:可能用于硬件升级的版本管理
- 故障诊断:可能用于基于版本信息的故障诊断
开发建议
- 保持配置:虽然暂未使用,建议保持配置的完整性
- 文档更新:当功能启用时,及时更新相关文档
- 测试验证:功能启用前进行充分的测试验证
- 兼容性考虑:确保新功能与现有系统的兼容性
⚠️ 重要说明
当前状态
- 预留功能:DftVersion类当前处于预留状态
- 暂未启用:所有属性描述均为"目前暂未使用"
- 配置保留:虽然暂未使用,但建议保留配置以备未来扩展
使用建议
- 配置完整:建议按照标准格式完成配置
- 关注更新:关注后续版本中该功能的启用情况
- 测试准备:为功能启用做好测试准备
技术支持
- 咨询渠道:如需了解该功能的启用计划,请联系技术支持
- 文档更新:功能启用时将及时更新相关文档
- 培训支持:功能启用后将提供相应的培训支持