u-boot.git/tools/binman/README, branch v2021.01

binman: Support compression of sections

2020-10-29T20:42:59Z

With the previous changes, it is now possible to compress entire sections. Add some tests to check that compression works correctly, including updating the metadata. Also update the documentation. Signed-off-by: Simon Glass

binman: Drop CheckEntries()

2020-10-29T20:42:59Z

This method introduces a separation between packing and checking that is different for sections. In order to handle compression properly, we need to be able to deal with a section's size being smaller than the uncompressed size of its contents. It is easier to make this work if everything happens in the Pack() method. The only real user of CheckEntries() is entry_Section and it can call it directly. Drop the call from 'control' and handle it locally. Signed-off-by: Simon Glass

binman: Drop the Entry.CheckSize() method

2020-10-29T20:42:59Z

This is only used by entry_Section and that class already calls it. Avoid calling it twice. Also drop it from the documentation. Signed-off-by: Simon Glass

binman: Expand docs and test for alignment

2020-10-29T20:42:59Z

Alignment does form part of the entry once the image is written out, but within binman the entry contents does not include the padding. Add documentation to make this clear, as well as a test. Signed-off-by: Simon Glass

binman: Expand docs and test for padding

2020-10-29T20:42:59Z

Padding becomes part of the entry once the image is written out, but within binman the entry contents does not include the padding. Add documentation to make this clear, as well as a test. Signed-off-by: Simon Glass

binman: Support help messages for missing blobs

2020-09-22T18:54:13Z

When an external blob is missing it can be quite confusing for the user. Add a way to provide a help message that is shown. Signed-off-by: Simon Glass Signed-off-by: Alper Nebi Yasak

binman: Document how CROSS_COMPILE, CC, HOSTCC etc. are used in README

2020-09-22T18:54:13Z

Explain that binman interprets these environment variables in the "External tools" section to run target/host specific versions of the tools, and add a new section on how to use CROSS_COMPILE to run the tests on non-x86 machines. Signed-off-by: Alper Nebi Yasak Reviewed-by: Simon Glass

Makefile: Rename ALL-y to INPUTS-y

2020-07-29T01:30:39Z

When binman is in use, most of the targets built by the Makefile are inputs to binman. We then need a final rule to run binman to produce the final outputs. Rename the variable to indicate this, and add a new 'inputs' target. Signed-off-by: Simon Glass Reviewed-by: Bin Meng

cosmetic: Fix spelling and whitespace errors

2019-12-03T13:43:23Z

Signed-off-by: Thomas Hebb

binman: tegra: Adjust symbol calculation depending on end-at-4gb

2019-11-11T19:20:35Z

A recent change adjusted the symbol calculation to work on x86 but broke it for Tegra. In fact this is because they have different needs. On x86 devices the code is linked to a ROM address and the end-at-4gb property is used for the image. In this case there is no need to add the base address of the image, since the base address is already built into the offset and image-pos properties. On other devices we must add the base address since the offsets start at zero. In addition the base address is currently added to the 'offset' and 'size' values. It should in fact only be added to 'image-pos', since 'offset' is relative to its parent and 'size' is not actually an address. This code should have been adjusted when support for 'image-pos' and 'size' was added, but it was not. To correct these problems: - move the code that handles adding the base address to section.py, which can check the end-at-4gb property and which property (offset/size/image-pos) is being read - add the base address only when needed (only for image-pos and not if the image uses end-at-4gb) - add a note to the documentation - add a separate test to cover x86 behaviour Fixes: 15c981cc (binman: Correct symbol calculation with non-zero image base) Signed-off-by: Simon Glass Tested-by: Stephen Warren