Changeset 1020

Show
Ignore:
Timestamp:
02/10/01 21:14:52 (14 years ago)
Author:
mds
Message:

format help a little better at top of sensors.conf,

add temp limit example.

Location:
lm-sensors/trunk
Files:
2 modified

Legend:

Unmodified
Added
Removed
  • lm-sensors/trunk/CHANGES

    r1018 r1020  
    2626  File doc/chips/via686a: Claim support for 686b. 
    2727  File sensors.conf.eg: Adjust as99127f in5 (-12V) and temp2 calculations 
     28  File sensors.conf.eg: Enhance help comments in file 
    2829  File sensors.c: Add xxx_init() calls for drivers added to mkpatch in 2.5.5. 
    2930  Include file i2c-isa.h: No longer required, moved to i2c.h in i2c package 
     
    268269  Modules: Somewhat less verbose on transfers 
    269270  Module lm78.o now recognizes and handles lm78-j and lm79 
     271 
    2702722.0.1 (1998121?) 
    271273  Module gl518sm.o updates, to make it actually work 
    272274  Module lm75.o high/low-byte swapping write bug fixed 
     275 
    2732762.0.0 (19981209) 
    274277  Initial release 
  • lm-sensors/trunk/etc/sensors.conf.eg

    r1018 r1020  
    1212########################################################################## 
    1313# 
     14# 
     15# OVERVIEW 
     16# -------- 
    1417# This configuration file will be used by all userspace applications 
    1518# linked to libsensors. It is NOT used by the lm_sensors drivers directly. 
    16  
     19# 
    1720# This config file consists of two parts: the heavily commented LM78 
    1821# example, and the real parts. Search for '####' if you want to skip 
    1922# to the real stuff. 
    20  
     23# 
    2124# Hash marks introduce comments, which continue until the end of a line 
    2225# 
     
    2427# unquoted; other identifiers must be quoted. Escape characters within 
    2528# quotes operate like those in C. 
    26  
     29# 
     30# 
     31# CHIP LINES 
     32# ---------- 
    2733# A 'chip' line specifies what the following 'label', 'compute', 'set' and  
    2834# 'ignore' lines refer to. In this case, until the 
     
    3642# "That" is used for LM78 chips on the ISA bus, and "This" for LM78 
    3743# chips on a non-ISA bus. 
    38  
    39 #chip "lm78-*" "lm78-j-*" "lm79-*" 
    40  
     44# 
     45#       chip "lm78-*" "lm78-j-*" "lm79-*" 
     46# 
     47# 
     48# FEATURE NAMES 
     49# ------------- 
     50# Feature names are used in 'label', 'compute', 'set', and 'ignore' lines. 
     51# Example feature names are 'in0', 'temp2', 'in3_min', and 'temp3_over'. 
     52# These features are defined for each chip in lib/chips.c. 
     53# Undefined features will be silently ignored!!!! 
     54# If you have trouble, verify the features in lib/chips.c!!! 
     55# 
     56# 
     57# LABEL LINES 
     58# ----------- 
    4159# A label line describes what a certain feature stands for on your 
    4260# mainboard. Programs can retrieve these names and display them. 
    4361# If no label is specified for a certain feature, the default name 
    4462# (ie. 'fan1' for fan1) is used. 
    45  
     63# 
    4664# If you specify a label for in1, this label is also used for in1_min and 
    4765# in1_max, unless they have their own labels declared. There are several 
    4866# of these logical groups. 
    49  
    50 # These are as advised in the LM78 and LM79 data sheets, and used on almost 
    51 # any mainboard we have seen. 
    52  
    53 #  label in0 "VCore 1" 
    54 #  label in1 "VCore 2" 
    55 #  label in2 "+3.3V" 
    56 #  label in3 "+5V" 
    57 #  label in4 "+12V" 
    58 #  label in5 "-12V" 
    59 #  label in6 "-5V" 
    60    
     67# 
     68# These are as advised in the LM78 and LM79 data sheets, and used on most 
     69# boards we have seen. 
     70# 
     71#       label in0 "VCore 1" 
     72#       label in1 "VCore 2" 
     73#       label in2 "+3.3V" 
     74#       label in3 "+5V" 
     75#       label in4 "+12V" 
     76#       label in5 "-12V" 
     77#       label in6 "-5V" 
     78#  
     79#  
     80# COMPUTE LINES 
     81# ------------- 
    6182# A compute line describes how to scale a certain feature. There are 
    6283# two expressions in it: the first describes how the /proc value must 
     
    6485# translated to a /proc value. '@' is the value to operate on. You may 
    6586# refer to other readable features (like '2 * vid'). 
    66  
     87# 
    6788# Like for the label statement, there are logical groups here. They are 
    6889# sometimes a bit different, though. For example, fan1_div is in the 
     
    7091# for it), but it is not in the compute group of fan1 (as it uses a 
    7192# completely different system of values). 
    72  
    73 # For positive voltages (in0..in4), two resistors are used, with the following 
     93# 
     94# 
     95# VOLTAGE COMPUTATION DETAILS 
     96# --------------------------- 
     97# Most voltage sensors in sensor chips have a range of 0 to 4.096 Volts. 
     98# This is generally sufficient for the 3.3 and CPU (2.5V, for example) 
     99# supply voltages, so the sensor chip reading is the actual voltage. 
     100# 
     101# Other supply voltages must be scaled with an external resistor network. 
     102# The chip driver generally reports the 'raw' value 0 - 4.09 V, and the 
     103# userspace application must convert this raw value to an actual voltage. 
     104# The 'compute' lines provide this facility. 
     105# 
     106# Unfortunately the resistor values vary among motherboard types. 
     107# Therefore you may have to adjust the computations in this file 
     108# to match your motherboard. 
     109# 
     110# For positive voltages (in3, in4), two resistors are used, with the following 
    74111# formula (R1,R2: resistor values, Vs: read voltage, Vin: pin voltage) 
    75 #   R1 = R2 * (Vs/Vin - 1) 
     112#       R1 = R2 * (Vs/Vin - 1) 
    76113# For negative voltages (in5, in6) two resistors are used, with the following 
    77114# formula (Rin,Rf: resistor values, Vs: read voltage, Vin: pin voltage) 
    78 #   Rin = (Vs * Rf) / Vin 
    79  
     115#       Rin = (Vs * Rf) / Vin 
     116# 
    80117# Here are the official LM78 and LM79 data sheet values. 
    81 #       Vs     R1,Rin   R2,Rf    Vin 
    82 # in3   +5.0      6.8    10     +2.98 
    83 # in4  +12.0     30      10     +3.00 
    84 # in5  -12.0    240      60     +3.00 
    85 # in6   -5.0    100      60     +3.00 
    86  
     118#             Vs     R1,Rin   R2,Rf    Vin 
     119#       in3   +5.0      6.8    10     +2.98 
     120#       in4  +12.0     30      10     +3.00 
     121#       in5  -12.0    240      60     +3.00 
     122#       in6   -5.0    100      60     +3.00 
     123# 
    87124# These would lead to these declarations: 
    88 # compute in3 ((6.8/10)+1)*@ ,  @/((6.8/10)+1) 
    89 # compute in4 ((30/10)+1)*@  ,  @/((30/10)+1) 
    90 # compute in5 -(240/60)*@    ,  -@/(240/60) 
    91 # compute in6 -(100/60)*@    ,  -@/(100/60) 
    92  
     125#       compute in3 ((6.8/10)+1)*@ ,  @/((6.8/10)+1) 
     126#       compute in4 ((30/10)+1)*@  ,  @/((30/10)+1) 
     127#       compute in5 -(240/60)*@    ,  -@/(240/60) 
     128#       compute in6 -(100/60)*@    ,  -@/(100/60) 
     129# 
    93130# On almost any mainboard we have seen, the Winbond compute values lead to 
    94131# much better results, though.  
    95  
    96 #       Vs     R1,Rin   R2,Rf    Vin 
    97 # in4  +12.0     28      10     +3.00 
    98 # in5  -12.0    210      60.4   +3.00 
    99 # in6   -5.0     90.9    60.4   +3.00 
    100  
     132# 
     133#             Vs     R1,Rin   R2,Rf    Vin 
     134#       in4  +12.0     28      10     +3.00 
     135#       in5  -12.0    210      60.4   +3.00 
     136#       in6   -5.0     90.9    60.4   +3.00 
     137# 
    101138# These leads to these declarations: 
    102 #  compute in3 ((6.8/10)+1)*@ ,  @/((6.8/10)+1) 
    103 #  compute in4 ((28/10)+1)*@  ,  @/((28/10)+1) 
    104 #  compute in5 -(210/60.4)*@  ,  -@/(210/60.4) 
    105 #  compute in6 -(90.9/60.4)*@ ,  -@/(90.9/60.4) 
    106  
     139#       compute in3 ((6.8/10)+1)*@ ,  @/((6.8/10)+1) 
     140#       compute in4 ((28/10)+1)*@  ,  @/((28/10)+1) 
     141#       compute in5 -(210/60.4)*@  ,  -@/(210/60.4) 
     142#       compute in6 -(90.9/60.4)*@ ,  -@/(90.9/60.4) 
     143# 
     144# 
     145# SET LINES 
     146# --------- 
    107147# Set statements set things like limits. Complete expressions can be 
    108148# used. Not everything can sensibly be set: setting 'in0', for example, 
    109149# is impossible! These settings are put through the compute translations; 
    110150# so if we specify '12.8' for in6, '3.2' will actually be written! 
    111  
    112 #set in0_max vid*1.05 
    113 #set in0_min vid*0.95 
    114  
     151# 
     152# Important note: In the 'sensors' program, these only take effect 
     153# after running 'sensors -s'!!! 
     154# 
     155#       set in0_max vid*1.05 
     156#       set in0_min vid*0.95 
     157#       set temp1_over 40        
     158#       set temp1_hyst 37        
     159# 
     160# 
     161# IGNORE LINES 
     162# ------------ 
    115163# Ignore statements tell certain features are not wanted. User programs can 
    116164# still read them if they really want, though; this is just an advisory 
     
    119167# simply advises the user program to not access that data. 
    120168# 
    121 #ignore in0 
    122  
    123  
     169#       ignore in0 
     170# 
     171# 
     172# BUS LINES 
     173# --------- 
    124174# There is one other feature: the 'bus' statement. An example is below. 
    125  
    126 #bus "i2c-0" "SMBus PIIX4 adapter at e800" "Non-I2C SMBus adapter" 
    127  
     175# 
     176#       bus "i2c-0" "SMBus PIIX4 adapter at e800" "Non-I2C SMBus adapter" 
     177# 
    128178# If we refer from now on to 'i2c-0' in 'chip' lines, this will run-time 
    129179# be matched to this bus. So even if the PIIX4 is called 'i2c-5' at that 
     
    132182# config file, this feature is not needed; but the next lines would 
    133183# only affect the LM75 chips on the PIIX4 adapter: 
    134  
    135 #chip "lm75-i2c-0-*" 
    136  
     184# 
     185#       chip "lm75-i2c-0-*" 
     186# 
    137187# You should really use the output of /proc/bus/chips to generate bus lines, 
    138188# because one mistyped characted will inhibit the match. Wildcards are not 
    139189# yet supported; spaces at the end are ignored, though. 
    140  
    141  
     190# 
     191# 
    142192########################################################################## 
    143193#### Here begins the real configuration file 
     
    156206    label in6 "-5V" 
    157207 
    158 # For positive voltages (in0..in4), two resistors are used, with the following 
     208# For positive voltages (in3, in4), two resistors are used, with the following 
    159209# formula (R1,R2: resistor values, Vs: read voltage, Vin: pin voltage) 
    160210#   R1 = R2 * (Vs/Vin - 1) 
     
    162212# formula (Rin,Rf: resistor values, Vs: read voltage, Vin: pin voltage) 
    163213#   Rin = (Vs * Rf) / Vin 
    164  
     214# 
    165215# Here are the official LM78 and LM79 data sheet values. 
    166216#       Vs     R1,Rin   R2,Rf    Vin 
     
    169219# in5  -12.0    240      60     +3.00 
    170220# in6   -5.0    100      60     +3.00 
    171  
     221# 
    172222# These would lead to these declarations: 
    173223# compute in3 ((6.8/10)+1)*@ ,  @/((6.8/10)+1) 
     
    175225# compute in5 -(240/60)*@    ,  -@/(240/60) 
    176226# compute in6 -(100/60)*@    ,  -@/(100/60) 
    177  
     227# 
    178228# On almost any mainboard we have seen, the Winbond compute values lead to 
    179229# much better results, though.  
    180  
     230# 
    181231#       Vs     R1,Rin   R2,Rf    Vin 
    182232# in4  +12.0     28      10     +3.00 
    183233# in5  -12.0    210      60.4   +3.00 
    184234# in6   -5.0     90.9    60.4   +3.00 
    185  
     235# 
    186236# These leads to these declarations: 
    187237 
     
    208258    set in6_max -5 * 1.05 
    209259 
     260# examples for temperature limits 
     261#    set temp1_over 40   
     262#    set temp1_hyst 37   
     263#    set temp2_over 52   
     264#    set temp2_hyst 47   
     265#    set temp3_over 52   
     266#    set temp3_hyst 47   
    210267 
    211268chip "w83782d-*" "w83783s-*" "w83627hf-*"