| # SPDX-License-Identifier: GPL-2.0+ |
| # Copyright (c) 2016 Google, Inc |
| # Written by Simon Glass <sjg@chromium.org> |
| # |
| # Entry-type module for spl/u-boot-spl.bin |
| # |
| |
| from binman.entry import Entry |
| from binman.etype.blob import Entry_blob |
| |
| class Entry_u_boot_spl(Entry_blob): |
| """U-Boot SPL binary |
| |
| Properties / Entry arguments: |
| - filename: Filename of u-boot-spl.bin (default 'spl/u-boot-spl.bin') |
| |
| This is the U-Boot SPL (Secondary Program Loader) binary. This is a small |
| binary which loads before U-Boot proper, typically into on-chip SRAM. It is |
| responsible for locating, loading and jumping to U-Boot. Note that SPL is |
| not relocatable so must be loaded to the correct address in SRAM, or written |
| to run from the correct address if direct flash execution is possible (e.g. |
| on x86 devices). |
| |
| SPL can access binman symbols at runtime. See :ref:`binman_fdt`. |
| |
| in the binman README for more information. |
| |
| The ELF file 'spl/u-boot-spl' must also be available for this to work, since |
| binman uses that to look up symbols to write into the SPL binary. |
| |
| Note that this entry is automatically replaced with u-boot-spl-expanded |
| unless --no-expanded is used or the node has a 'no-expanded' property. |
| """ |
| def __init__(self, section, etype, node): |
| super().__init__(section, etype, node, auto_write_symbols=True) |
| self.elf_fname = 'spl/u-boot-spl' |
| |
| def GetDefaultFilename(self): |
| return 'spl/u-boot-spl.bin' |