2011-06-20 14:48:19 +07:00
|
|
|
Kernel driver ntc_thermistor
|
2019-04-17 16:46:28 +07:00
|
|
|
============================
|
2011-06-20 14:48:19 +07:00
|
|
|
|
2014-06-25 13:29:31 +07:00
|
|
|
Supported thermistors from Murata:
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2015-04-30 11:07:43 +07:00
|
|
|
* Murata NTC Thermistors NCP15WB473, NCP18WB473, NCP21WB473, NCP03WB473,
|
2016-02-29 05:31:23 +07:00
|
|
|
NCP15WL333, NCP03WF104, NCP15XH103
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2015-04-30 11:07:43 +07:00
|
|
|
Prefixes: 'ncp15wb473', 'ncp18wb473', 'ncp21wb473', 'ncp03wb473',
|
2016-02-29 05:31:23 +07:00
|
|
|
'ncp15wl333', 'ncp03wf104', 'ncp15xh103'
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2011-06-20 14:48:19 +07:00
|
|
|
Datasheet: Publicly available at Murata
|
|
|
|
|
2014-07-01 13:05:52 +07:00
|
|
|
Supported thermistors from EPCOS:
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2014-07-01 13:05:52 +07:00
|
|
|
* EPCOS NTC Thermistors B57330V2103
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2014-07-01 13:05:52 +07:00
|
|
|
Prefixes: b57330v2103
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2014-07-01 13:05:52 +07:00
|
|
|
Datasheet: Publicly available at EPCOS
|
|
|
|
|
2011-06-20 14:48:19 +07:00
|
|
|
Other NTC thermistors can be supported simply by adding compensation
|
|
|
|
tables; e.g., NCP15WL333 support is added by the table ncpXXwl333.
|
|
|
|
|
|
|
|
Authors:
|
2019-04-17 16:46:28 +07:00
|
|
|
|
2011-06-20 14:48:19 +07:00
|
|
|
MyungJoo Ham <myungjoo.ham@samsung.com>
|
|
|
|
|
|
|
|
Description
|
|
|
|
-----------
|
|
|
|
|
2014-06-25 13:29:31 +07:00
|
|
|
The NTC (Negative Temperature Coefficient) thermistor is a simple thermistor
|
|
|
|
that requires users to provide the resistance and lookup the corresponding
|
|
|
|
compensation table to get the temperature input.
|
2011-06-20 14:48:19 +07:00
|
|
|
|
|
|
|
The NTC driver provides lookup tables with a linear approximation function
|
|
|
|
and four circuit models with an option not to use any of the four models.
|
|
|
|
|
2019-04-17 16:46:28 +07:00
|
|
|
Using the following convention::
|
|
|
|
|
|
|
|
$ resistor
|
|
|
|
[TH] the thermistor
|
|
|
|
|
2011-06-20 14:48:19 +07:00
|
|
|
The four circuit models provided are:
|
|
|
|
|
2019-04-17 16:46:28 +07:00
|
|
|
1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0::
|
|
|
|
|
|
|
|
[pullup_uV]
|
|
|
|
| |
|
|
|
|
[TH] $ (pullup_ohm)
|
|
|
|
| |
|
|
|
|
+----+-----------------------[read_uV]
|
|
|
|
|
|
|
|
|
$ (pulldown_ohm)
|
|
|
|
|
|
|
|
|
-+- (ground)
|
|
|
|
|
|
|
|
2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected)::
|
|
|
|
|
|
|
|
[pullup_uV]
|
|
|
|
|
|
|
|
|
[TH]
|
|
|
|
|
|
|
|
|
+----------------------------[read_uV]
|
|
|
|
|
|
|
|
|
$ (pulldown_ohm)
|
|
|
|
|
|
|
|
|
-+- (ground)
|
|
|
|
|
|
|
|
3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0::
|
|
|
|
|
|
|
|
[pullup_uV]
|
|
|
|
|
|
|
|
|
$ (pullup_ohm)
|
|
|
|
|
|
|
|
|
+----+-----------------------[read_uV]
|
|
|
|
| |
|
|
|
|
[TH] $ (pulldown_ohm)
|
|
|
|
| |
|
|
|
|
-+----+- (ground)
|
|
|
|
|
|
|
|
4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected)::
|
|
|
|
|
|
|
|
[pullup_uV]
|
|
|
|
|
|
|
|
|
$ (pullup_ohm)
|
|
|
|
|
|
|
|
|
+----------------------------[read_uV]
|
|
|
|
|
|
|
|
|
[TH]
|
|
|
|
|
|
|
|
|
-+- (ground)
|
2011-06-20 14:48:19 +07:00
|
|
|
|
|
|
|
When one of the four circuit models is used, read_uV, pullup_uV, pullup_ohm,
|
|
|
|
pulldown_ohm, and connect should be provided. When none of the four models
|
|
|
|
are suitable or the user can get the resistance directly, the user should
|
|
|
|
provide read_ohm and _not_ provide the others.
|
|
|
|
|
|
|
|
Sysfs Interface
|
|
|
|
---------------
|
|
|
|
|
2019-04-17 16:46:28 +07:00
|
|
|
=============== == =============================================================
|
|
|
|
name the mandatory global attribute, the thermistor name.
|
|
|
|
=============== == =============================================================
|
|
|
|
temp1_type RO always 4 (thermistor)
|
2011-06-20 14:48:19 +07:00
|
|
|
|
2019-04-17 16:46:28 +07:00
|
|
|
temp1_input RO measure the temperature and provide the measured value.
|
|
|
|
(reading this file initiates the reading procedure.)
|
|
|
|
=============== == =============================================================
|
2011-06-20 14:48:19 +07:00
|
|
|
|
|
|
|
Note that each NTC thermistor has only _one_ thermistor; thus, only temp1 exists.
|