commit | 542c27d48714ad4174f5b3ea47659f0fca3cdaf2 | [log] [tgz] |
---|---|---|
author | Sean Rhodes <sean@starlabs.systems> | Thu Aug 10 10:19:34 2023 +0100 |
committer | Sean Rhodes <sean@starlabs.systems> | Wed Aug 16 09:10:38 2023 +0100 |
tree | f3ffc12748d472a4ef78a6e40c9d3783de7e010b | |
parent | a8db7dfe823def043368857b8fbfbba86f2e9e47 [diff] |
mb/starlabs/starbook: Consolidate version history From mid-2022, EC updates were bundled into coreboot using the ITE mirror protocol, leading to individual binaries being added solely to the blobs repo. This made separate version histories redundant. To simplify tracking, the old history has been removed, centralizing all changes in the blobs repository. Signed-off-by: Sean Rhodes <sean@starlabs.systems> Change-Id: Icdac82a0dfd90559a9a7d9808b3fb57a164d121f
While coreboot attempts to be binary free, some coreboot mainboards require vendor binaries to support silicon and features. It is an unfortunate fact, as silicon has become more complicated, vendors are using more binaries to support their silicon. The coreboot community can not control the vendors, nor completely eliminate binaries, but it can set standards and expectations for vendor participation. coreboot needs policies and guidelines to meet GPL licence requirements and to organize and maintain standards within coreboot.
To accept binaries in coreboot 3rdparty/blobs repository, the binary must meet the following:
In case of non-ISA binary, documented usage conventions are required
Examples:
The binary must be accompanied by a distribution license. The license must allow unlimited redistribution to allow coreboot contributors to create coreboot images for third parties which contain this and other blobs.
Source code linked into coreboot may not be committed to the binary repository. Such source code and header files must be committed to the coreboot repository instead.
The binary must contain the version and how to extract the version must be published in the ABI
Each binary release must be accompanied by a release note that contains all of the following (if a field is unknown or unavailable, mark it as unknown or N/A):
* version * release date * supported silicon * instructions, requirements, and dependencies * changes since the last version * errata, known issues * toolchain version(s), if applicable * ABI version and link to the published ABI (in the binary repository)
The commit message should summarize the release note and contain any additional information that might be specific to coreboot. It is helpful to indicate how the binary was tested within coreboot and list any known exceptions or errata.