CSR配置字典之CollectRegisters类
更新时间: 2026/06/22
在Gitcode上查看源码

📋 文档信息

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

📋 变更历史记录

文档变更记录

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

🎯 类概览

CollectRegisters 类

属性
类名称CollectRegisters
功能描述寄存器收集配置对象
所属SIG组system
所属组件调试管理
权限ConfigureSelf
责任人系统架构组
最后更新2026-06-22
状态🟢 正常运行

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
RefChipU8[]-refInterface: bmc.kepler.Chip.JtagTarget引用的JtagTarget芯片寄存器收集引用目标芯片的JtagTarget接口[1]CSR配置软件
UIDString--组件UID标识寄存器收集所属的组件"DebugModule1"CSR配置软件

可选属性


🔗 动态关联机制

语法规范

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

yaml
# RefChip关联
RefChip: refInterface "bmc.kepler.Chip.JtagTarget"   # 引用Chip的JtagTarget接口进行寄存器收集

关联说明

  • RefChip关联: 通过refInterface引用bmc.kepler.Chip.JtagTarget接口,用于通过JTAG通道访问芯片寄存器
  • 数组引用: RefChip为U8数组类型,支持同时引用多个芯片的JtagTarget接口
  • UID标识: UID用于标识寄存器收集配置所属的组件,便于调试管理

📂 分类标准

软件属性

  • 定义:用于软件层面的寄存器收集和调试管理配置
  • 特点:包含芯片JTAG引用和组件UID标识等功能
  • 示例RefChip, UID

📝 配置示例

标准单芯片寄存器收集配置

json
{
  "CollectRegisters": {
    "RefChip": [1],
    "UID": "DebugModule1"
  }
}

多芯片寄存器收集配置

json
{
  "CollectRegisters_MultiChip": {
    "RefChip": [1, 2],
    "UID": "DebugModuleAll"
  }
}

不同调试模块配置

json
{
  "CollectRegisters_CPUDebug": {
    "RefChip": [1],
    "UID": "CPUDebugModule"
  }
}
json
{
  "CollectRegisters_NPUDebug": {
    "RefChip": [2],
    "UID": "NPUDebugModule"
  }
}

🔧 使用指南

配置步骤

  1. 设置芯片引用:配置RefChip,指定寄存器收集目标芯片的JtagTarget接口
  2. 设置组件UID:配置UID,标识寄存器收集配置所属的组件

注意事项

  • JTAG接口:RefChip引用的JtagTarget接口用于通过JTAG通道访问芯片寄存器
  • UID唯一性:UID应保证唯一性,避免不同调试模块间的冲突
  • 数组引用:RefChip为U8数组类型,支持同时引用多个芯片
  • 调试安全:寄存器收集操作涉及底层硬件访问,需确保操作安全性

性能建议

  • 芯片引用优化:合理设置RefChip数组,避免不必要的芯片引用
  • UID命名规范:建议采用统一的UID命名规范,便于调试管理

引用接口说明

  • bmc.kepler.Chip.JtagTarget: 用于通过JTAG通道访问芯片寄存器,支持寄存器读写操作

常见问题

  • Q: JtagTarget接口的作用是什么?
    • A: JtagTarget接口用于通过JTAG通道访问芯片内部寄存器,支持调试和故障诊断
  • Q: UID的作用是什么?
    • A: UID用于标识寄存器收集配置所属的组件,便于在调试管理中区分不同的收集任务
  • Q: RefChip为什么是数组类型?
    • A: 支持同时引用多个芯片的JtagTarget接口,便于批量寄存器收集场景