A feature of CBFS is that it allows files to be positioned at particular
offset (as with binman in general). This is useful to support
execute-in-place (XIP) code, since this may not be relocatable.

Add a new cbfs-offset property to control this.
Signed-off-by: NSimon Glass <sjg@chromium.org>

When there is lots of open space in a CBFS it is normally padded with
'empty' files so that sequentially scanning the CBFS can skip from one to
the next without a break.

Add support for this.
Signed-off-by: NSimon Glass <sjg@chromium.org>

An Integrated Firmware Image is used to hold various binaries used for
booting with Apollolake and some later devices. Add support for this.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Add support for putting CBFSs (Coreboot Filesystems) in an image. This
allows binman to produce firmware images used by coreboot to boot.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Coreboot uses a simple flash-based filesystem called Coreboot Filesystem
(CBFS) to organise files used during boot. This allows files to be named
and their position in the flash to be set. It has special features for
dealing with x86 devices which typically memory-map their SPI flash to the
top of 32-bit address space and need a 'boot block' ending there.

Create a library to help create and read CBFS files. This includes a
writer class, a reader class and associated other helpers. Only a subset
of features are currently supported.
Signed-off-by: NSimon Glass <sjg@chromium.org>

This tool has quite a few arguments and options, so put the functionality
in a function so that we call it from one place and hopefully get it
right.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Tools like ifwitool may not be available in the PATH, but are available in
the build. These tools may be needed by tests, so allow tests to use the
--toolpath flag.

Also use this flag with travis.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Sometimes when debugging tests it is useful to keep the input and output
directories so they can be examined later. Add an option for this and
update the binman tests to support it. This affects both the test class
and the tearDown() function called after each test.
Signed-off-by: NSimon Glass <sjg@chromium.org>

At present the -v flag is ignored with tests, so that (for example) -v2
does not have any effect. Update binman to pass this flag through to tests
so that they work just like running binman normally, except in a few
special cases where we are actually testing behaviour with different
levels of verbosity.
Signed-off-by: NSimon Glass <sjg@chromium.org>

This should be -u, not -up, since we don't need to preserve the output
directory in this case.
Signed-off-by: NSimon Glass <sjg@chromium.org>

We currenty support using the ELF file in U-Boot proper and SPL, but not
TPL. Add this as it is useful both with sandbox and for CBFS to allow
adding TPL as a 'stage'.
Signed-off-by: NSimon Glass <sjg@chromium.org>

This comment mentions the wrong default filename. Fix it.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Avoid duplicate code here by using the new compression function in the
tools module.
Signed-off-by: NSimon Glass <sjg@chromium.org>

The -D option enables debug mode, but we only need to add -D to the
command line once. Drop the duplicate code. Also drop the comment about
enabling debugging since this can be done with -D.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Update the compression test to use the tools module to decompress the
output data.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Add utility functions to compress and decompress using lz4 and lzma
algorithms. In the latter case these use the legacy lzma support favoured
by coreboot's CBFS.

No tests are provided as these functions will be tested by the CBFS
tests in a separate patch.
Signed-off-by: NSimon Glass <sjg@chromium.org>

At present text entries use an indirect method to specify the text to use,
with a label pointing to the text itself.

Allow the text to be directly written into the node. This is more
convenient in cases where the text is constant.
Signed-off-by: NSimon Glass <sjg@chromium.org>

At present this function always sets both the offset and the size of
entries. But in some cases we want to set only one or the other, for
example with the forthcoming ifwi entry, where we only set the offset.
Update the function to handle this.
Signed-off-by: NSimon Glass <sjg@chromium.org>

At present having a descriptor means that there is an ME (Intel
Management Engine) entry as well. The descriptor provides the ME location
and assumes that it is present.

For some SoCs this is not true. Before providing the location of a
potentially non-existent entry, check if it is present.

Update the comment in the ME entry also.
Signed-off-by: NSimon Glass <sjg@chromium.org>

At present binman requires that the Intel descriptor has an explicit
offset. Generally this is 0 since the descriptor is at the start of the
image. Add a default to handle this, so users don't need to specify the
offset.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Code coverage tests fail on binman due to dist-packages being dropped from
the python path on Ubuntu 16.04. Add them in so that we can find the
elffile module, which is required by binman.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Add a function which decodes an ELF file, working out where in memory each
part of the data should be written.
Signed-off-by: NSimon Glass <sjg@chromium.org>

It is useful to create an ELF file for testing purposes, with just the
right attributes used by the test. Add a function to handle this, along
with a test that it works correctly.
Signed-off-by: NSimon Glass <sjg@chromium.org>

If tests are skipped we should ideally exit with an error, since there may
be a missing dependency. However at present this is not desirable since it
breaks travis tests. For now, just report the skips.
Signed-off-by: NSimon Glass <sjg@chromium.org>

FD is a bit confusing so write this out in full. Also avoid splitting the
string so that people can grep for the error message more easily.
Signed-off-by: NSimon Glass <sjg@chromium.org>

The current help is confusing. Adjust it to indicate what the flag
actually does.
Signed-off-by: NSimon Glass <sjg@chromium.org>

At present GetOffsets() lacks a function comment. Add one.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Some functions lack comments in this file. Add comments to cover this
functionality.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Sometimes tools used by binman may not be in the normal PATH search path,
such as when the tool is built by the U-Boot build itself (e.g. mkimage).
Provide a way to specify an additional search path for tools. The flag
can be used multiple times.

Update the help to describe this option.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Sometimes tools can be located by looking in other locations. Add a way to
direct the search.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Test coverage with Python 3 requires a new package. Add details about
this.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Two functions have incorrect names. Fix them.
Signed-off-by: NSimon Glass <sjg@chromium.org>

This comment is out of date as it does not correctly describe the return
value. Fix it.
Signed-off-by: NSimon Glass <sjg@chromium.org>

If kwargs contains raise_on_error then this function generates an error
due to a duplicate argument. Fix this.
Signed-off-by: NSimon Glass <sjg@chromium.org>

It seems that this field has been renamed in later version of coreboot.
Update it.
Signed-off-by: NSimon Glass <sjg@chromium.org>

This field is not commented in the original file. Add a comment.
Signed-off-by: NSimon Glass <sjg@chromium.org>

Some Intel SoCs from about 2016 boot using an internal microcontroller via
an 'IFWI' image. This is a special format which can hold firmware images.
In U-Boot's case it holds u-boot-tpl.bin.

Add this tool, taken from coreboot, so that we can build bootable images
on apollolake SoCs.

This tool itself has no tests. Some amount of coverage will be provided by
the binman tests that use it, so enable building the tool on sandbox.
Signed-off-by: NSimon Glass <sjg@chromium.org>

- add rtc driver for stm32mp1
- add remoteproc driver for stm32mp1
- use kernel qspi compatible string for stm32

- rk3399 sdhci driver fixup
- TPL BANNER fixup

The generic code in common/spl/spl.c allows TPL/SPL banners to be
silenced by unsetting CONFIG_TPL_BANNER_PRINT or CONFIG_SPL_BANNER_PRINT
respectively. However, arch/arm/mach-rockchip/tpl.c prints this banner
unconditionally.

Fix the rockchip-specific tpl.c so that the TPL banner depends on
CONFIG_TPL_BANNER_PRINT in the same way as the generic code.

Signed-off-by: <chris@arachsys.com>
Reviewed-by: NKever Yang <Kever.yang@rock-chips.com>