~ubuntu-branches/ubuntu/trusty/linux-armadaxp/trusty

« back to all changes in this revision

Viewing changes to Documentation/hwmon/ntc_thermistor

  • Committer: Package Import Robot
  • Author(s): Michael Casadevall, Bryan Wu, Dann Frazier, Michael Casadeall
  • Date: 2012-03-10 15:00:54 UTC
  • mfrom: (1.1.1)
  • Revision ID: package-import@ubuntu.com-20120310150054-flugb39zon8vvgwe
Tags: 3.2.0-1600.1
[ Bryan Wu ]
* UBUNTU: import debian/debian.env and debian.armadaxp

[ Dann Frazier ]
* ARM: Armada XP: remove trailing '/' in dirnames in mvRules.mk

[ Michael Casadeall ]
* tools: add some tools for Marvell Armada XP processor
* kernel: timer tick hacking from Marvell
* kernel: Sheeva Errata: add delay on Sheeva when powering down
* net: add Marvell NFP netfilter
* net: socket and skb modifications made by Marvell
* miscdevice: add minor IDs for some Marvell Armada drivers
* fs: introduce memory pool for splice()
* video: EDID detection updates from Marvell Armada XP patchset
* video: backlight: add Marvell Dove LCD backlight driver
* video: display: add THS8200 display driver
* video: framebuffer: add Marvell Dove and Armada XP processor onchip LCD controller driver
* usbtest: add Interrupt transfer testing by Marvell Armada XP code
* usb: ehci: add support for Marvell EHCI controler
* tty/serial: 8250: add support for Marvell Armada XP processor and DeviceTree work
* rtc: add support for Marvell Armada XP onchip RTC controller
* net: pppoe: add Marvell ethernet NFP hook in PPPoE networking driver
* mtd: nand: add support for Marvell Armada XP Nand Flash Controller
* mtd: maps: add Marvell Armada XP specific map driver
* mmc: add support for Marvell Armada XP MMC/SD host controller
* i2c: add support for Marvell Armada XP onchip i2c bus controller
* hwmon: add Kconfig option for Armada XP onchip thermal sensor driver
* dmaengine: add Net DMA support for splice and update Marvell XOR DMA engine driver
* ata: add support for Marvell Armada XP SATA controller and update some quirks
* ARM: add Marvell Armada XP machine to mach-types
* ARM: oprofile: add support for Marvell PJ4B core
* ARM: mm: more ARMv6 switches for Marvell Armada XP
* ARM: remove static declaration to allow compilation
* ARM: alignment access fault trick
* ARM: mm: skip some fault fixing when run on NONE SMP ARMv6 mode during early abort event
* ARM: mm: add Marvell Sheeva CPU Architecture for PJ4B
* ARM: introduce optimized copy operation for Marvell Armada XP
* ARM: SAUCE: hardware breakpoint trick for Marvell Armada XP
* ARM: big endian and little endian tricks for Marvell Armada XP
* ARM: SAUCE: Add Marvell Armada XP build rules to arch/arm/kernel/Makefile
* ARM: vfp: add special handling for Marvell Armada XP
* ARM: add support for Marvell U-Boot
* ARM: add mv_controller_num for ARM PCI drivers
* ARM: add support for local PMUs, general SMP tweaks and cache flushing
* ARM: add Marvell device identifies in glue-proc.h
* ARM: add IPC driver support for Marvell platforms
* ARM: add DMA mapping for Marvell platforms
* ARM: add Sheeva errata and PJ4B code for booting
* ARM: update Kconfig and Makefile to include Marvell Armada XP platforms
* ARM: Armada XP: import LSP from Marvell for Armada XP 3.2 kernel enablement

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Kernel driver ntc_thermistor
 
2
=================
 
3
 
 
4
Supported thermistors:
 
5
* Murata NTC Thermistors NCP15WB473, NCP18WB473, NCP21WB473, NCP03WB473, NCP15WL333
 
6
  Prefixes: 'ncp15wb473', 'ncp18wb473', 'ncp21wb473', 'ncp03wb473', 'ncp15wl333'
 
7
  Datasheet: Publicly available at Murata
 
8
 
 
9
Other NTC thermistors can be supported simply by adding compensation
 
10
tables; e.g., NCP15WL333 support is added by the table ncpXXwl333.
 
11
 
 
12
Authors:
 
13
        MyungJoo Ham <myungjoo.ham@samsung.com>
 
14
 
 
15
Description
 
16
-----------
 
17
 
 
18
The NTC thermistor is a simple thermistor that requires users to provide the
 
19
resistance and lookup the corresponding compensation table to get the
 
20
temperature input.
 
21
 
 
22
The NTC driver provides lookup tables with a linear approximation function
 
23
and four circuit models with an option not to use any of the four models.
 
24
 
 
25
The four circuit models provided are:
 
26
 
 
27
        $: resister, [TH]: the thermistor
 
28
 
 
29
 1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0
 
30
 
 
31
   [pullup_uV]
 
32
       |    |
 
33
      [TH]  $ (pullup_ohm)
 
34
       |    |
 
35
       +----+-----------------------[read_uV]
 
36
       |
 
37
       $ (pulldown_ohm)
 
38
       |
 
39
      --- (ground)
 
40
 
 
41
 2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected)
 
42
 
 
43
   [pullup_uV]
 
44
       |
 
45
      [TH]
 
46
       |
 
47
       +----------------------------[read_uV]
 
48
       |
 
49
       $ (pulldown_ohm)
 
50
       |
 
51
      --- (ground)
 
52
 
 
53
 3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0
 
54
 
 
55
   [pullup_uV]
 
56
       |
 
57
       $ (pullup_ohm)
 
58
       |
 
59
       +----+-----------------------[read_uV]
 
60
       |    |
 
61
      [TH]  $ (pulldown_ohm)
 
62
       |    |
 
63
      -------- (ground)
 
64
 
 
65
 4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected)
 
66
 
 
67
   [pullup_uV]
 
68
       |
 
69
       $ (pullup_ohm)
 
70
       |
 
71
       +----------------------------[read_uV]
 
72
       |
 
73
      [TH]
 
74
       |
 
75
      --- (ground)
 
76
 
 
77
When one of the four circuit models is used, read_uV, pullup_uV, pullup_ohm,
 
78
pulldown_ohm, and connect should be provided. When none of the four models
 
79
are suitable or the user can get the resistance directly, the user should
 
80
provide read_ohm and _not_ provide the others.
 
81
 
 
82
Sysfs Interface
 
83
---------------
 
84
name            the mandatory global attribute, the thermistor name.
 
85
 
 
86
temp1_type      always 4 (thermistor)
 
87
                RO
 
88
 
 
89
temp1_input     measure the temperature and provide the measured value.
 
90
                (reading this file initiates the reading procedure.)
 
91
                RO
 
92
 
 
93
Note that each NTC thermistor has only _one_ thermistor; thus, only temp1 exists.