1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * Copyright (c) 2013 Google, Inc 4 * 5 * (C) Copyright 2012 6 * Pavel Herrmann <morpheus.ibis@gmail.com> 7 */ 8 9 #ifndef _DM_LISTS_H_ 10 #define _DM_LISTS_H_ 11 12 #include <dm/ofnode.h> 13 #include <dm/uclass-id.h> 14 15 /** 16 * lists_driver_lookup_name() - Return u_boot_driver corresponding to name 17 * 18 * This function returns a pointer to a driver given its name. This is used 19 * for binding a driver given its name and platdata. 20 * 21 * @name: Name of driver to look up 22 * @return pointer to driver, or NULL if not found 23 */ 24 struct driver *lists_driver_lookup_name(const char *name); 25 26 /** 27 * lists_uclass_lookup() - Return uclass_driver based on ID of the class 28 * id: ID of the class 29 * 30 * This function returns the pointer to uclass_driver, which is the class's 31 * base structure based on the ID of the class. Returns NULL on error. 32 */ 33 struct uclass_driver *lists_uclass_lookup(enum uclass_id id); 34 35 /** 36 * lists_bind_drivers() - search for and bind all drivers to parent 37 * 38 * This searches the U_BOOT_DEVICE() structures and creates new devices for 39 * each one. The devices will have @parent as their parent. 40 * 41 * @parent: parent device (root) 42 * @early_only: If true, bind only drivers with the DM_INIT_F flag. If false 43 * bind all drivers. 44 */ 45 int lists_bind_drivers(struct udevice *parent, bool pre_reloc_only); 46 47 /** 48 * lists_bind_fdt() - bind a device tree node 49 * 50 * This creates a new device bound to the given device tree node, with 51 * @parent as its parent. 52 * 53 * @parent: parent device (root) 54 * @node: device tree node to bind 55 * @devp: if non-NULL, returns a pointer to the bound device 56 * @pre_reloc_only: If true, bind only nodes with special devicetree properties, 57 * or drivers with the DM_FLAG_PRE_RELOC flag. If false bind all drivers. 58 * @return 0 if device was bound, -EINVAL if the device tree is invalid, 59 * other -ve value on error 60 */ 61 int lists_bind_fdt(struct udevice *parent, ofnode node, struct udevice **devp, 62 bool pre_reloc_only); 63 64 /** 65 * device_bind_driver() - bind a device to a driver 66 * 67 * This binds a new device to a driver. 68 * 69 * @parent: Parent device 70 * @drv_name: Name of driver to attach to this parent 71 * @dev_name: Name of the new device thus created 72 * @devp: If non-NULL, returns the newly bound device 73 */ 74 int device_bind_driver(struct udevice *parent, const char *drv_name, 75 const char *dev_name, struct udevice **devp); 76 77 /** 78 * device_bind_driver_to_node() - bind a device to a driver for a node 79 * 80 * This binds a new device to a driver for a given device tree node. This 81 * should only be needed if the node lacks a compatible strings. 82 * 83 * @parent: Parent device 84 * @drv_name: Name of driver to attach to this parent 85 * @dev_name: Name of the new device thus created 86 * @node: Device tree node 87 * @devp: If non-NULL, returns the newly bound device 88 */ 89 int device_bind_driver_to_node(struct udevice *parent, const char *drv_name, 90 const char *dev_name, ofnode node, 91 struct udevice **devp); 92 93 #endif 94