xref: /netbsd-src/sys/dev/i2c/lm75.c (revision 6a493d6bc668897c91594964a732d38505b70cbb)
1 /*	$NetBSD: lm75.c,v 1.25 2012/10/27 17:18:17 chs Exp $	*/
2 
3 /*
4  * Copyright (c) 2003 Wasabi Systems, Inc.
5  * All rights reserved.
6  *
7  * Written by Jason R. Thorpe for Wasabi Systems, Inc.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  * 3. All advertising materials mentioning features or use of this software
18  *    must display the following acknowledgement:
19  *      This product includes software developed for the NetBSD Project by
20  *      Wasabi Systems, Inc.
21  * 4. The name of Wasabi Systems, Inc. may not be used to endorse
22  *    or promote products derived from this software without specific prior
23  *    written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
29  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35  * POSSIBILITY OF SUCH DAMAGE.
36  */
37 
38 #include <sys/cdefs.h>
39 __KERNEL_RCSID(0, "$NetBSD: lm75.c,v 1.25 2012/10/27 17:18:17 chs Exp $");
40 
41 #include <sys/param.h>
42 #include <sys/systm.h>
43 #include <sys/device.h>
44 #include <sys/kernel.h>
45 #include <sys/sysctl.h>
46 
47 #include <dev/sysmon/sysmonvar.h>
48 
49 #include <dev/i2c/i2cvar.h>
50 #include <dev/i2c/lm75reg.h>
51 
52 struct lmtemp_softc {
53 	device_t sc_dev;
54 	i2c_tag_t sc_tag;
55 	int sc_address;
56 
57 	struct sysmon_envsys *sc_sme;
58 	envsys_data_t sc_sensor;
59 	int sc_tmax;
60 
61 	uint32_t (*sc_lmtemp_decode)(const uint8_t *);
62 };
63 
64 static int  lmtemp_match(device_t, cfdata_t, void *);
65 static void lmtemp_attach(device_t, device_t, void *);
66 
67 CFATTACH_DECL_NEW(lmtemp, sizeof(struct lmtemp_softc),
68 	lmtemp_match, lmtemp_attach, NULL, NULL);
69 
70 static void	lmtemp_refresh(struct sysmon_envsys *, envsys_data_t *);
71 
72 static int	lmtemp_config_write(struct lmtemp_softc *, uint8_t);
73 static int	lmtemp_temp_write(struct lmtemp_softc *, int, uint16_t);
74 static uint32_t lmtemp_decode_lm75(const uint8_t *);
75 static uint32_t lmtemp_decode_ds75(const uint8_t *);
76 static uint32_t lmtemp_decode_lm77(const uint8_t *);
77 
78 static void	lmtemp_setup_sysctl(struct lmtemp_softc *);
79 static int	sysctl_lm75_temp(SYSCTLFN_ARGS);
80 
81 static const char * lmtemp_compats[] = {
82 	"i2c-lm75",
83 	/*
84 	 * see XXX in _attach() below: add code once non-lm75 matches are
85 	 * added here!
86 	 */
87 	NULL
88 };
89 
90 enum {
91 	lmtemp_lm75 = 0,
92 	lmtemp_ds75,
93 	lmtemp_lm77,
94 };
95 static const struct {
96 	int lmtemp_type;
97 	const char *lmtemp_name;
98 	int lmtemp_addrmask;
99 	int lmtemp_addr;
100 	uint32_t (*lmtemp_decode)(const uint8_t *);
101 } lmtemptbl[] = {
102 	{ lmtemp_lm75,	"LM75",
103 	    LM75_ADDRMASK,	LM75_ADDR,	lmtemp_decode_lm75 },
104 	{ lmtemp_ds75,	"DS75",
105 	    LM75_ADDRMASK,	LM75_ADDR,	lmtemp_decode_ds75 },
106 	{ lmtemp_lm77,	"LM77",
107 	    LM77_ADDRMASK,	LM77_ADDR,	lmtemp_decode_lm77 },
108 
109 	{ -1,		NULL,
110 	    0,			0,		NULL }
111 };
112 
113 static int
114 lmtemp_match(device_t parent, cfdata_t cf, void *aux)
115 {
116 	struct i2c_attach_args *ia = aux;
117 	int i;
118 
119 	if (ia->ia_name == NULL) {
120 		/*
121 		 * Indirect config - not much we can do!
122 		 */
123 		for (i = 0; lmtemptbl[i].lmtemp_type != -1 ; i++)
124 			if (lmtemptbl[i].lmtemp_type == cf->cf_flags)
125 				break;
126 		if (lmtemptbl[i].lmtemp_type == -1)
127 			return 0;
128 
129 		if ((ia->ia_addr & lmtemptbl[i].lmtemp_addrmask) ==
130 		    lmtemptbl[i].lmtemp_addr)
131 			return 1;
132 	} else {
133 		/*
134 		 * Direct config - match via the list of compatible
135 		 * hardware.
136 		 */
137 		if (iic_compat_match(ia, lmtemp_compats))
138 			return 1;
139 	}
140 
141 
142 	return 0;
143 }
144 
145 static void
146 lmtemp_attach(device_t parent, device_t self, void *aux)
147 {
148 	struct lmtemp_softc *sc = device_private(self);
149 	struct i2c_attach_args *ia = aux;
150 	int i;
151 
152 	sc->sc_dev = self;
153 	if (ia->ia_name == NULL) {
154 		for (i = 0; lmtemptbl[i].lmtemp_type != -1 ; i++)
155 			if (lmtemptbl[i].lmtemp_type ==
156 			    device_cfdata(self)->cf_flags)
157 				break;
158 	} else {
159 		/* XXX - add code when adding other direct matches! */
160 		i = 0;
161 	}
162 
163 	sc->sc_tag = ia->ia_tag;
164 	sc->sc_address = ia->ia_addr;
165 
166 	aprint_naive(": Temperature Sensor\n");
167 	if (ia->ia_name) {
168 		aprint_normal(": %s %s Temperature Sensor\n", ia->ia_name,
169 			lmtemptbl[i].lmtemp_name);
170 	} else {
171 		aprint_normal(": %s Temperature Sensor\n",
172 			lmtemptbl[i].lmtemp_name);
173 	}
174 
175 	/*
176 	 * according to the LM75 data sheet 80C is the default, so leave it
177 	 * there to avoid unexpected behaviour
178 	 */
179 	sc->sc_tmax = 80;
180 	if (i == lmtemp_lm75)
181 		lmtemp_setup_sysctl(sc);
182 
183 	/* Set the configuration of the LM75 to defaults. */
184 	iic_acquire_bus(sc->sc_tag, I2C_F_POLL);
185 	if (lmtemp_config_write(sc, LM75_CONFIG_FAULT_QUEUE_4) != 0) {
186 		aprint_error_dev(self, "unable to write config register\n");
187 		iic_release_bus(sc->sc_tag, I2C_F_POLL);
188 		return;
189 	}
190 	iic_release_bus(sc->sc_tag, I2C_F_POLL);
191 
192 	sc->sc_sme = sysmon_envsys_create();
193 	/* Initialize sensor data. */
194 	sc->sc_sensor.units =  ENVSYS_STEMP;
195 	sc->sc_sensor.state =  ENVSYS_SINVALID;
196 	(void)strlcpy(sc->sc_sensor.desc,
197 	    ia->ia_name? ia->ia_name : device_xname(self),
198 	    sizeof(sc->sc_sensor.desc));
199 	if (sysmon_envsys_sensor_attach(sc->sc_sme, &sc->sc_sensor)) {
200 		sysmon_envsys_destroy(sc->sc_sme);
201 		return;
202 	}
203 
204 	sc->sc_lmtemp_decode = lmtemptbl[i].lmtemp_decode;
205 
206 	/* Hook into system monitor. */
207 	sc->sc_sme->sme_name = device_xname(self);
208 	sc->sc_sme->sme_cookie = sc;
209 	sc->sc_sme->sme_refresh = lmtemp_refresh;
210 
211 	if (sysmon_envsys_register(sc->sc_sme)) {
212 		aprint_error_dev(self, "unable to register with sysmon\n");
213 		sysmon_envsys_destroy(sc->sc_sme);
214 	}
215 }
216 
217 static int
218 lmtemp_config_write(struct lmtemp_softc *sc, uint8_t val)
219 {
220 	uint8_t cmdbuf[2];
221 
222 	cmdbuf[0] = LM75_REG_CONFIG;
223 	cmdbuf[1] = val;
224 
225 	return iic_exec(sc->sc_tag, I2C_OP_WRITE_WITH_STOP,
226 	    sc->sc_address, cmdbuf, 1, &cmdbuf[1], 1, I2C_F_POLL);
227 }
228 
229 static int
230 lmtemp_temp_write(struct lmtemp_softc *sc, int reg, uint16_t val)
231 {
232 	uint8_t cmdbuf[3];
233 
234 	cmdbuf[0] = reg;
235 	cmdbuf[1] = (val >> 1) & 0xff;
236 	cmdbuf[2] = (val & 1) << 7;
237 
238 	return iic_exec(sc->sc_tag, I2C_OP_WRITE_WITH_STOP,
239 	    sc->sc_address, cmdbuf, 1, &cmdbuf[1], 2, I2C_F_POLL);
240 }
241 
242 static int
243 lmtemp_temp_read(struct lmtemp_softc *sc, uint8_t which, uint32_t *valp)
244 {
245 	int error;
246 	uint8_t cmdbuf[1];
247 	uint8_t buf[LM75_TEMP_LEN];
248 
249 	cmdbuf[0] = which;
250 
251 	error = iic_exec(sc->sc_tag, I2C_OP_READ_WITH_STOP,
252 	    sc->sc_address, cmdbuf, 1, buf, LM75_TEMP_LEN, 0);
253 	if (error)
254 		return error;
255 
256 	*valp = sc->sc_lmtemp_decode(buf);
257 	return 0;
258 }
259 
260 static void
261 lmtemp_refresh_sensor_data(struct lmtemp_softc *sc)
262 {
263 	uint32_t val;
264 	int error;
265 
266 	error = lmtemp_temp_read(sc, LM75_REG_TEMP, &val);
267 	if (error) {
268 #if 0
269 		aprint_error_dev(sc->sc_dev, "unable to read temperature, error = %d\n",
270 		    error);
271 #endif
272 		sc->sc_sensor.state = ENVSYS_SINVALID;
273 		return;
274 	}
275 
276 	sc->sc_sensor.value_cur = val;
277 	sc->sc_sensor.state = ENVSYS_SVALID;
278 }
279 
280 static void
281 lmtemp_refresh(struct sysmon_envsys *sme, envsys_data_t *edata)
282 {
283 	struct lmtemp_softc *sc = sme->sme_cookie;
284 
285 	iic_acquire_bus(sc->sc_tag, 0);	/* also locks our instance */
286 	lmtemp_refresh_sensor_data(sc);
287 	iic_release_bus(sc->sc_tag, 0);	/* also unlocks our instance */
288 }
289 
290 static uint32_t
291 lmtemp_decode_lm75(const uint8_t *buf)
292 {
293 	int temp;
294 	uint32_t val;
295 
296 	/*
297 	 * LM75 temps are the most-significant 9 bits of a 16-bit reg.
298 	 * sign-extend the MSB and add in the 0.5 from the LSB
299 	 */
300 	temp = (int8_t) buf[0];
301 	temp = (temp << 1) + ((buf[1] >> 7) & 0x1);
302 
303 	/* Temp is given in 1/2 deg. C, we convert to uK. */
304 	val = temp * 500000 + 273150000;
305 
306 	return val;
307 }
308 
309 static uint32_t
310 lmtemp_decode_ds75(const uint8_t *buf)
311 {
312 	int temp;
313 
314 	/*
315 	 * Sign-extend the MSB byte, and add in the fractions of a
316 	 * degree contained in the LSB (precision 1/16th DegC).
317 	 */
318 	temp = (int8_t)buf[0];
319 	temp = (temp << 4) | ((buf[1] >> 4) & 0xf);
320 
321 	/*
322 	 * Conversion to uK is simple.
323 	 */
324 	return (temp * 62500 + 273150000);
325 }
326 
327 static uint32_t
328 lmtemp_decode_lm77(const uint8_t *buf)
329 {
330 	int temp;
331 	uint32_t val;
332 
333 	/*
334 	 * Describe each bits of temperature registers on LM77.
335 	 *   D15 - D12:	Sign
336 	 *   D11 - D3 :	Bit8(MSB) - Bit0
337 	 */
338 	temp = (int8_t)buf[0];
339 	temp = (temp << 5) | ((buf[1] >> 3) & 0x1f);
340 
341 	/* Temp is given in 1/2 deg. C, we convert to uK. */
342 	val = temp * 500000 + 273150000;
343 
344 	return val;
345 }
346 
347 static void
348 lmtemp_setup_sysctl(struct lmtemp_softc *sc)
349 {
350 	const struct sysctlnode *me = NULL, *node = NULL;
351 
352 	iic_acquire_bus(sc->sc_tag, I2C_F_POLL);
353 	lmtemp_temp_write(sc, LM75_REG_THYST_SET_POINT, (sc->sc_tmax - 5) * 2);
354 	lmtemp_temp_write(sc, LM75_REG_TOS_SET_POINT, sc->sc_tmax * 2);
355 	iic_release_bus(sc->sc_tag, I2C_F_POLL);
356 
357 	sysctl_createv(NULL, 0, NULL, &me,
358 	    CTLFLAG_READWRITE,
359 	    CTLTYPE_NODE, device_xname(sc->sc_dev), NULL,
360 	    NULL, 0, NULL, 0,
361 	    CTL_MACHDEP, CTL_CREATE, CTL_EOL);
362 
363 	sysctl_createv(NULL, 0, NULL, &node,
364 	    CTLFLAG_READWRITE | CTLFLAG_OWNDESC,
365 	    CTLTYPE_INT, "temp", "Threshold temperature",
366 	    sysctl_lm75_temp, 1, (void *)sc, 0,
367 	    CTL_MACHDEP, me->sysctl_num, CTL_CREATE, CTL_EOL);
368 }
369 
370 static int
371 sysctl_lm75_temp(SYSCTLFN_ARGS)
372 {
373 	struct sysctlnode node = *rnode;
374 	struct lmtemp_softc *sc = node.sysctl_data;
375 	int temp;
376 
377 	if (newp) {
378 
379 		/* we're asked to write */
380 		node.sysctl_data = &sc->sc_tmax;
381 		if (sysctl_lookup(SYSCTLFN_CALL(&node)) == 0) {
382 
383 			temp = *(int *)node.sysctl_data;
384 			sc->sc_tmax = temp;
385 			iic_acquire_bus(sc->sc_tag, I2C_F_POLL);
386 			lmtemp_temp_write(sc, LM75_REG_THYST_SET_POINT,
387 			    (sc->sc_tmax - 5) * 2);
388 			lmtemp_temp_write(sc, LM75_REG_TOS_SET_POINT,
389 			    sc->sc_tmax * 2);
390 			iic_release_bus(sc->sc_tag, I2C_F_POLL);
391 			return 0;
392 		}
393 		return EINVAL;
394 	} else {
395 
396 		node.sysctl_data = &sc->sc_tmax;
397 		node.sysctl_size = 4;
398 		return (sysctl_lookup(SYSCTLFN_CALL(&node)));
399 	}
400 
401 	return 0;
402 }
403 
404 SYSCTL_SETUP(sysctl_lmtemp_setup, "sysctl lmtemp subtree setup")
405 {
406 
407 	sysctl_createv(NULL, 0, NULL, NULL,
408 		       CTLFLAG_PERMANENT,
409 		       CTLTYPE_NODE, "machdep", NULL,
410 		       NULL, 0, NULL, 0,
411 		       CTL_MACHDEP, CTL_EOL);
412 }
413 
414 
415