94 lines
		
	
	
	
		
			2.4 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
		
		
			
		
	
	
			94 lines
		
	
	
	
		
			2.4 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
|   | Kernel driver ntc_thermistor | ||
|  | ================= | ||
|  | 
 | ||
|  | Supported thermistors: | ||
|  | * Murata NTC Thermistors NCP15WB473, NCP18WB473, NCP21WB473, NCP03WB473, NCP15WL333 | ||
|  |   Prefixes: 'ncp15wb473', 'ncp18wb473', 'ncp21wb473', 'ncp03wb473', 'ncp15wl333' | ||
|  |   Datasheet: Publicly available at Murata | ||
|  | 
 | ||
|  | Other NTC thermistors can be supported simply by adding compensation | ||
|  | tables; e.g., NCP15WL333 support is added by the table ncpXXwl333. | ||
|  | 
 | ||
|  | Authors: | ||
|  | 	MyungJoo Ham <myungjoo.ham@samsung.com> | ||
|  | 
 | ||
|  | Description | ||
|  | ----------- | ||
|  | 
 | ||
|  | The NTC thermistor is a simple thermistor that requires users to provide the | ||
|  | resistance and lookup the corresponding compensation table to get the | ||
|  | temperature input. | ||
|  | 
 | ||
|  | 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. | ||
|  | 
 | ||
|  | The four circuit models provided are: | ||
|  | 
 | ||
|  | 	$: resister, [TH]: the thermistor | ||
|  | 
 | ||
|  |  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) | ||
|  | 
 | ||
|  | 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 | ||
|  | --------------- | ||
|  | name		the mandatory global attribute, the thermistor name. | ||
|  | 
 | ||
|  | temp1_type	always 4 (thermistor) | ||
|  | 		RO | ||
|  | 
 | ||
|  | temp1_input	measure the temperature and provide the measured value. | ||
|  | 		(reading this file initiates the reading procedure.) | ||
|  | 		RO | ||
|  | 
 | ||
|  | Note that each NTC thermistor has only _one_ thermistor; thus, only temp1 exists. |