mirror of
				https://github.com/smaeul/u-boot.git
				synced 2025-10-31 12:08:19 +00:00 
			
		
		
		
	Provide a function to read the ROM offset so that we can store the value in one place and clients don't need to store it themselves after calling binman_set_rom_offset(). Signed-off-by: Simon Glass <sjg@chromium.org>
		
			
				
	
	
		
			83 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			83 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /* SPDX-License-Identifier: Intel */
 | |
| /*
 | |
|  * Access to binman information at runtime
 | |
|  *
 | |
|  * Copyright 2019 Google LLC
 | |
|  * Written by Simon Glass <sjg@chromium.org>
 | |
|  */
 | |
| 
 | |
| #ifndef _BINMAN_H_
 | |
| #define _BINMAN_H_
 | |
| 
 | |
| #include <dm/ofnode.h>
 | |
| 
 | |
| /**
 | |
|  *struct binman_entry - information about a binman entry
 | |
|  *
 | |
|  * @image_pos: Position of entry in the image
 | |
|  * @size: Size of entry
 | |
|  */
 | |
| struct binman_entry {
 | |
| 	u32 image_pos;
 | |
| 	u32 size;
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * binman_entry_map() - Look up the address of an entry in memory
 | |
|  *
 | |
|  * @parent: Parent binman node
 | |
|  * @name: Name of entry
 | |
|  * @bufp: Returns a pointer to the entry
 | |
|  * @sizep: Returns the size of the entry
 | |
|  * @return 0 on success, -EPERM if the ROM offset is not set, -ENOENT if the
 | |
|  *	entry cannot be found, other error code other error
 | |
|  */
 | |
| int binman_entry_map(ofnode parent, const char *name, void **bufp, int *sizep);
 | |
| 
 | |
| /**
 | |
|  * binman_set_rom_offset() - Set the ROM memory-map offset
 | |
|  *
 | |
|  * @rom_offset: Offset from an image_pos to the memory-mapped address. This
 | |
|  *	tells binman that ROM image_pos x can be addressed at rom_offset + x
 | |
|  */
 | |
| void binman_set_rom_offset(int rom_offset);
 | |
| 
 | |
| /**
 | |
|  * binman_get_rom_offset() - Get the ROM memory-map offset
 | |
|  *
 | |
|  * @returns offset from an image_pos to the memory-mapped address
 | |
|  */
 | |
| int binman_get_rom_offset(void);
 | |
| 
 | |
| /**
 | |
|  * binman_entry_find() - Find a binman symbol
 | |
|  *
 | |
|  * This searches the binman information in the device tree for a symbol of the
 | |
|  * given name
 | |
|  *
 | |
|  * @name: Path to entry to examine (e.g. "/read-only/u-boot")
 | |
|  * @entry: Returns information about the entry
 | |
|  * @return 0 if OK, -ENOENT if the path is not found, other -ve value if the
 | |
|  *	binman information is invalid (missing image-pos or size)
 | |
|  */
 | |
| int binman_entry_find(const char *name, struct binman_entry *entry);
 | |
| 
 | |
| /**
 | |
|  * binman_section_find_node() - Find a binman node
 | |
|  *
 | |
|  * @name: Name of node to look for
 | |
|  * @return Node that was found, ofnode_null() if not found
 | |
|  */
 | |
| ofnode binman_section_find_node(const char *name);
 | |
| 
 | |
| /**
 | |
|  * binman_init() - Set up the binman symbol information
 | |
|  *
 | |
|  * This locates the binary symbol information in the device tree ready for use
 | |
|  *
 | |
|  * @return 0 if OK, -ENOMEM if out of memory, -EINVAL if there is no binman node
 | |
|  */
 | |
| int binman_init(void);
 | |
| 
 | |
| #endif
 |