CSR配置字典之CollectRegisters类
更新时间: 2026/06/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | CollectRegisters类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026-06-22 |
| 最后更新 | 2026-06-22 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-06-22 | 初始版本 | 创建CollectRegisters类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
CollectRegisters 类
| 属性 | 值 |
|---|---|
| 类名称 | CollectRegisters |
| 功能描述 | 寄存器收集配置对象 |
| 所属SIG组 | system |
| 所属组件 | 调试管理 |
| 权限 | ConfigureSelf |
| 责任人 | 系统架构组 |
| 最后更新 | 2026-06-22 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
RefChip | U8[] | 无 | - | refInterface: bmc.kepler.Chip.JtagTarget | 引用的JtagTarget芯片 | 寄存器收集引用目标芯片的JtagTarget接口 | [1] | CSR配置 | 软件 |
UID | String | 无 | - | - | 组件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"
}
}🔧 使用指南
配置步骤
- 设置芯片引用:配置RefChip,指定寄存器收集目标芯片的JtagTarget接口
- 设置组件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接口,便于批量寄存器收集场景