include/dm/device-internal.h

8  * SPDX-License-Identifier:	GPL-2.0+
20  * device_bind() - Create a device and bind it to a driver
22  * Called to set up a new device attached to a driver. The device will either
23  * have platdata, or a device tree node which can be used to create the
26  * Once bound a device exists but is not yet active until device_probe() is
29  * @parent: Pointer to device's parent, under which this driver will exist
30  * @drv: Device's driver
31  * @name: Name of device (e.g. device tree node name)
32  * @platdata: Pointer to data for this device - the structure is device-
33  * specific but may include the device's I/O address, etc.. This is NULL for
34  * devices which use device tree.
35  * @of_offset: Offset of device tree node for this device. This is -1 for
36  * devices which don't use device tree.
37  * @devp: if non-NULL, returns a pointer to the bound device
38  * @return 0 if OK, -ve on error
45  * device_bind_with_driver_data() - Create a device and bind it to a driver
47  * Called to set up a new device attached to a driver, in the case where the
48  * driver was matched to the device by means of a match table that provides
51  * Once bound a device exists but is not yet active until device_probe() is
54  * @parent: Pointer to device's parent, under which this driver will exist
55  * @drv: Device's driver
56  * @name: Name of device (e.g. device tree node name)
58  * @node: Device tree node for this device. This is invalid for devices which
59  * don't use device tree.
60  * @devp: if non-NULL, returns a pointer to the bound device
61  * @return 0 if OK, -ve on error
68  * device_bind_by_name: Create a device and bind it to a driver
70  * This is a helper function used to bind devices which do not use device
71  * tree.
73  * @parent: Pointer to device's parent
76  * @info: Name and platdata for this device
77  * @devp: if non-NULL, returns a pointer to the bound device
78  * @return 0 if OK, -ve on error
84  * device_probe() - Probe a device, activating it
86  * Activate a device so that it is ready for use. All its parents are probed
89  * @dev: Pointer to device to probe
90  * @return 0 if OK, -ve on error
95  * device_remove() - Remove a device, de-activating it
97  * De-activate a device so that it is no longer ready for use. All its
100  * @dev: Pointer to device to remove
101  * @flags: Flags for selective device removal (DM_REMOVE_...)
102  * @return 0 if OK, -ve on error (an error here is normally a very bad thing)
111  * device_unbind() - Unbind a device, destroying it
113  * Unbind a device and remove all memory used by it
115  * @dev: Pointer to device to unbind
116  * @return 0 if OK, -ve on error
131  * simple_bus_translate() - translate a bus address to a system address
134  * device address @addr to a system address using this property.
136  * @dev:	Simple bus device (parent of target device)
143 #define DM_ROOT_NON_CONST		(((gd_t *)gd)->dm_root)
144 #define DM_UCLASS_ROOT_NON_CONST	(((gd_t *)gd)->uclass_root)
146 /* device resource management */
150  * devres_release_probe - Release managed resources allocated after probing
151  * @dev: Device to release resources for
159  * devres_release_all - Release all managed resources
160  * @dev: Device to release resources for