Documentation/hwmon/ltc2947.rst

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

File Facts

System
Linux kernel
Corpus path
Documentation/hwmon/ltc2947.rst
Extension
.rst
Size
3565 bytes
Lines
101
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

Kernel drivers ltc2947-i2c and ltc2947-spi
==========================================

Supported chips:

  * Analog Devices LTC2947

    Prefix: 'ltc2947'

    Addresses scanned: -

    Datasheet:

        https://www.analog.com/media/en/technical-documentation/data-sheets/LTC2947.pdf

Author: Nuno Sá <nuno.sa@analog.com>

Description
___________

The LTC2947 is a high precision power and energy monitor that measures current,
voltage, power, temperature, charge and energy. The device supports both SPI
and I2C depending on the chip configuration.
The device also measures accumulated quantities as energy. It has two banks of
register's to read/set energy related values. These banks can be configured
independently to have setups like: energy1 accumulates always and enrgy2 only
accumulates if current is positive (to check battery charging efficiency for
example). The device also supports a GPIO pin that can be configured as output
to control a fan as a function of measured temperature. Then, the GPIO becomes
active as soon as a temperature reading is higher than a defined threshold. The
temp2 channel is used to control this thresholds and to read the respective
alarms.

Sysfs entries
_____________

The following attributes are supported. Limits are read-write, reset_history
is write-only and all the other attributes are read-only.

======================= ==========================================
in0_input		VP-VM voltage (mV).
in0_min			Undervoltage threshold
in0_max			Overvoltage threshold
in0_lowest		Lowest measured voltage
in0_highest		Highest measured voltage
in0_reset_history	Write 1 to reset in1 history
in0_min_alarm		Undervoltage alarm
in0_max_alarm		Overvoltage alarm
in0_label		Channel label (VP-VM)

in1_input		DVCC voltage (mV)
in1_min			Undervoltage threshold
in1_max			Overvoltage threshold
in1_lowest		Lowest measured voltage
in1_highest		Highest measured voltage
in1_reset_history	Write 1 to reset in2 history
in1_min_alarm		Undervoltage alarm
in1_max_alarm		Overvoltage alarm
in1_label		Channel label (DVCC)

curr1_input		IP-IM Sense current (mA)
curr1_min		Undercurrent threshold
curr1_max		Overcurrent threshold
curr1_lowest		Lowest measured current
curr1_highest		Highest measured current
curr1_reset_history	Write 1 to reset curr1 history
curr1_min_alarm		Undercurrent alarm
curr1_max_alarm		Overcurrent alarm
curr1_label		Channel label (IP-IM)

Annotation

Implementation Notes