drivers/w1/w1_internal.h

0001 /* SPDX-License-Identifier: GPL-2.0-or-later */
0002 /*
0003  * Copyright (c) 2004 Evgeniy Polyakov <zbr@ioremap.net>
0004  */
0005
0006 #ifndef __W1_H
0007 #define __W1_H
0008
0009 #include <linux/w1.h>
0010
0011 #include <linux/completion.h>
0012 #include <linux/mutex.h>
0013
0014 #define W1_SLAVE_ACTIVE     0
0015 #define W1_SLAVE_DETACH     1
0016
0017 /**
0018  * struct w1_async_cmd - execute callback from the w1_process kthread
0019  * @async_entry: link entry
0020  * @cb: callback function, must list_del and destroy this list before
0021  * returning
0022  *
0023  * When inserted into the w1_master async_list, w1_process will execute
0024  * the callback.  Embed this into the structure with the command details.
0025  */
0026 struct w1_async_cmd {
0027     struct list_head    async_entry;
0028     void (*cb)(struct w1_master *dev, struct w1_async_cmd *async_cmd);
0029 };
0030
0031 int w1_create_master_attributes(struct w1_master *master);
0032 void w1_destroy_master_attributes(struct w1_master *master);
0033 void w1_search(struct w1_master *dev, u8 search_type,
0034            w1_slave_found_callback cb);
0035 void w1_search_devices(struct w1_master *dev, u8 search_type,
0036                w1_slave_found_callback cb);
0037 /* call w1_unref_slave to release the reference counts w1_search_slave added */
0038 struct w1_slave *w1_search_slave(struct w1_reg_num *id);
0039 /*
0040  * decrements the reference on sl->master and sl, and cleans up if zero
0041  * returns the reference count after it has been decremented
0042  */
0043 int w1_unref_slave(struct w1_slave *sl);
0044 void w1_slave_found(struct w1_master *dev, u64 rn);
0045 void w1_search_process_cb(struct w1_master *dev, u8 search_type,
0046               w1_slave_found_callback cb);
0047 struct w1_slave *w1_slave_search_device(struct w1_master *dev,
0048                     struct w1_reg_num *rn);
0049 struct w1_master *w1_search_master_id(u32 id);
0050
0051 /* Disconnect and reconnect devices in the given family.  Used for finding
0052  * unclaimed devices after a family has been registered or releasing devices
0053  * after a family has been unregistered.  Set attach to 1 when a new family
0054  * has just been registered, to 0 when it has been unregistered.
0055  */
0056 void w1_reconnect_slaves(struct w1_family *f, int attach);
0057 int w1_attach_slave_device(struct w1_master *dev, struct w1_reg_num *rn);
0058 /* 0 success, otherwise EBUSY */
0059 int w1_slave_detach(struct w1_slave *sl);
0060
0061 void __w1_remove_master_device(struct w1_master *dev);
0062
0063 void w1_family_put(struct w1_family *f);
0064 void __w1_family_get(struct w1_family *f);
0065 struct w1_family *w1_family_registered(u8 fid);
0066
0067 extern struct device_driver w1_master_driver;
0068 extern struct device w1_master_device;
0069 extern int w1_max_slave_count;
0070 extern int w1_max_slave_ttl;
0071 extern struct list_head w1_masters;
0072 extern struct mutex w1_mlock;
0073 extern spinlock_t w1_flock;
0074
0075 int w1_process_callbacks(struct w1_master *dev);
0076 int w1_process(void *data);
0077
0078 #endif /* __W1_H */