17ebd8b66SMauro Carvalho ChehabKernel driver ntc_thermistor 27ebd8b66SMauro Carvalho Chehab============================ 37ebd8b66SMauro Carvalho Chehab 47ebd8b66SMauro Carvalho ChehabSupported thermistors from Murata: 57ebd8b66SMauro Carvalho Chehab 67ebd8b66SMauro Carvalho Chehab* Murata NTC Thermistors NCP15WB473, NCP18WB473, NCP21WB473, NCP03WB473, 77ebd8b66SMauro Carvalho Chehab NCP15WL333, NCP03WF104, NCP15XH103 87ebd8b66SMauro Carvalho Chehab 97ebd8b66SMauro Carvalho Chehab Prefixes: 'ncp15wb473', 'ncp18wb473', 'ncp21wb473', 'ncp03wb473', 107ebd8b66SMauro Carvalho Chehab 'ncp15wl333', 'ncp03wf104', 'ncp15xh103' 117ebd8b66SMauro Carvalho Chehab 127ebd8b66SMauro Carvalho Chehab Datasheet: Publicly available at Murata 137ebd8b66SMauro Carvalho Chehab 147ebd8b66SMauro Carvalho ChehabSupported thermistors from EPCOS: 157ebd8b66SMauro Carvalho Chehab 167ebd8b66SMauro Carvalho Chehab* EPCOS NTC Thermistors B57330V2103 177ebd8b66SMauro Carvalho Chehab 187ebd8b66SMauro Carvalho Chehab Prefixes: b57330v2103 197ebd8b66SMauro Carvalho Chehab 207ebd8b66SMauro Carvalho Chehab Datasheet: Publicly available at EPCOS 217ebd8b66SMauro Carvalho Chehab 227ebd8b66SMauro Carvalho ChehabOther NTC thermistors can be supported simply by adding compensation 237ebd8b66SMauro Carvalho Chehabtables; e.g., NCP15WL333 support is added by the table ncpXXwl333. 247ebd8b66SMauro Carvalho Chehab 257ebd8b66SMauro Carvalho ChehabAuthors: 267ebd8b66SMauro Carvalho Chehab 277ebd8b66SMauro Carvalho Chehab MyungJoo Ham <myungjoo.ham@samsung.com> 287ebd8b66SMauro Carvalho Chehab 297ebd8b66SMauro Carvalho ChehabDescription 307ebd8b66SMauro Carvalho Chehab----------- 317ebd8b66SMauro Carvalho Chehab 327ebd8b66SMauro Carvalho ChehabThe NTC (Negative Temperature Coefficient) thermistor is a simple thermistor 337ebd8b66SMauro Carvalho Chehabthat requires users to provide the resistance and lookup the corresponding 347ebd8b66SMauro Carvalho Chehabcompensation table to get the temperature input. 357ebd8b66SMauro Carvalho Chehab 367ebd8b66SMauro Carvalho ChehabThe NTC driver provides lookup tables with a linear approximation function 377ebd8b66SMauro Carvalho Chehaband four circuit models with an option not to use any of the four models. 387ebd8b66SMauro Carvalho Chehab 397ebd8b66SMauro Carvalho ChehabUsing the following convention:: 407ebd8b66SMauro Carvalho Chehab 417ebd8b66SMauro Carvalho Chehab $ resistor 427ebd8b66SMauro Carvalho Chehab [TH] the thermistor 437ebd8b66SMauro Carvalho Chehab 447ebd8b66SMauro Carvalho ChehabThe four circuit models provided are: 457ebd8b66SMauro Carvalho Chehab 467ebd8b66SMauro Carvalho Chehab1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0:: 477ebd8b66SMauro Carvalho Chehab 487ebd8b66SMauro Carvalho Chehab [pullup_uV] 497ebd8b66SMauro Carvalho Chehab | | 507ebd8b66SMauro Carvalho Chehab [TH] $ (pullup_ohm) 517ebd8b66SMauro Carvalho Chehab | | 527ebd8b66SMauro Carvalho Chehab +----+-----------------------[read_uV] 537ebd8b66SMauro Carvalho Chehab | 547ebd8b66SMauro Carvalho Chehab $ (pulldown_ohm) 557ebd8b66SMauro Carvalho Chehab | 567ebd8b66SMauro Carvalho Chehab -+- (ground) 577ebd8b66SMauro Carvalho Chehab 587ebd8b66SMauro Carvalho Chehab2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected):: 597ebd8b66SMauro Carvalho Chehab 607ebd8b66SMauro Carvalho Chehab [pullup_uV] 617ebd8b66SMauro Carvalho Chehab | 627ebd8b66SMauro Carvalho Chehab [TH] 637ebd8b66SMauro Carvalho Chehab | 647ebd8b66SMauro Carvalho Chehab +----------------------------[read_uV] 657ebd8b66SMauro Carvalho Chehab | 667ebd8b66SMauro Carvalho Chehab $ (pulldown_ohm) 677ebd8b66SMauro Carvalho Chehab | 687ebd8b66SMauro Carvalho Chehab -+- (ground) 697ebd8b66SMauro Carvalho Chehab 707ebd8b66SMauro Carvalho Chehab3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0:: 717ebd8b66SMauro Carvalho Chehab 727ebd8b66SMauro Carvalho Chehab [pullup_uV] 737ebd8b66SMauro Carvalho Chehab | 747ebd8b66SMauro Carvalho Chehab $ (pullup_ohm) 757ebd8b66SMauro Carvalho Chehab | 767ebd8b66SMauro Carvalho Chehab +----+-----------------------[read_uV] 777ebd8b66SMauro Carvalho Chehab | | 787ebd8b66SMauro Carvalho Chehab [TH] $ (pulldown_ohm) 797ebd8b66SMauro Carvalho Chehab | | 807ebd8b66SMauro Carvalho Chehab -+----+- (ground) 817ebd8b66SMauro Carvalho Chehab 827ebd8b66SMauro Carvalho Chehab4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected):: 837ebd8b66SMauro Carvalho Chehab 847ebd8b66SMauro Carvalho Chehab [pullup_uV] 857ebd8b66SMauro Carvalho Chehab | 867ebd8b66SMauro Carvalho Chehab $ (pullup_ohm) 877ebd8b66SMauro Carvalho Chehab | 887ebd8b66SMauro Carvalho Chehab +----------------------------[read_uV] 897ebd8b66SMauro Carvalho Chehab | 907ebd8b66SMauro Carvalho Chehab [TH] 917ebd8b66SMauro Carvalho Chehab | 927ebd8b66SMauro Carvalho Chehab -+- (ground) 937ebd8b66SMauro Carvalho Chehab 947ebd8b66SMauro Carvalho ChehabWhen one of the four circuit models is used, read_uV, pullup_uV, pullup_ohm, 957ebd8b66SMauro Carvalho Chehabpulldown_ohm, and connect should be provided. When none of the four models 967ebd8b66SMauro Carvalho Chehabare suitable or the user can get the resistance directly, the user should 977ebd8b66SMauro Carvalho Chehabprovide read_ohm and _not_ provide the others. 987ebd8b66SMauro Carvalho Chehab 997ebd8b66SMauro Carvalho ChehabSysfs Interface 1007ebd8b66SMauro Carvalho Chehab--------------- 1017ebd8b66SMauro Carvalho Chehab 1027ebd8b66SMauro Carvalho Chehab=============== == ============================================================= 1037ebd8b66SMauro Carvalho Chehabname the mandatory global attribute, the thermistor name. 1047ebd8b66SMauro Carvalho Chehab=============== == ============================================================= 1057ebd8b66SMauro Carvalho Chehabtemp1_type RO always 4 (thermistor) 1067ebd8b66SMauro Carvalho Chehab 1077ebd8b66SMauro Carvalho Chehabtemp1_input RO measure the temperature and provide the measured value. 1087ebd8b66SMauro Carvalho Chehab (reading this file initiates the reading procedure.) 1097ebd8b66SMauro Carvalho Chehab=============== == ============================================================= 1107ebd8b66SMauro Carvalho Chehab 1117ebd8b66SMauro Carvalho ChehabNote that each NTC thermistor has only _one_ thermistor; thus, only temp1 exists. 112