CSR 配置字典总览
更新时间:2025/7/12
在Gitcode上查看源码📋 文档信息
| 字段 | 值 |
|---|---|
| 文档标题 | CSR配置字典总览 |
| 创建日期 | 2025-07-12 |
| 最后更新 | 2025-07-12 |
| 文档版本 | v2.0 |
| 维护人员 | Hardware SIG |
| 审核状态 | ✅ 已审核 |
🎯 总览
本目录包含了BMC固件开发中CSR(Component System Resource)配置的完整字典文档。每个文档详细描述了特定组件类型的配置方法、属性定义、使用场景和最佳实践。
🔧 基础配置与模板
| 文档名称 | 描述 | 状态 |
|---|---|---|
| CSR配置指导模板 | CSR配置文档的标准模板 | 已完成初稿,待排版 |
| CSR语法汇总 | CSR配置中所有支持的语法规则和使用方法 | 已完成初稿,待排版 |
| CSR公共配置 | CSR文件的基础配置信息,包括版本管理 | 已完成初稿,待排版 |
| CSR硬件监控防抖机制 | CSR文件中硬件监控系统使用的各种防抖机制及其应用场景 | 已完成初稿,待排版 |
🔌 硬件访问组件
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Scanner | 周期性扫描和读取硬件数据的组件 | 已完成初稿,待排版 |
| Accessor | 硬件寄存器写操作的访问器组件 | 已完成初稿,待排版 |
| SMC | 系统管理控制器通信组件 | 已完成初稿,待排版 |
| Chip | 硬件芯片访问配置 | 已完成初稿,待排版 |
🏗️ 硬件管理组件
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Component | 硬件组件的基本信息和状态管理 | 已完成初稿,待排版 |
| LogicFirmware | CPLD、FPGA等逻辑器件固件管理 | 已完成初稿,待排版 |
| FRU | 现场可替换单元的电子标签管理 | 已完成初稿,待排版 |
| Connector | 硬件连接器配置和管理 | 已完成初稿,待排版 |
| BusinessConnector | 业务连接器配置和管理 | 已完成初稿,待排版 |
📊 监控告警组件
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Event | 硬件状态监控和告警事件配置 | 已完成初稿,待排版 |
| Sensor | 温度、电压等传感器配置 | 已完成初稿,待排版 |
| DiscreteEvent | 离散状态变化事件配置 | 已完成初稿,待排版 |
| Debounce | 信号防抖处理配置 | 已完成初稿,待排版 |
🔄 系统功能组件
CPU与内存管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| CPU | CPU相关的配置和管理 | 已完成初稿,待排版 |
| CpuBoard | CPU板卡配置和管理 | 已完成初稿,待排版 |
| CPUMetrics | CPU占用率监控和告警配置 | 已完成初稿,待排版 |
| Memory | 内存信息加载、显示和HBM温度监控 | 已完成初稿,待排版 |
| MemoryMetrics | 内存占用率监控和告警配置 | 已完成初稿,待排版 |
PCIe与总线管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| PCIeDevice | PCIe设备配置和管理 | 已完成初稿,待排版 |
| PcieAddrInfo | PCIe设备地址和拓扑信息 | 已完成初稿,待排版 |
| BDFConfig | PCIe设备BDF配置 | 已完成初稿,待排版 |
| SerDes | 串行/解串行器配置 | 已完成初稿,待排版 |
| RiserCard | PCIe转接卡配置 | 已完成初稿,待排版 |
散热管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Fan | 风扇硬件信息管理和控制 | 已完成初稿,待排版 |
| FanType | 风扇类型识别和模型认知 | 已完成初稿,待排版 |
| FanGroup | 风扇分组配置 | 已完成初稿,待排版 |
| CoolingFan | 风扇自动调速对象 | 已完成初稿,待排版 |
| CoolingPump | 泵自动调速配置 | 已完成初稿,待排版 |
| CoolingArea | 自动调速区域管理 | 已完成初稿,待排版 |
| CoolingConfig | 散热配置管理 | 已完成初稿,待排版 |
| CoolingPolicy | 散热策略配置 | 已完成初稿,待排版 |
| CoolingRequirement | 散热需求配置 | 已完成初稿,待排版 |
| AirCoolingConfig | 风冷散热配置 | 已完成初稿,待排版 |
| LiquidCoolingConfig | 液冷散热配置 | 已完成初稿,待排版 |
| BasicCoolingConfig | 基础散热配置 | 已完成初稿,待排版 |
| AbnormalFan | 风扇异常情况下的调速策略 | 已完成初稿,待排版 |
| AbnormalPump | 泵异常情况下的调速策略 | 已完成初稿,待排版 |
| LeakDetection | 液冷泄漏检测配置 | 已完成初稿,待排版 |
| Pumps | 泵速传递对象 | 已完成初稿,待排版 |
| ThermTrip | 温度保护配置 | 已完成初稿,待排版 |
| ThermalConfiguration | 散热系统配置 | 已完成初稿,待排版 |
| ThermalSubsystem | 散热子系统功耗统计 | 已完成初稿,待排版 |
电源管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| PowerStrategy | 电源管理策略配置 | 已完成初稿,待排版 |
| PowerConfiguration | 电源配置管理 | 已完成初稿,待排版 |
| PowerSupplies | PSU升级状态监控和告警配置 | 已完成初稿,待排版 |
| PowerAction | 硬件上电锁控制和电源安全保护 | 已完成初稿,待排版 |
| PowerManagement | 电源按钮、AC循环、信号监控和事件处理 | 已完成初稿,待排版 |
| PsuSlot | 电源槽位配置和I2C地址管理 | 已完成初稿,待排版 |
| VrdMgmt | VR管理对象配置 | 已完成初稿,待排版 |
| VrdChip | VR芯片配置 | 已完成初稿,待排版 |
| VrdPower | VR电源供电区域配置 | 已完成初稿,待排版 |
| ForceReset | 强制重启操作配置 | 已完成初稿,待排版 |
温度监控
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Temperature | 历史温度采集曲线和温度点类型管理 | 已完成初稿,待排版 |
| TemperatureInfo | 温度海洋接口温度点配置 | 已完成初稿,待排版 |
| Lm75 | 数字温度检测和I2C通信 | 已完成初稿,待排版 |
存储管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Drive | 硬盘驱动器配置和管理 | 已完成初稿,待排版 |
| HddBackplane | 硬盘背板配置 | 已完成初稿,待排版 |
| M2TransferCard | M.2转接卡配置 | 已完成初稿,待排版 |
系统管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Bios | BIOS版本管理、配置清除和安全启动 | 已完成初稿,待排版 |
| Cpld | CPLD健康状态、上电状态和自检结果 | 已完成初稿,待排版 |
| MCUFirmware | MCU固件管理 | 已完成初稿,待排版 |
| FirmwareComponentInfo | 固件组件信息管理 | 已完成初稿,待排版 |
| SecureBootOptions | 证书过期告警和安全启动配置 | 已完成初稿,待排版 |
| Time | 系统时间配置 | 已完成初稿,待排版 |
| SRUpgrade | 系统升级配置 | 已完成初稿,待排版 |
板卡管理
| 文档名称 | 描述 | 状态 |
|---|---|---|
| ExpBoard | 扩展板基本信息、版本管理和状态监控 | 已完成初稿,待排版 |
| Chassis | 机框信息、开箱事件监控和UID按钮事件处理 | 已完成初稿,待排版 |
| ChassisBMC | 机框BMC配置 | 已完成初稿,待排版 |
| BoardSlotConfig | 板卡槽位配置 | 已完成初稿,待排版 |
接口与通信
| 文档名称 | 描述 | 状态 |
|---|---|---|
| I2cMux | I2C总线通道选择和管理 | 已完成初稿,待排版 |
| Pca9555 | 16位I/O端口扩展和GPIO控制 | 已完成初稿,待排版 |
| NCSICapabilities | PCIe标卡NCSI功能支持能力管理 | 已完成初稿,待排版 |
| UsbLocalOMService | USB近端运维 | 已完成初稿,待排版 |
指示灯与显示
测试与验证
| 文档名称 | 描述 | 状态 |
|---|---|---|
| DftJTAG | JTAG通路配置和bypass检查 | 已完成初稿,待排版 |
| Dft3V3Vlot | 3.3V电压测试项,ADC电压值检测和验证 | 已完成初稿,待排版 |
| DftPysicalLed | 物理LED测试项,LED灯功能验证和状态检测 | 已完成初稿,待排版 |
| DftVersion | 版本测试项配置 | 已完成初稿,待排版 |
| CpldSpaceTest | Cpld全资源检测配置 | 已完成初稿,待排版 |
产品与配置
| 文档名称 | 描述 | 状态 |
|---|---|---|
| Product | 产品信息配置 | 已完成初稿,待排版 |
| UnitConfiguration | UBC线缆检测和PCIe业务拓扑建立 | 已完成初稿,待排版 |
| BusinessTopoNode | UBC高速线缆检测和拓扑管理 | 已完成初稿,待排版 |
| Contact | 联系人信息配置 | 已完成初稿,待排版 |
| Dimension | 尺寸信息配置 | 已完成初稿,待排版 |
其他组件
| 文档名称 | 描述 | 状态 |
|---|---|---|
| DeviceChip | VGA接口切换控制和设备芯片管理 | 已完成初稿,待排版 |
| FruData | 电子标签数据管理和多种存储类型支持 | 已完成初稿,待排版 |
| Pmu | IMU版本显示、健康监控和光模块温度管理 | 已完成初稿,待排版 |
| EnergyMetric | 能耗指标监控 | 已完成初稿,待排版 |
| MPCConfig | MPC速度控制配置(已废弃) | 已完成初稿,待排版 |
| MPCModel | MPC速度控制模型(已废弃) | 已完成初稿,待排版 |
| MPCPowerFeature | MPC电源特性数据 | 已完成初稿,待排版 |
📊 统计信息
文档状态统计
- 总文档数量: 89个
- 已完成文档: 89个 (100%)
- 待完成文档: 0个 (0%)
按分类统计
- 基础配置与模板: 3个
- 硬件访问组件: 4个
- 硬件管理组件: 5个
- 监控告警组件: 4个
- 系统功能组件: 73个
- CPU与内存管理: 5个
- PCIe与总线管理: 5个
- 散热管理: 19个
- 电源管理: 10个
- 温度监控: 3个
- 存储管理: 3个
- 系统管理: 7个
- 板卡管理: 4个
- 接口与通信: 4个
- 指示灯与显示: 2个
- 测试与验证: 4个
- 产品与配置: 5个
- 其他组件: 12个
🗂️ 按功能分类
硬件访问层
- 数据读取:
Scanner(周期性读取) - 数据写入:
Accessor(寄存器写入) - 通信协议:
SMC(系统管理控制器) - 芯片访问:
Chip(底层芯片访问)
硬件管理层
- 组件抽象:
Component(硬件组件抽象) - 固件管理:
LogicFirmware(逻辑固件)、MCUFirmware(MCU固件) - 标签管理:
FRU(电子标签)、FruData(FRU数据) - 连接管理:
Connector(连接器)、BusinessConnector(业务连接器)
监控告警层
- 状态监控:
Event(告警事件) - 传感器:
Sensor(各类传感器)、Lm75(温度传感器) - 事件处理:
DiscreteEvent(离散事件) - 信号处理:
Debounce(防抖)
系统功能层
- 处理器管理:
CPU(处理器)、CpuBoard(CPU板卡) - 总线管理:
PCIe(PCIe总线)、SerDes(串行/解串行器) - 散热管理: 风扇、泵、液冷等19个组件
- 电源管理:
VRD、电源策略等10个组件 - 存储管理: 硬盘、
M.2转接卡等3个组件 - 系统管理:
BIOS、CPLD、固件等7个组件
📖 使用指南
🚀 快速入门
🔍 查找配置
- 按组件类型: 直接查找对应的组件文档
- 按功能需求: 参考上述功能分类选择相关文档
- 按开发阶段: 从基础配置到高级功能逐步学习
📝 配置开发流程
- 需求分析: 明确硬件配置需求
- 语法学习: 掌握CSR语法规则
- 组件选择: 选择合适的组件类型
- 配置编写: 按照文档指导编写配置
- 测试验证: 验证配置的正确性和功能
🔧 配置模板
基本CSR文件结构
json
{
"FormatVersion": "3.00",
"DataVersion": "3.00",
"Components": {
"Scanner": {
// Scanner配置
},
"Accessor": {
// Accessor配置
},
"Component": {
// Component配置
},
"Event": {
// Event配置
}
}
}配置文件命名规范
- 基础板配置:
BCU_配置.json - 扩展板配置:
EXU_配置.json - IO板配置:
IEU_配置.json - 存储板配置:
SEU_配置.json - 产品配置:
PSR_配置.json