文档信息

项目	内容
文档标题	Chassis类配置字典
版本	v1.1
创建日期	2025-01-27
最后更新	2026-05-27
维护状态	活跃维护

变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2025-01-27	初始版本	创建Chassis类配置字典	全新文档	系统管理员
v1.1	2026-05-27	属性补充	补充Location、TopologyConfigId、ChassisIdentifier、CapabilitiesFlags、FRUDeviceAddress、SDRDeviceAddress、SMDeviceAddress、BridgeDeviceAddress、LastIntrusionACOn、UidButtonTestFlag、UidButtonTestResult、UidButtonTestStatus、GPUMaxCount属性	属性定义	系统管理员

类概览

Chassis 类

属性	值
类名称	`Chassis`
功能描述	机框管理对象，提供机框基本信息、开箱事件监控和UID按钮事件处理功能
所属SIG组	hardware
所属组件	chassis
责任人	机框管理组
最后更新	2026-05-27
状态	正常运行

属性定义详表

必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Name`	String	-	String	-	机框名	BMC接口展示	`"1"`	CSR配置	软件
`IntrusionACOn`	Mixed	0	U8	Scanner_ChassisIntrusionACOn	AC上电开箱事件关联SMC	开箱事件上报	`"<=/Scanner_ChassisIntrusionACOn.Value"`	硬件提供	硬件
`IntrusionACOff`	Mixed	0	U8	Scanner_ChassisIntrusionACOff	AC下电开箱事件关联SMC	开箱事件上报	`"<=/Scanner_ChassisIntrusionACOff.Value"`	硬件提供	硬件
`CoverStatus`	Mixed	0	U8	Scanner_ChassisCoverStatus	机盖状态关联SMC	开箱事件上报	`"<=/Scanner_ChassisCoverStatus.Value"`	硬件提供	硬件
`IntrusionACOnClear`	Mixed	0	U8	Accessor_ChassisIntrusionACOnClear	AC上电开箱事件写清关联SMC	开箱事件上报	`"#/Accessor_ChassisIntrusionACOnClear.Value"`	硬件提供	硬件
`IntrusionACOffClear`	Mixed	0	U8	Accessor_ChassisIntrusionACOffClear	AC下电开箱事件写清关联SMC	开箱事件上报	`"#/Accessor_ChassisIntrusionACOffClear.Value"`	硬件提供	硬件
`UidButtonAccessor`	Mixed	0	U8	Accessor_UIDButtonEvent	UID短按信号写清关联SMC	UID状态翻转，短按UID按钮事件	`"#/Accessor_UIDButtonEvent.Value"`	硬件提供	硬件
`UidButtonScanner`	Mixed	0	U8	Scanner_UIDButtonEvent	UID短按信号关联SMC	UID状态翻转，短按UID按钮事件	`"<=/Scanner_UIDButtonEvent.Value"`	硬件提供	硬件
`UidButtonLongAccessor`	Mixed	0	U8	Accessor_UIDButtonLongEvent	UID长按信号写清关联SMC	UID长按事件	`"#/Accessor_UIDButtonLongEvent.Value"`	硬件提供	硬件
`UidButtonLongScanner`	Mixed	0	U8	Scanner_UIDButtonLongEvent	UID长按信号关联SMC	UID长按事件	`"<=/Scanner_UIDButtonLongEvent.Value"`	硬件提供	硬件

可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`ChassisType`	U8	0	U8	-	当前管理软件类型	BMC接口展示	`2`	CSR配置	软件
`IntrusionFlag`	U8	0	U8	-	开箱事件标志开箱：0x01 关闭：0x0	开箱事件上报	`0`	BMC内部设置	软件
`UidButtonPressed`	U8	0	U8	-	UID按钮按下标志	短按UID按钮事件	`0`	BMC内部设置	软件
`UidButtonLongPressed`	U8	0	U8	-	UID按钮长按标志	UID长按事件	`0`	BMC内部设置	软件
`Location`	String	-	String	-	位置信息	BMC接口展示	`"Rack1"`	CSR配置	软件
`TopologyConfigId`	U16	65535	U16	-	产品组网拓扑	BMC接口展示	`65535`	CSR配置	软件
`ChassisIdentifier`	String	-	String	-	物理位置标识符	BMC接口展示	`"Chassis001"`	CSR配置	软件
`CapabilitiesFlags`	U8	-	U8	-	机框能力标志	BMC接口展示	`0`	CSR配置	软件
`FRUDeviceAddress`	U8	32	U8	-	FRU设备地址	BMC接口展示	`32`	CSR配置	软件
`SDRDeviceAddress`	U8	32	U8	-	SDR设备地址	BMC接口展示	`32`	CSR配置	软件
`SELDeviceAddress`	U8	32	U8	-	SEL设备地址	BMC接口展示	`32`	CSR配置	软件
`SMDeviceAddress`	U8	32	U8	-	SM设备地址	BMC接口展示	`32`	CSR配置	软件
`BridgeDeviceAddress`	U8	32	U8	-	桥接设备地址	BMC接口展示	`32`	CSR配置	软件
`LastIntrusionACOn`	U8	0	U8	-	最后一次AC上电开箱事件记录	开箱事件记录	`0`	BMC内部设置	软件
`UidButtonTestFlag`	Boolean	true	Boolean	-	UID按钮测试标志	UID按钮测试	`true`	CSR配置	软件
`UidButtonTestResult`	U8	255	U8	-	UID按钮测试结果	UID按钮测试	`255`	BMC内部设置	软件
`UidButtonTestStatus`	U8	129	U8	-	UID按钮测试状态	UID按钮测试	`129`	BMC内部设置	软件
`GPUMaxCount`	U8	0	U8	-	GPU最大数量	BMC接口展示	`0`	CSR配置	软件

动态关联机制

语法规范

使用多种动态关联语法：

yaml

# Scanner关联（读取硬件状态）
IntrusionACOn: "<=/Scanner_ChassisIntrusionACOn.Value"
IntrusionACOff: "<=/Scanner_ChassisIntrusionACOff.Value"
CoverStatus: "<=/Scanner_ChassisCoverStatus.Value"
UidButtonScanner: "<=/Scanner_UIDButtonEvent.Value"
UidButtonLongScanner: "<=/Scanner_UIDButtonLongEvent.Value"

# Accessor关联（写入控制命令）
IntrusionACOnClear: "#/Accessor_ChassisIntrusionACOnClear.Value"
IntrusionACOffClear: "#/Accessor_ChassisIntrusionACOffClear.Value"
UidButtonAccessor: "#/Accessor_UIDButtonEvent.Value"
UidButtonLongAccessor: "#/Accessor_UIDButtonLongEvent.Value"

关联说明

Scanner关联: 用于读取硬件状态，监控开箱事件和按钮状态
Accessor关联: 用于写入控制命令，清除事件标志和处理按钮事件
事件配对: 每个事件都有对应的Scanner（读取）和Accessor（清除）配对

分类标准

硬件属性

定义：与机框硬件事件和按钮直接相关的参数
特点：通过SMC协议与硬件交互
示例：IntrusionACOn, IntrusionACOff, CoverStatus, IntrusionACOnClear, IntrusionACOffClear, UidButtonAccessor, UidButtonScanner, UidButtonLongAccessor, UidButtonLongScanner

件属性

定义：由软件管理和维护的参数
特点：配置管理和状态维护
示例：Name, ChassisType, IntrusionFlag, UidButtonPressed, UidButtonLongPressed, Location, TopologyConfigId, ChassisIdentifier, CapabilitiesFlags, FRUDeviceAddress, SDRDeviceAddress, SELDeviceAddress, SMDeviceAddress, BridgeDeviceAddress, LastIntrusionACOn, UidButtonTestFlag, UidButtonTestResult, UidButtonTestStatus, GPUMaxCount

配置示例

标准机框配置

json

{
  "Chassis_1": {
    "Name": "1",
    "ChassisType": 2,
    "Location": "Rack1",
    "TopologyConfigId": 65535,
    "ChassisIdentifier": "Chassis001",
    "CapabilitiesFlags": 0,
    "FRUDeviceAddress": 32,
    "SDRDeviceAddress": 32,
    "SELDeviceAddress": 32,
    "SMDeviceAddress": 32,
    "BridgeDeviceAddress": 32,
    "GPUMaxCount": 8,
    "UidButtonTestFlag": true,
    "IntrusionACOn": "<=/Scanner_ChassisIntrusionACOn.Value",
    "IntrusionACOff": "<=/Scanner_ChassisIntrusionACOff.Value",
    "CoverStatus": "<=/Scanner_ChassisCoverStatus.Value",
    "IntrusionACOnClear": "#/Accessor_ChassisIntrusionACOnClear.Value",
    "IntrusionACOffClear": "#/Accessor_ChassisIntrusionACOffClear.Value",
    "UidButtonAccessor": "#/Accessor_UIDButtonEvent.Value",
    "UidButtonScanner": "<=/Scanner_UIDButtonEvent.Value",
    "UidButtonLongAccessor": "#/Accessor_UIDButtonLongEvent.Value",
    "UidButtonLongScanner": "<=/Scanner_UIDButtonLongEvent.Value"
  }
}

机架管理配置

json

{
  "Chassis_2": {
    "Name": "RackChassis",
    "ChassisType": 0,
    "Location": "DataCenter1",
    "TopologyConfigId": 1,
    "ChassisIdentifier": "Rack001",
    "CapabilitiesFlags": 1,
    "FRUDeviceAddress": 32,
    "SDRDeviceAddress": 32,
    "SELDeviceAddress": 32,
    "SMDeviceAddress": 32,
    "BridgeDeviceAddress": 32,
    "GPUMaxCount": 16,
    "UidButtonTestFlag": true,
    "IntrusionACOn": "<=/Scanner_ChassisIntrusionACOn.Value",
    "IntrusionACOff": "<=/Scanner_ChassisIntrusionACOff.Value",
    "CoverStatus": "<=/Scanner_ChassisCoverStatus.Value",
    "IntrusionACOnClear": "#/Accessor_ChassisIntrusionACOnClear.Value",
    "IntrusionACOffClear": "#/Accessor_ChassisIntrusionACOffClear.Value",
    "UidButtonAccessor": "#/Accessor_UIDButtonEvent.Value",
    "UidButtonScanner": "<=/Scanner_UIDButtonEvent.Value",
    "UidButtonLongAccessor": "#/Accessor_UIDButtonLongEvent.Value",
    "UidButtonLongScanner": "<=/Scanner_UIDButtonLongEvent.Value"
  }
}

使用指南

配置步骤

基本信息配置：设置机框名称和类型
开箱事件配置：关联AC上电/下电开箱事件的Scanner和Accessor
机盖状态配置：关联机盖状态监控
UID按钮配置：关联UID按钮的短按和长按事件
位置标识配置：设置Location、ChassisIdentifier等标识信息
设备地址配置：配置各种设备地址参数
SMC通信验证：确保所有关联的SMC对象正常工作

机框类型说明

RACK (0)：机架管理，用于机架式服务器
X_SERIAL (1)：高密计算节点，用于高密度计算场景
BLADE (2)：刀片计算节点，用于刀片服务器
SWITCH (3)：交换节点，用于网络交换设备
MM (4)：机框/柜外围部件，用于外围设备管理
CMC (5)：机框/柜集中管理，用于集中管理控制
RM (6)：机柜管理，用于机柜级别管理

事件处理流程

开箱事件：
- Scanner监控AC上电/下电开箱状态
- 检测到开箱事件时触发告警
- 通过Accessor清除事件标志
- LastIntrusionACOn记录最后一次开箱事件
UID按钮事件：
- Scanner监控UID按钮状态
- 区分短按和长按事件
- 通过Accessor处理按钮事件
- UidButtonTestFlag控制测试标志

UID按钮测试功能

UidButtonTestFlag: 控制是否启用UID按钮测试
UidButtonTestResult: 存储测试结果
UidButtonTestStatus: 表示测试状态
默认值：Flag=true, Result=255, Status=129

注意事项

SMC通信：确保所有关联的SMC对象配置正确
事件配对：每个事件都需要Scanner和Accessor配对
硬件依赖：确保硬件支持相应的开箱检测和按钮功能
状态同步：BMC内部状态会自动更新，无需手动配置
地址配置：设备地址默认值为32，按实际需求配置

文档信息 ​

变更历史记录 ​

文档变更记录 ​

类概览 ​

Chassis 类 ​

属性定义详表 ​

必选属性 ​

可选属性 ​

动态关联机制 ​

语法规范 ​

关联说明 ​

分类标准 ​

硬件属性 ​

件属性 ​

配置示例 ​

标准机框配置 ​

机架管理配置 ​

使用指南 ​

配置步骤 ​

机框类型说明 ​

事件处理流程 ​

UID按钮测试功能 ​

注意事项 ​

相关文档 ​

文档信息

变更历史记录

文档变更记录

类概览

Chassis 类

属性定义详表

必选属性

可选属性

动态关联机制

语法规范

关联说明

分类标准

硬件属性

件属性

配置示例

标准机框配置

机架管理配置

使用指南

配置步骤

机框类型说明

事件处理流程

UID按钮测试功能

注意事项

相关文档