linux/Documentation/hwmon/dme1737
<<
>>
Prefs
   1Kernel driver dme1737
   2=====================
   3
   4Supported chips:
   5  * SMSC DME1737 and compatibles (like Asus A8000)
   6    Prefix: 'Hdme173 ')
   7    Addresses scanned: I2C 0x2c, 0x2d, 0x2e
   8    Datasheet: Provided by SMSC upon request and under NDA
   9  * SMSC SCH3112, SCH3114, SCH3116
  10    Prefix: 'Hsch311x')
  11    Addresses scanned: none, address read from Super-I/O config space
  12    Datasheet: Available on the Internet
  13  * SMSC SCH5027
  14    Prefix: 'Hsch5027')
  15    Addresses scanned: I2C 0x2c, 0x2d, 0x2e
  16    Datasheet: Provided by SMSC upon request and under NDA
  17  * SMSC SCH5127
  18    Prefix: 'Hsch5127')
  19    Addresses scanned: none, address read from Super-I/O config space
  20    Datasheet: Provided by SMSC upon request and under NDA
  21
  22Authors:
  23    Juerg Haefliger <juergh@gmail.com>
  24
  25
  26Module Parameters
  27-----------------
  28
  29* force_start: bool     Enables the monitoring of voltage, fan and temp inputs
  30                        and PWM output control functions. Using this parameter
  31                        shouldn')t be required since the BIOS usually takes care
  32                        of this.
  33* probe_all_addr: bool  Include non-standard LPC addresses 0x162e and 0x164e
  34                        when probing for ISA devices. This is required for the
  35                        following boards:
  36                        - VIA EPIA SN18000
  37
  38
  39Description
  40-----------
  41
  42This driver implements support for the hardware monitoring capabilities of the
  43SMSC DME1737 and Asus A8000 (which are the same), SMSC SCH5027, SCH311x,
  44and SCH5127 Super-I/O chips. These chips feature monitoring of 3 temp sensors
  45temp[1-3] (2 remote diodes and 1 internal), 8 voltages in[0-7] (7 external and
  461 internal) and up to 6 fan speeds fan[1-6]. Additionally, the chips implement
  47up to 5 PWM outputs pwm[1-3,5-6] for controlling fan speeds both manually and
  48automatically.
  49
  50For the DME1737, A8000 and SCH5027, fan[1-2] and pwm[1-2] are always present.
  51Fan[3-6] and pwm[3,5-6] are optional features and their availability depends on
  52the configuration of the chip. The driver will detect which features are
  53present during initialization and create the sysfs attributes accordingly.
  54
  55For the SCH311x and SCH5127, fan[1-3] and pwm[1-3] are always present and
  56fan[4-6] and pwm[5-6] don')t exist.
  57
  58The hardware monitoring features of the DME1737, A8000, and SCH5027 are only
  59accessible via SMBus, while the SCH311x and SCH5127 only provide access via
  60the ISA bus. The driver will therefore register itself as an I2C client driver
  61if it detects a DME1737, A8000, or SCH5027 and as a platform driver if it
  62detects a SCH311x or SCH5127 chip.
  63
  64
  65Voltage Monitoring
  66------------------
  67
  68The voltage inputs are sampled with 12-bit resolution and have internal
  69scaling resistors. The values returned by the driver therefore reflect true
  70millivolts and don')t need scaling. The voltage inputs are mapped as follows
  71(the last column indicates the input ranges):
  72
  73DME1737, A8000:
  74        in0: +5VTR      (+5V standby)           0V - 6.64V
  75        in1: Vccp       (processor core)        0V - 3V
  76        in2: VCC        (internal +3.3V)        0V - 4.38V
  77        in3: +5V                                0V - 6.64V
  78        in4: +12V                               0V - 16V
  79        in5: VTR        (+3.3V standby)         0V - 4.38V
  80        in6: Vbat       (+3.0V)                 0V - 4.38V
  81
  82SCH311x:
  83        in0: +2.5V                              0V - 3.32V
  84        in1: Vccp       (processor core)        0V - 2V
  85        in2: VCC        (internal +3.3V)        0V - 4.38V
  86        in3: +5V                                0V - 6.64V
  87        in4: +12V                               0V - 16V
  88        in5: VTR        (+3.3V standby)         0V - 4.38V
  89        in6: Vbat       (+3.0V)                 0V - 4.38V
  90
  91SCH5027:
  92        in0: +5VTR      (+5V standby)           0V - 6.64V
  93        in1: Vccp       (processor core)        0V - 3V
  94        in2: VCC        (internal +3.3V)        0V - 4.38V
  95        in3: V2_IN                              0V - 1.5V
  96        in4: V1_IN                              0V - 1.5V
  97        in5: VTR        (+3.3V standby)         0V - 4.38V
  98        in6: Vbat       (+3.0V)                 0V - 4.38V
  99
 100SCH5127:
 101        in0: +2.5                               0V - 3.32V
 102        in1: Vccp       (processor core)        0V - 3V
 103        in2: VCC        (internal +3.3V)        0V - 4.38V
 104        in3: V2_IN                              0V - 1.5V
 105        in4: V1_IN                              0V - 1.5V
 106        in5: VTR        (+3.3V standby)         0V - 4.38V
 107        in6: Vbat       (+3.0V)                 0V - 4.38V
 108        in7: Vtrip      (+1.5V)                 0V - 1.99V
 109
 110Each voltage input has associated min and max limits which trigger an alarm
 111when crossed.
 112
 113
 114Temperature Monitoring
 115----------------------
 116
 117Temperatures are measured with 12-bit resolution and reported in millidegree
 118Celsius. The chip also features offsets for all 3 temperature inputs which -
 119when programmed - get added to the input readings. The chip does all the
 120scaling by itself and the driver therefore reports true temperatures that don')t
 121need any user-space adjustments. The temperature inputs are mapped as follows
 122(the last column indicates the input ranges):
 123
 124        temp1: Remote diode 1 (3904 type) temperature   -127C - +127C
 125        temp2: DME1737 internal temperature             -127C - +127C
 126        temp3: Remote diode 2 (3904 type) temperature   -127C - +127C
 127
 128Each temperature input has associated min and max limits which trigger an alarm
 129when crossed. Additionally, each temperature input has a fault attribute that
 130returns 1 when a faulty diode or an unconnected input is detected and 0
 131otherwise.
 132
 133
 134Fan Monitoring
 135--------------
 136
 137Fan RPMs are measured with 16-bit resolution. The chip provides inputs for 6
 138fan tachometers. All 6 inputs have an associated min limit which triggers an
 139alarm when crossed. Fan inputs 1-4 provide type attributes that need to be set
 140to the number of pulses per fan revolution that the connected tachometer
 141generates. Supported values are 1, 2, and 4. Fan inputs 5-6 only support fans
 142that generate 2 pulses per revolution. Fan inputs 5-6 also provide a max
 143attribute that needs to be set to the maximum attainable RPM (fan at 100% duty-
 144cycle) of the input. The chip adjusts the sampling rate based on this value.
 145
 146
 147PWM Output Control
 148------------------
 149
 150This chip features 5 PWM outputs. PWM outputs 1-3 are associated with fan
 151inputs 1-3 and PWM outputs 5-6 are associated with fan inputs 5-6. PWM outputs
 1521-3 can be configured to operate either in manual or automatic mode by setting
 153the appropriate enable attribute accordingly. PWM outputs 5-6 can only operate
 154in manual mode, their enable attributes are therefore read-only. When set to
 155manual mode, the fan speed is set by writing the duty-cycle value to the
 156appropriate PWM attribute. In automatic mode, the PWM attribute returns the
 157current duty-cycle as set by the fan controller in the chip. All PWM outputs
