f4f4123708
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
|