Gitiles
Code Review Sign In
gerrit.openbmc.org / openbmc / openpower-occ-control / refs/heads/master
commitffb6321e9e5acd2823e19174c28683dee8140d95[log] [tgz]
authorChris Cain <cjcain@us.ibm.com>Fri Aug 01 14:39:38 2025 -0500
committerChris Cain <cjcain@us.ibm.com>Fri Aug 01 14:46:27 2025 -0500
treed19e2f6b831137bba83dca6cc27ef3bee18d9eea
parentab397db15ed377b36936ba6a73c03fd1f7527dc4 [diff]
Add support for collecting data for BMC dumps

When occ-control receives a USR1 signal, it will trigger the code to
collect the following data:
- number of OCC objects created
- for each active OCC: state, role, hwmon path, poll response, and WOF
data

The data will be written in JSON format to a file which can be collected
and added to a dump. (/tmp/occ_control_dump.json)

To force the data collection:
  killall -s SIGUSR1 openpower-occ-control

Change-Id: I7a304f7ce0eb1c9109f630f187adf9c95722652e
Signed-off-by: Chris Cain <cjcain@us.ibm.com>
5 files changed
tree: d19e2f6b831137bba83dca6cc27ef3bee18d9eea
  1. example/
  2. service_files/
  3. subprojects/
  4. test/
  5. .clang-format
  6. .gitignore
  7. app.cpp
  8. file.hpp
  9. LICENSE
  10. meson.build
  11. meson.options
  12. occ-active.sh
  13. occ_command.cpp
  14. occ_command.hpp
  15. occ_dbus.cpp
  16. occ_dbus.hpp
  17. occ_device.cpp
  18. occ_device.hpp
  19. occ_errors.cpp
  20. occ_errors.hpp
  21. occ_events.hpp
  22. occ_ffdc.cpp
  23. occ_ffdc.hpp
  24. occ_manager.cpp
  25. occ_manager.hpp
  26. occ_pass_through.cpp
  27. occ_pass_through.hpp
  28. occ_presence.cpp
  29. occ_presence.hpp
  30. occ_sensor.mako.hpp
  31. occ_status.cpp
  32. occ_status.hpp
  33. OWNERS
  34. pldm.cpp
  35. pldm.hpp
  36. powercap.cpp
  37. powercap.hpp
  38. powermode.cpp
  39. powermode.hpp
  40. README.md
  41. sensor_gen.py
  42. utils.cpp
  43. utils.hpp
README.md

OpenPOWER OCC Control Service

This service will handle communications to the On-Chip Controller (OCC) on Power processors. The OCC provides processor and memory temperatures, power readings, power cap support, system power mode support, and idle power saver support. OCC Control will be interfacing with the OCC to collect the temperatures and power readings, updating the system power mode, setting power caps, and idle power save parameters.

The service is started automatically when the BMC is started.

Build Project

This project can be built with meson. The typical meson workflow is: meson builddir && ninja -C builddir.

Server

The server will start automatically after BMC is powered on.

Server status: systemctl status org.open_power.OCC.Control.service

To restart the service: systemctl restart org.open_power.OCC.Control.service

Configuration

Service files are located in service_files subdirectory.

References

Power10

IBM EnergyScale for Power10 Processor-Based Systems whitepaper: https://www.ibm.com/downloads/cas/E7RL9N4E

OCC Firmware Interface Spec for Power10: https://github.com/open-power/docs/blob/P10/occ/OCC_P10_FW_Interfaces_v1_17.pdf

OCC Firmware: https://github.com/open-power/occ/tree/master-p10

Power9

IBM EnergyScale for POWER9 Processor-Based Systems: https://www-01.ibm.com/common/ssi/cgi-bin/ssialias?htmlfid=49019149USEN&

OCC Firmware Interface Spec for POWER9: https://github.com/open-power/docs/blob/P9/occ/OCC_P9_FW_Interfaces.pdf