sensor_mgmt 主要用于承接传感器管理

组件概述 ​

组件是什么、解决什么问题 ​

sensor_mgmt 是基于 C++ 重构的高性能版传感器管理组件（服务名 sensor，D-Bus 总线名 bmc.kepler.sensor，部署服务 sensor_mgmt.service），通过 discovery 框架注册 D-Bus / IPMI 对象，负责监测 CPU、内存、硬盘、风扇、电源、卡等部件的在位、温度、电压、风扇转速等信息，并据此生成 IPMI SEL 事件与传感器健康状态，实现监管部件运行状态及健康状况的目的。

演进策略：稳定前 sensor（Lua 版）与 sensor_mgmt 均需同步新特性；稳定后 sensor 仅维护缺陷，新增功能主要由 sensor_mgmt 支持。具体使用哪个组件可通过 manifest.yml 配置。

核心功能 ​

术语解释 ​

外部系统交互边界 ​

说明：sensor_mgmt 订阅 Fru/FruCtrl/Frus 等外部接口获取部件在位与上下电状态，作为传感器读值与 SEL 事件生成的数据源；平台事件通过信号转发给 bmc_health 等管理组件。

功能简介 ​

传感器主要用于监测如 CPU、内存、硬盘、风扇、电源、卡等部件的信息，如部件在位、温度、电压、风扇转速等信息，并相应记录 IPMI SEL 以及通过传感器健康状态进行表征，以此达到监管部件的运行状态及健康状况的目的。

关键特性 ​

门限型传感器 ​

门限传感器又叫做连续性传感器，表征传感器的值是连续变化的（对比了解：数学中的连续值/曲线），如：温度、电压、功耗、转速等。通过门限传感器可描述性资源表征传感器的运行状态和健康状况。

关联类：ThresholdSensor

门限型传感器可描述资源 ​

门限传感器可描述资源均使用 ThresholdSensorDisplay 类来进行表示，该类不需要 CSR 配置，由 sensor 组件进行解析和完成资源协作接口注册。

离散型传感器 ​

离散传感器，表征传感器的值是离散的（对比了解：数学中的离散值/曲线），如：运行状态，隔离值等。通过离散型传感器可描述性资源表征传感器的运行状态和健康状况。

关联类：DiscreteSensor

离散型传感器可描述资源 ​

离散型传感器可描述资源均使用 DiscreteSensorDisplay 类来进行表示，该类不需要 CSR 配置，由 sensor 组件进行解析和完成资源协作接口注册。

实体资源 Entity ​

传感器实体资源，表征当前传感器依赖或者所属的硬件的实体描述，该实体的在位状态或者上下电状态会影响当前传感器的值以及状态，还有对应传感器事件 IPMI SEL 的生成状态。

关联类：Entity

IPMI SEL ​

连续型传感器触发事件 ​

连续传感器的事件生成条件即：读值与 6 个门限值比较后是否满足产生或恢复事件的条件：

1. 触发产生：AssertMask 置位、读值超出门限范围、且尚未产生事件 → 填充 SEL 信息落库并更新传感器健康状态；
2. 触发恢复：DeassertMask 置位、读值恢复到门限范围内（门限值经迟滞调整：上门限值 = 上门限 - 正向迟滞量，下门限值 = 下门限 + 负向迟滞量）、且已产生事件未恢复 → 记录恢复事件。

离散型传感器触发事件 ​

离散传感器的事件生成条件即关联的离散事件的方向是否发生改变，判定流程与连续型一致。

平台事件转发 ​

sensor 组件收到节点板平台事件（系统健康事件）并落库 SEL 后，若 PlatformEventForwardEnable 使能开关打开，则通过 Sensors 对象的 EventReportSignal 信号将 sel_record 结构化字段（11 字段）转发给管理组件（订阅该信号的组件）消费；关闭则仅记录 SEL 不转发。

对外接口 ​

资源协作接口 ​

ThresholdSensor 门限传感器 ​

• Path: /bmc/kepler/Systems/:SystemId/ThresholdSensors/:ID

• Interface: bmc.kepler.Systems.ThresholdSensor

属性：

Display 接口：bmc.kepler.Systems.ThresholdSensorDisplay（属性见「门限型传感器可描述资源」）

