xref: /linux/Documentation/hwmon/lattepanda-sigma-ec.rst (revision 7a0e692a0381254b2f77c54dec100cd3325a6fdf)
1*a28b088eSMariano Abad.. SPDX-License-Identifier: GPL-2.0-or-later
2*a28b088eSMariano Abad
3*a28b088eSMariano AbadKernel driver lattepanda-sigma-ec
4*a28b088eSMariano Abad=================================
5*a28b088eSMariano Abad
6*a28b088eSMariano AbadSupported systems:
7*a28b088eSMariano Abad
8*a28b088eSMariano Abad  * LattePanda Sigma (Intel 13th Gen i5-1340P)
9*a28b088eSMariano Abad
10*a28b088eSMariano Abad    DMI vendor: LattePanda
11*a28b088eSMariano Abad
12*a28b088eSMariano Abad    DMI product: LattePanda Sigma
13*a28b088eSMariano Abad
14*a28b088eSMariano Abad    BIOS version: 5.27 (verified)
15*a28b088eSMariano Abad
16*a28b088eSMariano Abad    Datasheet: Not available (EC registers discovered empirically)
17*a28b088eSMariano Abad
18*a28b088eSMariano AbadAuthor: Mariano Abad <weimaraner@gmail.com>
19*a28b088eSMariano Abad
20*a28b088eSMariano AbadDescription
21*a28b088eSMariano Abad-----------
22*a28b088eSMariano Abad
23*a28b088eSMariano AbadThis driver provides hardware monitoring for the LattePanda Sigma
24*a28b088eSMariano Abadsingle-board computer made by DFRobot. The board uses an ITE IT8613E
25*a28b088eSMariano AbadEmbedded Controller to manage a CPU cooling fan and thermal sensors.
26*a28b088eSMariano Abad
27*a28b088eSMariano AbadThe BIOS declares the ACPI Embedded Controller (``PNP0C09``) with
28*a28b088eSMariano Abad``_STA`` returning 0, preventing the kernel's ACPI EC subsystem from
29*a28b088eSMariano Abadinitializing. This driver reads the EC directly via the standard ACPI
30*a28b088eSMariano AbadEC I/O ports (``0x62`` data, ``0x66`` command/status).
31*a28b088eSMariano Abad
32*a28b088eSMariano AbadSysfs attributes
33*a28b088eSMariano Abad----------------
34*a28b088eSMariano Abad
35*a28b088eSMariano Abad======================= ===============================================
36*a28b088eSMariano Abad``fan1_input``          Fan speed in RPM (EC registers 0x2E:0x2F,
37*a28b088eSMariano Abad                        16-bit big-endian)
38*a28b088eSMariano Abad``fan1_label``          "CPU Fan"
39*a28b088eSMariano Abad``temp1_input``         Board/ambient temperature in millidegrees
40*a28b088eSMariano Abad                        Celsius (EC register 0x60, unsigned)
41*a28b088eSMariano Abad``temp1_label``         "Board Temp"
42*a28b088eSMariano Abad``temp2_input``         CPU proximity temperature in millidegrees
43*a28b088eSMariano Abad                        Celsius (EC register 0x70, unsigned)
44*a28b088eSMariano Abad``temp2_label``         "CPU Temp"
45*a28b088eSMariano Abad======================= ===============================================
46*a28b088eSMariano Abad
47*a28b088eSMariano AbadModule parameters
48*a28b088eSMariano Abad-----------------
49*a28b088eSMariano Abad
50*a28b088eSMariano Abad``force`` (bool, default false)
51*a28b088eSMariano Abad    Force loading on BIOS versions other than 5.27. The driver still
52*a28b088eSMariano Abad    requires DMI vendor and product name matching.
53*a28b088eSMariano Abad
54*a28b088eSMariano AbadKnown limitations
55*a28b088eSMariano Abad-----------------
56*a28b088eSMariano Abad
57*a28b088eSMariano Abad* Fan speed control is not supported. The fan is always under EC
58*a28b088eSMariano Abad  automatic control.
59*a28b088eSMariano Abad* The EC register map was verified only on BIOS version 5.27.
60*a28b088eSMariano Abad  Other versions may use different register offsets; use the ``force``
61*a28b088eSMariano Abad  parameter at your own risk.
62