| 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
|---|
| 2 | /* |
|---|
| 3 | * Copyright (c) 2004 Evgeniy Polyakov <zbr@ioremap.net> |
|---|
| 4 | */ |
|---|
| 5 | |
|---|
| 6 | #ifndef __W1_H |
|---|
| 7 | #define __W1_H |
|---|
| 8 | |
|---|
| 9 | #include <linux/w1.h> |
|---|
| 10 | |
|---|
| 11 | #include <linux/completion.h> |
|---|
| 12 | #include <linux/mutex.h> |
|---|
| 13 | |
|---|
| 14 | #define W1_SLAVE_ACTIVE 0 |
|---|
| 15 | #define W1_SLAVE_DETACH 1 |
|---|
| 16 | |
|---|
| 17 | /** |
|---|
| 18 | * struct w1_async_cmd - execute callback from the w1_process kthread |
|---|
| 19 | * @async_entry: link entry |
|---|
| 20 | * @cb: callback function, must list_del and destroy this list before |
|---|
| 21 | * returning |
|---|
| 22 | * |
|---|
| 23 | * When inserted into the w1_master async_list, w1_process will execute |
|---|
| 24 | * the callback. Embed this into the structure with the command details. |
|---|
| 25 | */ |
|---|
| 26 | struct w1_async_cmd { |
|---|
| 27 | struct list_head async_entry; |
|---|
| 28 | void (*cb)(struct w1_master *dev, struct w1_async_cmd *async_cmd); |
|---|
| 29 | }; |
|---|
| 30 | |
|---|
| 31 | int w1_create_master_attributes(struct w1_master *master); |
|---|
| 32 | void w1_destroy_master_attributes(struct w1_master *master); |
|---|
| 33 | void w1_search(struct w1_master *dev, u8 search_type, |
|---|
| 34 | w1_slave_found_callback cb); |
|---|
| 35 | void w1_search_devices(struct w1_master *dev, u8 search_type, |
|---|
| 36 | w1_slave_found_callback cb); |
|---|
| 37 | /* call w1_unref_slave to release the reference counts w1_search_slave added */ |
|---|
| 38 | struct w1_slave *w1_search_slave(struct w1_reg_num *id); |
|---|
| 39 | /* |
|---|
| 40 | * decrements the reference on sl->master and sl, and cleans up if zero |
|---|
| 41 | * returns the reference count after it has been decremented |
|---|
| 42 | */ |
|---|
| 43 | int w1_unref_slave(struct w1_slave *sl); |
|---|
| 44 | void w1_slave_found(struct w1_master *dev, u64 rn); |
|---|
| 45 | void w1_search_process_cb(struct w1_master *dev, u8 search_type, |
|---|
| 46 | w1_slave_found_callback cb); |
|---|
| 47 | struct w1_slave *w1_slave_search_device(struct w1_master *dev, |
|---|
| 48 | struct w1_reg_num *rn); |
|---|
| 49 | struct w1_master *w1_search_master_id(u32 id); |
|---|
| 50 | |
|---|
| 51 | /* Disconnect and reconnect devices in the given family. Used for finding |
|---|
| 52 | * unclaimed devices after a family has been registered or releasing devices |
|---|
| 53 | * after a family has been unregistered. Set attach to 1 when a new family |
|---|
| 54 | * has just been registered, to 0 when it has been unregistered. |
|---|
| 55 | */ |
|---|
| 56 | void w1_reconnect_slaves(struct w1_family *f, int attach); |
|---|
| 57 | int w1_attach_slave_device(struct w1_master *dev, struct w1_reg_num *rn); |
|---|
| 58 | /* 0 success, otherwise EBUSY */ |
|---|
| 59 | int w1_slave_detach(struct w1_slave *sl); |
|---|
| 60 | |
|---|
| 61 | void __w1_remove_master_device(struct w1_master *dev); |
|---|
| 62 | |
|---|
| 63 | void w1_family_put(struct w1_family *f); |
|---|
| 64 | void __w1_family_get(struct w1_family *f); |
|---|
| 65 | struct w1_family *w1_family_registered(u8 fid); |
|---|
| 66 | |
|---|
| 67 | extern struct device_driver w1_master_driver; |
|---|
| 68 | extern struct device w1_master_device; |
|---|
| 69 | extern int w1_max_slave_count; |
|---|
| 70 | extern int w1_max_slave_ttl; |
|---|
| 71 | extern struct list_head w1_masters; |
|---|
| 72 | extern struct mutex w1_mlock; |
|---|
| 73 | extern spinlock_t w1_flock; |
|---|
| 74 | |
|---|
| 75 | int w1_process_callbacks(struct w1_master *dev); |
|---|
| 76 | int w1_process(void *data); |
|---|
| 77 | |
|---|
| 78 | #endif /* __W1_H */ |
|---|
| 79 | |
|---|
