.. SPDX-License-Identifier: GPL-2.0-only Kernel driver tsc1641 ===================== Supported chips: * ST TSC1641 Prefix: 'tsc1641' Addresses scanned: - Datasheet: https://www.st.com/resource/en/datasheet/tsc1641.pdf Author: - Igor Reznichenko Description ----------- The TSC1641 is a high-precision current, voltage, power, and temperature monitoring analog front-end (AFE). It monitors bidirectional current into a shunt resistor and load voltage up to 60 V in a synchronized way. Digital bus interface is I2C/SMbus. The TSC1641 allows the assertion of several alerts regarding the voltage, current, power and temperature. Usage Notes ----------- The TSC1641 driver requires the value of the external shunt resistor to correctly compute current and power measurements. The resistor value, in micro-ohms, should be provided either through the device tree property "shunt-resistor-micro-ohms" or via writable sysfs attribute "shunt_resistor". Please refer to the Documentation/devicetree/bindings/hwmon/st,tsc1641.yaml for bindings if the device tree is used. Supported range of shunt resistor values is from 100 uOhm to 655.35 mOhm, in 10 uOhm steps. When selecting the value keep in mind device maximum DC power measurement is 1600W. See datasheet p.22 for ST recommendations on selecting shunt value. If the shunt resistor value is not specified in the device tree, the driver initializes it to 1000 uOhm by default. Users may configure the correct shunt resistor value at runtime by writing to the "shunt_resistor" sysfs attribute. The driver only supports continuous operating mode. Measurement ranges: ================ =============================================================== Current Bidirectional, dependent on shunt Bus voltage 0-60V Maximum DC power 1600W Temperature -40C to +125C ================ =============================================================== Sysfs entries ------------- ==================== =========================================================== in0_input bus voltage (mV) in0_max bus voltage max alarm limit (mV) in0_max_alarm bus voltage max alarm limit exceeded in0_min bus voltage min alarm limit (mV) in0_min_alarm bus voltage min alarm limit exceeded curr1_input current measurement (mA) curr1_max current max alarm limit (mA) curr1_max_alarm current max alarm limit exceeded curr1_min current min alarm limit (mA) curr1_min_alarm current min alarm limit exceeded power1_input power measurement (uW) power1_max power max alarm limit (uW) power1_max_alarm power max alarm limit exceeded shunt_resistor shunt resistor value (uOhms) temp1_input temperature measurement (mdegC) temp1_max temperature max alarm limit (mdegC) temp1_max_alarm temperature max alarm limit exceeded update_interval data conversion time (1 - 33ms), longer conversion time corresponds to higher effective resolution in bits ==================== ===========================================================