DiscreteSensor 离散传感器 ​

• Path: /bmc/kepler/Systems/:SystemId/DiscreteSensors/:ID

• Interface: bmc.kepler.Systems.DiscreteSensor

属性：

Display 接口：bmc.kepler.Systems.DiscreteSensorDisplay（属性见「离散型传感器可描述资源」）

Entity 实体 ​

• Path: /bmc/kepler/Systems/:SystemId/Entities/:ID

• Interface: bmc.kepler.Systems.Entity

属性：

DiscreteEvent 离散事件 ​

• Path: /bmc/kepler/Systems/:SystemId/DiscreteEvents/:Id

• Interface: bmc.kepler.Systems.DiscreteEvent

属性：

类属性（CSR 配置）：

Sensors 传感器集合 ​

• Path: /bmc/kepler/Chassis/:ChassisId/Sensors

• Interface: bmc.kepler.Chassis.Sensors

属性：

方法：

信号：

查询门限传感器列表 GetThresholdSensorList ​

输入：

• 无

输出：

• SensorList（Array<ThresholdSensorItem>）：门限传感器列表

ThresholdSensorItem 结构：

• SensorNumber（uint16）：传感器编号
• SensorName（string）：传感器名称
• SensorIdentifier（string）：传感器标识
• SensorUnit（string）：传感器单位，具体的描述单位，比如RPM
• SensorStatus（string）：传感器状态
• SensorReading（string）：传感器读数，经过单位转换之后
• LowerThresholdFatal（string）：传感器紧急事件下限
• LowerThresholdCritical（string）：传感器严重事件下限
• LowerThresholdNonCritical（string）：传感器一般事件下限
• UpperThresholdNonCritical（string）：传感器一般事件上限
• UpperThresholdCritical（string）：传感器严重事件上限
• UpperThresholdFatal（string）：传感器紧急事件上限
• SensorType（uint8）：传感器类型
• Status（string）：传感器状态
• Health（string）：传感器健康状态
• SystemId（uint8）：传感器归属host的编号
• EntityName（string）：传感器关联实体名称（Entity.Name 原值）

模拟传感器 MockSensor ​

用于调试：将指定传感器的读值模拟为固定值，便于验证门限事件、SEL 生成与健康状态联动。

输入：

• Enabled（uint8）：是否使能模拟，取值范围：0-1
• SensorName（string）：模拟传感器的名称
• Value（string）：模拟传感器读值，stop 表示停止模拟

输出：

• 无

异常与触发条件：

首发版本： sensor_mgmt 0.0.113（bmcsdk 25.x）

应用场景与限制条件：

• 典型场景：测试环境模拟某传感器读值，验证门限事件、SEL、健康状态；Value=stop 停止模拟恢复真实读值。
• 限制条件：仅支持已注册的传感器（阈值/离散）；模拟值需为数字字符串；模拟期间传感器读值不随数据源更新。

调试示例：

# 1) 查询门限传感器列表确认名称
busctl --user call bmc.kepler.sensor /bmc/kepler/Chassis/1/Sensors \
    bmc.kepler.Chassis.Sensors GetThresholdSensorList

# 2) 将名为 "CPU0 Temp" 的传感器模拟为 85.000
busctl --user call bmc.kepler.sensor /bmc/kepler/Chassis/1/Sensors \
    bmc.kepler.Chassis.Sensors MockSensor yss 1 'CPU0 Temp' '85.000'

# 3) 停止模拟
busctl --user call bmc.kepler.sensor /bmc/kepler/Chassis/1/Sensors \
    bmc.kepler.Chassis.Sensors MockSensor yss 1 'CPU0 Temp' stop

查询所有传感器列表 GetSensorList ​

输入：

• 无

输出：

• SensorList（Array<AllSensorItem>）：查询到的传感器列表

AllSensorItem 结构：

