Pin where buildroot comes from

The firmware builds against sysdrv/source/buildroot/buildroot-2025.02.8 in the
vendor SDK. That tree is not in the vendor checkout -- the SDK ships 2023.02.6 --
it was not in this manifest, and nothing anywhere recorded its origin. A clean
rebuild on another machine silently fell back to the vendor's older buildroot
and produced a different userspace, which is flare-edge#135.

fetch-buildroot-tarball.sh follows fetch-kernel-tarball.sh exactly: pinned URL,
pinned sha256, fails closed on a missing pin. Buildroot signs releases with GPG
rather than publishing a .sha256, so the pin was computed from the tarball and
is what the script verifies against.

The manifest now says out loud that two of the inputs are tarballs rather than
git trees, so "which buildroot" has an answer in the same place as "which LVGL".

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T2D2KtdgwbhbF6Mo64eUrn
This commit is contained in:
Noah
2026-09-03 21:24:10 -06:00
co-authored by Claude Opus 5
parent b6aee456e8
commit 3d8a683d68
3 changed files with 70 additions and 0 deletions
+1
View File
@@ -0,0 +1 @@
695360d10d038122f11c76c35f3bd10561d949af2bc90468659f4ec5ee6687cc buildroot-2025.02.8.tar.xz
+54
View File
@@ -0,0 +1,54 @@
#!/usr/bin/env bash
# Fetch (with retries) and sha256-verify the pristine Buildroot tarball into $1.
#
# WHY THIS EXISTS. The firmware builds against
# sysdrv/source/buildroot/buildroot-2025.02.8 inside the vendor SDK. That tree
# is NOT in the vendor checkout -- the SDK ships 2023.02.6 -- and nothing
# recorded where it came from, so the build was reproducible only on the one
# machine that happened to have the directory (flare-edge#135). Buildroot signs
# its releases with GPG rather than publishing a .sha256, so the pin here was
# computed from the downloaded tarball and is what this script verifies against.
#
# Same shape as fetch-kernel-tarball.sh, deliberately: a version bump edits this
# file and the pin beside it, nothing else. FAILS CLOSED on a missing pin.
#
# Usage: fetch-buildroot-tarball.sh <destination-path>
set -euo pipefail
BRVER=2025.02.8
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" # build/
SHA_FILE="$HERE/buildroot-$BRVER.tar.xz.sha256"
URL="https://buildroot.org/downloads/buildroot-$BRVER.tar.xz"
TB="${1:?usage: fetch-buildroot-tarball.sh <destination-path>}"
[ -f "$SHA_FILE" ] || {
echo "FATAL: no pinned sha256 for buildroot-$BRVER (expected $SHA_FILE):" >&2
echo " refusing an unverified tarball" >&2
exit 1
}
WANT="$(awk '{print $1; exit}' "$SHA_FILE")"
verify() {
[ -f "$TB" ] || return 1
local got
got="$(sha256sum "$TB" | awk '{print $1}')"
[ "$got" = "$WANT" ]
}
if verify; then
echo "buildroot-$BRVER: already present and verified"
exit 0
fi
for attempt in 1 2 3; do
echo "== fetching buildroot-$BRVER (attempt $attempt)"
if curl -fsSL --retry 2 -o "$TB" "$URL" && verify; then
echo "buildroot-$BRVER: sha256 verified"
exit 0
fi
rm -f "$TB"
done
echo "FATAL: could not fetch a buildroot-$BRVER tarball matching $WANT" >&2
exit 1
+15
View File
@@ -12,6 +12,21 @@
# and fetch-vendor.sh is the only thing that acts on it. A checkout that has # and fetch-vendor.sh is the only thing that acts on it. A checkout that has
# drifted off its pin is reported, never silently used. # drifted off its pin is reported, never silently used.
# #
# NOT EVERYTHING HERE IS A GIT TREE. Two build inputs are pinned tarballs
# instead, each with its own fetch-and-verify script beside this file, because a
# release tarball has no commit to name:
#
# linux-6.18.46 build/fetch-kernel-tarball.sh
# buildroot-2025.02.8 build/fetch-buildroot-tarball.sh
#
# The buildroot one matters more than it looks. The firmware builds against
# sysdrv/source/buildroot/buildroot-2025.02.8 inside the vendor SDK, and the
# vendor SDK ships 2023.02.6 -- so that tree is not in the vendor checkout, was
# not in this manifest, and had no recorded origin at all. A clean rebuild
# silently used the vendor's older buildroot and produced a different userspace
# (flare-edge#135). Our delta on top of it is captured in the flare-edge repo at
# sdk-patches/buildroot/.
#
# Format: name<TAB>url<TAB>commit<TAB>description # Format: name<TAB>url<TAB>commit<TAB>description
# Blank lines and lines starting with '#' are ignored. # Blank lines and lines starting with '#' are ignored.