79 lines · plain
1.. SPDX-License-Identifier: GPL-2.02 3Kernel driver sg2042-mcu4========================5 6Supported chips:7 8 * Onboard MCU for sg20429 10 Addresses scanned: -11 12 Prefix: 'sg2042-mcu'13 14Authors:15 16 - Inochi Amaoto <inochiama@outlook.com>17 18Description19-----------20 21This driver supprts hardware monitoring for onboard MCU with22i2c interface.23 24Usage Notes25-----------26 27This driver does not auto-detect devices. You will have to instantiate28the devices explicitly.29Please see Documentation/i2c/instantiating-devices.rst for details.30 31Sysfs Attributes32----------------33 34The following table shows the standard entries support by the driver:35 36================= =====================================================37Name Description38================= =====================================================39temp1_input Measured temperature of SoC40temp1_crit Critical high temperature41temp1_crit_hyst hysteresis temperature restore from Critical42temp2_input Measured temperature of the base board43================= =====================================================44 45The following table shows the extra entries support by the driver46(the MCU device is in i2c subsystem):47 48================= ======= =============================================49Name Perm Description50================= ======= =============================================51reset_count RO Reset count of the SoC52uptime RO Seconds after the MCU is powered53reset_reason RO Reset reason for the last reset54repower_policy RW Execution policy when triggering repower55================= ======= =============================================56 57``repower_policy``58 The repower is triggered when the temperature of the SoC falls below59 the hysteresis temperature after triggering a shutdown due to60 reaching the critical temperature.61 The valid values for this entry are "repower" and "keep". "keep" will62 leave the SoC down when the triggering repower, and "repower" will63 boot the SoC.64 65Debugfs Interfaces66------------------67 68If debugfs is available, this driver exposes some hardware specific69data in ``/sys/kernel/debug/sg2042-mcu/*/``.70 71================= ======= =============================================72Name Format Description73================= ======= =============================================74firmware_version 0x%02x firmware version of the MCU75pcb_version 0x%02x version number of the base board76board_type 0x%02x identifiers for the base board77mcu_type %d type of the MCU: 0 is STM32, 1 is GD3278================= ======= =============================================79