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