projects / mirror_ubuntu-artful-kernel.git / blame
| Commit | Line | Data |
|---|---|---|
| 6700ce03 GR |
1 | Kernel driver ltc2945 |
| 2 | ===================== | |
| 3 | ||
| 4 | Supported chips: | |
| 5 | * Linear Technology LTC2945 | |
| 6 | Prefix: 'ltc2945' | |
| 7 | Addresses scanned: - | |
| 8 | Datasheet: | |
| 9 | http://cds.linear.com/docs/en/datasheet/2945fa.pdf | |
| 10 | ||
| 11 | Author: Guenter Roeck <linux@roeck-us.net> | |
| 12 | ||
| 13 | ||
| 14 | Description | |
| 15 | ----------- | |
| 16 | ||
| 17 | The LTC2945 is a rail-to-rail system monitor that measures current, voltage, | |
| 18 | and power consumption. | |
| 19 | ||
| 20 | ||
| 21 | Usage Notes | |
| 22 | ----------- | |
| 23 | ||
| 24 | This driver does not probe for LTC2945 devices, since there is no register | |
| 25 | which can be safely used to identify the chip. You will have to instantiate | |
| 26 | the devices explicitly. | |
| 27 | ||
| 28 | Example: the following will load the driver for an LTC2945 at address 0x10 | |
| 29 | on I2C bus #1: | |
| 30 | $ modprobe ltc2945 | |
| 31 | $ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device | |
| 32 | ||
| 33 | ||
| 34 | Sysfs entries | |
| 35 | ------------- | |
| 36 | ||
| 37 | Voltage readings provided by this driver are reported as obtained from the ADC | |
| 38 | registers. If a set of voltage divider resistors is installed, calculate the | |
| 39 | real voltage by multiplying the reported value with (R1+R2)/R2, where R1 is the | |
| 40 | value of the divider resistor against the measured voltage and R2 is the value | |
| 41 | of the divider resistor against Ground. | |
| 42 | ||
| 43 | Current reading provided by this driver is reported as obtained from the ADC | |
| 44 | Current Sense register. The reported value assumes that a 1 mOhm sense resistor | |
| 45 | is installed. If a different sense resistor is installed, calculate the real | |
| 46 | current by dividing the reported value by the sense resistor value in mOhm. | |
| 47 | ||
| 48 | in1_input VIN voltage (mV). Voltage is measured either at | |
| 49 | SENSE+ or VDD pin depending on chip configuration. | |
| 50 | in1_min Undervoltage threshold | |
| 51 | in1_max Overvoltage threshold | |
| 52 | in1_lowest Lowest measured voltage | |
| 53 | in1_highest Highest measured voltage | |
| 54 | in1_reset_history Write 1 to reset in1 history | |
| 55 | in1_min_alarm Undervoltage alarm | |
| 56 | in1_max_alarm Overvoltage alarm | |
| 57 | ||
| 58 | in2_input ADIN voltage (mV) | |
| 59 | in2_min Undervoltage threshold | |
| 60 | in2_max Overvoltage threshold | |
| 61 | in2_lowest Lowest measured voltage | |
| 62 | in2_highest Highest measured voltage | |
| 63 | in2_reset_history Write 1 to reset in2 history | |
| 64 | in2_min_alarm Undervoltage alarm | |
| 65 | in2_max_alarm Overvoltage alarm | |
| 66 | ||
| 67 | curr1_input SENSE current (mA) | |
| 68 | curr1_min Undercurrent threshold | |
| 69 | curr1_max Overcurrent threshold | |
| 70 | curr1_lowest Lowest measured current | |
| 71 | curr1_highest Highest measured current | |
| 72 | curr1_reset_history Write 1 to reset curr1 history | |
| 73 | curr1_min_alarm Undercurrent alarm | |
| 74 | curr1_max_alarm Overcurrent alarm | |
| 75 | ||
| 76 | power1_input Power (in uW). Power is calculated based on SENSE+/VDD | |
| 77 | voltage or ADIN voltage depending on chip configuration. | |
| 78 | power1_min Low lower threshold | |
| 79 | power1_max High power threshold | |
| 80 | power1_input_lowest Historical minimum power use | |
| 81 | power1_input_highest Historical maximum power use | |
| 82 | power1_reset_history Write 1 to reset power1 history | |
| 83 | power1_min_alarm Low power alarm | |
| 84 | power1_max_alarm High power alarm |