u-boot-brain/tools/binman/etype/intel_fsp.py

# SPDX-License-Identifier: GPL-2.0+
# Copyright (c) 2016 Google, Inc
# Written by Simon Glass <sjg@chromium.org>
#
# Entry-type module for Intel Firmware Support Package binary blob
#

from binman.etype.blob_ext import Entry_blob_ext

class Entry_intel_fsp(Entry_blob_ext):
    """Entry containing an Intel Firmware Support Package (FSP) file

    Properties / Entry arguments:
        - filename: Filename of file to read into entry

    This file contains binary blobs which are used on some devices to make the
    platform work. U-Boot executes this code since it is not possible to set up
    the hardware using U-Boot open-source code. Documentation is typically not
    available in sufficient detail to allow this.

    An example filename is 'FSP/QUEENSBAY_FSP_GOLD_001_20-DECEMBER-2013.fd'

    See README.x86 for information about x86 binary blobs.
    """
    def __init__(self, section, etype, node):
        super().__init__(section, etype, node)
SPDX: Convert all of our single license tags to Linux Kernel style When U-Boot started using SPDX tags we were among the early adopters and there weren't a lot of other examples to borrow from. So we picked the area of the file that usually had a full license text and replaced it with an appropriate SPDX-License-Identifier: entry. Since then, the Linux Kernel has adopted SPDX tags and they place it as the very first line in a file (except where shebangs are used, then it's second line) and with slightly different comment styles than us. In part due to community overlap, in part due to better tag visibility and in part for other minor reasons, switch over to that style. This commit changes all instances where we have a single declared license in the tag as both the before and after are identical in tag contents. There's also a few places where I found we did not have a tag and have introduced one. Signed-off-by: Tom Rini <trini@konsulko.com> 2018-05-07 06:58:06 +09:00			`# SPDX-License-Identifier: GPL-2.0+`
binman: Add support for building x86 images with FSP/CMC Add support for two more from the inexhaustible supply of x86 binary blob types. Signed-off-by: Simon Glass <sjg@chromium.org> Tested-by: Bin Meng <bmeng.cn@gmail.com> 2016-11-26 12:15:56 +09:00			`# Copyright (c) 2016 Google, Inc`
			`# Written by Simon Glass <sjg@chromium.org>`
			`#`
			`# Entry-type module for Intel Firmware Support Package binary blob`
			`#`

binman: Convert existing binary blobs to blob_ext Many of the existing blobs rely on external binaries which may not be available. Move them over to use blob_ext to indicate this. Unfortunately cros-ec-rw cannot use this class because it inherits another. So set the 'external' value for that class. While we are here, drop the import of Entry since it is not used (and pylint3 complains). Signed-off-by: Simon Glass <sjg@chromium.org> 2020-07-10 09:39:37 +09:00			`from binman.etype.blob_ext import Entry_blob_ext`
binman: Add support for building x86 images with FSP/CMC Add support for two more from the inexhaustible supply of x86 binary blob types. Signed-off-by: Simon Glass <sjg@chromium.org> Tested-by: Bin Meng <bmeng.cn@gmail.com> 2016-11-26 12:15:56 +09:00
binman: Convert existing binary blobs to blob_ext Many of the existing blobs rely on external binaries which may not be available. Move them over to use blob_ext to indicate this. Unfortunately cros-ec-rw cannot use this class because it inherits another. So set the 'external' value for that class. While we are here, drop the import of Entry since it is not used (and pylint3 complains). Signed-off-by: Simon Glass <sjg@chromium.org> 2020-07-10 09:39:37 +09:00			`class Entry_intel_fsp(Entry_blob_ext):`
binman: Expand documentation for entries At present only the more complex entries are documented. It is useful to have documentation for all entries in one place. As a first step, add and expand the documentation to cover all entries. Signed-off-by: Simon Glass <sjg@chromium.org> 2018-07-18 04:25:35 +09:00			`"""Entry containing an Intel Firmware Support Package (FSP) file`

			`Properties / Entry arguments:`
			`- filename: Filename of file to read into entry`

			`This file contains binary blobs which are used on some devices to make the`
			`platform work. U-Boot executes this code since it is not possible to set up`
			`the hardware using U-Boot open-source code. Documentation is typically not`
			`available in sufficient detail to allow this.`

			`An example filename is 'FSP/QUEENSBAY_FSP_GOLD_001_20-DECEMBER-2013.fd'`

			`See README.x86 for information about x86 binary blobs.`
			`"""`
binman: Rename Entry property to 'section' Entries are now passed a Section object rather than an Image. Rename this property to avoid confusion. Signed-off-by: Simon Glass <sjg@chromium.org> 2018-06-02 00:38:14 +09:00			`def __init__(self, section, etype, node):`
binman: Use super() instead of specifying parent type It is easier and less error-prone to use super() when the parent type is needed. Update binman to remove the type names. Signed-off-by: Simon Glass <sjg@chromium.org> Reviewed-by: Bin Meng <bmeng.cn@gmail.com> 2020-07-10 09:39:35 +09:00			`super().__init__(section, etype, node)`