CSR 配置字典总览
更新时间: 2025/07/12
在Gitcode上查看源码

📋 文档信息

字段
文档标题CSR配置字典总览
创建日期2025-07-12
最后更新2026-06-04
文档版本v2.0
维护人员Hardware SIG
审核状态✅ 已审核

🎯 总览

本目录包含了BMC固件开发中CSR(Component System Resource)配置的完整字典文档。每个文档详细描述了特定组件类型的配置方法、属性定义、使用场景和最佳实践。

🔧 基础配置与模板

文档名称描述状态
CSR配置指导模板CSR配置文档的标准模板已完成
CSR语法指南CSR配置中所有支持的语法规则和使用方法已完成
CSR格式指南CSR文件的基础配置信息,包括版本管理已完成
CSR硬件监控防抖机制CSR文件中硬件监控系统使用的各种防抖机制及其应用场景已完成
事件对象唯一性原则CSR文件中硬件监控系统使用的各种防抖机制及其应用场景已完成

🔌 硬件访问组件

文档名称描述状态
Scanner周期性扫描和读取硬件数据的组件已完成
Accessor硬件寄存器写操作的访问器组件已完成
SMC系统管理控制器通信组件已完成
Chip硬件芯片访问配置已完成

🏗️ 硬件管理组件

文档名称描述状态
Component硬件组件的基本信息和状态管理已完成
LogicFirmwareCPLD、FPGA等逻辑器件固件管理已完成
FRU现场可替换单元的电子标签管理已完成初稿,待排版
Connector硬件连接器配置和管理已完成
BusinessConnector业务连接器配置和管理已完成

📊 监控告警组件

文档名称描述状态
Event硬件状态监控和告警事件配置已完成
Sensor温度、电压等传感器配置已完成
DiscreteEvent离散状态变化事件配置已完成
Debounce信号防抖处理配置已完成
IpmiPefConfigIPMI PEF全局配置已完成
IpmiPefControlIPMI PEF控制参数全局配置已完成
IpmiPefFilterIPMI PEF过滤器配置已完成
IpmiPefAlertFilterIPMI PEF告警过滤器配置已完成
IpmiPefAlertStringIPMI PEF告警字符串配置已完成
MCDLSDR管理控制器设备定位SDR(Sensor Data Record)配置已完成
BootErrorBIOS启动错误事件记录配置已完成
PowerEvent电源事件管理已完成
Events系统事件记录管理已完成

🔄 系统功能组件

CPU与内存管理

文档名称描述状态
CPUCPU相关的配置和管理已完成
CpuBoardCPU板卡配置和管理已完成
CPUMetricsCPU占用率监控和告警配置已完成
Memory内存信息加载、显示和HBM温度监控已完成
MemoryMetrics内存占用率监控和告警配置已完成

PCIe与总线管理

文档名称描述状态
PCIeDevicePCIe设备配置和管理已完成
PcieAddrInfoPCIe设备地址和拓扑信息已完成
BDFConfigPCIe设备BDF配置已完成
SerDes串行/解串行器配置已完成
RiserCardPCIe转接卡配置已完成
PCIeCardPCIe卡配置已完成
PCIeSlotPCIe槽位管理已完成
CANMgmtCAN-FD总线通信管理已完成
TCPMgmtTCP网络通信管理已完成

散热管理

文档名称描述状态
Fan风扇硬件信息管理和控制已完成
FanType风扇类型识别和模型认知已完成
FanGroup风扇分组配置已完成
CoolingFan风扇自动调速对象已完成
CoolingPump泵自动调速配置已完成
CoolingArea自动调速区域管理已完成
CoolingConfig散热配置管理已完成
CoolingPolicy散热策略配置已完成
CoolingRequirement散热需求配置已完成
AirCoolingConfig风冷散热配置已完成
LiquidCoolingConfig液冷散热配置已完成
BasicCoolingConfig基础散热配置已完成
AbnormalFan风扇异常情况下的调速策略已完成
AbnormalPump泵异常情况下的调速策略已完成
LeakDetection液冷泄漏检测配置已完成
LeakDetector液冷漏液检测器配置已完成
Pumps泵速传递对象已完成
ThermTrip温度保护配置已完成
ThermalConfiguration散热系统配置已完成
ThermalSubsystem散热子系统功耗统计已完成

