diff options
| author | Simon Glass <sjg@chromium.org> | 2024-06-23 14:30:21 -0600 |
|---|---|---|
| committer | Tom Rini <trini@konsulko.com> | 2024-07-04 09:25:20 -0600 |
| commit | cb44201c7182f9367e7e0dd1b009a85e26fc1a83 (patch) | |
| tree | 961cb222cfb0137c3dc5d74e7387ce1a948ba7fe /drivers/core/lists.c | |
| parent | 7f65e69c81c7b2cbec1cb2d719d6335312256904 (diff) | |
dm: core: Enhance comments on bind_drivers_pass()
This part of driver model is a little subtle, so add some more comments
to promote better understanding.
Signed-off-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'drivers/core/lists.c')
| -rw-r--r-- | drivers/core/lists.c | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/drivers/core/lists.c b/drivers/core/lists.c index bd0ab4f16c9..c7be504b6fc 100644 --- a/drivers/core/lists.c +++ b/drivers/core/lists.c @@ -8,6 +8,7 @@ #define LOG_CATEGORY LOGC_DM +#include <debug_uart.h> #include <errno.h> #include <log.h> #include <dm/device.h> @@ -50,6 +51,21 @@ struct uclass_driver *lists_uclass_lookup(enum uclass_id id) return NULL; } +/** + * bind_drivers_pass() - Perform a pass of driver binding + * + * Work through the driver_info records binding a driver for each one. If the + * binding fails, continue binding others, but return the error. + * + * For OF_PLATDATA we must bind parent devices before their children. So only + * children of bound parents are bound on each call to this function. When a + * child is left unbound, -EAGAIN is returned, indicating that this function + * should be called again + * + * @parent: Parent device to use when binding each child device + * Return: 0 if OK, -EAGAIN if unbound children exist, -ENOENT if there is no + * driver for one of the devices, other -ve on other error + */ static int bind_drivers_pass(struct udevice *parent, bool pre_reloc_only) { struct driver_info *info = |