xref: /linux/drivers/w1/w1.c (revision 1ec0b899c2b776c0c2dd03044b171a52b5211570)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * Copyright (c) 2004 Evgeniy Polyakov <zbr@ioremap.net>
4  */
5 
6 #include <linux/delay.h>
7 #include <linux/kernel.h>
8 #include <linux/module.h>
9 #include <linux/moduleparam.h>
10 #include <linux/list.h>
11 #include <linux/interrupt.h>
12 #include <linux/spinlock.h>
13 #include <linux/timer.h>
14 #include <linux/device.h>
15 #include <linux/slab.h>
16 #include <linux/sched.h>
17 #include <linux/kthread.h>
18 #include <linux/freezer.h>
19 #include <linux/hwmon.h>
20 #include <linux/of.h>
21 
22 #include <linux/atomic.h>
23 
24 #include "w1_internal.h"
25 #include "w1_netlink.h"
26 
27 #define W1_FAMILY_DEFAULT	0
28 
29 static int w1_timeout = 10;
30 module_param_named(timeout, w1_timeout, int, 0);
31 MODULE_PARM_DESC(timeout, "time in seconds between automatic slave searches");
32 
33 static int w1_timeout_us = 0;
34 module_param_named(timeout_us, w1_timeout_us, int, 0);
35 MODULE_PARM_DESC(timeout_us,
36 		 "time in microseconds between automatic slave searches");
37 
38 /* A search stops when w1_max_slave_count devices have been found in that
39  * search.  The next search will start over and detect the same set of devices
40  * on a static 1-wire bus.  Memory is not allocated based on this number, just
41  * on the number of devices known to the kernel.  Having a high number does not
42  * consume additional resources.  As a special case, if there is only one
43  * device on the network and w1_max_slave_count is set to 1, the device id can
44  * be read directly skipping the normal slower search process.
45  */
46 int w1_max_slave_count = 64;
47 module_param_named(max_slave_count, w1_max_slave_count, int, 0);
48 MODULE_PARM_DESC(max_slave_count,
49 	"maximum number of slaves detected in a search");
50 
51 int w1_max_slave_ttl = 10;
52 module_param_named(slave_ttl, w1_max_slave_ttl, int, 0);
53 MODULE_PARM_DESC(slave_ttl,
54 	"Number of searches not seeing a slave before it will be removed");
55 
56 DEFINE_MUTEX(w1_mlock);
57 LIST_HEAD(w1_masters);
58 
59 static int w1_master_match(struct device *dev, struct device_driver *drv)
60 {
61 	return 1;
62 }
63 
64 static int w1_master_probe(struct device *dev)
65 {
66 	return -ENODEV;
67 }
68 
69 static void w1_master_release(struct device *dev)
70 {
71 	struct w1_master *md = dev_to_w1_master(dev);
72 
73 	dev_dbg(dev, "%s: Releasing %s.\n", __func__, md->name);
74 	memset(md, 0, sizeof(struct w1_master) + sizeof(struct w1_bus_master));
75 	kfree(md);
76 }
77 
78 static void w1_slave_release(struct device *dev)
79 {
80 	struct w1_slave *sl = dev_to_w1_slave(dev);
81 
82 	dev_dbg(dev, "%s: Releasing %s [%p]\n", __func__, sl->name, sl);
83 
84 	w1_family_put(sl->family);
85 	sl->master->slave_count--;
86 }
87 
88 static ssize_t name_show(struct device *dev, struct device_attribute *attr, char *buf)
89 {
90 	struct w1_slave *sl = dev_to_w1_slave(dev);
91 
92 	return sprintf(buf, "%s\n", sl->name);
93 }
94 static DEVICE_ATTR_RO(name);
95 
96 static ssize_t id_show(struct device *dev,
97 	struct device_attribute *attr, char *buf)
98 {
99 	struct w1_slave *sl = dev_to_w1_slave(dev);
100 	ssize_t count = sizeof(sl->reg_num);
101 
102 	memcpy(buf, (u8 *)&sl->reg_num, count);
103 	return count;
104 }
105 static DEVICE_ATTR_RO(id);
106 
107 static struct attribute *w1_slave_attrs[] = {
108 	&dev_attr_name.attr,
109 	&dev_attr_id.attr,
110 	NULL,
111 };
112 ATTRIBUTE_GROUPS(w1_slave);
113 
114 /* Default family */
115 
116 static ssize_t rw_write(struct file *filp, struct kobject *kobj,
117 			struct bin_attribute *bin_attr, char *buf, loff_t off,
118 			size_t count)
119 {
120 	struct w1_slave *sl = kobj_to_w1_slave(kobj);
121 
122 	mutex_lock(&sl->master->mutex);
123 	if (w1_reset_select_slave(sl)) {
124 		count = 0;
125 		goto out_up;
126 	}
127 
128 	w1_write_block(sl->master, buf, count);
129 
130 out_up:
131 	mutex_unlock(&sl->master->mutex);
132 	return count;
133 }
134 
135 static ssize_t rw_read(struct file *filp, struct kobject *kobj,
136 		       struct bin_attribute *bin_attr, char *buf, loff_t off,
137 		       size_t count)
138 {
139 	struct w1_slave *sl = kobj_to_w1_slave(kobj);
140 
141 	mutex_lock(&sl->master->mutex);
142 	w1_read_block(sl->master, buf, count);
143 	mutex_unlock(&sl->master->mutex);
144 	return count;
145 }
146 
147 static BIN_ATTR_RW(rw, PAGE_SIZE);
148 
149 static struct bin_attribute *w1_slave_bin_attrs[] = {
150 	&bin_attr_rw,
151 	NULL,
152 };
153 
154 static const struct attribute_group w1_slave_default_group = {
155 	.bin_attrs = w1_slave_bin_attrs,
156 };
157 
158 static const struct attribute_group *w1_slave_default_groups[] = {
159 	&w1_slave_default_group,
160 	NULL,
161 };
162 
163 static const struct w1_family_ops w1_default_fops = {
164 	.groups		= w1_slave_default_groups,
165 };
166 
167 static struct w1_family w1_default_family = {
168 	.fops = &w1_default_fops,
169 };
170 
171 static int w1_uevent(struct device *dev, struct kobj_uevent_env *env);
172 
173 static struct bus_type w1_bus_type = {
174 	.name = "w1",
175 	.match = w1_master_match,
176 	.uevent = w1_uevent,
177 };
178 
179 struct device_driver w1_master_driver = {
180 	.name = "w1_master_driver",
181 	.bus = &w1_bus_type,
182 	.probe = w1_master_probe,
183 };
184 
185 struct device w1_master_device = {
186 	.parent = NULL,
187 	.bus = &w1_bus_type,
188 	.init_name = "w1 bus master",
189 	.driver = &w1_master_driver,
190 	.release = &w1_master_release
191 };
192 
193 static struct device_driver w1_slave_driver = {
194 	.name = "w1_slave_driver",
195 	.bus = &w1_bus_type,
196 };
197 
198 #if 0
199 struct device w1_slave_device = {
200 	.parent = NULL,
201 	.bus = &w1_bus_type,
202 	.init_name = "w1 bus slave",
203 	.driver = &w1_slave_driver,
204 	.release = &w1_slave_release
205 };
206 #endif  /*  0  */
207 
208 static ssize_t w1_master_attribute_show_name(struct device *dev, struct device_attribute *attr, char *buf)
209 {
210 	struct w1_master *md = dev_to_w1_master(dev);
211 	ssize_t count;
212 
213 	mutex_lock(&md->mutex);
214 	count = sprintf(buf, "%s\n", md->name);
215 	mutex_unlock(&md->mutex);
216 
217 	return count;
218 }
219 
220 static ssize_t w1_master_attribute_store_search(struct device * dev,
221 						struct device_attribute *attr,
222 						const char * buf, size_t count)
223 {
224 	long tmp;
225 	struct w1_master *md = dev_to_w1_master(dev);
226 	int ret;
227 
228 	ret = kstrtol(buf, 0, &tmp);
229 	if (ret)
230 		return ret;
231 
232 	mutex_lock(&md->mutex);
233 	md->search_count = tmp;
234 	mutex_unlock(&md->mutex);
235 	/* Only wake if it is going to be searching. */
236 	if (tmp)
237 		wake_up_process(md->thread);
238 
239 	return count;
240 }
241 
242 static ssize_t w1_master_attribute_show_search(struct device *dev,
243 					       struct device_attribute *attr,
244 					       char *buf)
245 {
246 	struct w1_master *md = dev_to_w1_master(dev);
247 	ssize_t count;
248 
249 	mutex_lock(&md->mutex);
250 	count = sprintf(buf, "%d\n", md->search_count);
251 	mutex_unlock(&md->mutex);
252 
253 	return count;
254 }
255 
256 static ssize_t w1_master_attribute_store_pullup(struct device *dev,
257 						struct device_attribute *attr,
258 						const char *buf, size_t count)
259 {
260 	long tmp;
261 	struct w1_master *md = dev_to_w1_master(dev);
262 	int ret;
263 
264 	ret = kstrtol(buf, 0, &tmp);
265 	if (ret)
266 		return ret;
267 
268 	mutex_lock(&md->mutex);
269 	md->enable_pullup = tmp;
270 	mutex_unlock(&md->mutex);
271 
272 	return count;
273 }
274 
275 static ssize_t w1_master_attribute_show_pullup(struct device *dev,
276 					       struct device_attribute *attr,
277 					       char *buf)
278 {
279 	struct w1_master *md = dev_to_w1_master(dev);
280 	ssize_t count;
281 
282 	mutex_lock(&md->mutex);
283 	count = sprintf(buf, "%d\n", md->enable_pullup);
284 	mutex_unlock(&md->mutex);
285 
286 	return count;
287 }
288 
289 static ssize_t w1_master_attribute_show_pointer(struct device *dev, struct device_attribute *attr, char *buf)
290 {
291 	struct w1_master *md = dev_to_w1_master(dev);
292 	ssize_t count;
293 
294 	mutex_lock(&md->mutex);
295 	count = sprintf(buf, "0x%p\n", md->bus_master);
296 	mutex_unlock(&md->mutex);
297 	return count;
298 }
299 
300 static ssize_t w1_master_attribute_show_timeout(struct device *dev, struct device_attribute *attr, char *buf)
301 {
302 	ssize_t count;
303 	count = sprintf(buf, "%d\n", w1_timeout);
304 	return count;
305 }
306 
307 static ssize_t w1_master_attribute_show_timeout_us(struct device *dev,
308 	struct device_attribute *attr, char *buf)
309 {
310 	ssize_t count;
311 	count = sprintf(buf, "%d\n", w1_timeout_us);
312 	return count;
313 }
314 
315 static ssize_t w1_master_attribute_store_max_slave_count(struct device *dev,
316 	struct device_attribute *attr, const char *buf, size_t count)
317 {
318 	int tmp;
319 	struct w1_master *md = dev_to_w1_master(dev);
320 
321 	if (kstrtoint(buf, 0, &tmp) || tmp < 1)
322 		return -EINVAL;
323 
324 	mutex_lock(&md->mutex);
325 	md->max_slave_count = tmp;
326 	/* allow each time the max_slave_count is updated */
327 	clear_bit(W1_WARN_MAX_COUNT, &md->flags);
328 	mutex_unlock(&md->mutex);
329 
330 	return count;
331 }
332 
333 static ssize_t w1_master_attribute_show_max_slave_count(struct device *dev, struct device_attribute *attr, char *buf)
334 {
335 	struct w1_master *md = dev_to_w1_master(dev);
336 	ssize_t count;
337 
338 	mutex_lock(&md->mutex);
339 	count = sprintf(buf, "%d\n", md->max_slave_count);
340 	mutex_unlock(&md->mutex);
341 	return count;
342 }
343 
344 static ssize_t w1_master_attribute_show_attempts(struct device *dev, struct device_attribute *attr, char *buf)
345 {
346 	struct w1_master *md = dev_to_w1_master(dev);
347 	ssize_t count;
348 
349 	mutex_lock(&md->mutex);
350 	count = sprintf(buf, "%lu\n", md->attempts);
351 	mutex_unlock(&md->mutex);
352 	return count;
353 }
354 
355 static ssize_t w1_master_attribute_show_slave_count(struct device *dev, struct device_attribute *attr, char *buf)
356 {
357 	struct w1_master *md = dev_to_w1_master(dev);
358 	ssize_t count;
359 
360 	mutex_lock(&md->mutex);
361 	count = sprintf(buf, "%d\n", md->slave_count);
362 	mutex_unlock(&md->mutex);
363 	return count;
364 }
365 
366 static ssize_t w1_master_attribute_show_slaves(struct device *dev,
367 	struct device_attribute *attr, char *buf)
368 {
369 	struct w1_master *md = dev_to_w1_master(dev);
370 	int c = PAGE_SIZE;
371 	struct list_head *ent, *n;
372 	struct w1_slave *sl = NULL;
373 
374 	mutex_lock(&md->list_mutex);
375 
376 	list_for_each_safe(ent, n, &md->slist) {
377 		sl = list_entry(ent, struct w1_slave, w1_slave_entry);
378 
379 		c -= snprintf(buf + PAGE_SIZE - c, c, "%s\n", sl->name);
380 	}
381 	if (!sl)
382 		c -= snprintf(buf + PAGE_SIZE - c, c, "not found.\n");
383 
384 	mutex_unlock(&md->list_mutex);
385 
386 	return PAGE_SIZE - c;
387 }
388 
389 static ssize_t w1_master_attribute_show_add(struct device *dev,
390 	struct device_attribute *attr, char *buf)
391 {
392 	int c = PAGE_SIZE;
393 	c -= snprintf(buf+PAGE_SIZE - c, c,
394 		"write device id xx-xxxxxxxxxxxx to add slave\n");
395 	return PAGE_SIZE - c;
396 }
397 
398 static int w1_atoreg_num(struct device *dev, const char *buf, size_t count,
399 	struct w1_reg_num *rn)
400 {
401 	unsigned int family;
402 	unsigned long long id;
403 	int i;
404 	u64 rn64_le;
405 
406 	/* The CRC value isn't read from the user because the sysfs directory
407 	 * doesn't include it and most messages from the bus search don't
408 	 * print it either.  It would be unreasonable for the user to then
409 	 * provide it.
410 	 */
411 	const char *error_msg = "bad slave string format, expecting "
412 		"ff-dddddddddddd\n";
413 
414 	if (buf[2] != '-') {
415 		dev_err(dev, "%s", error_msg);
416 		return -EINVAL;
417 	}
418 	i = sscanf(buf, "%02x-%012llx", &family, &id);
419 	if (i != 2) {
420 		dev_err(dev, "%s", error_msg);
421 		return -EINVAL;
422 	}
423 	rn->family = family;
424 	rn->id = id;
425 
426 	rn64_le = cpu_to_le64(*(u64 *)rn);
427 	rn->crc = w1_calc_crc8((u8 *)&rn64_le, 7);
428 
429 #if 0
430 	dev_info(dev, "With CRC device is %02x.%012llx.%02x.\n",
431 		  rn->family, (unsigned long long)rn->id, rn->crc);
432 #endif
433 
434 	return 0;
435 }
436 
437 /* Searches the slaves in the w1_master and returns a pointer or NULL.
438  * Note: must not hold list_mutex
439  */
440 struct w1_slave *w1_slave_search_device(struct w1_master *dev,
441 	struct w1_reg_num *rn)
442 {
443 	struct w1_slave *sl;
444 	mutex_lock(&dev->list_mutex);
445 	list_for_each_entry(sl, &dev->slist, w1_slave_entry) {
446 		if (sl->reg_num.family == rn->family &&
447 				sl->reg_num.id == rn->id &&
448 				sl->reg_num.crc == rn->crc) {
449 			mutex_unlock(&dev->list_mutex);
450 			return sl;
451 		}
452 	}
453 	mutex_unlock(&dev->list_mutex);
454 	return NULL;
455 }
456 
457 static ssize_t w1_master_attribute_store_add(struct device *dev,
458 						struct device_attribute *attr,
459 						const char *buf, size_t count)
460 {
461 	struct w1_master *md = dev_to_w1_master(dev);
462 	struct w1_reg_num rn;
463 	struct w1_slave *sl;
464 	ssize_t result = count;
465 
466 	if (w1_atoreg_num(dev, buf, count, &rn))
467 		return -EINVAL;
468 
469 	mutex_lock(&md->mutex);
470 	sl = w1_slave_search_device(md, &rn);
471 	/* It would be nice to do a targeted search one the one-wire bus
472 	 * for the new device to see if it is out there or not.  But the
473 	 * current search doesn't support that.
474 	 */
475 	if (sl) {
476 		dev_info(dev, "Device %s already exists\n", sl->name);
477 		result = -EINVAL;
478 	} else {
479 		w1_attach_slave_device(md, &rn);
480 	}
481 	mutex_unlock(&md->mutex);
482 
483 	return result;
484 }
485 
486 static ssize_t w1_master_attribute_show_remove(struct device *dev,
487 	struct device_attribute *attr, char *buf)
488 {
489 	int c = PAGE_SIZE;
490 	c -= snprintf(buf+PAGE_SIZE - c, c,
491 		"write device id xx-xxxxxxxxxxxx to remove slave\n");
492 	return PAGE_SIZE - c;
493 }
494 
495 static ssize_t w1_master_attribute_store_remove(struct device *dev,
496 						struct device_attribute *attr,
497 						const char *buf, size_t count)
498 {
499 	struct w1_master *md = dev_to_w1_master(dev);
500 	struct w1_reg_num rn;
501 	struct w1_slave *sl;
502 	ssize_t result = count;
503 
504 	if (w1_atoreg_num(dev, buf, count, &rn))
505 		return -EINVAL;
506 
507 	mutex_lock(&md->mutex);
508 	sl = w1_slave_search_device(md, &rn);
509 	if (sl) {
510 		result = w1_slave_detach(sl);
511 		/* refcnt 0 means it was detached in the call */
512 		if (result == 0)
513 			result = count;
514 	} else {
515 		dev_info(dev, "Device %02x-%012llx doesn't exists\n", rn.family,
516 			(unsigned long long)rn.id);
517 		result = -EINVAL;
518 	}
519 	mutex_unlock(&md->mutex);
520 
521 	return result;
522 }
523 
524 #define W1_MASTER_ATTR_RO(_name, _mode)				\
525 	struct device_attribute w1_master_attribute_##_name =	\
526 		__ATTR(w1_master_##_name, _mode,		\
527 		       w1_master_attribute_show_##_name, NULL)
528 
529 #define W1_MASTER_ATTR_RW(_name, _mode)				\
530 	struct device_attribute w1_master_attribute_##_name =	\
531 		__ATTR(w1_master_##_name, _mode,		\
532 		       w1_master_attribute_show_##_name,	\
533 		       w1_master_attribute_store_##_name)
534 
535 static W1_MASTER_ATTR_RO(name, S_IRUGO);
536 static W1_MASTER_ATTR_RO(slaves, S_IRUGO);
537 static W1_MASTER_ATTR_RO(slave_count, S_IRUGO);
538 static W1_MASTER_ATTR_RW(max_slave_count, S_IRUGO | S_IWUSR | S_IWGRP);
539 static W1_MASTER_ATTR_RO(attempts, S_IRUGO);
540 static W1_MASTER_ATTR_RO(timeout, S_IRUGO);
541 static W1_MASTER_ATTR_RO(timeout_us, S_IRUGO);
542 static W1_MASTER_ATTR_RO(pointer, S_IRUGO);
543 static W1_MASTER_ATTR_RW(search, S_IRUGO | S_IWUSR | S_IWGRP);
544 static W1_MASTER_ATTR_RW(pullup, S_IRUGO | S_IWUSR | S_IWGRP);
545 static W1_MASTER_ATTR_RW(add, S_IRUGO | S_IWUSR | S_IWGRP);
546 static W1_MASTER_ATTR_RW(remove, S_IRUGO | S_IWUSR | S_IWGRP);
547 
548 static struct attribute *w1_master_default_attrs[] = {
549 	&w1_master_attribute_name.attr,
550 	&w1_master_attribute_slaves.attr,
551 	&w1_master_attribute_slave_count.attr,
552 	&w1_master_attribute_max_slave_count.attr,
553 	&w1_master_attribute_attempts.attr,
554 	&w1_master_attribute_timeout.attr,
555 	&w1_master_attribute_timeout_us.attr,
556 	&w1_master_attribute_pointer.attr,
557 	&w1_master_attribute_search.attr,
558 	&w1_master_attribute_pullup.attr,
559 	&w1_master_attribute_add.attr,
560 	&w1_master_attribute_remove.attr,
561 	NULL
562 };
563 
564 static const struct attribute_group w1_master_defattr_group = {
565 	.attrs = w1_master_default_attrs,
566 };
567 
568 int w1_create_master_attributes(struct w1_master *master)
569 {
570 	return sysfs_create_group(&master->dev.kobj, &w1_master_defattr_group);
571 }
572 
573 void w1_destroy_master_attributes(struct w1_master *master)
574 {
575 	sysfs_remove_group(&master->dev.kobj, &w1_master_defattr_group);
576 }
577 
578 static int w1_uevent(struct device *dev, struct kobj_uevent_env *env)
579 {
580 	struct w1_master *md = NULL;
581 	struct w1_slave *sl = NULL;
582 	char *event_owner, *name;
583 	int err = 0;
584 
585 	if (dev->driver == &w1_master_driver) {
586 		md = container_of(dev, struct w1_master, dev);
587 		event_owner = "master";
588 		name = md->name;
589 	} else if (dev->driver == &w1_slave_driver) {
590 		sl = container_of(dev, struct w1_slave, dev);
591 		event_owner = "slave";
592 		name = sl->name;
593 	} else {
594 		dev_dbg(dev, "Unknown event.\n");
595 		return -EINVAL;
596 	}
597 
598 	dev_dbg(dev, "Hotplug event for %s %s, bus_id=%s.\n",
599 			event_owner, name, dev_name(dev));
600 
601 	if (dev->driver != &w1_slave_driver || !sl)
602 		goto end;
603 
604 	err = add_uevent_var(env, "W1_FID=%02X", sl->reg_num.family);
605 	if (err)
606 		goto end;
607 
608 	err = add_uevent_var(env, "W1_SLAVE_ID=%024LX",
609 			     (unsigned long long)sl->reg_num.id);
610 end:
611 	return err;
612 }
613 
614 static int w1_family_notify(unsigned long action, struct w1_slave *sl)
615 {
616 	const struct w1_family_ops *fops;
617 	int err;
618 
619 	fops = sl->family->fops;
620 
621 	if (!fops)
622 		return 0;
623 
624 	switch (action) {
625 	case BUS_NOTIFY_ADD_DEVICE:
626 		/* if the family driver needs to initialize something... */
627 		if (fops->add_slave) {
628 			err = fops->add_slave(sl);
629 			if (err < 0) {
630 				dev_err(&sl->dev,
631 					"add_slave() call failed. err=%d\n",
632 					err);
633 				return err;
634 			}
635 		}
636 		if (fops->groups) {
637 			err = sysfs_create_groups(&sl->dev.kobj, fops->groups);
638 			if (err) {
639 				dev_err(&sl->dev,
640 					"sysfs group creation failed. err=%d\n",
641 					err);
642 				return err;
643 			}
644 		}
645 		if (IS_REACHABLE(CONFIG_HWMON) && fops->chip_info) {
646 			struct device *hwmon
647 				= hwmon_device_register_with_info(&sl->dev,
648 						"w1_slave_temp", sl,
649 						fops->chip_info,
650 						NULL);
651 			if (IS_ERR(hwmon)) {
652 				dev_warn(&sl->dev,
653 					 "could not create hwmon device\n");
654 			} else {
655 				sl->hwmon = hwmon;
656 			}
657 		}
658 		break;
659 	case BUS_NOTIFY_DEL_DEVICE:
660 		if (IS_REACHABLE(CONFIG_HWMON) && fops->chip_info &&
661 			    sl->hwmon)
662 			hwmon_device_unregister(sl->hwmon);
663 		if (fops->remove_slave)
664 			sl->family->fops->remove_slave(sl);
665 		if (fops->groups)
666 			sysfs_remove_groups(&sl->dev.kobj, fops->groups);
667 		break;
668 	}
669 	return 0;
670 }
671 
672 static int __w1_attach_slave_device(struct w1_slave *sl)
673 {
674 	int err;
675 
676 	sl->dev.parent = &sl->master->dev;
677 	sl->dev.driver = &w1_slave_driver;
678 	sl->dev.bus = &w1_bus_type;
679 	sl->dev.release = &w1_slave_release;
680 	sl->dev.groups = w1_slave_groups;
681 	sl->dev.of_node = of_find_matching_node(sl->master->dev.of_node,
682 						sl->family->of_match_table);
683 
684 	dev_set_name(&sl->dev, "%02x-%012llx",
685 		 (unsigned int) sl->reg_num.family,
686 		 (unsigned long long) sl->reg_num.id);
687 	snprintf(&sl->name[0], sizeof(sl->name),
688 		 "%02x-%012llx",
689 		 (unsigned int) sl->reg_num.family,
690 		 (unsigned long long) sl->reg_num.id);
691 
692 	dev_dbg(&sl->dev, "%s: registering %s as %p.\n", __func__,
693 		dev_name(&sl->dev), sl);
694 
695 	/* suppress for w1_family_notify before sending KOBJ_ADD */
696 	dev_set_uevent_suppress(&sl->dev, true);
697 
698 	err = device_register(&sl->dev);
699 	if (err < 0) {
700 		dev_err(&sl->dev,
701 			"Device registration [%s] failed. err=%d\n",
702 			dev_name(&sl->dev), err);
703 		put_device(&sl->dev);
704 		return err;
705 	}
706 	w1_family_notify(BUS_NOTIFY_ADD_DEVICE, sl);
707 
708 	dev_set_uevent_suppress(&sl->dev, false);
709 	kobject_uevent(&sl->dev.kobj, KOBJ_ADD);
710 
711 	mutex_lock(&sl->master->list_mutex);
712 	list_add_tail(&sl->w1_slave_entry, &sl->master->slist);
713 	mutex_unlock(&sl->master->list_mutex);
714 
715 	return 0;
716 }
717 
718 int w1_attach_slave_device(struct w1_master *dev, struct w1_reg_num *rn)
719 {
720 	struct w1_slave *sl;
721 	struct w1_family *f;
722 	int err;
723 	struct w1_netlink_msg msg;
724 
725 	sl = kzalloc(sizeof(struct w1_slave), GFP_KERNEL);
726 	if (!sl) {
727 		dev_err(&dev->dev,
728 			 "%s: failed to allocate new slave device.\n",
729 			 __func__);
730 		return -ENOMEM;
731 	}
732 
733 
734 	sl->owner = THIS_MODULE;
735 	sl->master = dev;
736 	set_bit(W1_SLAVE_ACTIVE, &sl->flags);
737 
738 	memset(&msg, 0, sizeof(msg));
739 	memcpy(&sl->reg_num, rn, sizeof(sl->reg_num));
740 	atomic_set(&sl->refcnt, 1);
741 	atomic_inc(&sl->master->refcnt);
742 	dev->slave_count++;
743 	dev_info(&dev->dev, "Attaching one wire slave %02x.%012llx crc %02x\n",
744 		  rn->family, (unsigned long long)rn->id, rn->crc);
745 
746 	/* slave modules need to be loaded in a context with unlocked mutex */
747 	mutex_unlock(&dev->mutex);
748 	request_module("w1-family-0x%02X", rn->family);
749 	mutex_lock(&dev->mutex);
750 
751 	spin_lock(&w1_flock);
752 	f = w1_family_registered(rn->family);
753 	if (!f) {
754 		f= &w1_default_family;
755 		dev_info(&dev->dev, "Family %x for %02x.%012llx.%02x is not registered.\n",
756 			  rn->family, rn->family,
757 			  (unsigned long long)rn->id, rn->crc);
758 	}
759 	__w1_family_get(f);
760 	spin_unlock(&w1_flock);
761 
762 	sl->family = f;
763 
764 	err = __w1_attach_slave_device(sl);
765 	if (err < 0) {
766 		dev_err(&dev->dev, "%s: Attaching %s failed.\n", __func__,
767 			 sl->name);
768 		dev->slave_count--;
769 		w1_family_put(sl->family);
770 		atomic_dec(&sl->master->refcnt);
771 		kfree(sl);
772 		return err;
773 	}
774 
775 	sl->ttl = dev->slave_ttl;
776 
777 	memcpy(msg.id.id, rn, sizeof(msg.id));
778 	msg.type = W1_SLAVE_ADD;
779 	w1_netlink_send(dev, &msg);
780 
781 	return 0;
782 }
783 
784 int w1_unref_slave(struct w1_slave *sl)
785 {
786 	struct w1_master *dev = sl->master;
787 	int refcnt;
788 	mutex_lock(&dev->list_mutex);
789 	refcnt = atomic_sub_return(1, &sl->refcnt);
790 	if (refcnt == 0) {
791 		struct w1_netlink_msg msg;
792 
793 		dev_dbg(&sl->dev, "%s: detaching %s [%p].\n", __func__,
794 			sl->name, sl);
795 
796 		list_del(&sl->w1_slave_entry);
797 
798 		memset(&msg, 0, sizeof(msg));
799 		memcpy(msg.id.id, &sl->reg_num, sizeof(msg.id));
800 		msg.type = W1_SLAVE_REMOVE;
801 		w1_netlink_send(sl->master, &msg);
802 
803 		w1_family_notify(BUS_NOTIFY_DEL_DEVICE, sl);
804 		device_unregister(&sl->dev);
805 		#ifdef DEBUG
806 		memset(sl, 0, sizeof(*sl));
807 		#endif
808 		kfree(sl);
809 	}
810 	atomic_dec(&dev->refcnt);
811 	mutex_unlock(&dev->list_mutex);
812 	return refcnt;
813 }
814 
815 int w1_slave_detach(struct w1_slave *sl)
816 {
817 	/* Only detach a slave once as it decreases the refcnt each time. */
818 	int destroy_now;
819 	mutex_lock(&sl->master->list_mutex);
820 	destroy_now = !test_bit(W1_SLAVE_DETACH, &sl->flags);
821 	set_bit(W1_SLAVE_DETACH, &sl->flags);
822 	mutex_unlock(&sl->master->list_mutex);
823 
824 	if (destroy_now)
825 		destroy_now = !w1_unref_slave(sl);
826 	return destroy_now ? 0 : -EBUSY;
827 }
828 
829 struct w1_master *w1_search_master_id(u32 id)
830 {
831 	struct w1_master *dev;
832 	int found = 0;
833 
834 	mutex_lock(&w1_mlock);
835 	list_for_each_entry(dev, &w1_masters, w1_master_entry) {
836 		if (dev->id == id) {
837 			found = 1;
838 			atomic_inc(&dev->refcnt);
839 			break;
840 		}
841 	}
842 	mutex_unlock(&w1_mlock);
843 
844 	return (found)?dev:NULL;
845 }
846 
847 struct w1_slave *w1_search_slave(struct w1_reg_num *id)
848 {
849 	struct w1_master *dev;
850 	struct w1_slave *sl = NULL;
851 	int found = 0;
852 
853 	mutex_lock(&w1_mlock);
854 	list_for_each_entry(dev, &w1_masters, w1_master_entry) {
855 		mutex_lock(&dev->list_mutex);
856 		list_for_each_entry(sl, &dev->slist, w1_slave_entry) {
857 			if (sl->reg_num.family == id->family &&
858 					sl->reg_num.id == id->id &&
859 					sl->reg_num.crc == id->crc) {
860 				found = 1;
861 				atomic_inc(&dev->refcnt);
862 				atomic_inc(&sl->refcnt);
863 				break;
864 			}
865 		}
866 		mutex_unlock(&dev->list_mutex);
867 
868 		if (found)
869 			break;
870 	}
871 	mutex_unlock(&w1_mlock);
872 
873 	return (found)?sl:NULL;
874 }
875 
876 void w1_reconnect_slaves(struct w1_family *f, int attach)
877 {
878 	struct w1_slave *sl, *sln;
879 	struct w1_master *dev;
880 
881 	mutex_lock(&w1_mlock);
882 	list_for_each_entry(dev, &w1_masters, w1_master_entry) {
883 		dev_dbg(&dev->dev, "Reconnecting slaves in device %s "
884 			"for family %02x.\n", dev->name, f->fid);
885 		mutex_lock(&dev->mutex);
886 		mutex_lock(&dev->list_mutex);
887 		list_for_each_entry_safe(sl, sln, &dev->slist, w1_slave_entry) {
888 			/* If it is a new family, slaves with the default
889 			 * family driver and are that family will be
890 			 * connected.  If the family is going away, devices
891 			 * matching that family are reconneced.
892 			 */
893 			if ((attach && sl->family->fid == W1_FAMILY_DEFAULT
894 				&& sl->reg_num.family == f->fid) ||
895 				(!attach && sl->family->fid == f->fid)) {
896 				struct w1_reg_num rn;
897 
898 				mutex_unlock(&dev->list_mutex);
899 				memcpy(&rn, &sl->reg_num, sizeof(rn));
900 				/* If it was already in use let the automatic
901 				 * scan pick it up again later.
902 				 */
903 				if (!w1_slave_detach(sl))
904 					w1_attach_slave_device(dev, &rn);
905 				mutex_lock(&dev->list_mutex);
906 			}
907 		}
908 		dev_dbg(&dev->dev, "Reconnecting slaves in device %s "
909 			"has been finished.\n", dev->name);
910 		mutex_unlock(&dev->list_mutex);
911 		mutex_unlock(&dev->mutex);
912 	}
913 	mutex_unlock(&w1_mlock);
914 }
915 
916 void w1_slave_found(struct w1_master *dev, u64 rn)
917 {
918 	struct w1_slave *sl;
919 	struct w1_reg_num *tmp;
920 	u64 rn_le = cpu_to_le64(rn);
921 
922 	atomic_inc(&dev->refcnt);
923 
924 	tmp = (struct w1_reg_num *) &rn;
925 
926 	sl = w1_slave_search_device(dev, tmp);
927 	if (sl) {
928 		set_bit(W1_SLAVE_ACTIVE, &sl->flags);
929 	} else {
930 		if (rn && tmp->crc == w1_calc_crc8((u8 *)&rn_le, 7))
931 			w1_attach_slave_device(dev, tmp);
932 	}
933 
934 	atomic_dec(&dev->refcnt);
935 }
936 
937 /**
938  * w1_search() - Performs a ROM Search & registers any devices found.
939  * @dev: The master device to search
940  * @search_type: W1_SEARCH to search all devices, or W1_ALARM_SEARCH
941  * to return only devices in the alarmed state
942  * @cb: Function to call when a device is found
943  *
944  * The 1-wire search is a simple binary tree search.
945  * For each bit of the address, we read two bits and write one bit.
946  * The bit written will put to sleep all devies that don't match that bit.
947  * When the two reads differ, the direction choice is obvious.
948  * When both bits are 0, we must choose a path to take.
949  * When we can scan all 64 bits without having to choose a path, we are done.
950  *
951  * See "Application note 187 1-wire search algorithm" at www.maxim-ic.com
952  *
953  */
954 void w1_search(struct w1_master *dev, u8 search_type, w1_slave_found_callback cb)
955 {
956 	u64 last_rn, rn, tmp64;
957 	int i, slave_count = 0;
958 	int last_zero, last_device;
959 	int search_bit, desc_bit;
960 	u8  triplet_ret = 0;
961 
962 	search_bit = 0;
963 	rn = dev->search_id;
964 	last_rn = 0;
965 	last_device = 0;
966 	last_zero = -1;
967 
968 	desc_bit = 64;
969 
970 	while ( !last_device && (slave_count++ < dev->max_slave_count) ) {
971 		last_rn = rn;
972 		rn = 0;
973 
974 		/*
975 		 * Reset bus and all 1-wire device state machines
976 		 * so they can respond to our requests.
977 		 *
978 		 * Return 0 - device(s) present, 1 - no devices present.
979 		 */
980 		mutex_lock(&dev->bus_mutex);
981 		if (w1_reset_bus(dev)) {
982 			mutex_unlock(&dev->bus_mutex);
983 			dev_dbg(&dev->dev, "No devices present on the wire.\n");
984 			break;
985 		}
986 
987 		/* Do fast search on single slave bus */
988 		if (dev->max_slave_count == 1) {
989 			int rv;
990 			w1_write_8(dev, W1_READ_ROM);
991 			rv = w1_read_block(dev, (u8 *)&rn, 8);
992 			mutex_unlock(&dev->bus_mutex);
993 
994 			if (rv == 8 && rn)
995 				cb(dev, rn);
996 
997 			break;
998 		}
999 
1000 		/* Start the search */
1001 		w1_write_8(dev, search_type);
1002 		for (i = 0; i < 64; ++i) {
1003 			/* Determine the direction/search bit */
1004 			if (i == desc_bit)
1005 				search_bit = 1;	  /* took the 0 path last time, so take the 1 path */
1006 			else if (i > desc_bit)
1007 				search_bit = 0;	  /* take the 0 path on the next branch */
1008 			else
1009 				search_bit = ((last_rn >> i) & 0x1);
1010 
1011 			/* Read two bits and write one bit */
1012 			triplet_ret = w1_triplet(dev, search_bit);
1013 
1014 			/* quit if no device responded */
1015 			if ( (triplet_ret & 0x03) == 0x03 )
1016 				break;
1017 
1018 			/* If both directions were valid, and we took the 0 path... */
1019 			if (triplet_ret == 0)
1020 				last_zero = i;
1021 
1022 			/* extract the direction taken & update the device number */
1023 			tmp64 = (triplet_ret >> 2);
1024 			rn |= (tmp64 << i);
1025 
1026 			if (test_bit(W1_ABORT_SEARCH, &dev->flags)) {
1027 				mutex_unlock(&dev->bus_mutex);
1028 				dev_dbg(&dev->dev, "Abort w1_search\n");
1029 				return;
1030 			}
1031 		}
1032 		mutex_unlock(&dev->bus_mutex);
1033 
1034 		if ( (triplet_ret & 0x03) != 0x03 ) {
1035 			if ((desc_bit == last_zero) || (last_zero < 0)) {
1036 				last_device = 1;
1037 				dev->search_id = 0;
1038 			} else {
1039 				dev->search_id = rn;
1040 			}
1041 			desc_bit = last_zero;
1042 			cb(dev, rn);
1043 		}
1044 
1045 		if (!last_device && slave_count == dev->max_slave_count &&
1046 			!test_bit(W1_WARN_MAX_COUNT, &dev->flags)) {
1047 			/* Only max_slave_count will be scanned in a search,
1048 			 * but it will start where it left off next search
1049 			 * until all ids are identified and then it will start
1050 			 * over.  A continued search will report the previous
1051 			 * last id as the first id (provided it is still on the
1052 			 * bus).
1053 			 */
1054 			dev_info(&dev->dev, "%s: max_slave_count %d reached, "
1055 				"will continue next search.\n", __func__,
1056 				dev->max_slave_count);
1057 			set_bit(W1_WARN_MAX_COUNT, &dev->flags);
1058 		}
1059 	}
1060 }
1061 
1062 void w1_search_process_cb(struct w1_master *dev, u8 search_type,
1063 	w1_slave_found_callback cb)
1064 {
1065 	struct w1_slave *sl, *sln;
1066 
1067 	mutex_lock(&dev->list_mutex);
1068 	list_for_each_entry(sl, &dev->slist, w1_slave_entry)
1069 		clear_bit(W1_SLAVE_ACTIVE, &sl->flags);
1070 	mutex_unlock(&dev->list_mutex);
1071 
1072 	w1_search_devices(dev, search_type, cb);
1073 
1074 	mutex_lock(&dev->list_mutex);
1075 	list_for_each_entry_safe(sl, sln, &dev->slist, w1_slave_entry) {
1076 		if (!test_bit(W1_SLAVE_ACTIVE, &sl->flags) && !--sl->ttl) {
1077 			mutex_unlock(&dev->list_mutex);
1078 			w1_slave_detach(sl);
1079 			mutex_lock(&dev->list_mutex);
1080 		}
1081 		else if (test_bit(W1_SLAVE_ACTIVE, &sl->flags))
1082 			sl->ttl = dev->slave_ttl;
1083 	}
1084 	mutex_unlock(&dev->list_mutex);
1085 
1086 	if (dev->search_count > 0)
1087 		dev->search_count--;
1088 }
1089 
1090 static void w1_search_process(struct w1_master *dev, u8 search_type)
1091 {
1092 	w1_search_process_cb(dev, search_type, w1_slave_found);
1093 }
1094 
1095 /**
1096  * w1_process_callbacks() - execute each dev->async_list callback entry
1097  * @dev: w1_master device
1098  *
1099  * The w1 master list_mutex must be held.
1100  *
1101  * Return: 1 if there were commands to executed 0 otherwise
1102  */
1103 int w1_process_callbacks(struct w1_master *dev)
1104 {
1105 	int ret = 0;
1106 	struct w1_async_cmd *async_cmd, *async_n;
1107 
1108 	/* The list can be added to in another thread, loop until it is empty */
1109 	while (!list_empty(&dev->async_list)) {
1110 		list_for_each_entry_safe(async_cmd, async_n, &dev->async_list,
1111 			async_entry) {
1112 			/* drop the lock, if it is a search it can take a long
1113 			 * time */
1114 			mutex_unlock(&dev->list_mutex);
1115 			async_cmd->cb(dev, async_cmd);
1116 			ret = 1;
1117 			mutex_lock(&dev->list_mutex);
1118 		}
1119 	}
1120 	return ret;
1121 }
1122 
1123 int w1_process(void *data)
1124 {
1125 	struct w1_master *dev = (struct w1_master *) data;
1126 	/* As long as w1_timeout is only set by a module parameter the sleep
1127 	 * time can be calculated in jiffies once.
1128 	 */
1129 	const unsigned long jtime =
1130 	  usecs_to_jiffies(w1_timeout * 1000000 + w1_timeout_us);
1131 	/* remainder if it woke up early */
1132 	unsigned long jremain = 0;
1133 
1134 	for (;;) {
1135 
1136 		if (!jremain && dev->search_count) {
1137 			mutex_lock(&dev->mutex);
1138 			w1_search_process(dev, W1_SEARCH);
1139 			mutex_unlock(&dev->mutex);
1140 		}
1141 
1142 		mutex_lock(&dev->list_mutex);
1143 		/* Note, w1_process_callback drops the lock while processing,
1144 		 * but locks it again before returning.
1145 		 */
1146 		if (!w1_process_callbacks(dev) && jremain) {
1147 			/* a wake up is either to stop the thread, process
1148 			 * callbacks, or search, it isn't process callbacks, so
1149 			 * schedule a search.
1150 			 */
1151 			jremain = 1;
1152 		}
1153 
1154 		__set_current_state(TASK_INTERRUPTIBLE);
1155 
1156 		/* hold list_mutex until after interruptible to prevent loosing
1157 		 * the wakeup signal when async_cmd is added.
1158 		 */
1159 		mutex_unlock(&dev->list_mutex);
1160 
1161 		if (kthread_should_stop())
1162 			break;
1163 
1164 		/* Only sleep when the search is active. */
1165 		if (dev->search_count) {
1166 			if (!jremain)
1167 				jremain = jtime;
1168 			jremain = schedule_timeout(jremain);
1169 		}
1170 		else
1171 			schedule();
1172 	}
1173 
1174 	atomic_dec(&dev->refcnt);
1175 
1176 	return 0;
1177 }
1178 
1179 static int __init w1_init(void)
1180 {
1181 	int retval;
1182 
1183 	pr_info("Driver for 1-wire Dallas network protocol.\n");
1184 
1185 	w1_init_netlink();
1186 
1187 	retval = bus_register(&w1_bus_type);
1188 	if (retval) {
1189 		pr_err("Failed to register bus. err=%d.\n", retval);
1190 		goto err_out_exit_init;
1191 	}
1192 
1193 	retval = driver_register(&w1_master_driver);
1194 	if (retval) {
1195 		pr_err("Failed to register master driver. err=%d.\n",
1196 			retval);
1197 		goto err_out_bus_unregister;
1198 	}
1199 
1200 	retval = driver_register(&w1_slave_driver);
1201 	if (retval) {
1202 		pr_err("Failed to register slave driver. err=%d.\n",
1203 			retval);
1204 		goto err_out_master_unregister;
1205 	}
1206 
1207 	return 0;
1208 
1209 #if 0
1210 /* For undoing the slave register if there was a step after it. */
1211 err_out_slave_unregister:
1212 	driver_unregister(&w1_slave_driver);
1213 #endif
1214 
1215 err_out_master_unregister:
1216 	driver_unregister(&w1_master_driver);
1217 
1218 err_out_bus_unregister:
1219 	bus_unregister(&w1_bus_type);
1220 
1221 err_out_exit_init:
1222 	return retval;
1223 }
1224 
1225 static void __exit w1_fini(void)
1226 {
1227 	struct w1_master *dev;
1228 
1229 	/* Set netlink removal messages and some cleanup */
1230 	list_for_each_entry(dev, &w1_masters, w1_master_entry)
1231 		__w1_remove_master_device(dev);
1232 
1233 	w1_fini_netlink();
1234 
1235 	driver_unregister(&w1_slave_driver);
1236 	driver_unregister(&w1_master_driver);
1237 	bus_unregister(&w1_bus_type);
1238 }
1239 
1240 module_init(w1_init);
1241 module_exit(w1_fini);
1242 
1243 MODULE_AUTHOR("Evgeniy Polyakov <zbr@ioremap.net>");
1244 MODULE_DESCRIPTION("Driver for 1-wire Dallas network protocol.");
1245 MODULE_LICENSE("GPL");
1246