CSR配置字典之[类名称]类
更新时间:2025/07/12
在Gitcode上查看源码

NOTE

该文档仍在建设中,敬请期待。

📋 文档信息

字段
文档标题CSR配置字典之[类名称]类
创建日期[YYYY-MM-DD]
最后更新[YYYY-MM-DD]
文档版本v[版本号]
维护人员Hardware SIG
审核状态✅ 已审核

📋 变更历史

版本日期变更内容变更人审核人备注
v1.0[YYYY-MM-DD]初始版本创建开发团队技术负责人首次发布

🎯 类概览

[类名称]类 是BMC固件中用于[功能描述]的配置类。该类提供了[主要功能1]、[主要功能2]和[主要功能3]等功能。 状态: 🟢 活跃维护中
适用范围: [适用范围描述]
依赖组件: [依赖组件1]、[依赖组件2]、[依赖组件3]

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源
UId[硬件/软件][默认值][取值范围][动态关联对象]唯一标识符,格式:[具体格式说明]身份识别"[示例UID值]"[CSR配置/硬件提供/软件生成]
Name[硬件/软件][默认值][取值范围][动态关联对象]组件名称,[命名规则说明]接口展示"[示例名称]"[CSR配置/硬件提供/软件生成]
Version[硬件/软件][默认值][取值范围][动态关联对象]版本号升级校验"#/Accessor_[组件名]Ver.Value"[CSR配置/硬件提供/软件生成]
Location[硬件/软件][默认值][取值范围][动态关联对象]器件位号硬件定位[示例位号][CSR配置/硬件提供/软件生成]
Status[硬件/软件][默认值][取值范围][动态关联对象]运行状态状态监控"#/Accessor_[组件名]Status.Value"[CSR配置/硬件提供/软件生成]

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源
ExtendedInfo[硬件/软件][默认值][取值范围][动态关联对象]扩展信息调试诊断"[扩展信息示例]"[CSR配置/硬件提供/软件生成]
TestMode[硬件/软件]00或1[动态关联对象]测试模式开关测试验证0[CSR配置/硬件提供/软件生成]

🔗 动态关联机制

[关联类型1]关联

json
{
  "属性名": "#/目标对象.属性名"
}

[关联类型2]关联

json
{
  "属性名": "<=/表达式对象.Value"
}

[关联类型3]关联

json
{
  "属性名": "|> expr(表达式内容)"
}

关联说明:

  • #/目标对象.属性名: [关联说明1]
  • <=/表达式对象.Value: [关联说明2]
  • |> expr(表达式内容): [关联说明3]

📂 分类标准

硬件属性

  • 属性名1: [属性功能描述]
  • 属性名2: [属性功能描述]
  • 属性名3: [属性功能描述]

软件属性

  • 属性名1: [属性功能描述]
  • 属性名2: [属性功能描述]
  • 属性名3: [属性功能描述]

📝 配置示例

基础配置

json
{
  "[类名称]": {
    "UId": "[示例UID值]",
    "Name": "[示例名称]",
    "Version": "#/Accessor_[组件名]Ver.Value",
    "Location": [示例位号],
    "Status": "#/Accessor_[组件名]Status.Value"
  }
}

高级配置

json
{
  "[类名称]": {
    "UId": "[示例UID值]",
    "Name": "[示例名称]",
    "Version": "#/Accessor_[组件名]Ver.Value",
    "Location": [示例位号],
    "Status": "#/Accessor_[组件名]Status.Value",
    "ExtendedInfo": "[扩展信息示例]",
    "TestMode": 0
  }
}

多实例配置

json
{
  "[类名称]_1": {
    "UId": "[示例UID值1]",
    "Name": "[示例名称1]",
    "Version": "#/Accessor_[组件名]Ver.Value",
    "Location": [示例位号1],
    "Status": "#/Accessor_[组件名]Status.Value"
  },
  "[类名称]_2": {
    "UId": "[示例UID值2]",
    "Name": "[示例名称2]",
    "Version": "#/Accessor_[组件名]Ver.Value",
    "Location": [示例位号2],
    "Status": "#/Accessor_[组件名]Status.Value"
  }
}

复杂配置

json
{
  "[类名称]": {
    "UId": "[示例UID值]",
    "Name": "[示例名称]",
    "Version": "|> expr((($1 > 1) ? $1 : 1))",
    "Location": [示例位号],
    "Status": "<=/Scanner_PowerGd.Value",
    "ExtendedInfo": "[扩展信息示例]",
    "TestMode": 1
  }
}

🔧 使用指南

配置步骤

  1. [步骤1]: [步骤描述]
  2. [步骤2]: [步骤描述]
  3. [步骤3]: [步骤描述]
  4. [步骤4]: [步骤描述]
  5. [步骤5]: [步骤描述]

最佳实践

  • [最佳实践1]
  • [最佳实践2]
  • [最佳实践3]
  • [最佳实践4]

注意事项

  • [注意事项1]
  • [注意事项2]
  • [注意事项3]
  • [注意事项4]

故障排除

  • [问题1]: [解决方案]
  • [问题2]: [解决方案]
  • [问题3]: [解决方案]
  • [问题4]: [解决方案]

📚 相关文档