电源管理

文档名称描述状态
PowerStrategy电源管理策略配置已完成
PowerConfiguration电源配置管理已完成
PowerSuppliesPSU升级状态监控和告警配置已完成
PowerAction硬件上电锁控制和电源安全保护已完成
PowerManagement电源按钮、AC循环、信号监控和事件处理已完成
PsuSlot电源槽位配置和I2C地址管理已完成
VrdMgmtVR管理对象配置已完成
VrdChipVR芯片配置已完成
VrdPowerVR电源供电区域配置已完成
ForceReset强制重启操作配置已完成
PowerPoint功耗点对象配置管理已完成
PowerPointMgmt功耗点管理对象配置管理已完成
EnergySavingMeasurement节能度量对象配置管理已完成
EnergySavingScene智能节能场景对象配置管理已完成
PowerSubsystem电源子系统对象配置管理已完成
PSUStrategy配置电源节能策略的对象已完成
ChassisFruCtrl机箱FRU电源控制已完成
FruCtrlFRU电源控制已完成
RecordFaultFRU故障记录配置已完成
PGSignal真实后电电源信号已完成
PowerButton电源按钮配置已完成
ACCycleAC循环(交流电源循环)配置已完成
NmiNMI(Non-Maskable Interrupt)不可屏蔽中断配置已完成
ButtonEvt电源按钮事件配置已完成
SysReset系统复位检测配置已完成
DftPowerButton制造测试电源按钮配置已完成
SystemLockDown系统锁定配置已完成
Multihost多主机配置已完成
FruCtrlCapabilitiesFRU控制能力配置已完成
BmcStartFlagBMC启动标记配置已完成
POHPOH(Power-On Hours)通电时长记录已完成

温度监控

文档名称描述状态
Temperature历史温度采集曲线和温度点类型管理已完成
TemperatureInfo温度海洋接口温度点配置已完成
TemperatureManagement温度海洋管理信息配置已完成
Lm75数字温度检测和I2C通信已完成

存储管理

文档名称描述状态
Drive硬盘驱动器配置和管理已完成
HddBackplane硬盘背板配置已完成
M2TransferCardM.2转接卡配置已完成

系统管理

文档名称描述状态
BiosBIOS版本管理、配置清除和安全启动已完成
CpldCPLD健康状态、上电状态和自检结果已完成
MCUFirmwareMCU固件管理已完成
FirmwareComponentInfo固件组件信息管理已完成
FirmwareCustomConfig定制化固件包相关配置已完成
FirmwarePriority固件生效优先级配置已完成
FirmwareLimit升级组件防回退限制配置已完成
SecureBootOptions证书过期告警和安全启动配置已完成
Time系统时间配置已完成
TimeSynchronization时间同步策略配置已完成
SRUpgrade系统升级配置已完成
DataSync数据同步核心配置已完成
PropertySync属性同步配置已完成
SyncDestination同步目标节点配置已完成
FileSync文件同步配置已完成
UpdateMgmtBMC升级管理配置已完成
ActiveComponentInfo生效组件信息配置已完成
UpgradeErrorCode升级错误码配置已完成
MutuallyExclusiveFirmwares固件互斥关系配置已完成
ParallelUpgradePolicy并行升级策略配置已完成

板卡管理

文档名称描述状态
ExpBoard扩展板基本信息、版本管理和状态监控已完成
Chassis机框信息、开箱事件监控和UID按钮事件处理已完成
ChassisBMC机框BMC配置已完成
BoardSlotConfig板卡槽位配置已完成

