Blame view

Documentation/hwmon/lm73.rst 2.74 KB
8c14d126a   Chris Verges   hwmon: (lm73) Add...
1
2
3
4
  Kernel driver lm73
  ==================
  
  Supported chips:
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
5

8c14d126a   Chris Verges   hwmon: (lm73) Add...
6
    * Texas Instruments LM73
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
7

8c14d126a   Chris Verges   hwmon: (lm73) Add...
8
      Prefix: 'lm73'
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
9

8c14d126a   Chris Verges   hwmon: (lm73) Add...
10
      Addresses scanned: I2C 0x48, 0x49, 0x4a, 0x4c, 0x4d, and 0x4e
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
11

8c14d126a   Chris Verges   hwmon: (lm73) Add...
12
      Datasheet: Publicly available at the Texas Instruments website
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
13

ad736c1a4   Alexander A. Klimov   hwmon: Replace HT...
14
  	       https://www.ti.com/product/lm73
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
15

8c14d126a   Chris Verges   hwmon: (lm73) Add...
16
17
  
  Author: Guillaume Ligneul <guillaume.ligneul@gmail.com>
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
18

8c14d126a   Chris Verges   hwmon: (lm73) Add...
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
  Documentation: Chris Verges <kg4ysn@gmail.com>
  
  
  Description
  -----------
  
  The LM73 is a digital temperature sensor.  All temperature values are
  given in degrees Celsius.
  
  Measurement Resolution Support
  ------------------------------
  
  The LM73 supports four resolutions, defined in terms of degrees C per
  LSB: 0.25, 0.125, 0.0625, and 0.3125.  Changing the resolution mode
  affects the conversion time of the LM73's analog-to-digital converter.
  From userspace, the desired resolution can be specified as a function of
  conversion time via the 'update_interval' sysfs attribute for the
  device.  This attribute will normalize ranges of input values to the
  maximum times defined for the resolution in the datasheet.
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
38
      ============= ============= ============
8c14d126a   Chris Verges   hwmon: (lm73) Add...
39
40
      Resolution    Conv. Time    Input Range
      (C/LSB)       (msec)        (msec)
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
41
      ============= ============= ============
8c14d126a   Chris Verges   hwmon: (lm73) Add...
42
43
44
45
      0.25          14             0..14
      0.125         28            15..28
      0.0625        56            29..56
      0.03125       112           57..infinity
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
46
      ============= ============= ============
8c14d126a   Chris Verges   hwmon: (lm73) Add...
47
48
  
  The following examples show how the 'update_interval' attribute can be
b04f2f7d3   Mauro Carvalho Chehab   docs: hwmon: conv...
49
  used to change the conversion time::
8c14d126a   Chris Verges   hwmon: (lm73) Add...
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
  
      $ echo 0 > update_interval
      $ cat update_interval
      14
      $ cat temp1_input
      24250
  
      $ echo 22 > update_interval
      $ cat update_interval
      28
      $ cat temp1_input
      24125
  
      $ echo 56 > update_interval
      $ cat update_interval
      56
      $ cat temp1_input
      24062
  
      $ echo 85 > update_interval
      $ cat update_interval
      112
      $ cat temp1_input
      24031
  
  As shown here, the lm73 driver automatically adjusts any user input for
  'update_interval' via a step function.  Reading back the
  'update_interval' value after a write operation will confirm the
  conversion time actively in use.
  
  Mathematically, the resolution can be derived from the conversion time
  via the following function:
  
     g(x) = 0.250 * [log(x/14) / log(2)]
  
  where 'x' is the output from 'update_interval' and 'g(x)' is the
  resolution in degrees C per LSB.
2bf9233a1   Chris Verges   hwmon: (lm73) Add...
87
88
89
90
91
92
93
94
95
96
97
  
  Alarm Support
  -------------
  
  The LM73 features a simple over-temperature alarm mechanism.  This
  feature is exposed via the sysfs attributes.
  
  The attributes 'temp1_max_alarm' and 'temp1_min_alarm' are flags
  provided by the LM73 that indicate whether the measured temperature has
  passed the 'temp1_max' and 'temp1_min' thresholds, respectively.  These
  values _must_ be read to clear the registers on the LM73.