Kernel driver tsc1641

Supported chips:

Author:

Description

The TSC1641 is a high-precision current, voltage, power, and temperaturemonitoring analog front-end (AFE). It monitors bidirectional current into ashunt resistor and load voltage up to 60 V in a synchronized way. Digital businterface is I2C/SMbus. The TSC1641 allows the assertion of several alertsregarding the voltage, current, power and temperature.

Usage Notes

The TSC1641 driver requires the value of the external shunt resistor tocorrectly compute current and power measurements. The resistor value, inmicro-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.yamlfor bindings if the device tree is used.

Supported range of shunt resistor values is from 100 uOhm to 655.35 mOhm, in10 uOhm steps.When selecting the value keep in mind device maximum DC power measurement is1600W. See datasheet p.22 for ST recommendations on selecting shunt value.

If the shunt resistor value is not specified in the device tree, the driverinitializes it to 1000 uOhm by default. Users may configure the correct shuntresistor 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 timecorresponds to higher effective resolution in bits