接口与通信

文档名称描述状态
I2cMuxI2C总线通道选择和管理已完成
Pca955516位I/O端口扩展和GPIO控制已完成
NCSICapabilitiesPCIe标卡NCSI功能支持能力管理已完成
UsbLocalOMServiceUSB近端运维已完成
ActiveStandbyLocal本地BMC节点主备配置已完成
ActiveStandbyRemote远程BMC节点主备配置已完成
SwitchRule主备切换规则配置管理已完成
ActiveStandbyService主备服务核心配置已完成
Ipv4IPv4网络配置管理已完成
Ipv6IPv6网络配置管理已完成
EthernetInterfaces以太网接口综合配置管理已完成
LldpConfigLLDP(链路层发现协议)配置管理已完成
EthMac网口MAC地址管理配置已完成
HeartBeat心跳检测配置管理已完成
EthGroup网口组配置管理已完成
InnerNetwork内部网口配置已完成
NodeLocation节点位置配置管理已完成
DedicatedPort专用网口配置管理已完成
ServiceConfig网络服务配置管理已完成
DhcpOptionConfigDHCP选项配置管理已完成
NetSwitchConfig网络切换配置管理已完成
NetworkPlaneValidity网络平面有效性配置管理已完成
BfdConfigBFD(双向转发检测)配置管理已完成
PhyRegisterWritePHY芯片寄存器写入配置已完成
PhyChipMgmtPHY芯片管理配置已完成
PhyRegisterWritePHY芯片寄存器写入配置已完成
EthRename网口重命名配置已完成
SwitchSlotConfig交换机槽位配置已完成
UartBMC串口端口配置管理已完成
UartData面板串口数据配置管理已完成
SerialManagement串口连接管理配置已完成
UartCircularLog串口环形日志配置管理已完成
NandFlashNandFlash存储管理配置已完成
NandInfoNandFlash基本信息配置管理已完成
BMCFileSystemCheckBMC文件系统健康检查配置管理已完成
UartBMC串口端口配置管理已完成
SOCSOC芯片管理配置已完成
SerialSwitchAction串口切换动作配置已完成
McuLogMCU日志管理配置已完成
UartDynamicConfig动态系统串口参数配置已完成

指示灯与显示

文档名称描述状态
Led健康灯和UID灯控制,支持IPMI接口已完成
I2cLedI2C LED控制已完成

测试与验证

文档名称描述状态
DftJTAGJTAG通路配置和bypass检查已完成
Dft3V3Vlot3.3V电压测试项,ADC电压值检测和验证已完成
DftPysicalLed物理LED测试项,LED灯功能验证和状态检测已完成
DftVersion版本测试项配置已完成
DftCD光驱测试项配置已完成
DftKeyBoard键盘测试项配置已完成
DftNewVideo视频测试项配置已完成
DftUsbUsb测试项配置已完成
CpldSpaceTestCpld全资源检测配置已完成
DftEepromWpEEPROM写保护自测试配置已完成
DftEepromEEPROM自测试配置已完成
DftEth网口自检测试配置已完成
DftSwitch交换机自检测试配置已完成
DftBmcCardBMC板卡自检测试配置已完成
DftDdr3DDR3内存自检测试配置已完成
DftNandFlashNandFlash自检测试配置已完成
DftSerialLoopback串口回环自检测试配置已完成
DFT制造测试模式的配置类已完成
DftLpcLPC总线自检测试配置已完成
DftIpmbIPMB总线自检测试配置已完成

产品与配置

文档名称描述状态
Product产品信息配置已完成
UnitConfigurationUBC线缆检测和PCIe业务拓扑建立已完成
BusinessTopoNodeUBC高速线缆检测和拓扑管理已完成
Contact联系人信息配置已完成
Dimension尺寸信息配置已完成
BMCBMC软件信息配置已完成

