| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687 |
- .. 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 <igor@reznichenko.net>
- 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
- ==================== ===========================================================
|
