Skip to content

Commit 915aed5

Browse files
committed
[docs] define strict RP2 scrub and offline setup parsing
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent 6cc74e2 commit 915aed5

2 files changed

Lines changed: 28 additions & 0 deletions

File tree

‎docs/specifications/firmware.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -444,6 +444,23 @@ BIN, and UF2 digests. An absent recipe, extra Target Code object, changed tool
444444
or helper, unknown flag path, unmapped member/header, or source/archive mismatch
445445
MUST fail closed before a public candidate can be assembled.
446446

447+
The RP2 build-driver environment proof MUST parse the one marked `unset`
448+
command independently of later CMake setup. Its one-name-per-line grammar
449+
accepts case-sensitive shell identifiers, including `picotool_DIR`, requires
450+
the exact continuation/terminal structure, rejects duplicate names, and still
451+
requires every GCC resolution and launcher override to be scrubbed. For
452+
v0.6.1 and later, all pinned-picotool discovery controls MUST also be scrubbed;
453+
the complete intervening assignment/export block before the first retained
454+
`mpy-cross` build MUST equal the reviewed offline package configuration. It
455+
sets the verified `PICOTOOL_PACKAGE_DIR`, typed
456+
`FETCHCONTENT_FULLY_DISCONNECTED:BOOL=ON`, disabled package registries and
457+
disabled forced fetching. Missing or additional commands, changed values,
458+
substitutions, or incomplete exports MUST fail; the auditor MUST NOT execute
459+
the shell or ignore an unknown intervening block. Earlier source versions
460+
retain the scrub-only form without this later package setup. This parser
461+
correction does not change build provenance, candidate-source identity,
462+
Eligible Compilation evidence, or qualification-root requirements.
463+
447464
## 7. Footprint budget (provisional, per target)
448465

449466
The measurement method is frozen in

‎docs/specifications/firmware/TDD.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2436,6 +2436,17 @@ pico-sdk, BTstack and its actually linked third parties, CYW43, TinyUSB, and
24362436
every contributing ARM GNU/newlib runtime archive. Deleting or substituting
24372437
one class fails even when the remaining evidence is canonically rehashed.
24382438

2439+
RP2 environment-proof tests MUST run the actual checked-in build driver through
2440+
the production Arm observer's parser boundary. They separately cover the strict
2441+
`unset` command and the exact pinned offline CMake assignment/export block,
2442+
including the case-sensitive `picotool_DIR` name. Missing/duplicate markers or
2443+
variables, malformed names/continuations, lost GCC or package-discovery scrub
2444+
coverage, inserted shell commands, changed offline values and incomplete exports
2445+
are red cases. The historical scrub-only form remains source-version-selected;
2446+
it cannot satisfy the v0.6.1 pinned-picotool contract. Existing cache, compile
2447+
recipe, helper/archive, depfile, runtime notice and source-identity gates remain
2448+
unchanged.
2449+
24392450
The same fixtures derive every compiler depfile belonging to the linked
24402451
firmware target from its C/C++ DependInfo records; assembly records, for which
24412452
CMake does not emit `.o.d`, bind their source bytes directly. Unlinked host

0 commit comments

Comments
 (0)