include/dm/root.h

   1 /*
   2  * Copyright (c) 2013 Google, Inc
   3  *
   4  * (C) Copyright 2012
   5  * Pavel Herrmann <morpheus.ibis@gmail.com>
   6  *
   7  * SPDX-License-Identifier:     GPL-2.0+
   8  */
   9
  10 #ifndef _DM_ROOT_H_
  11 #define _DM_ROOT_H_
  12
  13 struct udevice;
  14
  15 /**
  16  * dm_root() - Return pointer to the top of the driver tree
  17  *
  18  * This function returns pointer to the root node of the driver tree,
  19  *
  20  * @return pointer to root device, or NULL if not inited yet
  21  */
  22 struct udevice *dm_root(void);
  23
  24 /**
  25  * dm_scan_platdata() - Scan all platform data and bind drivers
  26  *
  27  * This scans all available platdata and creates drivers for each
  28  *
  29  * @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
  30  * flag. If false bind all drivers.
  31  * @return 0 if OK, -ve on error
  32  */
  33 int dm_scan_platdata(bool pre_reloc_only);
  34
  35 /**
  36  * dm_scan_fdt() - Scan the device tree and bind drivers
  37  *
  38  * This scans the device tree and creates a driver for each node. Only
  39  * the top-level subnodes are examined.
  40  *
  41  * @blob: Pointer to device tree blob
  42  * @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
  43  * flag. If false bind all drivers.
  44  * @return 0 if OK, -ve on error
  45  */
  46 int dm_scan_fdt(const void *blob, bool pre_reloc_only);
  47
  48 /**
  49  * dm_init_and_scan() - Initialise Driver Model structures and scan for devices
  50  *
  51  * This function initialises the roots of the driver tree and uclass trees,
  52  * then scans and binds available devices from platform data and the FDT.
  53  * This calls dm_init() to set up Driver Model structures.
  54  *
  55  * @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
  56  * flag. If false bind all drivers.
  57  * @return 0 if OK, -ve on error
  58  */
  59 int dm_init_and_scan(bool pre_reloc_only);
  60
  61 /**
  62  * dm_init() - Initialise Driver Model structures
  63  *
  64  * This function will initialize roots of driver tree and class tree.
  65  * This needs to be called before anything uses the DM
  66  *
  67  * @return 0 if OK, -ve on error
  68  */
  69 int dm_init(void);
  70
  71 /**
  72  * dm_uninit - Uninitialise Driver Model structures
  73  *
  74  * All devices will be removed and unbound
  75  * @return 0 if OK, -ve on error
  76  */
  77 int dm_uninit(void);
  78
  79 #endif