1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Copyright (c) 2004 Evgeniy Polyakov <zbr@ioremap.net>
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>
22 #include <linux/atomic.h>
24 #include "w1_internal.h"
25 #include "w1_netlink.h"
27 #define W1_FAMILY_DEFAULT 0
28 #define W1_FAMILY_DS28E04 0x1C /* for crc quirk */
31 static int w1_timeout
= 10;
32 module_param_named(timeout
, w1_timeout
, int, 0);
33 MODULE_PARM_DESC(timeout
, "time in seconds between automatic slave searches");
35 static int w1_timeout_us
;
36 module_param_named(timeout_us
, w1_timeout_us
, int, 0);
37 MODULE_PARM_DESC(timeout_us
,
38 "time in microseconds between automatic slave searches");
40 /* A search stops when w1_max_slave_count devices have been found in that
41 * search. The next search will start over and detect the same set of devices
42 * on a static 1-wire bus. Memory is not allocated based on this number, just
43 * on the number of devices known to the kernel. Having a high number does not
44 * consume additional resources. As a special case, if there is only one
45 * device on the network and w1_max_slave_count is set to 1, the device id can
46 * be read directly skipping the normal slower search process.
48 int w1_max_slave_count
= 64;
49 module_param_named(max_slave_count
, w1_max_slave_count
, int, 0);
50 MODULE_PARM_DESC(max_slave_count
,
51 "maximum number of slaves detected in a search");
53 int w1_max_slave_ttl
= 10;
54 module_param_named(slave_ttl
, w1_max_slave_ttl
, int, 0);
55 MODULE_PARM_DESC(slave_ttl
,
56 "Number of searches not seeing a slave before it will be removed");
58 DEFINE_MUTEX(w1_mlock
);
59 LIST_HEAD(w1_masters
);
61 static int w1_master_probe(struct device
*dev
)
66 static void w1_master_release(struct device
*dev
)
68 struct w1_master
*md
= dev_to_w1_master(dev
);
70 dev_dbg(dev
, "%s: Releasing %s.\n", __func__
, md
->name
);
71 memset(md
, 0, sizeof(struct w1_master
) + sizeof(struct w1_bus_master
));
75 static void w1_slave_release(struct device
*dev
)
77 struct w1_slave
*sl
= dev_to_w1_slave(dev
);
79 dev_dbg(dev
, "%s: Releasing %s [%p]\n", __func__
, sl
->name
, sl
);
81 w1_family_put(sl
->family
);
82 sl
->master
->slave_count
--;
85 static ssize_t
name_show(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
87 struct w1_slave
*sl
= dev_to_w1_slave(dev
);
89 return sprintf(buf
, "%s\n", sl
->name
);
91 static DEVICE_ATTR_RO(name
);
93 static ssize_t
id_show(struct device
*dev
,
94 struct device_attribute
*attr
, char *buf
)
96 struct w1_slave
*sl
= dev_to_w1_slave(dev
);
97 ssize_t count
= sizeof(sl
->reg_num
);
99 memcpy(buf
, (u8
*)&sl
->reg_num
, count
);
102 static DEVICE_ATTR_RO(id
);
104 static struct attribute
*w1_slave_attrs
[] = {
109 ATTRIBUTE_GROUPS(w1_slave
);
113 static ssize_t
rw_write(struct file
*filp
, struct kobject
*kobj
,
114 struct bin_attribute
*bin_attr
, char *buf
, loff_t off
,
117 struct w1_slave
*sl
= kobj_to_w1_slave(kobj
);
119 mutex_lock(&sl
->master
->mutex
);
120 if (w1_reset_select_slave(sl
)) {
125 w1_write_block(sl
->master
, buf
, count
);
128 mutex_unlock(&sl
->master
->mutex
);
132 static ssize_t
rw_read(struct file
*filp
, struct kobject
*kobj
,
133 struct bin_attribute
*bin_attr
, char *buf
, loff_t off
,
136 struct w1_slave
*sl
= kobj_to_w1_slave(kobj
);
138 mutex_lock(&sl
->master
->mutex
);
139 w1_read_block(sl
->master
, buf
, count
);
140 mutex_unlock(&sl
->master
->mutex
);
144 static BIN_ATTR_RW(rw
, PAGE_SIZE
);
146 static struct bin_attribute
*w1_slave_bin_attrs
[] = {
151 static const struct attribute_group w1_slave_default_group
= {
152 .bin_attrs
= w1_slave_bin_attrs
,
155 static const struct attribute_group
*w1_slave_default_groups
[] = {
156 &w1_slave_default_group
,
160 static const struct w1_family_ops w1_default_fops
= {
161 .groups
= w1_slave_default_groups
,
164 static struct w1_family w1_default_family
= {
165 .fops
= &w1_default_fops
,
168 static int w1_uevent(const struct device
*dev
, struct kobj_uevent_env
*env
);
170 static const struct bus_type w1_bus_type
= {
175 struct device_driver w1_master_driver
= {
176 .name
= "w1_master_driver",
178 .probe
= w1_master_probe
,
181 struct device w1_master_device
= {
184 .init_name
= "w1 bus master",
185 .driver
= &w1_master_driver
,
186 .release
= &w1_master_release
189 static struct device_driver w1_slave_driver
= {
190 .name
= "w1_slave_driver",
195 struct device w1_slave_device
= {
198 .init_name
= "w1 bus slave",
199 .driver
= &w1_slave_driver
,
200 .release
= &w1_slave_release
204 static ssize_t
w1_master_attribute_show_name(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
206 struct w1_master
*md
= dev_to_w1_master(dev
);
209 mutex_lock(&md
->mutex
);
210 count
= sprintf(buf
, "%s\n", md
->name
);
211 mutex_unlock(&md
->mutex
);
216 static ssize_t
w1_master_attribute_store_search(struct device
* dev
,
217 struct device_attribute
*attr
,
218 const char * buf
, size_t count
)
221 struct w1_master
*md
= dev_to_w1_master(dev
);
224 ret
= kstrtol(buf
, 0, &tmp
);
228 mutex_lock(&md
->mutex
);
229 md
->search_count
= tmp
;
230 mutex_unlock(&md
->mutex
);
231 /* Only wake if it is going to be searching. */
233 wake_up_process(md
->thread
);
238 static ssize_t
w1_master_attribute_show_search(struct device
*dev
,
239 struct device_attribute
*attr
,
242 struct w1_master
*md
= dev_to_w1_master(dev
);
245 mutex_lock(&md
->mutex
);
246 count
= sprintf(buf
, "%d\n", md
->search_count
);
247 mutex_unlock(&md
->mutex
);
252 static ssize_t
w1_master_attribute_store_pullup(struct device
*dev
,
253 struct device_attribute
*attr
,
254 const char *buf
, size_t count
)
257 struct w1_master
*md
= dev_to_w1_master(dev
);
260 ret
= kstrtol(buf
, 0, &tmp
);
264 mutex_lock(&md
->mutex
);
265 md
->enable_pullup
= tmp
;
266 mutex_unlock(&md
->mutex
);
271 static ssize_t
w1_master_attribute_show_pullup(struct device
*dev
,
272 struct device_attribute
*attr
,
275 struct w1_master
*md
= dev_to_w1_master(dev
);
278 mutex_lock(&md
->mutex
);
279 count
= sprintf(buf
, "%d\n", md
->enable_pullup
);
280 mutex_unlock(&md
->mutex
);
285 static ssize_t
w1_master_attribute_show_pointer(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
287 struct w1_master
*md
= dev_to_w1_master(dev
);
290 mutex_lock(&md
->mutex
);
291 count
= sprintf(buf
, "0x%p\n", md
->bus_master
);
292 mutex_unlock(&md
->mutex
);
296 static ssize_t
w1_master_attribute_show_timeout(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
298 return sprintf(buf
, "%d\n", w1_timeout
);
301 static ssize_t
w1_master_attribute_show_timeout_us(struct device
*dev
,
302 struct device_attribute
*attr
, char *buf
)
304 return sprintf(buf
, "%d\n", w1_timeout_us
);
307 static ssize_t
w1_master_attribute_store_max_slave_count(struct device
*dev
,
308 struct device_attribute
*attr
, const char *buf
, size_t count
)
311 struct w1_master
*md
= dev_to_w1_master(dev
);
313 if (kstrtoint(buf
, 0, &tmp
) || tmp
< 1)
316 mutex_lock(&md
->mutex
);
317 md
->max_slave_count
= tmp
;
318 /* allow each time the max_slave_count is updated */
319 clear_bit(W1_WARN_MAX_COUNT
, &md
->flags
);
320 mutex_unlock(&md
->mutex
);
325 static ssize_t
w1_master_attribute_show_max_slave_count(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
327 struct w1_master
*md
= dev_to_w1_master(dev
);
330 mutex_lock(&md
->mutex
);
331 count
= sprintf(buf
, "%d\n", md
->max_slave_count
);
332 mutex_unlock(&md
->mutex
);
336 static ssize_t
w1_master_attribute_show_attempts(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
338 struct w1_master
*md
= dev_to_w1_master(dev
);
341 mutex_lock(&md
->mutex
);
342 count
= sprintf(buf
, "%lu\n", md
->attempts
);
343 mutex_unlock(&md
->mutex
);
347 static ssize_t
w1_master_attribute_show_slave_count(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
349 struct w1_master
*md
= dev_to_w1_master(dev
);
352 mutex_lock(&md
->mutex
);
353 count
= sprintf(buf
, "%d\n", md
->slave_count
);
354 mutex_unlock(&md
->mutex
);
358 static ssize_t
w1_master_attribute_show_slaves(struct device
*dev
,
359 struct device_attribute
*attr
, char *buf
)
361 struct w1_master
*md
= dev_to_w1_master(dev
);
363 struct list_head
*ent
, *n
;
364 struct w1_slave
*sl
= NULL
;
366 mutex_lock(&md
->list_mutex
);
368 list_for_each_safe(ent
, n
, &md
->slist
) {
369 sl
= list_entry(ent
, struct w1_slave
, w1_slave_entry
);
371 c
-= snprintf(buf
+ PAGE_SIZE
- c
, c
, "%s\n", sl
->name
);
374 c
-= snprintf(buf
+ PAGE_SIZE
- c
, c
, "not found.\n");
376 mutex_unlock(&md
->list_mutex
);
378 return PAGE_SIZE
- c
;
381 static ssize_t
w1_master_attribute_show_add(struct device
*dev
,
382 struct device_attribute
*attr
, char *buf
)
385 c
-= snprintf(buf
+PAGE_SIZE
- c
, c
,
386 "write device id xx-xxxxxxxxxxxx to add slave\n");
387 return PAGE_SIZE
- c
;
390 static int w1_atoreg_num(struct device
*dev
, const char *buf
, size_t count
,
391 struct w1_reg_num
*rn
)
394 unsigned long long id
;
398 /* The CRC value isn't read from the user because the sysfs directory
399 * doesn't include it and most messages from the bus search don't
400 * print it either. It would be unreasonable for the user to then
403 const char *error_msg
= "bad slave string format, expecting "
407 dev_err(dev
, "%s", error_msg
);
410 i
= sscanf(buf
, "%02x-%012llx", &family
, &id
);
412 dev_err(dev
, "%s", error_msg
);
418 rn64_le
= cpu_to_le64(*(u64
*)rn
);
419 rn
->crc
= w1_calc_crc8((u8
*)&rn64_le
, 7);
422 dev_info(dev
, "With CRC device is %02x.%012llx.%02x.\n",
423 rn
->family
, (unsigned long long)rn
->id
, rn
->crc
);
429 /* Searches the slaves in the w1_master and returns a pointer or NULL.
430 * Note: must not hold list_mutex
432 struct w1_slave
*w1_slave_search_device(struct w1_master
*dev
,
433 struct w1_reg_num
*rn
)
436 mutex_lock(&dev
->list_mutex
);
437 list_for_each_entry(sl
, &dev
->slist
, w1_slave_entry
) {
438 if (sl
->reg_num
.family
== rn
->family
&&
439 sl
->reg_num
.id
== rn
->id
&&
440 sl
->reg_num
.crc
== rn
->crc
) {
441 mutex_unlock(&dev
->list_mutex
);
445 mutex_unlock(&dev
->list_mutex
);
449 static ssize_t
w1_master_attribute_store_add(struct device
*dev
,
450 struct device_attribute
*attr
,
451 const char *buf
, size_t count
)
453 struct w1_master
*md
= dev_to_w1_master(dev
);
454 struct w1_reg_num rn
;
456 ssize_t result
= count
;
458 if (w1_atoreg_num(dev
, buf
, count
, &rn
))
461 mutex_lock(&md
->mutex
);
462 sl
= w1_slave_search_device(md
, &rn
);
463 /* It would be nice to do a targeted search one the one-wire bus
464 * for the new device to see if it is out there or not. But the
465 * current search doesn't support that.
468 dev_info(dev
, "Device %s already exists\n", sl
->name
);
471 w1_attach_slave_device(md
, &rn
);
473 mutex_unlock(&md
->mutex
);
478 static ssize_t
w1_master_attribute_show_remove(struct device
*dev
,
479 struct device_attribute
*attr
, char *buf
)
482 c
-= snprintf(buf
+PAGE_SIZE
- c
, c
,
483 "write device id xx-xxxxxxxxxxxx to remove slave\n");
484 return PAGE_SIZE
- c
;
487 static ssize_t
w1_master_attribute_store_remove(struct device
*dev
,
488 struct device_attribute
*attr
,
489 const char *buf
, size_t count
)
491 struct w1_master
*md
= dev_to_w1_master(dev
);
492 struct w1_reg_num rn
;
496 if (w1_atoreg_num(dev
, buf
, count
, &rn
))
499 mutex_lock(&md
->mutex
);
500 sl
= w1_slave_search_device(md
, &rn
);
502 result
= w1_slave_detach(sl
);
503 /* refcnt 0 means it was detached in the call */
507 dev_info(dev
, "Device %02x-%012llx doesn't exist\n", rn
.family
,
508 (unsigned long long)rn
.id
);
511 mutex_unlock(&md
->mutex
);
516 #define W1_MASTER_ATTR_RO(_name, _mode) \
517 struct device_attribute w1_master_attribute_##_name = \
518 __ATTR(w1_master_##_name, _mode, \
519 w1_master_attribute_show_##_name, NULL)
521 #define W1_MASTER_ATTR_RW(_name, _mode) \
522 struct device_attribute w1_master_attribute_##_name = \
523 __ATTR(w1_master_##_name, _mode, \
524 w1_master_attribute_show_##_name, \
525 w1_master_attribute_store_##_name)
527 static W1_MASTER_ATTR_RO(name
, S_IRUGO
);
528 static W1_MASTER_ATTR_RO(slaves
, S_IRUGO
);
529 static W1_MASTER_ATTR_RO(slave_count
, S_IRUGO
);
530 static W1_MASTER_ATTR_RW(max_slave_count
, S_IRUGO
| S_IWUSR
| S_IWGRP
);
531 static W1_MASTER_ATTR_RO(attempts
, S_IRUGO
);
532 static W1_MASTER_ATTR_RO(timeout
, S_IRUGO
);
533 static W1_MASTER_ATTR_RO(timeout_us
, S_IRUGO
);
534 static W1_MASTER_ATTR_RO(pointer
, S_IRUGO
);
535 static W1_MASTER_ATTR_RW(search
, S_IRUGO
| S_IWUSR
| S_IWGRP
);
536 static W1_MASTER_ATTR_RW(pullup
, S_IRUGO
| S_IWUSR
| S_IWGRP
);
537 static W1_MASTER_ATTR_RW(add
, S_IRUGO
| S_IWUSR
| S_IWGRP
);
538 static W1_MASTER_ATTR_RW(remove
, S_IRUGO
| S_IWUSR
| S_IWGRP
);
540 static struct attribute
*w1_master_default_attrs
[] = {
541 &w1_master_attribute_name
.attr
,
542 &w1_master_attribute_slaves
.attr
,
543 &w1_master_attribute_slave_count
.attr
,
544 &w1_master_attribute_max_slave_count
.attr
,
545 &w1_master_attribute_attempts
.attr
,
546 &w1_master_attribute_timeout
.attr
,
547 &w1_master_attribute_timeout_us
.attr
,
548 &w1_master_attribute_pointer
.attr
,
549 &w1_master_attribute_search
.attr
,
550 &w1_master_attribute_pullup
.attr
,
551 &w1_master_attribute_add
.attr
,
552 &w1_master_attribute_remove
.attr
,
556 static const struct attribute_group w1_master_defattr_group
= {
557 .attrs
= w1_master_default_attrs
,
560 int w1_create_master_attributes(struct w1_master
*master
)
562 return sysfs_create_group(&master
->dev
.kobj
, &w1_master_defattr_group
);
565 void w1_destroy_master_attributes(struct w1_master
*master
)
567 sysfs_remove_group(&master
->dev
.kobj
, &w1_master_defattr_group
);
570 static int w1_uevent(const struct device
*dev
, struct kobj_uevent_env
*env
)
572 const struct w1_master
*md
= NULL
;
573 const struct w1_slave
*sl
= NULL
;
574 const char *event_owner
, *name
;
577 if (dev
->driver
== &w1_master_driver
) {
578 md
= container_of(dev
, struct w1_master
, dev
);
579 event_owner
= "master";
581 } else if (dev
->driver
== &w1_slave_driver
) {
582 sl
= container_of(dev
, struct w1_slave
, dev
);
583 event_owner
= "slave";
586 dev_dbg(dev
, "Unknown event.\n");
590 dev_dbg(dev
, "Hotplug event for %s %s, bus_id=%s.\n",
591 event_owner
, name
, dev_name(dev
));
593 if (dev
->driver
!= &w1_slave_driver
|| !sl
)
596 err
= add_uevent_var(env
, "W1_FID=%02X", sl
->reg_num
.family
);
600 err
= add_uevent_var(env
, "W1_SLAVE_ID=%024LX",
601 (unsigned long long)sl
->reg_num
.id
);
606 static int w1_family_notify(unsigned long action
, struct w1_slave
*sl
)
608 const struct w1_family_ops
*fops
;
611 fops
= sl
->family
->fops
;
617 case BUS_NOTIFY_ADD_DEVICE
:
618 /* if the family driver needs to initialize something... */
619 if (fops
->add_slave
) {
620 err
= fops
->add_slave(sl
);
623 "add_slave() call failed. err=%d\n",
629 err
= sysfs_create_groups(&sl
->dev
.kobj
, fops
->groups
);
632 "sysfs group creation failed. err=%d\n",
637 if (IS_REACHABLE(CONFIG_HWMON
) && fops
->chip_info
) {
639 = hwmon_device_register_with_info(&sl
->dev
,
645 "could not create hwmon device\n");
651 case BUS_NOTIFY_DEL_DEVICE
:
652 if (IS_REACHABLE(CONFIG_HWMON
) && fops
->chip_info
&&
654 hwmon_device_unregister(sl
->hwmon
);
655 if (fops
->remove_slave
)
656 sl
->family
->fops
->remove_slave(sl
);
658 sysfs_remove_groups(&sl
->dev
.kobj
, fops
->groups
);
664 static int __w1_attach_slave_device(struct w1_slave
*sl
)
668 sl
->dev
.parent
= &sl
->master
->dev
;
669 sl
->dev
.driver
= &w1_slave_driver
;
670 sl
->dev
.bus
= &w1_bus_type
;
671 sl
->dev
.release
= &w1_slave_release
;
672 sl
->dev
.groups
= w1_slave_groups
;
673 sl
->dev
.of_node
= of_find_matching_node(sl
->master
->dev
.of_node
,
674 sl
->family
->of_match_table
);
676 dev_set_name(&sl
->dev
, "%02x-%012llx",
677 (unsigned int) sl
->reg_num
.family
,
678 (unsigned long long) sl
->reg_num
.id
);
679 snprintf(&sl
->name
[0], sizeof(sl
->name
),
681 (unsigned int) sl
->reg_num
.family
,
682 (unsigned long long) sl
->reg_num
.id
);
684 dev_dbg(&sl
->dev
, "%s: registering %s as %p.\n", __func__
,
685 dev_name(&sl
->dev
), sl
);
687 /* suppress for w1_family_notify before sending KOBJ_ADD */
688 dev_set_uevent_suppress(&sl
->dev
, true);
690 err
= device_register(&sl
->dev
);
693 "Device registration [%s] failed. err=%d\n",
694 dev_name(&sl
->dev
), err
);
695 of_node_put(sl
->dev
.of_node
);
696 put_device(&sl
->dev
);
699 w1_family_notify(BUS_NOTIFY_ADD_DEVICE
, sl
);
701 dev_set_uevent_suppress(&sl
->dev
, false);
702 kobject_uevent(&sl
->dev
.kobj
, KOBJ_ADD
);
704 mutex_lock(&sl
->master
->list_mutex
);
705 list_add_tail(&sl
->w1_slave_entry
, &sl
->master
->slist
);
706 mutex_unlock(&sl
->master
->list_mutex
);
711 int w1_attach_slave_device(struct w1_master
*dev
, struct w1_reg_num
*rn
)
716 struct w1_netlink_msg msg
;
718 sl
= kzalloc(sizeof(struct w1_slave
), GFP_KERNEL
);
721 "%s: failed to allocate new slave device.\n",
727 sl
->owner
= THIS_MODULE
;
729 set_bit(W1_SLAVE_ACTIVE
, &sl
->flags
);
731 memset(&msg
, 0, sizeof(msg
));
732 memcpy(&sl
->reg_num
, rn
, sizeof(sl
->reg_num
));
733 atomic_set(&sl
->refcnt
, 1);
734 atomic_inc(&sl
->master
->refcnt
);
736 dev_info(&dev
->dev
, "Attaching one wire slave %02x.%012llx crc %02x\n",
737 rn
->family
, (unsigned long long)rn
->id
, rn
->crc
);
739 /* slave modules need to be loaded in a context with unlocked mutex */
740 mutex_unlock(&dev
->mutex
);
741 request_module("w1-family-0x%02X", rn
->family
);
742 mutex_lock(&dev
->mutex
);
744 spin_lock(&w1_flock
);
745 f
= w1_family_registered(rn
->family
);
747 f
= &w1_default_family
;
748 dev_info(&dev
->dev
, "Family %x for %02x.%012llx.%02x is not registered.\n",
749 rn
->family
, rn
->family
,
750 (unsigned long long)rn
->id
, rn
->crc
);
753 spin_unlock(&w1_flock
);
757 err
= __w1_attach_slave_device(sl
);
759 dev_err(&dev
->dev
, "%s: Attaching %s failed.\n", __func__
,
762 w1_family_put(sl
->family
);
763 atomic_dec(&sl
->master
->refcnt
);
768 sl
->ttl
= dev
->slave_ttl
;
770 memcpy(msg
.id
.id
, rn
, sizeof(msg
.id
));
771 msg
.type
= W1_SLAVE_ADD
;
772 w1_netlink_send(dev
, &msg
);
777 int w1_unref_slave(struct w1_slave
*sl
)
779 struct w1_master
*dev
= sl
->master
;
781 mutex_lock(&dev
->list_mutex
);
782 refcnt
= atomic_sub_return(1, &sl
->refcnt
);
784 struct w1_netlink_msg msg
;
786 dev_dbg(&sl
->dev
, "%s: detaching %s [%p].\n", __func__
,
789 list_del(&sl
->w1_slave_entry
);
791 memset(&msg
, 0, sizeof(msg
));
792 memcpy(msg
.id
.id
, &sl
->reg_num
, sizeof(msg
.id
));
793 msg
.type
= W1_SLAVE_REMOVE
;
794 w1_netlink_send(sl
->master
, &msg
);
796 w1_family_notify(BUS_NOTIFY_DEL_DEVICE
, sl
);
797 device_unregister(&sl
->dev
);
799 memset(sl
, 0, sizeof(*sl
));
803 atomic_dec(&dev
->refcnt
);
804 mutex_unlock(&dev
->list_mutex
);
808 int w1_slave_detach(struct w1_slave
*sl
)
810 /* Only detach a slave once as it decreases the refcnt each time. */
812 mutex_lock(&sl
->master
->list_mutex
);
813 destroy_now
= !test_bit(W1_SLAVE_DETACH
, &sl
->flags
);
814 set_bit(W1_SLAVE_DETACH
, &sl
->flags
);
815 mutex_unlock(&sl
->master
->list_mutex
);
818 destroy_now
= !w1_unref_slave(sl
);
819 return destroy_now
? 0 : -EBUSY
;
822 struct w1_master
*w1_search_master_id(u32 id
)
824 struct w1_master
*dev
= NULL
, *iter
;
826 mutex_lock(&w1_mlock
);
827 list_for_each_entry(iter
, &w1_masters
, w1_master_entry
) {
828 if (iter
->id
== id
) {
830 atomic_inc(&iter
->refcnt
);
834 mutex_unlock(&w1_mlock
);
839 struct w1_slave
*w1_search_slave(struct w1_reg_num
*id
)
841 struct w1_master
*dev
;
842 struct w1_slave
*sl
= NULL
, *iter
;
844 mutex_lock(&w1_mlock
);
845 list_for_each_entry(dev
, &w1_masters
, w1_master_entry
) {
846 mutex_lock(&dev
->list_mutex
);
847 list_for_each_entry(iter
, &dev
->slist
, w1_slave_entry
) {
848 if (iter
->reg_num
.family
== id
->family
&&
849 iter
->reg_num
.id
== id
->id
&&
850 iter
->reg_num
.crc
== id
->crc
) {
852 atomic_inc(&dev
->refcnt
);
853 atomic_inc(&iter
->refcnt
);
857 mutex_unlock(&dev
->list_mutex
);
862 mutex_unlock(&w1_mlock
);
867 void w1_reconnect_slaves(struct w1_family
*f
, int attach
)
869 struct w1_slave
*sl
, *sln
;
870 struct w1_master
*dev
;
872 mutex_lock(&w1_mlock
);
873 list_for_each_entry(dev
, &w1_masters
, w1_master_entry
) {
874 dev_dbg(&dev
->dev
, "Reconnecting slaves in device %s "
875 "for family %02x.\n", dev
->name
, f
->fid
);
876 mutex_lock(&dev
->mutex
);
877 mutex_lock(&dev
->list_mutex
);
878 list_for_each_entry_safe(sl
, sln
, &dev
->slist
, w1_slave_entry
) {
879 /* If it is a new family, slaves with the default
880 * family driver and are that family will be
881 * connected. If the family is going away, devices
882 * matching that family are reconneced.
884 if ((attach
&& sl
->family
->fid
== W1_FAMILY_DEFAULT
885 && sl
->reg_num
.family
== f
->fid
) ||
886 (!attach
&& sl
->family
->fid
== f
->fid
)) {
887 struct w1_reg_num rn
;
889 mutex_unlock(&dev
->list_mutex
);
890 memcpy(&rn
, &sl
->reg_num
, sizeof(rn
));
891 /* If it was already in use let the automatic
892 * scan pick it up again later.
894 if (!w1_slave_detach(sl
))
895 w1_attach_slave_device(dev
, &rn
);
896 mutex_lock(&dev
->list_mutex
);
899 dev_dbg(&dev
->dev
, "Reconnecting slaves in device %s "
900 "has been finished.\n", dev
->name
);
901 mutex_unlock(&dev
->list_mutex
);
902 mutex_unlock(&dev
->mutex
);
904 mutex_unlock(&w1_mlock
);
907 static int w1_addr_crc_is_valid(struct w1_master
*dev
, u64 rn
)
909 u64 rn_le
= cpu_to_le64(rn
);
910 struct w1_reg_num
*tmp
= (struct w1_reg_num
*)&rn
;
913 crc
= w1_calc_crc8((u8
*)&rn_le
, 7);
916 * DS28E04 (1w eeprom) has strapping pins to change
917 * address, but will not update the crc. So normal rules
918 * for consistent w1 addresses are violated. We test
919 * with the 7 LSBs of the address forced high.
921 * (char*)&rn_le = { family, addr_lsb, ..., addr_msb, crc }.
923 if (crc
!= tmp
->crc
&& tmp
->family
== W1_FAMILY_DS28E04
) {
926 ((u8
*)&corr_le
)[1] |= 0x7f;
927 crc
= w1_calc_crc8((u8
*)&corr_le
, 7);
929 dev_info(&dev
->dev
, "DS28E04 crc workaround on %02x.%012llx.%02x\n",
930 tmp
->family
, (unsigned long long)tmp
->id
, tmp
->crc
);
933 if (crc
!= tmp
->crc
) {
934 dev_dbg(&dev
->dev
, "w1 addr crc mismatch: %02x.%012llx.%02x != 0x%02x.\n",
935 tmp
->family
, (unsigned long long)tmp
->id
, tmp
->crc
, crc
);
941 void w1_slave_found(struct w1_master
*dev
, u64 rn
)
944 struct w1_reg_num
*tmp
;
946 atomic_inc(&dev
->refcnt
);
948 tmp
= (struct w1_reg_num
*) &rn
;
950 sl
= w1_slave_search_device(dev
, tmp
);
952 set_bit(W1_SLAVE_ACTIVE
, &sl
->flags
);
954 if (rn
&& w1_addr_crc_is_valid(dev
, rn
))
955 w1_attach_slave_device(dev
, tmp
);
958 atomic_dec(&dev
->refcnt
);
962 * w1_search() - Performs a ROM Search & registers any devices found.
963 * @dev: The master device to search
964 * @search_type: W1_SEARCH to search all devices, or W1_ALARM_SEARCH
965 * to return only devices in the alarmed state
966 * @cb: Function to call when a device is found
968 * The 1-wire search is a simple binary tree search.
969 * For each bit of the address, we read two bits and write one bit.
970 * The bit written will put to sleep all devies that don't match that bit.
971 * When the two reads differ, the direction choice is obvious.
972 * When both bits are 0, we must choose a path to take.
973 * When we can scan all 64 bits without having to choose a path, we are done.
975 * See "Application note 187 1-wire search algorithm" at www.maxim-ic.com
978 void w1_search(struct w1_master
*dev
, u8 search_type
, w1_slave_found_callback cb
)
980 u64 last_rn
, rn
, tmp64
;
981 int i
, slave_count
= 0;
982 int last_zero
, last_device
;
983 int search_bit
, desc_bit
;
994 while ( !last_device
&& (slave_count
++ < dev
->max_slave_count
) ) {
999 * Reset bus and all 1-wire device state machines
1000 * so they can respond to our requests.
1002 * Return 0 - device(s) present, 1 - no devices present.
1004 mutex_lock(&dev
->bus_mutex
);
1005 if (w1_reset_bus(dev
)) {
1006 mutex_unlock(&dev
->bus_mutex
);
1007 dev_dbg(&dev
->dev
, "No devices present on the wire.\n");
1011 /* Do fast search on single slave bus */
1012 if (dev
->max_slave_count
== 1) {
1014 w1_write_8(dev
, W1_READ_ROM
);
1015 rv
= w1_read_block(dev
, (u8
*)&rn
, 8);
1016 mutex_unlock(&dev
->bus_mutex
);
1024 /* Start the search */
1025 w1_write_8(dev
, search_type
);
1026 for (i
= 0; i
< 64; ++i
) {
1027 /* Determine the direction/search bit */
1029 search_bit
= 1; /* took the 0 path last time, so take the 1 path */
1030 else if (i
> desc_bit
)
1031 search_bit
= 0; /* take the 0 path on the next branch */
1033 search_bit
= ((last_rn
>> i
) & 0x1);
1035 /* Read two bits and write one bit */
1036 triplet_ret
= w1_triplet(dev
, search_bit
);
1038 /* quit if no device responded */
1039 if ( (triplet_ret
& 0x03) == 0x03 )
1042 /* If both directions were valid, and we took the 0 path... */
1043 if (triplet_ret
== 0)
1046 /* extract the direction taken & update the device number */
1047 tmp64
= (triplet_ret
>> 2);
1050 if (test_bit(W1_ABORT_SEARCH
, &dev
->flags
)) {
1051 mutex_unlock(&dev
->bus_mutex
);
1052 dev_dbg(&dev
->dev
, "Abort w1_search\n");
1056 mutex_unlock(&dev
->bus_mutex
);
1058 if ( (triplet_ret
& 0x03) != 0x03 ) {
1059 if ((desc_bit
== last_zero
) || (last_zero
< 0)) {
1063 dev
->search_id
= rn
;
1065 desc_bit
= last_zero
;
1069 if (!last_device
&& slave_count
== dev
->max_slave_count
&&
1070 !test_bit(W1_WARN_MAX_COUNT
, &dev
->flags
)) {
1071 /* Only max_slave_count will be scanned in a search,
1072 * but it will start where it left off next search
1073 * until all ids are identified and then it will start
1074 * over. A continued search will report the previous
1075 * last id as the first id (provided it is still on the
1078 dev_info(&dev
->dev
, "%s: max_slave_count %d reached, "
1079 "will continue next search.\n", __func__
,
1080 dev
->max_slave_count
);
1081 set_bit(W1_WARN_MAX_COUNT
, &dev
->flags
);
1086 void w1_search_process_cb(struct w1_master
*dev
, u8 search_type
,
1087 w1_slave_found_callback cb
)
1089 struct w1_slave
*sl
, *sln
;
1091 mutex_lock(&dev
->list_mutex
);
1092 list_for_each_entry(sl
, &dev
->slist
, w1_slave_entry
)
1093 clear_bit(W1_SLAVE_ACTIVE
, &sl
->flags
);
1094 mutex_unlock(&dev
->list_mutex
);
1096 w1_search_devices(dev
, search_type
, cb
);
1098 mutex_lock(&dev
->list_mutex
);
1099 list_for_each_entry_safe(sl
, sln
, &dev
->slist
, w1_slave_entry
) {
1100 if (!test_bit(W1_SLAVE_ACTIVE
, &sl
->flags
) && !--sl
->ttl
) {
1101 mutex_unlock(&dev
->list_mutex
);
1102 w1_slave_detach(sl
);
1103 mutex_lock(&dev
->list_mutex
);
1105 else if (test_bit(W1_SLAVE_ACTIVE
, &sl
->flags
))
1106 sl
->ttl
= dev
->slave_ttl
;
1108 mutex_unlock(&dev
->list_mutex
);
1110 if (dev
->search_count
> 0)
1111 dev
->search_count
--;
1114 static void w1_search_process(struct w1_master
*dev
, u8 search_type
)
1116 w1_search_process_cb(dev
, search_type
, w1_slave_found
);
1120 * w1_process_callbacks() - execute each dev->async_list callback entry
1121 * @dev: w1_master device
1123 * The w1 master list_mutex must be held.
1125 * Return: 1 if there were commands to executed 0 otherwise
1127 int w1_process_callbacks(struct w1_master
*dev
)
1130 struct w1_async_cmd
*async_cmd
, *async_n
;
1132 /* The list can be added to in another thread, loop until it is empty */
1133 while (!list_empty(&dev
->async_list
)) {
1134 list_for_each_entry_safe(async_cmd
, async_n
, &dev
->async_list
,
1136 /* drop the lock, if it is a search it can take a long
1138 mutex_unlock(&dev
->list_mutex
);
1139 async_cmd
->cb(dev
, async_cmd
);
1141 mutex_lock(&dev
->list_mutex
);
1147 int w1_process(void *data
)
1149 struct w1_master
*dev
= (struct w1_master
*) data
;
1150 /* As long as w1_timeout is only set by a module parameter the sleep
1151 * time can be calculated in jiffies once.
1153 const unsigned long jtime
=
1154 usecs_to_jiffies(w1_timeout
* 1000000 + w1_timeout_us
);
1155 /* remainder if it woke up early */
1156 unsigned long jremain
= 0;
1158 atomic_inc(&dev
->refcnt
);
1162 if (!jremain
&& dev
->search_count
) {
1163 mutex_lock(&dev
->mutex
);
1164 w1_search_process(dev
, W1_SEARCH
);
1165 mutex_unlock(&dev
->mutex
);
1168 mutex_lock(&dev
->list_mutex
);
1169 /* Note, w1_process_callback drops the lock while processing,
1170 * but locks it again before returning.
1172 if (!w1_process_callbacks(dev
) && jremain
) {
1173 /* a wake up is either to stop the thread, process
1174 * callbacks, or search, it isn't process callbacks, so
1175 * schedule a search.
1180 __set_current_state(TASK_INTERRUPTIBLE
);
1182 /* hold list_mutex until after interruptible to prevent loosing
1183 * the wakeup signal when async_cmd is added.
1185 mutex_unlock(&dev
->list_mutex
);
1187 if (kthread_should_stop()) {
1188 __set_current_state(TASK_RUNNING
);
1192 /* Only sleep when the search is active. */
1193 if (dev
->search_count
) {
1196 jremain
= schedule_timeout(jremain
);
1202 atomic_dec(&dev
->refcnt
);
1207 static int __init
w1_init(void)
1211 pr_info("Driver for 1-wire Dallas network protocol.\n");
1215 retval
= bus_register(&w1_bus_type
);
1217 pr_err("Failed to register bus. err=%d.\n", retval
);
1218 goto err_out_exit_init
;
1221 retval
= driver_register(&w1_master_driver
);
1223 pr_err("Failed to register master driver. err=%d.\n",
1225 goto err_out_bus_unregister
;
1228 retval
= driver_register(&w1_slave_driver
);
1230 pr_err("Failed to register slave driver. err=%d.\n",
1232 goto err_out_master_unregister
;
1238 /* For undoing the slave register if there was a step after it. */
1239 err_out_slave_unregister
:
1240 driver_unregister(&w1_slave_driver
);
1243 err_out_master_unregister
:
1244 driver_unregister(&w1_master_driver
);
1246 err_out_bus_unregister
:
1247 bus_unregister(&w1_bus_type
);
1253 static void __exit
w1_fini(void)
1255 struct w1_master
*dev
, *n
;
1257 /* Set netlink removal messages and some cleanup */
1258 list_for_each_entry_safe(dev
, n
, &w1_masters
, w1_master_entry
)
1259 __w1_remove_master_device(dev
);
1263 driver_unregister(&w1_slave_driver
);
1264 driver_unregister(&w1_master_driver
);
1265 bus_unregister(&w1_bus_type
);
1268 module_init(w1_init
);
1269 module_exit(w1_fini
);
1271 MODULE_AUTHOR("Evgeniy Polyakov <zbr@ioremap.net>");
1272 MODULE_DESCRIPTION("Driver for 1-wire Dallas network protocol.");
1273 MODULE_LICENSE("GPL");