• SensorNumber（uint16）：传感器编号
• SensorName（string）：传感器名称
• SensorUnit（string）：传感器单位，具体的描述单位，比如RPM
• SensorStatus（string）：传感器状态
• SensorReading（string）：传感器读数，经过单位转换之后
• LowerFatal（string）：传感器紧急事件下限
• LowerCritical（string）：传感器严重事件下限
• LowerNonCritical（string）：传感器一般事件下限
• UpperNonCritical（string）：传感器一般事件上限
• UpperCritical（string）：传感器严重事件上限
• UpperFatal（string）：传感器紧急事件上限
• PosHysteresis（string）：传感器正向迟滞量
• NegHysteresis（string）：传感器负向迟滞量
• SensorType（uint8）：传感器类型
• BaseUnit（uint8）：单位（数字描述）
• ReadingType（uint8）：读值类型
• SystemId（uint8）：传感器归属host的编号
• EntityName（string）：传感器关联实体名称（Entity.Name 原值）

设置传感器使能状态 SetSensorStatus ​

输入：

• SensorName（string）：传感器的名称
• Status（string）：使能状态(enabled,disabled)

输出：

• 无

异常与触发条件：

首发版本： sensor_mgmt 0.0.113（bmcsdk 25.x）

应用场景与限制条件：

• 典型场景：禁用故障传感器避免误报 SEL，或重新启用。
• 限制条件：仅离散传感器支持使能/禁用，门限传感器调用会抛 SensorNotSupported。

调试示例：

# 禁用离散传感器
busctl --user call bmc.kepler.sensor /bmc/kepler/Chassis/1/Sensors \
    bmc.kepler.Chassis.Sensors SetSensorStatus ss 'SensorName' disabled
# 相应: （无输出）

# 重新启用
busctl --user call bmc.kepler.sensor /bmc/kepler/Chassis/1/Sensors \
    bmc.kepler.Chassis.Sensors SetSensorStatus ss 'SensorName' enabled

获取传感器事件列表 GetSel ​

输入：

• StartId（uint16）：事件索引，取值范围：0-65535。StartId 大于等于 1，超过总条数会返回空表
• Count（uint16）：事件条数，取值范围：0-65535。Count 大于等于 0，超过总条数会返回所有事件

输出：

• Total（uint16）：事件总条数
• SelList（Array<SelInfo>）：事件列表

SelInfo 结构：

• MappingTable（Array<KeyValueTable>）：Sel信息键值表，键的值包括：序号，时间戳，传感器名称，传感器类型，传感器事件级别，传感器事件状态，传感器事件描述

KeyValueTable 结构：

• Key（string）
• Value（string）

异常与触发条件：

首发版本： sensor_mgmt 0.0.113（bmcsdk 25.x）

应用场景与限制条件：

• 典型场景：北向查询传感器事件列表（分页查询：StartId 起查 Count 条）。
• 限制条件：StartId 大于等于 1，超过总条数返回空表；Count 超过总条数返回所有事件；SEL 查询最大记录数由 QueryMaxCount 配置（默认 2000）。

调试示例：

# D-Bus 查询前 10 条 SEL
busctl --user call bmc.kepler.sensor /bmc/kepler/Chassis/1/Sensors \
    bmc.kepler.Chassis.Sensors GetSel qq 1 10
# 相应: q a(av) ...   （Total + SelList）

# IPMI 查询 SEL 信息（GetSelInfo 0x0A/0x40）
ipmitool raw 0x0a 0x40
# 相应: 00 51 02 02 00 ...

# IPMI 查询传感器读数（GetSensorReading 0x04/0x2D，参数为传感器编号）
ipmitool raw 0x04 0x2d 0x01
# 相应: 00 55 00 ...

其余方法速查 ​

平台事件转发信号 EventReportSignal ​

Ctx（a{ss}）：请求上下文键值表（String->String），键由框架 SignalContext 注入，含 Interface、UserName、ClientAddr

EventRecord（a{sv}）：sel_record 结构化字段字典，按 sel_record 声明顺序含 11 字段（SelRecordDict）：

SensorSelInfo SEL 信息 ​

• Path: /bmc/kepler/Chassis/:ChassisId/SensorSelInfo

• Interface: bmc.kepler.Chassis.SensorSelInfo

属性：

BootError 启动错误事件 ​

• Path: /bmc/kepler/Systems/:SystemId/EventEntries/BootError

• Interface: bmc.kepler.Systems.IPMIEvent

属性：

IPMI接口 ​

• 具体参数参考本组件配置文件 ipmi.json

传感器与 PEF 接口（NetFn 0x04） ​