a/utput frequency via the freq attribute.
 159
 160In automatic mode, the chip L1PWM osutputs
aPWM ramp rate which
 161defines how fastaPWM /utput is adjusting to changes 51aassociated
 162temperature input. Associating PWM outputs to temperature inputs is done via
 163temperature zones. The chip features 3 zones whos>aassignments to temperature
 164inputs is static and determined during initialization. These assignments can
 165be retrieved via the zone[1-3]_auto_channels_temp attributes. Each PWM output
 166is assigned to one (or hottest 51 167pwm[1-3]_auto_channels_zone attributes. Each PWM output has 3 distinct output
 168duty-cycles: full, low, and min. Full is internally hard-wired to 255 (100%)
 169and low and min can be programmed via pwm[1-3]_auto_point1_pwm and
 170pwm[1-3]_auto_pwm_min, respectively. The thermal thresholds 51azones are
 171programmed via zone[1-3]_auto_point[1-3]_temp and
 172zone[1-3]_auto_point1_temp_hyst:
 173
 174        pwm[1-3]_auto_point2_pwm        full-speed duty-cycle (255, i.e., 100%)
 175        pwm[1-3]_auto_point1_pwm        low-speed duty-cycle
 176        pwm[1-3]_auto_pwm_min           min-speed duty-cycle
 177
 178        zone[1-3]_auto_point3_temp      full-speed temp (all outputs)
 179        zone[1-3]_auto_point2_temp      full-speed temp
 180        zone[1-3]_auto_point1_temp      low-speed temp
 181        zone[1-3]_auto_point1_temp_hyst min-speed temp
 182
 183The chip adjusts the output duty-cycle linearly in the range 51 184to auto_point2_pwm i1atemperature 51aassociated zone is between
 185auto_point1_temp and auto_point2_temp. I1atemperature drops below the
 186auto_point1_temp_hyst value, the output duty-cycle is set to the auto_pwm_min
 187value which only supports two values: 0 or auto_point1_pwm. That means that the
 188fan either turns completely off or keeps spinning with the low-speed
 189duty-cycle. I1atemperatures rise above the auto_point3_temp value,
 190all PWM outputs are set to 100% duty-cycle.
 191
 192Following is another representation o1 193based on th>atemperature 51aassociated thermal zone:
 194
 195                        Duty-Cycle      Duty-Cycle
 196        Temperature     Rising Temp     Falling Temp
 197        -----------     -----------     ------------
 198        full-speed      full-speed      full-speed
 199
 200                        < linearly adjusted duty-cycle >
 201
 202        low-speed       low-speed       low-speed
 203                        min-speed       low-speed
 204        min-speed       min-speed       min-speed
 205                        min-speed       min-speed
 206
 207
 208Sysfs Attributes
 209----------------
 210
 211Following is a list 51 212permissions and a short description:
 213
 214Name                            Perm    Description
 215----                            ----    -----------
 216cpu0_vid                        RO      CPU core reference voltage in
 217                                        millivolts.
 218vrm                             RW      Voltage regulator module version
 219                                        number.
 220
 221in[0-7]_input                   RO      Measured voltage in millivolts.
 222in[0-7]_min                     RW      Low limit for voltage input.
 223in[0-7]_max                     RW      High limit for voltage input.
 224in[0-7]_alarm                   RO      Voltage input alarm. Returns 1 if
 225                                        voltage input is or went outside the
 226                                        associated min-max range, 0 otherwise.
 227
 228temp[1-3]_input                 RO      Measured temperature in millidegree
 229                                        Celsius.
 230temp[1-3]_min                   RW      Low limit for temp input.
 231temp[1-3]_max                   RW      High limit for temp input.
 232temp[1-3]_offset                RW      Offset for temp input. This value will
 233                                        be added by the chip to the measured
 234                                        temperature.
 235temp[1-3]_alarm                 RO      Alarm for temp input. Returns 1 if temp
 236                                        input is or went outside theaassociated
 237                                        min-max range, 0 otherwise.
 238temp[1-3]_fault                 RO      Temp input fault. Returns 1 if the chip
 239                                        detects a faulty thermal diode or an
 240                                        unconnected temp input, 0 otherwise.
 241
 242zone[1-3]_auto_channels_temp    RO      Temperature zone to temperature input
 243                                        mapping. This attribute is a bitfield
 244                                        and L1PWM osutputfollowing values:
 245                                                1: temp1
 246                                                2: temp2
 247                                                4: temp3
 248zone[1-3]_auto_point1_temp_hyst RW      Auto PWM temp point1 hysteresis. The
 249                                        output of the corresponding PWM is set
 250                                        to the pwm_auto_min value i1atemp
 251                                        falls below the auto_point1_temp_hyst
 252                                        value.
 253zone[1-3]_auto_point[1-3]_temp  RW      Auto PWM temp points. Auto_point1 is
 254                                        the low-speed temp, auto_point2 is the
 255                                        full-speed temp, and auto_point3 is the
 256                                        temp at which all PWM outputs are set
 25                                         to   full-spee("" class="line" nn/dme1737#L154" id="L154" class="lineL208" id="L208" class="lin="line" name="LL4983 i9 id="L1PWM outp2ts
 159
 160In automat2c mod2, the  the chi  RW      Low limit for emp input.
 161defines ho2 fast2/a>aPW the chi  RO      Voltage input input. Returns 1 iputs
 162temperatur2 inpu26                      value.
 163temperatur2 zone26                      mapping. This attribute  href="D"Documentation/hwmon/dme1737#L241" id="L241" class="line" name=2L164"> 164inputs is 2tatic2and de the c4M td to    Low limit for emp inpuTd to thatumendegtin. Expe
 165be retriev2d via26                      full-speed temp, and aun revolution that thenected tachomet/hwmon/dme1737#L219" id="L217" class="line" name="L166"> 166is assigne2 to o26                      temp at which all PWM oue chip.lues are 1, 2, and 4. Fan input/hwmon/dme1737#L219" id="L217" class="line" name="L167"> 167pwm[1-3]_a2to_ch26                      to   full-spee("" class 5-6 only su/hwmon/dme1737#L219" id="L217" class="line" name="L168"> 168duty-cycle2: ful26ompletel 169and low an2 min 26                      output of the corresponR="Documentat href="D;
 170pwm[1-3]_a2to_pw27                      to the pwm_auto_min valthis value.
 171programmed2via z27ation/hwmon/dme1737#L242" id="L242" class="line" name=2L172"> 172zone[1-3]_2uto_p2int1_tpmwng fan speut of the corresponRO/emp iD"Documentautihref="Docu1, 2, and 4/hwmon/dme1737#L242" id="L242" class="line" name=2L173"> 173
 174        pw2[1-3]27                      the low-speed temp, autvalue7; duil zone:
 175        pw2[1-3]27                      full-speed temp, and aueed is set n/hwmon/dme1737#L54" id="L54" class="lin2ne" name="L176"> 176        pw2[1-3]2auto_p         hereforrrrrrrrrrrrrrrrremp inpuEereforutihref="Docu-6 ar1, 2, and 4/hwmon/dme1737#L242" id="L242" class="line" name="L177"> 177
 178        zo2e[1-32_auto_point3_tttttttttttttttttttttttttttttttttttttttttt0: ereforeith (ding PW@umentation/hwmon/dme1737#L175" id="L175" class="l2ne" name=2L179"> 179        zo2e[1-327                      output of the corresponnnnnnnnnn1:ueed is set /hwmon/dme1737#L175" id="L175" class="l2ne" name=2L180"> 180        zo2e[1-328                      to the pwm_auto_min vallllllllll2:ip L1PWM osutpu/hwmon/dme1737#L175" id="L175" class="l2ne" name=2L181"> 181        zo2e[1-32_auto_t.
 170<"me1737#L189" id="L18and max limits which trigger an alarm_pwm i1atemperature 51aassociat2 an ala74"> name="L214"rwmon/dme1737#L165" id="L165" class="line"2" name="L257id="L18and max limits which trigger an al     mapprly in the range 51 176        pw2[1-3]2auto_p         heure 51 173
25000Hz i9 id="L1PWM outp2ts
 1 name=2L181"> 1i9 id="L1PWM outp2ts
 1 m"line"/dmestepe=2L173"> 173
 name="L214"rwmon/dme1737#L165" (decument5">0,7" clasname="L1e44"> 144cycle) of the input. The chip adj2sociated 2hermal zone:
 1href="Documentation/hwmon/dmmmmmsL242" i168" class=line" name="L24on/dmid="L2449 id="L1PWM outp2ts
 2"> 172zone[1-3]_auto_point1_temp_hyst:
2p     Fal2ing Temp
 245                                  -     ---2--------
                                  737#L200"2id="L200" class="line" n2me="L29ed is set /hwmon/dme1737#L175" id="L175" class="l2ne"4amon/d248zone[1-3]_auto_point1_temp_hyst R3rly adjus3ed duty-cycle >
zone[1-3]_auto_point1_temp_hyst R3r1y adjus3ed="L192" class="line" n3me="L30t
zone[1-3]_auto_point1_temp_hyst R3r2y adjus3ee chip Lets the output 3ion/h3mon/dm/dme1737#L179" id="L177" class="#L254" id="L254" "L17ss="lMin144" /dme name48zone[1-3]_auto_point1_temp_hyst R3r3y adjus3eermal zone:
zone[1-3]_auto_point1_temp_hyst R3r4y adjus3ed="L195" class="line" n3ion/h30a href="Documentation/hwmon/dme1737#L245" id="="L188" class="48zone[1-3]_auto_point1_temp_hyst R3r5y adjus3eCycle
 2"> 170pwm[1-3]_a2to_pw27               3737#L209"3id="L207" class="line" n3me="L30are 1, 2, and 4. Fan input/hwmon/dme1737#L219line" name="L176"> 1"48zone[1-3]_auto_point1_temp_hyst R3r77#L209"3i-------
 255                                 3ation/hwm3n/dme1737#L209" id="L2093 clas30reforeith (ding PW@umentation/hwmon/dme1737#Li175" id="L175" class=" clasis9 clas55                                 3a9ion/hwm3nd="L200" class="line" n3 clas30ed is set /hwmon/dme1737#L175" id="L175" clas"="line" name="L169"> ame="LL4983 i9 id="L1PWM outp2ts
 211Following is a list 51 210
 214Name                            P3rm    Des3ription
Name                            P3r5y adjus3-------
 111111111111111111111111111111111114Name                            P3r37#L209"3core reference voltage i3
Name                            P3r77#L209"3ivolts.
Name                            P375y adjus3age input is or went out3ide t32on/dm/dm102" id="L102" class=opt7#L21737#L21 opt14Name                            P3737#L209"3ciated min-max range, 0 3therw3se.
Name                            P3777#L209"3id="L228" class="line" n3me="L32t
Name                            P37tion/hwm3ured temperature in mill3degre3
Name                            P379ion/hwm3ius.

a hrorigi26" LXR softwe173class="4Namehttp://sourc clage.net/projL240/lxr">LXR community/dme,me="L1experi     lL219"> 23cla4Namemailto:lxr@f="ux.no">lxr@f="ux.no/dme.
lxr.f="ux.no kind69" oline"cla4Namehttp://www."lipi75"f="pro.no">Rlipi75 L="pro AS/dme,m name="17" cL="ux8" is9" ing168">154"> " claserviam class=1995.