Redfish遥测服务

文档名称描述状态
MetricDefinition监控指标定义配置已完成
MetricReportDefinition监控指标报告定义配置已完成
Triggers触发器定义配置已完成

BMA和SP

文档名称描述状态
UmsUSB大容量存储设备管理配置已完成
SPSP部署管理配置已完成
BMA板载BMA管理配置已完成

IPMI和SOL

文档名称描述状态
ChannelConfig通道管理配置已完成
SOLSOL管理配置已完成
RMCPCipherSuitesRMCP加密套件配置已完成
UserPayload用户有效载荷配置已完成
IpmiCoreIPMI核心服务配置管理已完成
TraceIpmiIPMI追踪配置管理已完成
IPMIChannelIPMI通道配置管理已完成
IPMBIPMB智能平台管理总线配置管理已完成
Watchdog2看门狗配置管理已完成
BlackListDbIPMI命令黑名单数据库配置已完成
WhiteListDbIPMI命令白名单数据库配置已完成
FirewallIPMI防火墙配置管理已完成
RestrictedIPMICmdListIPMI受限命令列表配置已完成
IpmbEthIPMB Over Ethernet配置管理已完成
BTCChannelModeBT通道模式配置已完成
IPMBToHostMapIPMB到Host映射配置管理已完成
Sms主机代理SMS配置已完成
ComputerSystem计算机系统配置已完成

其他组件

文档名称描述状态
DeviceChipVGA接口切换控制和设备芯片管理已完成
FruData电子标签数据管理和多种存储类型支持已完成
PmuIMU版本显示、健康监控和光模块温度管理已完成
EnergyMetric能耗指标监控已完成
MPCConfigMPC速度控制配置(已废弃)已完成
MPCModelMPC速度控制模型(已废弃)已完成
MPCPowerFeatureMPC电源特性数据已完成
KrunFirmwareKrun固件管理已完成
CPUDieCPU Die告警已完成
VRDTypeMapPSU告警已完成
EventReportConfig事件上报配置已完成
LogServices日志服务配置已完成

📊 统计信息

文档状态统计

  • 总文档数量: 221个
  • 已完成文档: 221个 (100%)
  • 待完成文档: 0个 (0%)

按分类统计

  • 基础配置与模板: 3个
  • 硬件访问组件: 4个
  • 硬件管理组件: 5个
  • 监控告警组件: 13个
  • 系统功能组件: 196个
    • CPU与内存管理: 5个
    • PCIe与总线管理: 7个
    • 散热管理: 19个
    • 电源管理: 31个
    • 温度监控: 3个
    • 存储管理: 3个
    • 系统管理: 20个
    • 板卡管理: 4个
    • 接口与通信: 40个
    • 指示灯与显示: 2个
    • 测试与验证: 20个
    • 产品与配置: 6个
    • Redfish遥测服务: 3个
    • BMA和SP: 3个
    • IPMI和SOL: 18个
    • 其他组件: 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个组件
  • 系统管理: BIOSCPLD、固件等7个组件

📖 使用指南

🚀 快速入门

  1. 首先阅读 CSR配置指导模板 了解文档结构
  2. 查看 CSR语法汇总 了解基本语法
  3. 阅读 CSR公共配置 了解版本管理
  4. 根据具体需求选择相应的组件配置文档

🔍 查找配置

  • 按组件类型: 直接查找对应的组件文档
  • 按功能需求: 参考上述功能分类选择相关文档
  • 按开发阶段: 从基础配置到高级功能逐步学习

📝 配置开发流程

  1. 需求分析: 明确硬件配置需求
  2. 语法学习: 掌握CSR语法规则
  3. 组件选择: 选择合适的组件类型
  4. 配置编写: 按照文档指导编写配置
  5. 测试验证: 验证配置的正确性和功能

🔧 配置模板

基本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

📚 相关文档