^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver max16065
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) ======================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) * Maxim MAX16065, MAX16066
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Prefixes: 'max16065', 'max16066'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) Datasheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) http://datasheets.maxim-ic.com/en/ds/MAX16065-MAX16066.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * Maxim MAX16067
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) Prefix: 'max16067'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Datasheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) http://datasheets.maxim-ic.com/en/ds/MAX16067.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) * Maxim MAX16068
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Prefix: 'max16068'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Datasheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) http://datasheets.maxim-ic.com/en/ds/MAX16068.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) * Maxim MAX16070/MAX16071
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Prefixes: 'max16070', 'max16071'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Datasheet:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) http://datasheets.maxim-ic.com/en/ds/MAX16070-MAX16071.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Author: Guenter Roeck <linux@roeck-us.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) [From datasheets] The MAX16065/MAX16066 flash-configurable system managers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) monitor and sequence multiple system voltages. The MAX16065/MAX16066 can also
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) accurately monitor (+/-2.5%) one current channel using a dedicated high-side
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) current-sense amplifier. The MAX16065 manages up to twelve system voltages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) simultaneously, and the MAX16066 manages up to eight supply voltages.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) The MAX16067 flash-configurable system manager monitors and sequences multiple
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) system voltages. The MAX16067 manages up to six system voltages simultaneously.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) The MAX16068 flash-configurable system manager monitors and manages up to six
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) system voltages simultaneously.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) The MAX16070/MAX16071 flash-configurable system monitors supervise multiple
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) system voltages. The MAX16070/MAX16071 can also accurately monitor (+/-2.5%)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) one current channel using a dedicated high-side current-sense amplifier. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) MAX16070 monitors up to twelve system voltages simultaneously, and the MAX16071
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) monitors up to eight supply voltages.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) Each monitored channel has its own low and high critical limits. MAX16065,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) MAX16066, MAX16070, and MAX16071 support an additional limit which is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) configurable as either low or high secondary limit. MAX16065, MAX16066,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) MAX16070, and MAX16071 also support supply current monitoring.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) This driver does not probe for devices, since there is no register which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) can be safely used to identify the chip. You will have to instantiate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) the devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) WARNING: Do not access chip registers using the i2cdump command, and do not use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) any of the i2ctools commands on a command register (0xa5 to 0xac). The chips
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) supported by this driver interpret any access to a command register (including
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) read commands) as request to execute the command in question. This may result in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) power loss, board resets, and/or Flash corruption. Worst case, your board may
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) turn into a brick.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) ======================= ========================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) in[0-11]_input Input voltage measurements.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) in12_input Voltage on CSP (Current Sense Positive) pin.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) Only if the chip supports current sensing and if
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) current sensing is enabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) in[0-11]_min Low warning limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) Supported on MAX16065, MAX16066, MAX16070, and MAX16071
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) in[0-11]_max High warning limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) Supported on MAX16065, MAX16066, MAX16070, and MAX16071
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) Either low or high warning limits are supported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) (depending on chip configuration), but not both.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) in[0-11]_lcrit Low critical limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) in[0-11]_crit High critical limit.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) in[0-11]_alarm Input voltage alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) curr1_input Current sense input; only if the chip supports current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) sensing and if current sensing is enabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) Displayed current assumes 0.001 Ohm current sense
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) resistor.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) curr1_alarm Overcurrent alarm; only if the chip supports current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) sensing and if current sensing is enabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) ======================= ========================================================