git.sur5r.net Git - u-boot/blob - 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 /**
  43  * Check if a dt node should be or was bound before relocation.
  44  *
  45  * Devicetree nodes can be marked as needed to be bound
  46  * in the loader stages via special devicetree properties.
  47  *
  48  * Before relocation this function can be used to check if nodes
  49  * are required in either SPL or TPL stages.
  50  *
  51  * After relocation and jumping into the real U-Boot binary
  52  * it is possible to determine if a node was bound in one of
  53  * SPL/TPL stages.
  54  *
  55  * There are 3 settings currently in use
  56  * -
  57  * - u-boot,dm-pre-reloc: legacy and indicates any of TPL or SPL
  58  *   Existing platforms only use it to indicate nodes needee in
  59  *   SPL. Should probably be replaced by u-boot,dm-spl for
  60  *   existing platforms.
  61  * @blob: devicetree
  62  * @offset: node offset
  63  *
  64  * Returns true if node is needed in SPL/TL, false otherwise.
  65  */
  66 bool dm_fdt_pre_reloc(const void *blob, int offset);
  67
  68 #endif