^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) Kernel driver ucd9200
^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) * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) 'ucd9248'
^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) Datasheets:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) - http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) - http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) - http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) - http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) - http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) - http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) - http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Author: Guenter Roeck <linux@roeck-us.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) [From datasheets] UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) UCD9248 are multi-rail, multi-phase synchronous buck digital PWM controllers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) designed for non-isolated DC/DC power applications. The devices integrate
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) dedicated circuitry for DC/DC loop management with flash memory and a serial
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) interface to support configuration, monitoring and management.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) This driver is a client driver to the core PMBus driver. Please see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) This driver does not auto-detect devices. You will have to instantiate the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Platform data support
^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) The driver supports standard PMBus driver platform data. Please see
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) Documentation/hwmon/pmbus.rst for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) The following attributes are supported. Limits are read-write; all other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) attributes are read-only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) ======================= ========================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) in1_label "vin".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) in1_input Measured voltage. From READ_VIN register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) in1_min Minimum Voltage. From VIN_UV_WARN_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) in1_max Maximum voltage. From VIN_OV_WARN_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) in1_lcrit Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) in1_crit Critical maximum voltage. From VIN_OV_FAULT_LIMIT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) in1_min_alarm Voltage low alarm. From VIN_UV_WARNING status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) in1_max_alarm Voltage high alarm. From VIN_OV_WARNING status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) in1_lcrit_alarm Voltage critical low alarm. From VIN_UV_FAULT status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) in1_crit_alarm Voltage critical high alarm. From VIN_OV_FAULT status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) in[2-5]_label "vout[1-4]".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) in[2-5]_input Measured voltage. From READ_VOUT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) in[2-5]_min Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) in[2-5]_max Maximum voltage. From VOUT_OV_WARN_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) in[2-5]_lcrit Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) in[2-5]_crit Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) in[2-5]_min_alarm Voltage low alarm. From VOLTAGE_UV_WARNING status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) in[2-5]_max_alarm Voltage high alarm. From VOLTAGE_OV_WARNING status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) in[2-5]_lcrit_alarm Voltage critical low alarm. From VOLTAGE_UV_FAULT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) in[2-5]_crit_alarm Voltage critical high alarm. From VOLTAGE_OV_FAULT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) curr1_label "iin".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) curr1_input Measured current. From READ_IIN register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) curr[2-5]_label "iout[1-4]".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) curr[2-5]_input Measured current. From READ_IOUT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) curr[2-5]_max Maximum current. From IOUT_OC_WARN_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) curr[2-5]_lcrit Critical minimum output current. From
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) IOUT_UC_FAULT_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) curr[2-5]_crit Critical maximum current. From IOUT_OC_FAULT_LIMIT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) curr[2-5]_max_alarm Current high alarm. From IOUT_OC_WARNING status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) curr[2-5]_crit_alarm Current critical high alarm. From IOUT_OC_FAULT status.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) power1_input Measured input power. From READ_PIN register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) power1_label "pin"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) power[2-5]_input Measured output power. From READ_POUT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) power[2-5]_label "pout[1-4]"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) The number of output voltage, current, and power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) attribute sets is determined by the number of enabled
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) rails. See chip datasheets for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) temp[1-5]_input Measured temperatures. From READ_TEMPERATURE_1 and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) READ_TEMPERATURE_2 registers.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) temp1 is the chip internal temperature. temp[2-5] are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) rail temperatures. temp[2-5] attributes are only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) created for enabled rails. See chip datasheets for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) temp[1-5]_max Maximum temperature. From OT_WARN_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) temp[1-5]_crit Critical high temperature. From OT_FAULT_LIMIT register.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) temp[1-5]_max_alarm Temperature high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) temp[1-5]_crit_alarm Temperature critical high alarm.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) fan1_input Fan RPM. ucd9240 only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) fan1_alarm Fan alarm. ucd9240 only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) fan1_fault Fan fault. ucd9240 only.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) ======================= ========================================================