cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

max16065.rst (3799B)


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