SDR 存储库接口（NetFn 0x0A） ​

SEL 接口（NetFn 0x0A） ​

OEM 扩展接口 ​

配置介绍 ​

传感器配置需要一定程度上参照 IPMI标准规范协议官方文档

实体资源配置 ​

传感器实体资源，表征当前的传感器依赖或者所属的硬件的实体描述，该实体的在位状态或者上下电状态会影响当前传感器的值以及状态，还有对应传感器事件 IPMI SEL 的生成状态。属性定义见「对外接口-Entity 实体」，另有多 Host 扩展属性：BelongsToSystem（bool，是否归属单一系统，默认 false 公共对象，SystemId 取 0）。

配置关键点： 实体资源在 CSR 中配置 Id/Instance/Name 等关键属性；在位/上下电信号来源与对应组件（如 Fru/FruCtrl）关联，影响传感器读值与 SEL 事件生成。

实际 CSR 配置示例：

"Entity_GPUCard": {
    "Id": 11,
    "Name": "GPUCard",
    "PowerState": 1,
    "Presence": 1,
    "Instance": 101
}

连续型传感器配置 ​

属性定义见「对外接口-ThresholdSensor 门限传感器」，此处补充 CSR 关键点：

• 传感器原始读值 Reading 需填写一个默认值，用于数据源未更新时显示，需在门限之内防止产生 SEL 事件。
• 线性计算相关配置（Linearization/M/MT/B/BA/Accuracy/RBExp/Analog）来自 IPMI 规范 36.3，用于计算传感器读值系数。
• 当 Linearization 配置 0x70-0x7f 时，需配置 OriginalReading 属性配合 Reading（固定配置 170）计算传感器读数系数以提升读值精度。
• 传感器编号 SensorNumber 默认 255 由 BMC 自行生成；特殊编号需在传感器定制化中定制（BMC 正常运行时插入的部件传感器不支持定制）。
• 多 Host 扩展属性：BelongsToSystem（bool）、IsValid（bool，多 host 下判断对象是否生效）。

实际 CSR 配置示例：

"ThresholdSensor_VA1AGPUTemp": {
    "OwnerId": 32,
    "OwnerLun": 0,
    "EntityId": "<=/Entity_GPUCard.Id",
    "EntityInstance": "<=/Entity_GPUCard.Instance",
    "Capabilities": 232,
    "SensorType": 1,
    "ReadingType": 1,
    "SensorName": "GPU${Slot} Temp",
    "NominalReading": 25,
    "MaximumReading": 127,
    "ReadingMask": 2056,
    "Reading": "<=/Scanner_GPUTemp.Value |> expr($1 // 25600)",
    "SensorNumber": 255,
    "UpperNoncritical": 85,
    "PositiveHysteresis": 2,
    "NegativeHysteresis": 2
}

离散型传感器配置 ​

属性定义见「对外接口-DiscreteSensor 离散传感器」。

配置关键点： 离散传感器需关联对应的离散事件（DiscreteEvent）来产生 IPMI SEL；健康状态与 SEL 事件状态体现在 DiscreteSensorDisplay 接口的 Health 与 AssertStatus 属性上。

实际 CSR 配置示例：

"DiscreteSensor_SelStatus": {
    "OwnerId": 32,
    "OwnerLun": 0,
    "EntityId": "<=/Entity_MainBoard.Id",
    "EntityInstance": "<=/Entity_MainBoard.Instance",
    "Capabilities": 64,
    "SensorType": 16,
    "ReadingType": 111,
    "SensorName": "SEL Status",
    "AssertMask": 52,
    "DeassertMask": 32,
    "DiscreteMask": 36,
    "Reading": 0
}

离散事件配置 ​

离散事件配置用于表征离散传感器的事件产生与恢复逻辑。属性定义见「对外接口-DiscreteEvent 离散事件」，其类属性（CSR 配置）为 ListenType/EventData1-3/Conversion/InvalidReadingIgnore/InvalidReading/Severity。

实际 CSR 配置示例：

