smm665.rst 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187
  1. Kernel driver smm665
  2. ====================
  3. Supported chips:
  4. * Summit Microelectronics SMM465
  5. Prefix: 'smm465'
  6. Addresses scanned: -
  7. Datasheet:
  8. http://www.summitmicro.com/prod_select/summary/SMM465/SMM465DS.pdf
  9. * Summit Microelectronics SMM665, SMM665B
  10. Prefix: 'smm665'
  11. Addresses scanned: -
  12. Datasheet:
  13. http://www.summitmicro.com/prod_select/summary/SMM665/SMM665B_2089_20.pdf
  14. * Summit Microelectronics SMM665C
  15. Prefix: 'smm665c'
  16. Addresses scanned: -
  17. Datasheet:
  18. http://www.summitmicro.com/prod_select/summary/SMM665C/SMM665C_2125.pdf
  19. * Summit Microelectronics SMM764
  20. Prefix: 'smm764'
  21. Addresses scanned: -
  22. Datasheet:
  23. http://www.summitmicro.com/prod_select/summary/SMM764/SMM764_2098.pdf
  24. * Summit Microelectronics SMM766, SMM766B
  25. Prefix: 'smm766'
  26. Addresses scanned: -
  27. Datasheets:
  28. http://www.summitmicro.com/prod_select/summary/SMM766/SMM766_2086.pdf
  29. http://www.summitmicro.com/prod_select/summary/SMM766B/SMM766B_2122.pdf
  30. Author: Guenter Roeck <linux@roeck-us.net>
  31. Module Parameters
  32. -----------------
  33. * vref: int
  34. Default: 1250 (mV)
  35. Reference voltage on VREF_ADC pin in mV. It should not be necessary to set
  36. this parameter unless a non-default reference voltage is used.
  37. Description
  38. -----------
  39. [From datasheet] The SMM665 is an Active DC Output power supply Controller
  40. that monitors, margins and cascade sequences power. The part monitors six
  41. power supply channels as well as VDD, 12V input, two general-purpose analog
  42. inputs and an internal temperature sensor using a 10-bit ADC.
  43. Each monitored channel has its own high and low limits, plus a critical
  44. limit.
  45. Support for SMM465, SMM764, and SMM766 has been implemented but is untested.
  46. Usage Notes
  47. -----------
  48. This driver does not probe for devices, since there is no register which
  49. can be safely used to identify the chip. You will have to instantiate
  50. the devices explicitly. When instantiating the device, you have to specify
  51. its configuration register address.
  52. Example: the following will load the driver for an SMM665 at address 0x57
  53. on I2C bus #1::
  54. $ modprobe smm665
  55. $ echo smm665 0x57 > /sys/bus/i2c/devices/i2c-1/new_device
  56. Sysfs entries
  57. -------------
  58. This driver uses the values in the datasheet to convert ADC register values
  59. into the values specified in the sysfs-interface document. All attributes are
  60. read only.
  61. Min, max, lcrit, and crit values are used by the chip to trigger external signals
  62. and/or other activity. Triggered signals can include HEALTHY, RST, Power Off,
  63. or Fault depending on the chip configuration. The driver reports values as lcrit
  64. or crit if exceeding the limits triggers RST, Power Off, or Fault, and as min or
  65. max otherwise. For details please see the SMM665 datasheet.
  66. For SMM465 and SMM764, values for Channel E and F are reported but undefined.
  67. ======================= =======================================================
  68. in1_input 12V input voltage (mV)
  69. in2_input 3.3V (VDD) input voltage (mV)
  70. in3_input Channel A voltage (mV)
  71. in4_input Channel B voltage (mV)
  72. in5_input Channel C voltage (mV)
  73. in6_input Channel D voltage (mV)
  74. in7_input Channel E voltage (mV)
  75. in8_input Channel F voltage (mV)
  76. in9_input AIN1 voltage (mV)
  77. in10_input AIN2 voltage (mV)
  78. in1_min 12v input minimum voltage (mV)
  79. in2_min 3.3V (VDD) input minimum voltage (mV)
  80. in3_min Channel A minimum voltage (mV)
  81. in4_min Channel B minimum voltage (mV)
  82. in5_min Channel C minimum voltage (mV)
  83. in6_min Channel D minimum voltage (mV)
  84. in7_min Channel E minimum voltage (mV)
  85. in8_min Channel F minimum voltage (mV)
  86. in9_min AIN1 minimum voltage (mV)
  87. in10_min AIN2 minimum voltage (mV)
  88. in1_max 12v input maximum voltage (mV)
  89. in2_max 3.3V (VDD) input maximum voltage (mV)
  90. in3_max Channel A maximum voltage (mV)
  91. in4_max Channel B maximum voltage (mV)
  92. in5_max Channel C maximum voltage (mV)
  93. in6_max Channel D maximum voltage (mV)
  94. in7_max Channel E maximum voltage (mV)
  95. in8_max Channel F maximum voltage (mV)
  96. in9_max AIN1 maximum voltage (mV)
  97. in10_max AIN2 maximum voltage (mV)
  98. in1_lcrit 12v input critical minimum voltage (mV)
  99. in2_lcrit 3.3V (VDD) input critical minimum voltage (mV)
  100. in3_lcrit Channel A critical minimum voltage (mV)
  101. in4_lcrit Channel B critical minimum voltage (mV)
  102. in5_lcrit Channel C critical minimum voltage (mV)
  103. in6_lcrit Channel D critical minimum voltage (mV)
  104. in7_lcrit Channel E critical minimum voltage (mV)
  105. in8_lcrit Channel F critical minimum voltage (mV)
  106. in9_lcrit AIN1 critical minimum voltage (mV)
  107. in10_lcrit AIN2 critical minimum voltage (mV)
  108. in1_crit 12v input critical maximum voltage (mV)
  109. in2_crit 3.3V (VDD) input critical maximum voltage (mV)
  110. in3_crit Channel A critical maximum voltage (mV)
  111. in4_crit Channel B critical maximum voltage (mV)
  112. in5_crit Channel C critical maximum voltage (mV)
  113. in6_crit Channel D critical maximum voltage (mV)
  114. in7_crit Channel E critical maximum voltage (mV)
  115. in8_crit Channel F critical maximum voltage (mV)
  116. in9_crit AIN1 critical maximum voltage (mV)
  117. in10_crit AIN2 critical maximum voltage (mV)
  118. in1_crit_alarm 12v input critical alarm
  119. in2_crit_alarm 3.3V (VDD) input critical alarm
  120. in3_crit_alarm Channel A critical alarm
  121. in4_crit_alarm Channel B critical alarm
  122. in5_crit_alarm Channel C critical alarm
  123. in6_crit_alarm Channel D critical alarm
  124. in7_crit_alarm Channel E critical alarm
  125. in8_crit_alarm Channel F critical alarm
  126. in9_crit_alarm AIN1 critical alarm
  127. in10_crit_alarm AIN2 critical alarm
  128. temp1_input Chip temperature
  129. temp1_min Mimimum chip temperature
  130. temp1_max Maximum chip temperature
  131. temp1_crit Critical chip temperature
  132. temp1_crit_alarm Temperature critical alarm
  133. ======================= =======================================================