Back to home page

OSCL-LXR

 
 

    


0001 Kernel driver ucd9200
0002 =====================
0003 
0004 Supported chips:
0005 
0006   * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
0007 
0008     Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
0009     'ucd9248'
0010 
0011     Addresses scanned: -
0012 
0013     Datasheets:
0014 
0015         - http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
0016         - http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
0017         - http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
0018         - http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
0019         - http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
0020         - http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
0021         - http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
0022 
0023 Author: Guenter Roeck <linux@roeck-us.net>
0024 
0025 
0026 Description
0027 -----------
0028 
0029 [From datasheets] UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and
0030 UCD9248 are multi-rail, multi-phase synchronous buck digital PWM controllers
0031 designed for non-isolated DC/DC power applications. The devices integrate
0032 dedicated circuitry for DC/DC loop management with flash memory and a serial
0033 interface to support configuration, monitoring and management.
0034 
0035 This driver is a client driver to the core PMBus driver. Please see
0036 Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
0037 
0038 
0039 Usage Notes
0040 -----------
0041 
0042 This driver does not auto-detect devices. You will have to instantiate the
0043 devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
0044 details.
0045 
0046 
0047 Platform data support
0048 ---------------------
0049 
0050 The driver supports standard PMBus driver platform data. Please see
0051 Documentation/hwmon/pmbus.rst for details.
0052 
0053 
0054 Sysfs entries
0055 -------------
0056 
0057 The following attributes are supported. Limits are read-write; all other
0058 attributes are read-only.
0059 
0060 ======================= ========================================================
0061 in1_label               "vin".
0062 in1_input               Measured voltage. From READ_VIN register.
0063 in1_min                 Minimum Voltage. From VIN_UV_WARN_LIMIT register.
0064 in1_max                 Maximum voltage. From VIN_OV_WARN_LIMIT register.
0065 in1_lcrit               Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
0066 in1_crit                Critical maximum voltage. From VIN_OV_FAULT_LIMIT
0067                         register.
0068 in1_min_alarm           Voltage low alarm. From VIN_UV_WARNING status.
0069 in1_max_alarm           Voltage high alarm. From VIN_OV_WARNING status.
0070 in1_lcrit_alarm         Voltage critical low alarm. From VIN_UV_FAULT status.
0071 in1_crit_alarm          Voltage critical high alarm. From VIN_OV_FAULT status.
0072 
0073 in[2-5]_label           "vout[1-4]".
0074 in[2-5]_input           Measured voltage. From READ_VOUT register.
0075 in[2-5]_min             Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
0076 in[2-5]_max             Maximum voltage. From VOUT_OV_WARN_LIMIT register.
0077 in[2-5]_lcrit           Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
0078 in[2-5]_crit            Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
0079                         register.
0080 in[2-5]_min_alarm       Voltage low alarm. From VOLTAGE_UV_WARNING status.
0081 in[2-5]_max_alarm       Voltage high alarm. From VOLTAGE_OV_WARNING status.
0082 in[2-5]_lcrit_alarm     Voltage critical low alarm. From VOLTAGE_UV_FAULT
0083                         status.
0084 in[2-5]_crit_alarm      Voltage critical high alarm. From VOLTAGE_OV_FAULT
0085                         status.
0086 
0087 curr1_label             "iin".
0088 curr1_input             Measured current. From READ_IIN register.
0089 
0090 curr[2-5]_label         "iout[1-4]".
0091 curr[2-5]_input         Measured current. From READ_IOUT register.
0092 curr[2-5]_max           Maximum current. From IOUT_OC_WARN_LIMIT register.
0093 curr[2-5]_lcrit         Critical minimum output current. From
0094                         IOUT_UC_FAULT_LIMIT register.
0095 curr[2-5]_crit          Critical maximum current. From IOUT_OC_FAULT_LIMIT
0096                         register.
0097 curr[2-5]_max_alarm     Current high alarm. From IOUT_OC_WARNING status.
0098 curr[2-5]_crit_alarm    Current critical high alarm. From IOUT_OC_FAULT status.
0099 
0100 power1_input            Measured input power. From READ_PIN register.
0101 power1_label            "pin"
0102 
0103 power[2-5]_input        Measured output power. From READ_POUT register.
0104 power[2-5]_label        "pout[1-4]"
0105 
0106                         The number of output voltage, current, and power
0107                         attribute sets is determined by the number of enabled
0108                         rails. See chip datasheets for details.
0109 
0110 temp[1-5]_input         Measured temperatures. From READ_TEMPERATURE_1 and
0111                         READ_TEMPERATURE_2 registers.
0112                         temp1 is the chip internal temperature. temp[2-5] are
0113                         rail temperatures.  temp[2-5] attributes are only
0114                         created for enabled rails. See chip datasheets for
0115                         details.
0116 temp[1-5]_max           Maximum temperature. From OT_WARN_LIMIT register.
0117 temp[1-5]_crit          Critical high temperature. From OT_FAULT_LIMIT register.
0118 temp[1-5]_max_alarm     Temperature high alarm.
0119 temp[1-5]_crit_alarm    Temperature critical high alarm.
0120 
0121 fan1_input              Fan RPM. ucd9240 only.
0122 fan1_alarm              Fan alarm. ucd9240 only.
0123 fan1_fault              Fan fault. ucd9240 only.
0124 ======================= ========================================================