CSR配置字典之KrunFirmware类
更新时间: 2026/04/23
在Gitcode上查看源码

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

KrunFirmware 类

属性
类名称KrunFirmware
功能描述Krun固件管理,提供Krun固件版本管理、升级和关联系统管理功能
所属SIG组firmware
所属组件firmware
责任人固件管理组
最后更新2026-04-23
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
IdU80--Krun固件编号Krun固件管理1CSR配置软件
UIdString""--单板UID
vendor(00000001)+单板类型(02)+单板编码(0302031825)
BMC接口展示"00000001020302080690"CSR配置软件
NameString""--Krun固件名称BMC接口展示"Krun"CSR配置软件
RefChipU8[][]-SPIFlash_1用于读写Krun固件数据关联ChipKrun固件升级#/SPIFlash_1硬件提供硬件
FlashChipU8[][]-SPIFlash_1用于擦除Krun固件数据关联ChipKrun固件升级#/SPIFlash_1硬件提供硬件
RelatedSystemsU8[][]-Krun固件关联HostKrun固件关联HostKrun固件版本号上报[1, 2]CSR配置软件

🔗 动态关联机制

语法规范

使用 #/xxx 格式实现属性间的动态关联:

yaml
# 语法格式
RefChip: "#/SPIFlash_1"
FlashChip: "#/SPIFlash_1"

关联说明

  • RefChip: 关联Krun固件对应的Chip对象
  • FlashChip: 关联Krun固件升级使用的Flash Chip
  • RelatedSystems: 关联Krun固件服务的Host系统

📂 分类标准

硬件属性

  • 定义:与硬件Chip直接相关的参数
  • 特点:通过硬件关联获取
  • 示例RefChip, FlashChip

软件属性

  • 定义:用于软件层面的固件管理
  • 特点:包含标识、版本、系统关联等功能
  • 示例Id, UId, Name, RelatedSystems

📝 配置示例

标准KrunFirmware配置

json
{
  "KrunFirmware": {
    "Id": 1,
    "UId": "00000001020302080690",
    "Name": "Krun",
    "RefChip": "#/SPIFlash_1",
    "FlashChip": "#/SPIFlash_1",
    "RelatedSystems": [1, 2]
  }
}

🔧 使用指南

配置步骤

  1. 设置固件编号:配置Id标识Krun固件
  2. 设置单板UID:配置UId格式为vendor+单板类型+单板编码
  3. 设置固件名称:配置Name显示固件名称
  4. 关联Chip对象:配置RefChip和FlashChip关联硬件Chip
  5. 关联Host系统:配置RelatedSystems指定服务的Host

注意事项

  • UID格式:UId必须符合vendor+单板类型+单板编码格式
  • Chip关联:确保SPIFlash对象已正确定义
  • 系统关联:RelatedSystems数组中的系统ID必须有效
  • 唯一性:Id在同一CSR中必须唯一

性能建议

  • 版本管理:及时更新Krun固件版本信息
  • 升级关联:确保Flash Chip有足够空间进行升级
  • 系统关联:正确配置RelatedSystems以支持多Host场景