mirror of
https://github.com/torvalds/linux.git
synced 2024-12-04 01:51:34 +00:00
c1cb98c55f
Improve documentation grammar and formatting for the Ampere(R)'s Altra(R) SMpro hwmon driver. Thanks Bagas for the changes in the link below. Link: https://lore.kernel.org/lkml/Y1aHiaZ1OpHZIzS9@google.com/T/#mfea2167b99384486a1b75d9304536015116c1821 Signed-off-by: Quan Nguyen <quan@os.amperecomputing.com> Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com> Link: https://lore.kernel.org/r/20221102062103.3135417-1-quan@os.amperecomputing.com Signed-off-by: Guenter Roeck <linux@roeck-us.net>
103 lines
4.0 KiB
ReStructuredText
103 lines
4.0 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0-only
|
|
|
|
Kernel driver Ampere(R)'s Altra(R) SMpro hwmon
|
|
==============================================
|
|
|
|
Supported chips:
|
|
|
|
* Ampere(R) Altra(R)
|
|
|
|
Prefix: ``smpro``
|
|
|
|
Reference: `Altra SoC BMC Interface Specification`
|
|
|
|
Author: Thu Nguyen <thu@os.amperecomputing.com>
|
|
|
|
Description
|
|
-----------
|
|
The smpro-hwmon driver supports hardware monitoring for Ampere(R) Altra(R)
|
|
SoCs based on the SMpro co-processor (SMpro). The following sensor metrics
|
|
are supported by the driver:
|
|
|
|
* temperature
|
|
* voltage
|
|
* current
|
|
* power
|
|
|
|
The interface provides the registers to query the various sensors and
|
|
their values which are then exported to userspace by this driver.
|
|
|
|
Usage Notes
|
|
-----------
|
|
|
|
The driver creates at least two sysfs files for each sensor.
|
|
|
|
* ``<sensor_type><idx>_label`` reports the sensor label.
|
|
* ``<sensor_type><idx>_input`` returns the sensor value.
|
|
|
|
The sysfs files are allocated in the SMpro rootfs folder, with one root
|
|
directory for each instance.
|
|
|
|
When the SoC is turned off, the driver will fail to read registers and
|
|
return ``-ENXIO``.
|
|
|
|
Sysfs entries
|
|
-------------
|
|
|
|
The following sysfs files are supported:
|
|
|
|
* Ampere(R) Altra(R):
|
|
|
|
============ ============= ====== ===============================================
|
|
Name Unit Perm Description
|
|
============ ============= ====== ===============================================
|
|
temp1_input millicelsius RO SoC temperature
|
|
temp2_input millicelsius RO Max temperature reported among SoC VRDs
|
|
temp2_crit millicelsius RO SoC VRD HOT Threshold temperature
|
|
temp3_input millicelsius RO Max temperature reported among DIMM VRDs
|
|
temp4_input millicelsius RO Max temperature reported among Core VRDs
|
|
temp5_input millicelsius RO Temperature of DIMM0 on CH0
|
|
temp5_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp6_input millicelsius RO Temperature of DIMM0 on CH1
|
|
temp6_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp7_input millicelsius RO Temperature of DIMM0 on CH2
|
|
temp7_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp8_input millicelsius RO Temperature of DIMM0 on CH3
|
|
temp8_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp9_input millicelsius RO Temperature of DIMM0 on CH4
|
|
temp9_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp10_input millicelsius RO Temperature of DIMM0 on CH5
|
|
temp10_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp11_input millicelsius RO Temperature of DIMM0 on CH6
|
|
temp11_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp12_input millicelsius RO Temperature of DIMM0 on CH7
|
|
temp12_crit millicelsius RO MEM HOT Threshold for all DIMMs
|
|
temp13_input millicelsius RO Max temperature reported among RCA VRDs
|
|
in0_input millivolts RO Core voltage
|
|
in1_input millivolts RO SoC voltage
|
|
in2_input millivolts RO DIMM VRD1 voltage
|
|
in3_input millivolts RO DIMM VRD2 voltage
|
|
in4_input millivolts RO RCA VRD voltage
|
|
cur1_input milliamperes RO Core VRD current
|
|
cur2_input milliamperes RO SoC VRD current
|
|
cur3_input milliamperes RO DIMM VRD1 current
|
|
cur4_input milliamperes RO DIMM VRD2 current
|
|
cur5_input milliamperes RO RCA VRD current
|
|
power1_input microwatts RO Core VRD power
|
|
power2_input microwatts RO SoC VRD power
|
|
power3_input microwatts RO DIMM VRD1 power
|
|
power4_input microwatts RO DIMM VRD2 power
|
|
power5_input microwatts RO RCA VRD power
|
|
============ ============= ====== ===============================================
|
|
|
|
Example::
|
|
|
|
# cat in0_input
|
|
830
|
|
# cat temp1_input
|
|
37000
|
|
# cat curr1_input
|
|
9000
|
|
# cat power5_input
|
|
19500000
|