Sync source edition with VCC Plus 3.7.0 build 63
This commit is contained in:
1 parent
c652a5276d
commit
b2ecec4d87
86 files changed
+10519
-472
No files matched your search
@@ -58,6 +58,16 @@ just the value written to an MMU register. Installed RAM capacity is checked by
|
||||
the emulator. The packed binary's transfer address is `entryPoint`; it can belong
|
||||
to a loader outside the unpacked C modules.
|
||||
|
||||
Verification uses distinct evidence budgets: the manifest is at most 1 MiB;
|
||||
retained compiler `.s` assembly is at most 32 MiB per file; other evidence files
|
||||
(including listings, objects, linker maps, executable and raw images) are at most
|
||||
8 MiB each. Unique retained evidence is capped at 128 MiB in total. Files are
|
||||
verified in full against their hashes; oversized evidence is rejected rather
|
||||
than truncated. Rejections identify the artifact path, observed size and byte
|
||||
limit. Existing limits on manifest records, module/page ownership and listing
|
||||
rows still apply. Large generated type records in assembly do not relax the
|
||||
assembler-listing row limits or establish a source mapping by themselves.
|
||||
|
||||
Declare each linker section under one module. `codeSections` names executable,
|
||||
immutable sections; mutable data and BSS belong in `sections` with their real page
|
||||
assignments but are excluded from code guards. BSS needs no invented raw zeros.
|
||||
@@ -65,8 +75,13 @@ A pure BSS module may omit `image` entirely when `codeSections` is empty;
|
||||
its explicit page assignments and section ownership still apply. An initialized
|
||||
section cannot use that omission to skip object byte verification.
|
||||
Keep mutable bytes out of executable sections. Split modules when unrelated pages
|
||||
need not remain mapped together. Different overlays may reuse a logical address
|
||||
only with distinct physical ownership.
|
||||
need not remain mapped together. Version 1 permits logical-address reuse with
|
||||
distinct physical ownership. For code images that replace one another in the
|
||||
same physical RAM, use the explicit version-2
|
||||
overlay group and owner contract. Runtime inspection
|
||||
requires complete loaded-code proof of exactly one owner; declaration alone
|
||||
does not establish residency. Build catalogs list static candidates, while a
|
||||
paused inspection reports current verified ownership and a residency fingerprint.
|
||||
|
||||
Hashes bind the declaration to one build. VCC Plus independently replays object
|
||||
relocations against the raw module bytes and verifies live RAM before publishing
|
||||
|
||||
@@ -37,7 +37,11 @@ its `VCCDBG1` type/storage records; retaining compiler-generated `.s` permits
|
||||
verification of records too long for an assembler listing row. A useful Debug
|
||||
compile uses `-O0 -fno-omit-frame-pointer`; optimized builds can legitimately
|
||||
have fewer C statements or unavailable locals. No user Makefile is rewritten
|
||||
merely to provide debugger metadata.
|
||||
merely to provide debugger metadata. Banked evidence permits compiler `.s` files
|
||||
up to 32 MiB while retaining 8 MiB limits for other evidence, the 1 MiB manifest
|
||||
limit and the 128 MiB aggregate cap. Size failures name the artifact and exact
|
||||
limit; hash, declared-output and symbolic-link checks still apply. No evidence
|
||||
is truncated to make a source map appear verified.
|
||||
|
||||
For example, a normal recipe can compile and link with:
|
||||
|
||||
@@ -51,7 +55,11 @@ program.bin: obj/main.o
|
||||
|
||||
This fragment only illustrates retained evidence; disk construction and launch
|
||||
commands remain the project's declared recipe. Packed, relocated or bank-switched
|
||||
programs must supply the public version-1 [banked debug manifest](MCP_BANKED_PLAYTEST.md).
|
||||
programs must supply the public [banked debug manifest](MCP_BANKED_PLAYTEST.md).
|
||||
Version 1 preserves distinct physical ownership; version 2 supports explicitly
|
||||
declared mutually exclusive code overlays. Discover
|
||||
`banked_debug_manifest_versions` and `verified_code_overlays` through
|
||||
`get_capabilities` before preparing that evidence.
|
||||
Its hashes, unpacked images, section ownership and actual physical page identities
|
||||
are required. It never falls back to a flat interpretation after verification
|
||||
fails.
|
||||
@@ -82,7 +90,11 @@ Locally configured watches retain their existing rules.
|
||||
|
||||
`read_debug_memory` accepts only ranges advertised by that immutable snapshot,
|
||||
up to 256 bytes. Resume, input, step, restart, source/artifact changes and
|
||||
connection revocation invalidate the applicable observation. Inspection performs
|
||||
connection revocation invalidate the applicable observation. Owned memory and
|
||||
call-context reads also compare a fresh complete capture, including verified
|
||||
residency, registers, cycles and safe memory, even at the same field clock.
|
||||
The residency fingerprint names a current proof rather than a monotonic guest
|
||||
write counter; A→B→A still requires fresh capture validation. Inspection performs
|
||||
no guest expressions, register writes, memory writes or side-effecting I/O reads.
|
||||
A mismatched binary, object relocation, source identity or bank cannot produce a
|
||||
verified snapshot merely because a requested function name exists.
|
||||
|
||||
@@ -0,0 +1,31 @@
|
||||
# Capture feedback audio
|
||||
|
||||
The two short cues play through NSSound on the Mac only. They never enter the
|
||||
emulator audio mixer, generated PCM, MCP audio capture or recorded movies.
|
||||
They are not controlled by the separate Include CoCo Audio in Video preference.
|
||||
|
||||
Brian selected these effects on Pixabay. The same recordings are available from
|
||||
their original creators on Freesound under **CC0 1.0**; the retained sources were
|
||||
downloaded from the preview URLs linked by those original pages on November 13,
|
||||
2026. These assets are public-domain dedications, separate from the GPL code and
|
||||
the original VCC Plus artwork notice.
|
||||
|
||||
| Cue | Original creator and source | Retained preview |
|
||||
| --- | --- | --- |
|
||||
| Screenshot | [iPhone Camera Capture.wav — pooky1](https://freesound.org/people/pooky1/sounds/431588/) | https://cdn.freesound.org/previews/431/431588_2339776-hq.mp3 |
|
||||
| Recording start | [Tape start .wav — sophiehall3535](https://freesound.org/people/sophiehall3535/sounds/245927/) | https://cdn.freesound.org/previews/245/245927_4361022-hq.mp3 |
|
||||
|
||||
Both source pages explicitly identify Creative Commons 0:
|
||||
https://creativecommons.org/publicdomain/zero/1.0/
|
||||
|
||||
The selected Pixabay pages remain references:
|
||||
https://pixabay.com/sound-effects/film-special-effects-iphone-camera-capture-6448/
|
||||
https://pixabay.com/sound-effects/film-special-effects-tape-start-85778/
|
||||
|
||||
`prepare.py` decodes the retained previews, extracts 1.62–2.14 seconds of the tape
|
||||
recording to remove the long lead-in and later sounds, downmixes to mono 44.1 kHz
|
||||
16-bit WAV, normalizes the peak to 0.35 and applies five-millisecond edge fades.
|
||||
The full shutter preview is retained in its cue. Source and output SHA-256 values
|
||||
are recorded in `manifest.json`. Run `python3 docs/media/capture-sounds/prepare.py`
|
||||
with ffmpeg available to reproduce the bundled WAV files. Application builds use
|
||||
the prepared WAV files and require no audio download or ffmpeg.
|
||||
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"license": "CC0-1.0",
|
||||
"reviewed": "2026-11-13",
|
||||
"inputs": {
|
||||
"shutter.mp3": {
|
||||
"sha256": "e805680b4ee8a48bc537f266c866e74d60b076a76e52af3acbaacf77e8cb7392",
|
||||
"bytes": 15600
|
||||
},
|
||||
"tape-start.mp3": {
|
||||
"sha256": "ebbbb9d82d0ff2f84d48ae8228a2f635fe45b7816583393e77d079034230eac7",
|
||||
"bytes": 50712
|
||||
}
|
||||
},
|
||||
"outputs": {
|
||||
"recording-start.wav": {
|
||||
"sha256": "5b5ba2407a84e39cf04018c64acb48b690089cd32cec193920dcbf2cb4080aa7",
|
||||
"bytes": 45908
|
||||
},
|
||||
"screenshot.wav": {
|
||||
"sha256": "38bce90df26042fa70bb0a5dc33a5759867e0440de0a7acd4b8942cbcbdf239d",
|
||||
"bytes": 48886
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Reproduce short host-only cues from the retained CC0 Freesound previews.
|
||||
|
||||
Requires ffmpeg; not needed to build or run VCC Plus.
|
||||
"""
|
||||
from pathlib import Path
|
||||
import hashlib
|
||||
import json
|
||||
import struct
|
||||
import subprocess
|
||||
import wave
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[3]
|
||||
HERE = Path(__file__).resolve().parent
|
||||
DEST = ROOT / "platforms/macos/Resources/CaptureSounds"
|
||||
CLIPS = [("shutter.mp3", "screenshot.wav", None),
|
||||
("tape-start.mp3", "recording-start.wav", "atrim=start=1.62:end=2.14,asetpts=PTS-STARTPTS")]
|
||||
|
||||
|
||||
def build():
|
||||
DEST.mkdir(parents=True, exist_ok=True)
|
||||
for original, filename, trim in CLIPS:
|
||||
command = ["ffmpeg", "-nostdin", "-v", "error", "-i", str(HERE / "source" / original)]
|
||||
if trim:
|
||||
command += ["-af", trim]
|
||||
raw = subprocess.check_output(command + ["-ac", "1", "-ar", "44100", "-f", "f32le", "-"])
|
||||
values = struct.unpack("<" + "f" * (len(raw) // 4), raw)
|
||||
peak = max(abs(v) for v in values)
|
||||
scale = 0.35 / max(peak, 0.000001)
|
||||
fade = 221
|
||||
samples = [round(v * scale * 32767 * min(1, i / fade, (len(values) - 1 - i) / fade))
|
||||
for i, v in enumerate(values)]
|
||||
with wave.open(str(DEST / filename), "wb") as output:
|
||||
output.setparams((1, 2, 44100, 0, "NONE", "not compressed"))
|
||||
output.writeframes(struct.pack("<" + "h" * len(samples), *samples))
|
||||
print(filename, len(samples) / 44100, hashlib.sha256((DEST / filename).read_bytes()).hexdigest())
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
build()
|
||||
Binary file not shown.
Binary file not shown.
@@ -230,7 +230,7 @@
|
||||
},
|
||||
{
|
||||
"path": "docs/development/MCP_BANKED_PLAYTEST.md",
|
||||
"export_sha256": "fad90fcb7e5ca3670d803f02578e44e637b0b126f7716dc4198f253ea7eae3a6",
|
||||
"export_sha256": "75f1b3c0977ffc536a0cb47f46f554c10c06a34d5b7a2a58458d997c1493c480",
|
||||
"selected_headings": [
|
||||
{
|
||||
"heading": "Build evidence for packed programs",
|
||||
@@ -306,7 +306,7 @@
|
||||
},
|
||||
{
|
||||
"path": "docs/development/MCP_DEBUG_EVIDENCE.md",
|
||||
"export_sha256": "79fe80ae2c40808e6da821bae1d2de1aa4c18b5f7e24b3a40707fdd473cf086e",
|
||||
"export_sha256": "ddb8e4979b5573cff809a6fda8c9b961fcbd3dfc0fd7f8bce4dcd1814782e2f4",
|
||||
"selected_headings": [
|
||||
{
|
||||
"heading": "Read the build evidence first",
|
||||
|
||||
Reference in new issue
Block a user