macsmc-hwmon.rst 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. .. SPDX-License-Identifier: GPL-2.0-only
  2. Kernel driver macsmc-hwmon
  3. ==========================
  4. Supported hardware
  5. * Apple Silicon Macs (M1 and up)
  6. Author: James Calligeros <jcalligeros99@gmail.com>
  7. Description
  8. -----------
  9. macsmc-hwmon exposes the Apple System Management controller's
  10. temperature, voltage, current and power sensors, as well as
  11. fan speed and control capabilities, via hwmon.
  12. Because each Apple Silicon Mac exposes a different set of sensors
  13. (e.g. the MacBooks expose battery telemetry that is not present on
  14. the desktop Macs), sensors present on any given machine are described
  15. via Devicetree. The driver picks these up and registers them with
  16. hwmon when probed.
  17. Manual fan speed is supported via the fan_control module parameter. This
  18. is disabled by default and marked as unsafe, as it cannot be proven that
  19. the system will fail safe if overheating due to manual fan control being
  20. used.
  21. sysfs interface
  22. ---------------
  23. currX_input
  24. Ammeter value
  25. currX_label
  26. Ammeter label
  27. fanX_input
  28. Current fan speed
  29. fanX_label
  30. Fan label
  31. fanX_min
  32. Minimum possible fan speed
  33. fanX_max
  34. Maximum possible fan speed
  35. fanX_target
  36. Current fan setpoint
  37. inX_input
  38. Voltmeter value
  39. inX_label
  40. Voltmeter label
  41. powerX_input
  42. Power meter value
  43. powerX_label
  44. Power meter label
  45. tempX_input
  46. Temperature sensor value
  47. tempX_label
  48. Temperature sensor label