"DiscreteEvent_OperateLogFull": {
    "Property": "<=/LogServices_1.OperationLogAlmostFull",
    "ListenType": 1,
    "EventData1": 8,
    "EventData2": 255,
    "EventData3": 255,
    "EventDir": "<=/LogServices_1.OperationLogAlmostFull",
    "Conversion": 0,
    "SensorObject": "#/DiscreteSensor_OperateLogFull",
    "InvalidReadingIgnore": 1,
    "InvalidReading": 255
}

SEL 相关配置 ​

SEL 记录模式与查询上限等通过 SensorSelInfo 对象的类属性配置：

持久化表 ​

sensor_mgmt 通过以下持久化表保存传感器与 SEL 相关配置与数据：

问题定界指南 ​

典型问题定界 ​

错误码速查表 ​

资源协作接口错误（sensor_error_map） ​

IPMI 完成码（与 custom.json 的 IpmiCompletionCode 对齐） ​

IPMI 命令的完成码由 mdb_interface 的 custom.json 定义，sensor_mgmt 通过错误引擎（ipmi_error_map 映射到错误名）在运行时解析得到。下表为各错误码对应的完成码。

调试方法 ​

开启调试日志 ​

sensor_mgmt 使用 libmcpp 日志框架，配置文件 config.json（logging 默认 level=notice），日志写到 sensor_file appender。

# 查看服务运行日志
journalctl -u sensor_mgmt.service -f

# 查看传感器注册 dump（注册信息在启动后约 5s 落盘）
cat /var/log/sensor.log

# 复现：MockSensor 模拟读值验证事件联动，或调用 GetSel/GetThresholdSensorList 查询

IPMI 复现方法 ​

# 查 SEL 信息
ipmitool raw 0x0a 0x40

# 查传感器读数
ipmitool raw 0x04 0x2d <sensor_number>

# 查传感器类型
ipmitool raw 0x04 0x2f <sensor_number>

# 清 SEL（需预留 ID，先 0x0a 0x42 获取）
ipmitool sel clear

日志说明 ​

一键日志收集 ​

一键日志收集（AppDump/日志导出）涉及 sensor_mgmt 的日志文件如下：

关键日志信息 ​

FAQ ​

Q1：传感器读值为空或异常？ ​

一句话答案： 检查数据源订阅、CSR 配置与注册记录。

根因： 传感器读值引用数据源（如 Fru/FruCtrl/Scanner）同步；数据源未就绪或 CSR 配置缺失会导致读值异常。

解决方案： ① 查 /var/log/sensor.log 注册记录确认传感器是否注册；② 校验 CSR 配置属性名；③ ipmitool raw 0x04 0x2d <num> 验证读值。

适用版本： 全版本。

Q2：MockSensor 报 InvalidSensorName？ ​

一句话答案： 指定名称的传感器未注册，检查传感器名称。

根因： MockSensor 需精确匹配已注册的阈值/离散传感器 SensorName。

解决方案： 先用 GetThresholdSensorList/GetDiscreteSensorList 查询正确名称。

适用版本： sensor_mgmt 0.0.113 及以上。

Q3：SEL 事件未产生？ ​

一句话答案： 检查门限/事件配置、事件掩码与迟滞量。

根因： 连续传感器需读值超出（含迟滞调整后的）门限且 AssertMask 置位才产生事件；离散传感器需离散事件方向变化。

解决方案： 用 MockSensor 模拟边界值复现；检查 AssertMask/DeassertMask、门限值与迟滞配置。

适用版本： 全版本。

Q4：平台事件没有转发到 bmc_health？ ​

一句话答案： 检查 PlatformEventForwardEnable 开关与 bmc_health 订阅。

根因： 开关关闭时仅记录 SEL 不转发；或 bmc_health 侧 EventReportSignal 订阅异常。

解决方案： ① 置 PlatformEventForwardEnable=true；② 检查 bmc_health 订阅日志与信号签名（a{sv}a{sv}）。

适用版本： 全版本。

Q5：服务启动失败或数据库异常？ ​

一句话答案： 检查数据库文件与依赖服务（framework/dbus）。

根因： 数据库损坏或不兼容、journal_mode 设置失败、依赖服务未就绪导致启动失败。

解决方案： ① journalctl -u sensor_mgmt.service 定位；② 数据库不兼容时组件会自动删除重建；③ 确认 framework/dbus 服务已就绪。

适用版本： 全版本。