include/dm/uclass-internal.h

30  * This handles returning an error or probing a device as needed.
32  * @dev: Device that needs to be probed
33  * @ret: Error to return. If non-zero then the device is not probed
40  * dev_get_uclass_index() - Get uclass and index of device
41  * @dev:	- in - Device that we want the uclass/index of
42  * @ucp:	- out - A pointer to the uclass the device belongs to
44  * The device is not prepared for use - this is an internal function.
46  * @return the index of the device in the uclass list or -ENODEV if not found.
54  * #devp:	Returns pointer to device, or NULL on error
56  * The device is not prepared for use - this is an internal function.
57  * The function uclass_get_device_tail() can be used to probe the device.
65  * uclass_find_first_device() - Return the first device in a uclass
67  * #devp:	Returns pointer to device, or NULL on error
69  * The device is not prepared for use - this is an internal function.
70  * The function uclass_get_device_tail() can be used to probe the device.
77  * uclass_find_next_device() - Return the next device in a uclass
78  * @devp: On entry, pointer to device to lookup. On exit, returns pointer
79  * to the next device in the same uclass, or NULL if none
81  * The device is not prepared for use - this is an internal function.
82  * The function uclass_get_device_tail() can be used to probe the device.
89  * uclass_find_device_by_name() - Find uclass device based on ID and name
91  * This searches for a device with the exactly given name.
93  * The device is NOT probed, it is merely returned.
96  * @name: name of a device to find
97  * @devp: Returns pointer to device (the first one with the name)
104  * uclass_find_device_by_seq() - Find uclass device based on ID and sequence
106  * This searches for a device with the given seq or req_seq.
108  * For seq, if an active device has this sequence it will be returned.
109  * If there is no such device then this will return -ENODEV.
111  * For req_seq, if a device (whether activated or not) has this req_seq
112  * value, that device will be returned. This is a strong indication that
113  * the device will receive that sequence when activated.
115  * The device is NOT probed, it is merely returned.
120  * @devp: Returns pointer to device (there is only one per for each seq)
127  * uclass_find_device_by_of_offset() - Find a uclass device by device tree node
130  * device tree node.
132  * The device is NOT probed, it is merely returned.
135  * @node: Device tree offset to search for (if -ve then -ENODEV is returned)
136  * @devp: Returns pointer to device (there is only one for each node)
143  * uclass_find_device_by_of_node() - Find a uclass device by device tree node
146  * device tree node.
148  * The device is NOT probed, it is merely returned.
151  * @node: Device tree offset to search for (if NULL then -ENODEV is returned)
152  * @devp: Returns pointer to device (there is only one for each node)
159  * uclass_find_device_by_phandle() - Find a uclass device by phandle
163  * The device is NOT probed, it is merely returned.
166  * @parent: Parent device containing the phandle pointer
167  * @name: Name of property in the parent device node
168  * @devp: Returns pointer to device (there is only one for each node)
176  * uclass_bind_device() - Associate device with a uclass
178  * Connect the device into uclass's list of devices.
180  * @dev:	Pointer to the device
186  * uclass_unbind_device() - Deassociate device with a uclass
188  * Disconnect the device from uclass's list of devices.
190  * @dev:	Pointer to the device
200  * uclass_pre_probe_device() - Deal with a device that is about to be probed
206  * @dev:	Pointer to the device
212  * uclass_post_probe_device() - Deal with a device that has just been probed
214  * Perform any post-processing of a probed device that is needed by the
217  * @dev:	Pointer to the device
223  * uclass_pre_remove_device() - Handle a device which is about to be removed
225  * Perform any pre-processing of a device that is about to be removed.
227  * @dev:	Pointer to the device