123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102 |
- Kernel driver ltc4245
- =====================
- Supported chips:
- * Linear Technology LTC4245
- Prefix: 'ltc4245'
- Addresses scanned: 0x20-0x3f
- Datasheet:
- http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
- Author: Ira W. Snyder <iws@ovro.caltech.edu>
- Description
- -----------
- The LTC4245 controller allows a board to be safely inserted and removed
- from a live backplane in multiple supply systems such as CompactPCI and
- PCI Express.
- Usage Notes
- -----------
- This driver does not probe for LTC4245 devices, due to the fact that some
- of the possible addresses are unfriendly to probing. You will have to
- instantiate the devices explicitly.
- Example: the following will load the driver for an LTC4245 at address 0x23
- on I2C bus #1:
- $ modprobe ltc4245
- $ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
- Sysfs entries
- -------------
- The LTC4245 has built-in limits for over and under current warnings. This
- makes it very likely that the reference circuit will be used.
- This driver uses the values in the datasheet to change the register values
- into the values specified in the sysfs-interface document. The current readings
- rely on the sense resistors listed in Table 2: "Sense Resistor Values".
- in1_input 12v input voltage (mV)
- in2_input 5v input voltage (mV)
- in3_input 3v input voltage (mV)
- in4_input Vee (-12v) input voltage (mV)
- in1_min_alarm 12v input undervoltage alarm
- in2_min_alarm 5v input undervoltage alarm
- in3_min_alarm 3v input undervoltage alarm
- in4_min_alarm Vee (-12v) input undervoltage alarm
- curr1_input 12v current (mA)
- curr2_input 5v current (mA)
- curr3_input 3v current (mA)
- curr4_input Vee (-12v) current (mA)
- curr1_max_alarm 12v overcurrent alarm
- curr2_max_alarm 5v overcurrent alarm
- curr3_max_alarm 3v overcurrent alarm
- curr4_max_alarm Vee (-12v) overcurrent alarm
- in5_input 12v output voltage (mV)
- in6_input 5v output voltage (mV)
- in7_input 3v output voltage (mV)
- in8_input Vee (-12v) output voltage (mV)
- in5_min_alarm 12v output undervoltage alarm
- in6_min_alarm 5v output undervoltage alarm
- in7_min_alarm 3v output undervoltage alarm
- in8_min_alarm Vee (-12v) output undervoltage alarm
- in9_input GPIO voltage data (see note 1)
- in10_input GPIO voltage data (see note 1)
- in11_input GPIO voltage data (see note 1)
- power1_input 12v power usage (mW)
- power2_input 5v power usage (mW)
- power3_input 3v power usage (mW)
- power4_input Vee (-12v) power usage (mW)
- Note 1
- ------
- If you have NOT configured the driver to sample all GPIO pins as analog
- voltages, then the in10_input and in11_input sysfs attributes will not be
- created. The driver will sample the GPIO pin that is currently connected to the
- ADC as an analog voltage, and report the value in in9_input.
- If you have configured the driver to sample all GPIO pins as analog voltages,
- then they will be sampled in round-robin fashion. If userspace reads too
- slowly, -EAGAIN will be returned when you read the sysfs attribute containing
- the sensor reading.
- The LTC4245 chip can be configured to sample all GPIO pins with two methods:
- 1) platform data -- see include/linux/i2c/ltc4245.h
- 2) OF device tree -- add the "ltc4245,use-extra-gpios" property to each chip
- The default mode of operation is to sample a single GPIO pin.
|