文档中心
CSR配置字典之MutuallyExclusiveFirmwares类
更新时间： 2026/05/12
在Gitcode上查看源码

📋 文档信息 ​

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

📋 变更历史记录 ​

文档变更记录 ​

版本发布日期变更类型变更内容影响范围维护人员
v1.02026/05/12初始版本创建MutuallyExclusiveFirmwares类配置字典全新文档firmware_mgmt组件组

🎯 类概览 ​

MutuallyExclusiveFirmwares 类 ​

属性值
类名称MutuallyExclusiveFirmwares
功能描述固件互斥关系配置，支持正在升级和禁止升级固件的ID配置
所属SIG组hardware
所属组件firmware_mgmt
责任人基础服务组
最后更新2026/05/12
状态🟢 正常运行

📊 属性定义详表 ​

MutuallyExclusiveFirmwares 类 - 必选属性 ​

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
CurrentFirmwareIdString-String-正在升级的固件ID配置当前固件"0x0000000100000001"CSR软件
ExclusiveFirmwareIdsString[]-String[]-禁止升级的固件ID列表配置互斥固件["0x0000000200000001"]CSR软件

📝 配置示例 ​

固件互斥关系配置 ​

json
{
  "MutuallyExclusiveFirmwares": {
    "CurrentFirmwareId": "0x0000000100000001",
    "ExclusiveFirmwareIds": ["0x0000000200000001", "0x0000000300000001"]
  }
}

🔧 使用指南 ​

配置步骤 ​

  1. 配置当前固件：设置 CurrentFirmwareId 确定正在升级的固件

  2. 配置互斥固件：设置 ExclusiveFirmwareIds 确定禁止同时升级的固件

注意事项 ​

  • CurrentFirmwareId 格式为 "0xXXXXXXXXXXXXXXXX"

  • ComponentID 占高四字节，ComponentIDEx 占低四字节

  • 互斥固件在当前固件升级完成前无法启动升级

  • 此对象用于配置禁止固件同时升级的互斥关系，Id的构成方式为ComponentID与ComponentIDEx组成的U64类型转换成字符串

故障排查 ​

  • 固件升级被阻止：检查 ExclusiveFirmwareIds 配置

  • 互斥配置失效：检查 CurrentFirmwareId 和 ExclusiveFirmwareIds 格式

上一篇UpgradeErrorCode
下一篇ParallelUpgradePolicy