CSR配置字典之KrunFirmware类
更新时间: 2026/04/23
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | KrunFirmware类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026-04-23 |
| 最后更新 | 2026-04-23 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-04-23 | 初始版本 | 创建KrunFirmware类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
KrunFirmware 类
| 属性 | 值 |
|---|---|
| 类名称 | KrunFirmware |
| 功能描述 | Krun固件管理,提供Krun固件版本管理、升级和关联系统管理功能 |
| 所属SIG组 | firmware |
| 所属组件 | firmware |
| 责任人 | 固件管理组 |
| 最后更新 | 2026-04-23 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Id | U8 | 0 | - | - | Krun固件编号 | Krun固件管理 | 1 | CSR配置 | 软件 |
UId | String | "" | - | - | 单板UID vendor(00000001)+单板类型(02)+单板编码(0302031825) | BMC接口展示 | "00000001020302080690" | CSR配置 | 软件 |
Name | String | "" | - | - | Krun固件名称 | BMC接口展示 | "Krun" | CSR配置 | 软件 |
RefChip | U8[] | [] | - | SPIFlash_1 | 用于读写Krun固件数据关联Chip | Krun固件升级 | #/SPIFlash_1 | 硬件提供 | 硬件 |
FlashChip | U8[] | [] | - | SPIFlash_1 | 用于擦除Krun固件数据关联Chip | Krun固件升级 | #/SPIFlash_1 | 硬件提供 | 硬件 |
RelatedSystems | U8[] | [] | - | Krun固件关联Host | Krun固件关联Host | Krun固件版本号上报 | [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]
}
}🔧 使用指南
配置步骤
- 设置固件编号:配置Id标识Krun固件
- 设置单板UID:配置UId格式为vendor+单板类型+单板编码
- 设置固件名称:配置Name显示固件名称
- 关联Chip对象:配置RefChip和FlashChip关联硬件Chip
- 关联Host系统:配置RelatedSystems指定服务的Host
注意事项
- UID格式:UId必须符合vendor+单板类型+单板编码格式
- Chip关联:确保SPIFlash对象已正确定义
- 系统关联:RelatedSystems数组中的系统ID必须有效
- 唯一性:Id在同一CSR中必须唯一
性能建议
- 版本管理:及时更新Krun固件版本信息
- 升级关联:确保Flash Chip有足够空间进行升级
- 系统关联:正确配置RelatedSystems以支持多Host场景