CSR配置字典之Ums类

📋 文档信息

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

📋 变更历史记录

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

🎯 类概览

属性	值
类名称	`Ums`
功能描述	USB大容量存储设备管理，用于管理USB存储设备的挂载、容量、文件系统等信息
所属SIG组	interface
所属组件	ums
最后更新	2025-04-24
状态	🟢 正常运行

📊 属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Name`	String	-	String	-	U盘名字	用于展示U盘名字	`"USB Mass Storage for BMA"`	CSR配置	软件
`CapacityKB`	U32	-	U32	-	U盘容量	标识U盘容量，单位kByte	`314573`	CSR配置	软件
`FileSystem`	String	-	String	-	U盘flash对应的文件系统	标识U盘flash对应的文件系统	`"vfat"`	CSR配置	软件
`FlashDev`	String	-	String	-	U盘flash对应的设备名称	标识U盘flash对应的设备名称	`"/dev/mmcblk"`	CSR配置	软件
`MountPoint`	String	-	String	-	u盘挂载点	标识u盘挂载点	`"/mnt"`	CSR配置	软件
`Enable`	Boolean	-	Boolean	-	U盘功能使能	标识U盘功能是否使能	`true`	CSR配置	软件
`BiosSupport`	Boolean	-	Boolean	-	BIOS支持U盘功能标志	标识BIOS是否支持U盘功能	`true`	CSR配置	软件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`FreeUpdateSpaceBytes`	U32	-	U32	-	U盘更新文件夹剩余容量	标识U盘更新文件夹剩余容量，单位byte	`524288000`	CSR配置	软件
`MaxUpdateSpaceBytes`	U32	-	U32	-	U盘更新文件夹最大容量	U盘更新文件夹最大容量，单位byte	`524288000`	CSR配置	软件

🔗 动态关联机制

语法规范

yaml

# UMS基本配置
Name: "USB Mass Storage for BMA"
CapacityKB: 314573
FileSystem: "vfat"
FlashDev: "/dev/mmcblk"
MountPoint: "/mnt"
Enable: true
BiosSupport: true
# 可选配置
FreeUpdateSpaceBytes: 524288000
MaxUpdateSpaceBytes: 524288000

关联说明

Name: U盘显示名称，用于Web界面和日志展示
CapacityKB: U盘总容量，以KB为单位
FileSystem: 支持的文件系统类型，通常为vfat
FlashDev: 底层存储设备节点
MountPoint: 系统挂载点路径
Enable: 控制U盘功能是否启用
BiosSupport: 标识BIOS是否支持USB启动

📂 分类标准

硬件属性

定义：当前版本无硬件属性
特点：所有属性都是软件管理相关
示例：无

软件属性

定义：由软件管理和维护的U盘参数
特点：挂载管理、容量管理、文件系统配置等
示例：所有属性都是软件属性

📝 配置示例

标准USB存储配置

json

{
  "Ums": {
    "Name": "USB Mass Storage for BMA",
    "CapacityKB": 314573,
    "FileSystem": "vfat",
    "FlashDev": "/dev/mmcblk",
    "MountPoint": "/mnt",
    "Enable": true,
    "BiosSupport": true,
    "FreeUpdateSpaceBytes": 524288000,
    "MaxUpdateSpaceBytes": 524288000
  }
}

大容量USB存储配置

json

{
  "Ums": {
    "Name": "USB Mass Storage for BMA",
    "CapacityKB": 2097152,
    "FileSystem": "vfat",
    "FlashDev": "/dev/mmcblk1",
    "MountPoint": "/mnt/usb",
    "Enable": true,
    "BiosSupport": true,
    "FreeUpdateSpaceBytes": 1073741824,
    "MaxUpdateSpaceBytes": 1073741824
  }
}

🔧 使用指南

配置步骤

设置设备名称：配置Name属性用于识别
设置容量信息：配置CapacityKB属性
设置文件系统：配置FileSystem属性
设置设备节点：配置FlashDev属性
设置挂载点：配置MountPoint属性
使能U盘功能：配置Enable属性
配置BIOS支持：配置BiosSupport属性
可选配置：根据需要配置FreeUpdateSpaceBytes和MaxUpdateSpaceBytes

使用场景

固件更新：通过U盘进行BMC固件更新
配置导入导出：通过U盘进行配置文件的导入和导出
日志收集：将系统日志导出到U盘
BIOS启动：支持BIOS从U盘启动

注意事项

挂载点冲突：确保MountPoint不与其他挂载点冲突
文件系统兼容性：确保FileSystem与实际格式一致
容量准确性：CapacityKB应与实际容量匹配
权限管理：确保挂载点有正确的访问权限
BIOS兼容性：BiosSupport应根据实际BIOS能力设置

故障排除

U盘无法挂载：
- 检查FlashDev设备节点是否存在
- 确认FileSystem配置是否正确
- 验证MountPoint目录是否存在
容量显示不正确：
- 检查CapacityKB配置是否正确
- 验证实际U盘容量是否与配置一致
更新失败：
- 检查FreeUpdateSpaceBytes是否足够
- 确认MaxUpdateSpaceBytes配置是否合理

CSR配置字典之Ums类 ​

📋 文档信息 ​

📋 变更历史记录 ​

🎯 类概览 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

关联说明 ​

📂 分类标准 ​

硬件属性 ​

软件属性 ​

📝 配置示例 ​

标准USB存储配置 ​

大容量USB存储配置 ​

🔧 使用指南 ​

配置步骤 ​

使用场景 ​

注意事项 ​

故障排除 ​

CSR配置字典之Ums类

📋 文档信息

📋 变更历史记录

🎯 类概览

📊 属性定义详表

必选属性

可选属性

🔗 动态关联机制

语法规范

关联说明

📂 分类标准

硬件属性

软件属性

📝 配置示例

标准USB存储配置

大容量USB存储配置

🔧 使用指南

配置步骤

使用场景

注意事项

故障排除