OreBolt-OS/BUILD_MANIFEST.txt

134 lines
6.9 KiB
Plaintext

================================================================
OreBolt OS v1.4 -- Build Manifest
================================================================
Generated: 2026-07-13
Target: HiFiWalker H2 (Ingenic X1000E, MIPS32r2, mipsel-linux-musl)
Host: Arch Linux x86_64
----------------------------------------------------------------
CHANGES VS v1.3 (full diff in CHANGELOG.md)
----------------------------------------------------------------
FIXED:
- Target SoC: T31 -> X1000E (matches actual H2 hardware family)
- Module count: reconciled to 16 (was 13 in SHA256SUMS, 16 in Makefile)
- macOS/Windows payload folders now generated (v1.3 only had Linux)
- Init scripts S98emulator-input, S99broker restored
- SHA256SUMS now matches what ships
CHANGED:
- Headers source: Rockbox (bare-metal) -> FiiO M3K GPL kernel tree
(same X1000E SoC, GPL-clean, ready to #include)
- Rockbox demoted to optional bare-metal-only reference
- Sub-Makefile names bumped:
Makefile.h2-core-v6.0 -> Makefile.h2-core-v6.1
Makefile.orebolt-v1.3 -> Makefile.orebolt-v1.4
- HARDWARE_GPIO default flipped to 0 (safe stubs) for host dev
- build.sh Phase 0 probes for KERNEL_HEADERS
- build.sh Phase 7 verifies bitchat AGPL marker
ADDED:
- bitchat mesh module (AGPL-3.0-only) -- see LICENSE.md
- QUICKSTART.md -- the fastest path from fresh host to deployed H2
- HEADERS.md (kernel headers sourcing strategy)
- LICENSE.md (multi-tier licensing strategy)
- licenses/ directory (AGPL-3.0, GPL-2.0, MIT stubs)
- make headers-check target
- BITCHAT_MSG_LICENSE wire message type for AGPL §13 compliance
REMOVED:
- v1.3 PREREQUISITES §3 Rockbox-mining workflow (replaced by HEADERS.md)
----------------------------------------------------------------
FILE INVENTORY (counts)
----------------------------------------------------------------
Top-level build files: 6 (Makefile, 2 sub-Makefiles, build.sh,
inject_payloads.sh, lv_conf.h.dist)
Headers: 3 (h2_ui.h, log_manager.h, panic_purge_api.h)
Master launcher: 1 (main.c)
Userland modules (.c): 18 (16 modules; emulate has 2 files)
HW library (.c): 7 (src/modules/mod_*.c)
Init scripts: 3 (S98emulator-input, S99broker,
bt_input_daemon.sh)
Overlay scripts: 2 (enable_vault_usb.sh, enable_vault_ble.sh)
Vault data files: 3 (syslog.log, failures.dat, Provision.txt)
Linux payloads (.dd): 50 (reference set; macos/windows generated
at build time)
Documentation: 8 (README, QUICKSTART, PREREQUISITES, HEADERS, LICENSE,
ARCHITECTURE, CHANGELOG, BUILD_MANIFEST)
License stubs: 3 (AGPL-3.0.txt, GPL-2.0.txt, MIT.txt)
Integrity manifest: 1 (SHA256SUMS)
TOTAL source/doc files: 105
TOTAL Linux .dd payloads: 50
GRAND TOTAL: 155
----------------------------------------------------------------
MODULE INVENTORY (16 modules, v1.4 reconciled)
----------------------------------------------------------------
ID Name License Status
-- ---- ------- ------
0 vault GPL-2.0-or-later stub (restored)
1 nettaps GPL-2.0-or-later stub (restored)
2 deploy GPL-2.0-or-later stub (restored)
3 studio GPL-2.0-or-later stub (restored)
4 probe GPL-2.0-or-later stub (restored)
5 vterm GPL-2.0-or-later stub (restored)
6 radar GPL-2.0-or-later stub (restored)
7 ducky GPL-2.0-or-later stub (restored)
8 extract GPL-2.0-or-later stub (restored)
9 noise GPL-2.0-or-later stub (restored)
10 reset GPL-2.0-or-later stub (restored)
11 emulate GPL-2.0-or-later stub (restored)
12 emulator_input_mapper GPL-2.0-or-later stub (restored)
13 rfid GPL-2.0-or-later v1.4 RESTORED
14 wifi GPL-2.0-or-later v1.4 RESTORED
15 glitch GPL-2.0-or-later v1.4 RESTORED
16 pwdb GPL-2.0-or-later v1.4 RESTORED
17 bitchat AGPL-3.0-only v1.4 NEW
----------------------------------------------------------------
HARDWARE LIBRARY (liborebolt.a, 7 modules)
----------------------------------------------------------------
mod_core_hid.c GPL-2.0-or-later stub
mod_forensics.c GPL-2.0-or-later stub
mod_panic_hardware_purge.c GPL-2.0-or-later stub
mod_panic_purge.c GPL-2.0-or-later stub
mod_radio_input_multiplex.c GPL-2.0-or-later stub
mod_ui_frame_graphics.c GPL-2.0-or-later stub
mod_bitchat_mesh.c AGPL-3.0-only (full license header)
----------------------------------------------------------------
KNOWN LIMITATIONS
----------------------------------------------------------------
- All .c files except mod_bitchat_mesh.c are build-linkable stubs.
Real implementations must be restored from upstream source set.
Stubs log their init/deinit calls so the launcher UI works end-to-end.
- licenses/AGPL-3.0.txt is a stub. Run:
curl -o licenses/AGPL-3.0.txt https://www.gnu.org/licenses/agpl-3.0.txt
before shipping.
- BITCHAT_SOURCE_URL in mod_bitchat_mesh.c is a placeholder. Replace
with the real Written Offer URL before any bitchat deployment.
- macos/ and windows/ payload folders are populated at build time by
inject_payloads.sh; only linux/ is shipped as a reference set.
----------------------------------------------------------------
BUILD COMMANDS
----------------------------------------------------------------
./build.sh # full build
./build.sh --deploy # build + deploy to SD card
./build.sh --clean # remove build artifacts
make headers-check # verify KERNEL_HEADERS
make payloads # regenerate 150-payload matrix only
----------------------------------------------------------------
REFERENCES
----------------------------------------------------------------
PREREQUISITES.md -- host setup, toolchain, SD card prep (deep reference)
QUICKSTART.md -- fastest path from fresh host to deployed H2
HEADERS.md -- kernel headers sourcing (FiiO M3K + XBurst BSP)
LICENSE.md -- multi-tier licensing (AGPL for bitchat)
ARCHITECTURE.md -- module layout, SoC, build pipeline
CHANGELOG.md -- v1.3 -> v1.4 diff
SHA256SUMS -- per-file integrity manifest
================================================================