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

功能简介 ​

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

关键特性 ​

门限型传感器 ​

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

关联类：ThresholdSensor

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

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

离散型传感器 ​

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

关联类：DiscreteSensor

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

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

IPMI SEL ​

连续型传感器触发事件 ​

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

检查是否满足事件生成条件流程如下：

离散型传感器触发事件 ​

离散传感器的事件生成条件即关联的离散事件的方向是否发生改变，然后查看是否满足产生与恢复条件。

检查是否满足事件生成条件流程如下：

对外接口 ​

资源协作接口 ​

• 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的编号

模拟传感器 MockSensor ​

输入：

• Enabled（uint8）：是否使能模拟，取值范围：0-1
• SensorName（string）：模拟传感器的名称
• Value（string）：模拟传感器读值，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的编号

设置传感器使能状态 SetSensorStatus ​

输入：

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

输出：

• 无

导出传感器事件列表 ExportSel ​

输入：

• Path（string）：导出SEL的路径

输出：

• TaskId（uint32）：Task标识，用于拼接任务路径

获取传感器事件列表 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）

查询离散传感器列表 GetDiscreteSensorList ​

输入：

• 无

输出：

• SensorList（Array<DiscreteSensorItem>）：离散传感器列表

DiscreteSensorItem 结构：

• SensorNumber（uint16）：传感器编号
• SensorName（string）：传感器名称
• SensorIdentifier（string）：传感器标识
• SensorStatus（string）：传感器状态
• SystemId（uint8）：传感器归属host的编号

获取上报事件 GetReportedSel ​

输入：

• StartId（uint64）：事件起始序列号，取值范围：0-18446744073709551615
• Count（uint16）：事件条数，取值范围：0-65535

输出：

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

SelInfo 结构同 GetSel 中的 SelInfo。

将SDR数据dump为二进制文件 DumpSDR ​

输入：

• DumpMode（string）：SDR数据缓存模式，限定为 LAN/BT 两种模式，取值范围：LAN/BT

输出：

• 无

添加OEM SEL AddOemSel ​

输入：

• RecordType（uint8）：表征当前要添加的OEM SEL的类型，取值范围：0-255
• Timestamp（uint32）：表征当前SEL发生的时间，取值范围：0-4294967295
• ManufactureID（uint32）：表征当前SEL记录的厂商，取值范围：0-4294967295
• SELDatas（string）：表征当前SEL记录的数据

输出：

• RecordId（uint32）：当前OEM SEL数据记录id

清空所有SEL事件 ClearSel ​

输入：

• 无

输出：

• 无

清空传感器事件 ClearSensorSel ​

输入：

• 无

输出：

• 无

设置门限传感器门限值 SetThresholds ​

输入：

• SensorName（string）：需要修改的传感器名称（若存在重名，以第一个为准）
• PersistenceType（uint8）：持久化类型，取值范围：0/1，其中 0 表示不持久化，1 表示掉电持久化
• Attributes（Dictionary<ThresholdAttributeItem>）：需要修改的门限属性与取值，支持同时设置多个。属性值为双精度数字字符串，精度为3位小数（如1.000）

输出：

• 无

ThresholdAttributeItem 结构：

• key（string）：可选值：UpperNonrecoverable/UpperCritical/UpperNoncritical/LowerNonrecoverable/LowerNoncritical/LowerCritical
• value（string）：门限属性值，双精度数字字符串，精度为3位小数（如1.000）

IPMI接口 ​

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

配置介绍 ​

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

实体资源配置 ​

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

配置属性 ​

配置关键点 ​

1. Entity Id严格按照IPMI 规范中的表格进行配置
2. Entity Instance保证同一Entity Id下唯一

连续型传感器配置 ​

连续型传感器，表征传感器的值是连续变化的，如：温度，电压，功耗，转速等。

配置属性 ​

以下属性配置原则皆参照 Section 43.1 SDR Type 01h, Full Sensor Record(P521)

配置关键点 ​

1. 传感器类型SensorType严格按照IPMI 规范中的表格配置
2. 三个Mask属性要与配置的门限匹配，若配置了某个门限，Mask相应bit需要置位
3. 注意当前Reading（也即原始值），数据源的范围不可超过255，若不满足则需要通过表达式进行一定程度的缩放，并通过传感器的表达公式进行还原

离散型传感器配置 ​

离散型传感器，表征传感器的值是离散的，如：上下电状态、在位状态、运行状态等。

配置属性 ​

以下属性配置原则皆参照 Section 43.2 SDR Type 02h, Compact Sensor Record(P521)

配置关键点 ​

1. 传感器类型SensorType严格按照IPMI 规范中的表格配置
2. 离散传感器的读值类型ReadingType分为两种：02h~0Ch、6Fh，需要根据离散事件的配置场景相应配置该属性
3. 离散传感器的配置与挂载的离散事件相关，注意三个Mask的配置需要与离散事件配置匹配

离散事件配置 ​

离散事件，是针对离散传感器需要承载和触发的事件源，每个离散传感器最多可以监听15个离散事件。

配置属性 ​

配置关键点 ​

1. 监听方式无固定要求，可以根据场景任意选择。若选择组合监听，需要保证Property属性按要求进行配置，保证各个字节的数据皆按照含义正确配置；若选择独立监听，需要保证三个EventData数据及EventDir属性按照含义正确配置。
2. 离散事件实则是遵循IPMI 规范定义的，因此需要严格参照IPMI 规范中的描述和定义进行配置