.. SPDX-License-Identifier: GPL-2.0 Kernel driver sg2042-mcu ======================== Supported chips: * Onboard MCU for sg2042 Addresses scanned: - Prefix: 'sg2042-mcu' Authors: - Inochi Amaoto Description ----------- This driver supprts hardware monitoring for onboard MCU with i2c interface. Usage Notes ----------- This driver does not auto-detect devices. You will have to instantiate the devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for details. Sysfs Attributes ---------------- The following table shows the standard entries support by the driver: ================= ===================================================== Name Description ================= ===================================================== temp1_input Measured temperature of SoC temp1_crit Critical high temperature temp1_crit_hyst hysteresis temperature restore from Critical temp2_input Measured temperature of the base board ================= ===================================================== The following table shows the extra entries support by the driver (the MCU device is in i2c subsystem): ================= ======= ============================================= Name Perm Description ================= ======= ============================================= reset_count RO Reset count of the SoC uptime RO Seconds after the MCU is powered reset_reason RO Reset reason for the last reset repower_policy RW Execution policy when triggering repower ================= ======= ============================================= ``repower_policy`` The repower is triggered when the temperature of the SoC falls below the hysteresis temperature after triggering a shutdown due to reaching the critical temperature. The valid values for this entry are "repower" and "keep". "keep" will leave the SoC down when the triggering repower, and "repower" will boot the SoC. Debugfs Interfaces ------------------ If debugfs is available, this driver exposes some hardware specific data in ``/sys/kernel/debug/sg2042-mcu/*/``. ================= ======= ============================================= Name Format Description ================= ======= ============================================= firmware_version 0x%02x firmware version of the MCU pcb_version 0x%02x version number of the base board board_type 0x%02x identifiers for the base board mcu_type %d type of the MCU: 0 is STM32, 1 is GD32 ================= ======= =============================================