u-boot.git/tools/binman/etype/blob.py, branch main

binman: mark optional missing blobs as absent

2025-06-26T15:54:05Z

Optional blobs should mark themselves as absent to avoid being packed into an image. Extend the documentation of this behaviour. Although the documentation implied this before, the "optional" property had not been explained properly before. The behaviour will change as now absent entries are no longer packed into an image. The image map will also reflect this. As a result, the CheckForProblems() function will no longer alert on optional (blob) entries. This is because the missing optional images were removed before CheckForProblems is called. Adjust the testExtblobOptional test case to highlight that we are testing not only an optional image but the image is missing as well. The behaviour for these is different where the latter will not be packaged into the image. Reported-by: Simon Glass Signed-off-by: Yannic Moog Reviewed-by: Bryan Brattlof

binman: drop "faked" return value from check_fake_fname

2025-06-26T15:54:05Z

check_fake_fname sets the faked member of the entry. Use that member to get the faked status instead of a returned value indicating the same. Add type annotations to the modified functions while at it. Signed-off-by: Yannic Moog Reviewed-by: Simon Glass Reviewed-by: Bryan Brattlof

binman: Support an assumed size for missing binaries

2024-07-03T06:36:33Z

Binman has a the useful feature of handling missing external blobs gracefully, including allowing them to be missing, deciding whether the resulting image is functional or not and faking blobs when this is necessary for particular tools (e.g. mkimage). This feature is widely used in CI. One drawback is that if U-Boot grows too large to fit along with the required blobs, then this is not discovered until someone does a 'real' build which includes the blobs. Add a 'assume-size' property to entries to allow Binman to reserve a given size for missing external blobs. Signed-off-by: Simon Glass

patman: Move library functions into a library directory

2023-03-08T19:40:49Z

The patman directory has a number of modules which are used by other tools in U-Boot. This makes it hard to package the tools using pypi since the common files must be copied along with the tool that uses them. To address this, move these files into a new u_boot_pylib library. This can be packaged separately and listed as a dependency of each tool. Signed-off-by: Simon Glass

binman: Use correct argument name in docstrings

2023-03-08T19:38:48Z

Use correct argument name in docstrings. Signed-off-by: Jonas Karlman Reviewed-by: Simon Glass

binman: Provide general support for updating ELF symbols

2023-01-18T21:55:41Z

The current support for updating variables in a binary is hard-coded to work with U-Boot: - It assumes the image starts at __image_copy_start - It uses the existing U-Boot-specific entry types It is useful for other projects to use these feature. Add properties to enable writing symbols for any blob, a way of specifying the base symbol and a way of providing the ELF filename to allow symbol lookup to take place. With this it is possible to update a Zephyr image, such as zephyr.bin after it has been built. Signed-off-by: Simon Glass

binman: Support optional external blobs

2023-01-18T18:50:01Z

Some blobs are actually not necessary for the board to work correctly. Add a property to allow this to be indicated. Missing optional blobs do not cause a build failure. Signed-off-by: Simon Glass

binman: Handle writing ELF symbols in the Entry class

2022-10-31T15:01:31Z

This feature is used by several etypes and we plan to add more that use it. Make symbol writing a feature of the base class to reduce the code duplication. Signed-off-by: Simon Glass

binman: Allow mkimage to use a non-zero fake-blob size

2022-03-19T01:24:25Z

Unfortunately mkimage gets upset with zero-sized files. Update the ObtainContents() method to support specifying the size, if a fake blob is created. Signed-off-by: Simon Glass Reviewed-by: Alper Nebi Yasak

binman: Change how faked blobs are created

2022-03-19T01:24:25Z

At present fake blobs are created but internally an empty blob is used. Change it to use the contents of the faked file. Also return whether the blob was faked, in case the caller needs to know that. Add a TODO to put fake blobs in their own directory. Signed-off-by: Simon Glass Reviewed-by: Alper Nebi Yasak