How openbmc/phosphor-fan-presence works
This repository packages independent BMC thermal applications, not one shared runtime. The principal control workflow loads JSON configuration, evaluates D-Bus-backed groups and triggers, runs actions on fan zones, and drives fan targets. Separate applications detect fan presence, monitor fan function (including trust and power-off policies), monitor sensor alarms, and set inventory cooling type. Relationships not shown in sampled source are included only where the README documents them; other implementation details remain summarized at subsystem level.
Main entry points: fan.cpp Fan function monitor · manager.cpp Control manager · group.hpp D-Bus groups · event.hpp Triggers and events
Components 20
Fan control
- JSON config loader
json_config.hpp - Control manager
control/json/manager.cpp - D-Bus groups
control/json/group.hpp - Triggers and events
control/json/event.hpp - Control actions
control/json/actions/action.hpp - Fan zones
control/json/zone.hpp - Fan targets
control/json/fan.hpp
Presence detection
- Presence detection
presence/json_parser.cpp - GPIO and tach inputs
presence - Presence property updates
presence/fan.hpp
Fan monitoring
- Monitor configuration
monitor/json_parser.cpp - Fan function monitor
monitor/fan.cpp - Tach sensors
monitor/tach_sensor.hpp - Sensor trust groups
monitor/trust_group.hpp - Monitor actions
monitor/power_off_action.hpp
Sensor monitoring
- Threshold alarm logger
sensor-monitor/threshold_alarm_logger.cpp - Shutdown alarm monitor
sensor-monitor/shutdown_alarm_monitor.cpp
Cooling type
- Cooling type setter
cooling-type/cooling_type.cpp
Other components
- Machine configuration
- OpenBMC D-Bus
Connections 22
- Machine configuration → JSON config loader: provides config
- JSON config loader → Control manager: loads config
control/json/manager.cpp - OpenBMC D-Bus → D-Bus groups: supplies object state
- Control manager → D-Bus groups: uses groups
control/json/manager.cpp - Control manager → Triggers and events: configures events
control/json/manager.cpp - D-Bus groups → Triggers and events: selects events
control/json/group.hpp - Triggers and events → Control actions: runs actions
control/json/manager.cpp - Control actions → Fan zones: acts on zones
control/json/actions/action.hpp - Fan zones → Fan targets: controls fans
control/json/zone.hpp - OpenBMC D-Bus → Presence detection: updates inventory
- GPIO and tach inputs → Presence detection: detects presence
presence/json_parser.cpp - Presence detection → Presence property updates: sets Present
- Machine configuration → Monitor configuration: provides config
- Monitor configuration → Fan function monitor: configures monitoring
monitor/json_parser.cpp - Fan function monitor → Tach sensors: checks feedback
- Fan function monitor → Sensor trust groups: applies trust
- Fan function monitor → Monitor actions: takes configured actions
- OpenBMC D-Bus → Fan function monitor: reads targets and state
- OpenBMC D-Bus → Threshold alarm logger: provides sensor values
- Threshold alarm logger → Shutdown alarm monitor: can trigger shutdown
- OpenBMC D-Bus → Cooling type setter: reads GPIO state
- Cooling type setter → OpenBMC D-Bus: sets inventory properties