1.. SPDX-License-Identifier: GPL-2.0
2
3Kernel driver sg2042-mcu
4========================
5
6Supported chips:
7
8  * Onboard MCU for sg2042
9
10    Addresses scanned: -
11
12    Prefix: 'sg2042-mcu'
13
14Authors:
15
16  - Inochi Amaoto <inochiama@outlook.com>
17
18Description
19-----------
20
21This driver supprts hardware monitoring for onboard MCU with
22i2c interface.
23
24Usage Notes
25-----------
26
27This driver does not auto-detect devices. You will have to instantiate
28the devices explicitly.
29Please see Documentation/i2c/instantiating-devices.rst for details.
30
31Sysfs Attributes
32----------------
33
34The following table shows the standard entries support by the driver:
35
36================= =====================================================
37Name              Description
38================= =====================================================
39temp1_input       Measured temperature of SoC
40temp1_crit        Critical high temperature
41temp1_crit_hyst   hysteresis temperature restore from Critical
42temp2_input       Measured temperature of the base board
43================= =====================================================
44
45The following table shows the extra entries support by the driver
46(the MCU device is in i2c subsystem):
47
48================= ======= =============================================
49Name              Perm    Description
50================= ======= =============================================
51reset_count       RO      Reset count of the SoC
52uptime            RO      Seconds after the MCU is powered
53reset_reason      RO      Reset reason for the last reset
54repower_policy    RW      Execution policy when triggering repower
55================= ======= =============================================
56
57``repower_policy``
58  The repower is triggered when the temperature of the SoC falls below
59  the hysteresis temperature after triggering a shutdown due to
60  reaching the critical temperature.
61  The valid values for this entry are "repower" and "keep". "keep" will
62  leave the SoC down when the triggering repower, and "repower" will
63  boot the SoC.
64
65Debugfs Interfaces
66------------------
67
68If debugfs is available, this driver exposes some hardware specific
69data in ``/sys/kernel/debug/sg2042-mcu/*/``.
70
71================= ======= =============================================
72Name              Format  Description
73================= ======= =============================================
74firmware_version  0x%02x  firmware version of the MCU
75pcb_version       0x%02x  version number of the base board
76board_type        0x%02x  identifiers for the base board
77mcu_type          %d      type of the MCU: 0 is STM32, 1 is GD32
78================= ======= =============================================
79