Documentation/hwmon/tsc1641.rst

Source file repositories/reference/linux-study-clean/Documentation/hwmon/tsc1641.rst

File Facts

System
Linux kernel
Corpus path
Documentation/hwmon/tsc1641.rst
Extension
.rst
Size
3177 bytes
Lines
87
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. 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)

Annotation

Implementation Notes