CSR配置字典之MCDLSDR类
更新时间： 2026/11/04
在AtomGit上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | MCDLSDR类配置字典 |
| 版本 | v1.1 |
| 创建日期 | 2026-05-15 |
| 最后更新 | 2026-11-03 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.1 | 2026-11-03 | 功能增强 | EntityId字段内联IPMI规范Entity ID Codes常用枚举值 | MCDLSDR类 | sensor SIG |
| v1.0 | 2026-05-15 | 新增 | 创建MCDLSDR类配置字典 | 全新文档 | sensor SIG |
🎯 类概览
MCDLSDR 类
| 属性 | 值 |
|---|---|
| 类名称 | MCDLSDR |
| 功能描述 | 管理控制器设备定位SDR（Sensor Data Record）描述，对应IPMI规范43.9节定义的MCDL记录 |
| 所属SIG组 | hardware |
| 所属组件 | sensor |
| 责任人 | 基础服务组 |
| 最后更新 | 2026-05-15 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
MCDLSDR 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
SlaveAddr | U8 | 32 | U8 | - | 管理设备的从地址，默认0x20（32） | 配置BMC从地址 | 32 | CSR | 硬件 |
Channel | U8 | 0 | 0x00-0x0F | - | 管理设备的通道，低4bit有效，默认0x00 | 配置通信通道 | 0 | CSR | 硬件 |
PowerStateInitialization | U8 | 128 | U8 | - | 管理设备的上电状态（高3bit）和全局初始化选项（低4bit），默认0x80 | 配置上电初始化 | 128 | CSR | 软件 |
Capabilities | U8 | 45 | U8 | - | 管理设备的属性，默认0x2D（45） | 配置设备能力 | 45 | CSR | 软件 |
EntityId | U8 | - | 实体标识码，常用枚举值见下文【实体标识枚举（常用值）】 | - | 管理设备关联的设备实体标识（Entity ID Codes），取值范围0x00~0xFF，常用值见下文 | 关联设备实体 | 7 | CSR | 硬件 |
EntityInstance | U8 | - | U8 | - | 管理设备关联的设备实体实例标识 | 配置实体实例 | 1 | CSR | 硬件 |
DeviceName | String | - | 最长16字符 | - | 管理设备的具体名称 | 配置设备名称 | "BMC Device" | CSR | 软件 |
📊 实体标识枚举（常用值）
实体标识码定义参照IPMI规范Entity ID Codes（Table 43-1），常用取值如下，完整取值详见IPMI规范：
| 代码 | 实体 |
|---|---|
0x00 | Unspecified（未指定） |
0x03 | Processor（处理器） |
0x04 | Disk or Disk Bay（磁盘或磁盘槽位） |
0x05 | System Management Software（系统管理软件） |
0x07 | System Board（系统板） |
0x08 | Board Set（板组） |
0x0A | Power Supply（电源） |
0x0B | Add-in Card（插卡） |
0x0C | Front Panel Board（前面板） |
0x12 | Processor Board（处理器板） |
0x1E | Cooling Unit（散热单元） |
0x20 | Memory Device（内存设备） |
0x37 | Air Inlet（进风口） |
0x41 | Air Exit（出风口） |
0xB0~0xFF | OEM 自定义 |
📝 配置示例
MCDLSDR基本配置
json
{
"MCDLSDR": {
"SlaveAddr": 32,
"Channel": 0,
"PowerStateInitialization": 128,
"Capabilities": 45,
"EntityId": 7,
"EntityInstance": 1,
"DeviceName": "BMC Main"
}
}系统板MCDLSDR配置
json
{
"MCDLSDR": {
"SlaveAddr": 32,
"Channel": 1,
"PowerStateInitialization": 136,
"Capabilities": 45,
"EntityId": 7,
"EntityInstance": 0,
"DeviceName": "System Board"
}
}🔧 使用指南
配置步骤
- 配置从地址：设置SlaveAddr匹配硬件地址
- 配置通道：通过Channel设置通信通道（低4bit有效）
- 配置初始化参数：设置PowerStateInitialization控制上电行为
- 配置设备能力：通过Capabilities设置支持的功能
- 关联实体：设置EntityId和EntityInstance关联设备实体
- 命名设备：通过DeviceName设置设备名称
注意事项
- SlaveAddr：默认0x20，BMC通常使用此地址
- Channel：范围0x00-0x0F，仅低4bit有效
- PowerStateInitialization高3bit：控制上电状态行为
- PowerStateInitialization低4bit：控制全局初始化选项
- EntityId：应参照IPMI规范的Entity ID Codes
故障排查
- SDR记录无效：检查SlaveAddr和Channel配置
- 设备关联失败：检查EntityId和EntityInstance是否匹配实际硬件
- 设备名称异常：检查DeviceName长度是否超过16字符