^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver bel-pfe
^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) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * BEL PFE1100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Prefixes: 'pfe1100'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Datasheet: https://www.belfuse.com/resources/datasheets/powersolutions/ds-bps-pfe1100-12-054xa.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) * BEL PFE3000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Prefixes: 'pfe3000'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Addresses scanned: -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Datasheet: https://www.belfuse.com/resources/datasheets/powersolutions/ds-bps-pfe3000-series.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Author: Tao Ren <rentao.bupt@gmail.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) This driver supports hardware monitoring for below power supply devices
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) which support PMBus Protocol:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) * BEL PFE1100
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) 1100 Watt AC to DC power-factor-corrected (PFC) power supply.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) PMBus Communication Manual is not publicly available.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) * BEL PFE3000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) 3000 Watt AC/DC power-factor-corrected (PFC) and DC-DC power supply.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) PMBus Communication Manual is not publicly available.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) The driver is a client driver to the core PMBus driver. Please see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) This driver does not auto-detect devices. You will have to instantiate the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Example: the following will load the driver for an PFE3000 at address 0x20
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) on I2C bus #1::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) $ modprobe bel-pfe
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) $ echo pfe3000 0x20 > /sys/bus/i2c/devices/i2c-1/new_device
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) Platform data support
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) ---------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) The driver supports standard PMBus driver platform data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) ======================= =======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) curr1_label "iin"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) curr1_input Measured input current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) curr1_max Input current max value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) curr1_max_alarm Input current max alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) curr[2-3]_label "iout[1-2]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) curr[2-3]_input Measured output current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) curr[2-3]_max Output current max value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) curr[2-3]_max_alarm Output current max alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) fan[1-2]_input Fan 1 and 2 speed in RPM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) fan1_target Set fan speed reference for both fans
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) in1_label "vin"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) in1_input Measured input voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) in1_crit Input voltage critical max value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) in1_crit_alarm Input voltage critical max alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) in1_lcrit Input voltage critical min value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) in1_lcrit_alarm Input voltage critical min alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) in1_max Input voltage max value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) in1_max_alarm Input voltage max alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) in2_label "vcap"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) in2_input Hold up capacitor voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) in[3-8]_label "vout[1-3,5-7]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) in[3-8]_input Measured output voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) in[3-4]_alarm vout[1-2] output voltage alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) power[1-2]_label "pin[1-2]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) power[1-2]_input Measured input power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) power[1-2]_alarm Input power high alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) power[3-4]_label "pout[1-2]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) power[3-4]_input Measured output power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) temp[1-3]_input Measured temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) temp[1-3]_alarm Temperature alarm
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) ======================= =======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) .. note::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) - curr3, fan2, vout[2-7], vcap, pin2, pout2 and temp3 attributes only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) exist for PFE3000.