0001 Kernel driver smm665
0002 ====================
0003
0004 Supported chips:
0005
0006 * Summit Microelectronics SMM465
0007
0008 Prefix: 'smm465'
0009
0010 Addresses scanned: -
0011
0012 Datasheet:
0013
0014 http://www.summitmicro.com/prod_select/summary/SMM465/SMM465DS.pdf
0015
0016 * Summit Microelectronics SMM665, SMM665B
0017
0018 Prefix: 'smm665'
0019
0020 Addresses scanned: -
0021
0022 Datasheet:
0023
0024 http://www.summitmicro.com/prod_select/summary/SMM665/SMM665B_2089_20.pdf
0025
0026 * Summit Microelectronics SMM665C
0027
0028 Prefix: 'smm665c'
0029
0030 Addresses scanned: -
0031
0032 Datasheet:
0033
0034 http://www.summitmicro.com/prod_select/summary/SMM665C/SMM665C_2125.pdf
0035
0036 * Summit Microelectronics SMM764
0037
0038 Prefix: 'smm764'
0039
0040 Addresses scanned: -
0041
0042 Datasheet:
0043
0044 http://www.summitmicro.com/prod_select/summary/SMM764/SMM764_2098.pdf
0045
0046 * Summit Microelectronics SMM766, SMM766B
0047
0048 Prefix: 'smm766'
0049
0050 Addresses scanned: -
0051
0052 Datasheets:
0053
0054 http://www.summitmicro.com/prod_select/summary/SMM766/SMM766_2086.pdf
0055
0056 http://www.summitmicro.com/prod_select/summary/SMM766B/SMM766B_2122.pdf
0057
0058 Author: Guenter Roeck <linux@roeck-us.net>
0059
0060
0061 Module Parameters
0062 -----------------
0063
0064 * vref: int
0065 Default: 1250 (mV)
0066
0067 Reference voltage on VREF_ADC pin in mV. It should not be necessary to set
0068 this parameter unless a non-default reference voltage is used.
0069
0070
0071 Description
0072 -----------
0073
0074 [From datasheet] The SMM665 is an Active DC Output power supply Controller
0075 that monitors, margins and cascade sequences power. The part monitors six
0076 power supply channels as well as VDD, 12V input, two general-purpose analog
0077 inputs and an internal temperature sensor using a 10-bit ADC.
0078
0079 Each monitored channel has its own high and low limits, plus a critical
0080 limit.
0081
0082 Support for SMM465, SMM764, and SMM766 has been implemented but is untested.
0083
0084
0085 Usage Notes
0086 -----------
0087
0088 This driver does not probe for devices, since there is no register which
0089 can be safely used to identify the chip. You will have to instantiate
0090 the devices explicitly. When instantiating the device, you have to specify
0091 its configuration register address.
0092
0093 Example: the following will load the driver for an SMM665 at address 0x57
0094 on I2C bus #1::
0095
0096 $ modprobe smm665
0097 $ echo smm665 0x57 > /sys/bus/i2c/devices/i2c-1/new_device
0098
0099
0100 Sysfs entries
0101 -------------
0102
0103 This driver uses the values in the datasheet to convert ADC register values
0104 into the values specified in the sysfs-interface document. All attributes are
0105 read only.
0106
0107 Min, max, lcrit, and crit values are used by the chip to trigger external signals
0108 and/or other activity. Triggered signals can include HEALTHY, RST, Power Off,
0109 or Fault depending on the chip configuration. The driver reports values as lcrit
0110 or crit if exceeding the limits triggers RST, Power Off, or Fault, and as min or
0111 max otherwise. For details please see the SMM665 datasheet.
0112
0113 For SMM465 and SMM764, values for Channel E and F are reported but undefined.
0114
0115 ======================= =======================================================
0116 in1_input 12V input voltage (mV)
0117 in2_input 3.3V (VDD) input voltage (mV)
0118 in3_input Channel A voltage (mV)
0119 in4_input Channel B voltage (mV)
0120 in5_input Channel C voltage (mV)
0121 in6_input Channel D voltage (mV)
0122 in7_input Channel E voltage (mV)
0123 in8_input Channel F voltage (mV)
0124 in9_input AIN1 voltage (mV)
0125 in10_input AIN2 voltage (mV)
0126
0127 in1_min 12v input minimum voltage (mV)
0128 in2_min 3.3V (VDD) input minimum voltage (mV)
0129 in3_min Channel A minimum voltage (mV)
0130 in4_min Channel B minimum voltage (mV)
0131 in5_min Channel C minimum voltage (mV)
0132 in6_min Channel D minimum voltage (mV)
0133 in7_min Channel E minimum voltage (mV)
0134 in8_min Channel F minimum voltage (mV)
0135 in9_min AIN1 minimum voltage (mV)
0136 in10_min AIN2 minimum voltage (mV)
0137
0138 in1_max 12v input maximum voltage (mV)
0139 in2_max 3.3V (VDD) input maximum voltage (mV)
0140 in3_max Channel A maximum voltage (mV)
0141 in4_max Channel B maximum voltage (mV)
0142 in5_max Channel C maximum voltage (mV)
0143 in6_max Channel D maximum voltage (mV)
0144 in7_max Channel E maximum voltage (mV)
0145 in8_max Channel F maximum voltage (mV)
0146 in9_max AIN1 maximum voltage (mV)
0147 in10_max AIN2 maximum voltage (mV)
0148
0149 in1_lcrit 12v input critical minimum voltage (mV)
0150 in2_lcrit 3.3V (VDD) input critical minimum voltage (mV)
0151 in3_lcrit Channel A critical minimum voltage (mV)
0152 in4_lcrit Channel B critical minimum voltage (mV)
0153 in5_lcrit Channel C critical minimum voltage (mV)
0154 in6_lcrit Channel D critical minimum voltage (mV)
0155 in7_lcrit Channel E critical minimum voltage (mV)
0156 in8_lcrit Channel F critical minimum voltage (mV)
0157 in9_lcrit AIN1 critical minimum voltage (mV)
0158 in10_lcrit AIN2 critical minimum voltage (mV)
0159
0160 in1_crit 12v input critical maximum voltage (mV)
0161 in2_crit 3.3V (VDD) input critical maximum voltage (mV)
0162 in3_crit Channel A critical maximum voltage (mV)
0163 in4_crit Channel B critical maximum voltage (mV)
0164 in5_crit Channel C critical maximum voltage (mV)
0165 in6_crit Channel D critical maximum voltage (mV)
0166 in7_crit Channel E critical maximum voltage (mV)
0167 in8_crit Channel F critical maximum voltage (mV)
0168 in9_crit AIN1 critical maximum voltage (mV)
0169 in10_crit AIN2 critical maximum voltage (mV)
0170
0171 in1_crit_alarm 12v input critical alarm
0172 in2_crit_alarm 3.3V (VDD) input critical alarm
0173 in3_crit_alarm Channel A critical alarm
0174 in4_crit_alarm Channel B critical alarm
0175 in5_crit_alarm Channel C critical alarm
0176 in6_crit_alarm Channel D critical alarm
0177 in7_crit_alarm Channel E critical alarm
0178 in8_crit_alarm Channel F critical alarm
0179 in9_crit_alarm AIN1 critical alarm
0180 in10_crit_alarm AIN2 critical alarm
0181
0182 temp1_input Chip temperature
0183 temp1_min Mimimum chip temperature
0184 temp1_max Maximum chip temperature
0185 temp1_crit Critical chip temperature
0186 temp1_crit_alarm Temperature critical alarm
0187 ======================= =======================================================
