include/dm/util.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Copyright (c) 2013 Google, Inc
   4  */
   5
   6 #ifndef __DM_UTIL_H
   7 #define __DM_UTIL_H
   8
   9 #ifdef CONFIG_DM_WARN
  10 void dm_warn(const char *fmt, ...);
  11 #else
  12 static inline void dm_warn(const char *fmt, ...)
  13 {
  14 }
  15 #endif
  16
  17 struct list_head;
  18
  19 /**
  20  * list_count_items() - Count number of items in a list
  21  *
  22  * @param head:         Head of list
  23  * @return number of items, or 0 if empty
  24  */
  25 int list_count_items(struct list_head *head);
  26
  27 /* Dump out a tree of all devices */
  28 void dm_dump_all(void);
  29
  30 /* Dump out a list of uclasses and their devices */
  31 void dm_dump_uclass(void);
  32
  33 #ifdef CONFIG_DEBUG_DEVRES
  34 /* Dump out a list of device resources */
  35 void dm_dump_devres(void);
  36 #else
  37 static inline void dm_dump_devres(void)
  38 {
  39 }
  40 #endif
  41
  42 /* Dump out a list of drivers */
  43 void dm_dump_drivers(void);
  44
  45 /**
  46  * Check if an of node should be or was bound before relocation.
  47  *
  48  * Devicetree nodes can be marked as needed to be bound
  49  * in the loader stages via special devicetree properties.
  50  *
  51  * Before relocation this function can be used to check if nodes
  52  * are required in either SPL or TPL stages.
  53  *
  54  * After relocation and jumping into the real U-Boot binary
  55  * it is possible to determine if a node was bound in one of
  56  * SPL/TPL stages.
  57  *
  58  * There are 4 settings currently in use
  59  * - u-boot,dm-pre-proper: U-Boot proper pre-relocation only
  60  * - u-boot,dm-pre-reloc: legacy and indicates any of TPL or SPL
  61  *   Existing platforms only use it to indicate nodes needed in
  62  *   SPL. Should probably be replaced by u-boot,dm-spl for
  63  *   existing platforms.
  64  * - u-boot,dm-spl: SPL and U-Boot pre-relocation
  65  * - u-boot,dm-tpl: TPL and U-Boot pre-relocation
  66  * @node: of node
  67  *
  68  * Returns true if node is needed in SPL/TL, false otherwise.
  69  */
  70 bool dm_ofnode_pre_reloc(ofnode node);
  71
  72 #endif