Orange Pi5 kernel

Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards

3 Commits   0 Branches   0 Tags
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   1) Kernel driver k10temp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   2) =====================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   3) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   4) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   5) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   6) * AMD Family 10h processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   8)   Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  10)   Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  11) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  12)   Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  13) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  14)   Socket S1G3: Athlon II, Sempron, Turion II
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  16) * AMD Family 11h processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  17) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  18)   Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  19) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  20) * AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  22) * AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  24) * AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  25)   "Carrizo", "Stoney Ridge", "Bristol Ridge"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  26) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  27) * AMD Family 16h processors: "Kabini", "Mullins"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  28) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  29) * AMD Family 17h processors: "Zen", "Zen 2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  31) * AMD Family 18h processors: "Hygon Dhyana"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  33) * AMD Family 19h processors: "Zen 3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  34) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  35)   Prefix: 'k10temp'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  36) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  37)   Addresses scanned: PCI space
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  38) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  39)   Datasheets:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  40) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  41)   BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  42) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  43)     http://support.amd.com/us/Processor_TechDocs/31116.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  44) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  45)   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  47)     http://support.amd.com/us/Processor_TechDocs/41256.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  48) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  49)   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  50) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  51)     http://support.amd.com/us/Processor_TechDocs/41131.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  52) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  53)   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  54) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  55)     http://support.amd.com/us/Processor_TechDocs/43170.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  56) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  57)   Revision Guide for AMD Family 10h Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  58) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  59)     http://support.amd.com/us/Processor_TechDocs/41322.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  60) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  61)   Revision Guide for AMD Family 11h Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  62) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  63)     http://support.amd.com/us/Processor_TechDocs/41788.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  64) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  65)   Revision Guide for AMD Family 12h Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  66) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  67)     http://support.amd.com/us/Processor_TechDocs/44739.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  68) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  69)   Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  70) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  71)     http://support.amd.com/us/Processor_TechDocs/47534.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  72) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  73)   AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  74) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  75)     http://support.amd.com/us/Processor_TechDocs/43373.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  76) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  77)   AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  78) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  79)     http://support.amd.com/us/Processor_TechDocs/43374.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  80) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  81)   AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  82) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  83)     http://support.amd.com/us/Processor_TechDocs/43375.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  84) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  85) Author: Clemens Ladisch <clemens@ladisch.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  86) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  87) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  88) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  89) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  90) This driver permits reading of the internal temperature sensor of AMD
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  91) Family 10h/11h/12h/14h/15h/16h processors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  92) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  93) All these processors have a sensor, but on those for Socket F or AM2+,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  94) the sensor may return inconsistent values (erratum 319).  The driver
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  95) will refuse to load on these revisions unless you specify the "force=1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  96) module parameter.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  97) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  98) Due to technical reasons, the driver can detect only the mainboard's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  99) socket type, not the processor's actual capabilities.  Therefore, if you
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) are using an AM3 processor on an AM2+ mainboard, you can safely use the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) "force=1" parameter.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) For CPUs older than Family 17h, there is one temperature measurement value,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) available as temp1_input in sysfs. It is measured in degrees Celsius with a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) resolution of 1/8th degree.  Please note that it is defined as a relative
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) value; to quote the AMD manual::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)   Tctl is the processor temperature control value, used by the platform to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109)   control cooling systems. Tctl is a non-physical temperature on an
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)   arbitrary scale measured in degrees. It does _not_ represent an actual
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111)   physical temperature like die or case temperature. Instead, it specifies
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)   the processor temperature relative to the point at which the system must
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)   supply the maximum cooling for the processor's specified maximum case
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114)   temperature and maximum thermal power dissipation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) The maximum value for Tctl is available in the file temp1_max.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) If the BIOS has enabled hardware temperature control, the threshold at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) which the processor will throttle itself to avoid damage is available in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) temp1_crit and temp1_crit_hyst.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) On some AMD CPUs, there is a difference between the die temperature (Tdie) and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) the reported temperature (Tctl). Tdie is the real measured temperature, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) Tctl is used for fan control. While Tctl is always available as temp1_input,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) the driver exports Tdie temperature as temp2_input for those CPUs which support
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) it.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) Models from 17h family report relative temperature, the driver aims to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) compensate and report the real temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) On Family 17h and Family 18h CPUs, additional temperature sensors may report
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) Core Complex Die (CCD) temperatures. Up to 8 such temperatures are reported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) as temp{3..10}_input, labeled Tccd{1..8}. Actual support depends on the CPU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) variant.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) Various Family 17h and 18h CPUs report voltage and current telemetry
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) information. The following attributes may be reported.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) Attribute	Label	Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) ===============	=======	================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) in0_input	Vcore	Core voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) in1_input	Vsoc	SoC voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) curr1_input	Icore	Core current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) curr2_input	Isoc	SoC current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) ===============	=======	================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) Current values are raw (unscaled) as reported by the CPU. Core current is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) reported as multiples of 1A / LSB. SoC is reported as multiples of 0.25A
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) / LSB. The real current is board specific. Reported currents should be seen
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) as rough guidance, and should be scaled using sensors3.conf as appropriate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) for a given board.