commit | cebb28c2a0247ccefe6e14f290029358f3d66672 | [log] [tgz] |
---|---|---|
author | Chau Ly <chaul@amperecomputing.com> | Fri Oct 21 10:01:52 2022 +0000 |
committer | Zhikui Ren <zhikui.ren@intel.com> | Fri Jun 02 21:55:08 2023 +0000 |
tree | 7b9ae354d349eb86b51ceac07f109bbc27ce770e | |
parent | 88a32137fb8173970e2bda25c41561b837f89f7d [diff] |
intrusionsensor: Refactor source code This commit splits the intrusionsensor source code into a base class and derived classes to dictate sensor of different methods. Only one method of chassis intrusion detection is expected for one given system. Tested with hwmon method on Ampere Mt.Mitchell platform which is implemented in the patch: https://gerrit.openbmc.org/c/openbmc/dbus-sensors/+/62775 Signed-off-by: Chau Ly <chaul@amperecomputing.com> Change-Id: Ia2b71d897a27ee7c7955e233d060ad14d62be3a8
dbus-sensors is a collection of sensor applications that provide the xyz.openbmc_project.Sensor collection of interfaces. They read sensor values from hwmon, d-bus, or direct driver access to provide readings. Some advance non-sensor features such as fan presence, pwm control, and automatic cpu detection (x86) are also supported.
runtime re-configurable from d-bus (entity-manager or the like)
isolated: each sensor type is isolated into its own daemon, so a bug in one sensor is unlikely to affect another, and single sensor modifications are possible
async single-threaded: uses sdbusplus/asio bindings
multiple data inputs: hwmon, d-bus, direct driver access
A typical dbus-sensors object support the following dbus interfaces:
Path /xyz/openbmc_project/sensors/<type>/<sensor_name> Interfaces xyz.openbmc_project.Sensor.Value xyz.openbmc_project.Sensor.Threshold.Critical xyz.openbmc_project.Sensor.Threshold.Warning xyz.openbmc_project.State.Decorator.Availability xyz.openbmc_project.State.Decorator.OperationalStatus xyz.openbmc_project.Association.Definitions
Sensor interfaces collection are described here.
Consumer examples of these interfaces are Redfish, Phosphor-Pid-Control, IPMI SDR.
dbus-sensor daemons are reactors that dynamically create and update sensors configuration when system configuration gets updated.
Using asio timers and async calls, dbus-sensor daemons read sensor values and check thresholds periodically. PropertiesChanged signals will be broadcasted for other services to consume when value or threshold status change. OperationStatus is set to false if the sensor is determined to be faulty.
A simple sensor example can be found here.
Sensor devices are described using Exposes records in configuration file. Name and Type fields are required. Different sensor types have different fields. Refer to entity manager schema for complete list.