]>
Commit | Line | Data |
---|---|---|
3c10dc95 SG |
1 | /* SPDX-License-Identifier: Intel */ |
2 | /* | |
3 | * Access to binman information at runtime | |
4 | * | |
5 | * Copyright 2019 Google LLC | |
6 | * Written by Simon Glass <sjg@chromium.org> | |
7 | */ | |
8 | ||
9 | #ifndef _BINMAN_H_ | |
10 | #define _BINMAN_H_ | |
11 | ||
8f9877df SG |
12 | #include <dm/ofnode.h> |
13 | ||
3c10dc95 SG |
14 | /** |
15 | *struct binman_entry - information about a binman entry | |
16 | * | |
17 | * @image_pos: Position of entry in the image | |
18 | * @size: Size of entry | |
19 | */ | |
20 | struct binman_entry { | |
21 | u32 image_pos; | |
22 | u32 size; | |
23 | }; | |
24 | ||
8f9877df SG |
25 | /** |
26 | * binman_entry_map() - Look up the address of an entry in memory | |
27 | * | |
28 | * @parent: Parent binman node | |
29 | * @name: Name of entry | |
30 | * @bufp: Returns a pointer to the entry | |
31 | * @sizep: Returns the size of the entry | |
32 | * @return 0 on success, -EPERM if the ROM offset is not set, -ENOENT if the | |
33 | * entry cannot be found, other error code other error | |
34 | */ | |
35 | int binman_entry_map(ofnode parent, const char *name, void **bufp, int *sizep); | |
36 | ||
db6fb7d1 SG |
37 | /** |
38 | * binman_set_rom_offset() - Set the ROM memory-map offset | |
39 | * | |
40 | * @rom_offset: Offset from an image_pos to the memory-mapped address. This | |
41 | * tells binman that ROM image_pos x can be addressed at rom_offset + x | |
42 | */ | |
43 | void binman_set_rom_offset(int rom_offset); | |
44 | ||
3c10dc95 SG |
45 | /** |
46 | * binman_entry_find() - Find a binman symbol | |
47 | * | |
48 | * This searches the binman information in the device tree for a symbol of the | |
49 | * given name | |
50 | * | |
51 | * @name: Path to entry to examine (e.g. "/read-only/u-boot") | |
52 | * @entry: Returns information about the entry | |
53 | * @return 0 if OK, -ENOENT if the path is not found, other -ve value if the | |
54 | * binman information is invalid (missing image-pos or size) | |
55 | */ | |
56 | int binman_entry_find(const char *name, struct binman_entry *entry); | |
57 | ||
8f9877df SG |
58 | /** |
59 | * binman_section_find_node() - Find a binman node | |
60 | * | |
61 | * @name: Name of node to look for | |
62 | * @return Node that was found, ofnode_null() if not found | |
63 | */ | |
64 | ofnode binman_section_find_node(const char *name); | |
65 | ||
3c10dc95 SG |
66 | /** |
67 | * binman_init() - Set up the binman symbol information | |
68 | * | |
69 | * This locates the binary symbol information in the device tree ready for use | |
70 | * | |
71 | * @return 0 if OK, -ENOMEM if out of memory, -EINVAL if there is no binman node | |
72 | */ | |
73 | int binman_init(void); | |
74 | ||
75 | #endif |