spd5118.rst 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .. SPDX-License-Identifier: GPL-2.0-or-later
  2. Kernel driver spd5118
  3. =====================
  4. Supported chips:
  5. * SPD5118 (JEDEC JESD300) compliant temperature sensor chips
  6. JEDEC standard download:
  7. https://www.jedec.org/standards-documents/docs/jesd300-5b01
  8. (account required)
  9. Prefix: 'spd5118'
  10. Addresses scanned: I2C 0x50 - 0x57
  11. Author:
  12. Guenter Roeck <linux@roeck-us.net>
  13. Description
  14. -----------
  15. This driver implements support for SPD5118 (JEDEC JESD300) compliant temperature
  16. sensors, which are used on many DDR5 memory modules. Some systems use the sensor
  17. to prevent memory overheating by automatically throttling the memory controller.
  18. The driver auto-detects SPD5118 compliant chips, but can also be instantiated
  19. using devicetree/firmware nodes.
  20. A SPD5118 compliant chip supports a single temperature sensor. Critical minimum,
  21. minimum, maximum, and critical temperature can be configured. There are alarms
  22. for low critical, low, high, and critical thresholds.
  23. Hardware monitoring sysfs entries
  24. ---------------------------------
  25. ======================= ==================================
  26. temp1_input Temperature (RO)
  27. temp1_lcrit Low critical high temperature (RW)
  28. temp1_min Minimum temperature (RW)
  29. temp1_max Maximum temperature (RW)
  30. temp1_crit Critical high temperature (RW)
  31. temp1_lcrit_alarm Temperature low critical alarm
  32. temp1_min_alarm Temperature low alarm
  33. temp1_max_alarm Temperature high alarm
  34. temp1_crit_alarm Temperature critical alarm
  35. ======================= ==================================
  36. Alarm attributes are sticky until read and will be cleared afterwards
  37. unless the alarm condition still applies.
  38. SPD (Serial Presence Detect) support
  39. ------------------------------------
  40. The driver also supports reading the SPD NVRAM on SPD5118 compatible chips.
  41. SPD data is available from the 'eeprom' binary attribute file attached to the
  42. chip's I2C device.