OreBolt-OS/CHANGELOG.md

Changelog

All notable changes to OreBolt OS are documented in this file. Format roughly follows Keep-a-Changelog; dates are YYYY-MM-DD.

[v1.6] -- 2026-07-14

The "Proximity Alarm" Release

v1.6 adds the first new module since the v1.5 restoration pass: proxalarm, a BLE proximity alarm (tripwire detector) with a clean 3-layer architecture. Also includes documentation hardening (module descriptions aligned to actual implementations, BitChat nominative fair use analysis).

Added

• proxalarm -- BLE Proximity Alarm (tripwire detector). The first new module for the v1.6 cycle, designed for use in the dark as a modern tripwire alarm. Three-layer architecture keeps hardware, math, and display cleanly separated:
  • bledsp (Hardware/DSP layer): BlueZ HCI LE scanning with rolling- average RSSI smoothing. Falls back to simulation mode when no BT hardware is present (all revisions without BLE, or development hosts). Source-agnostic device table has a bledsp_source_t enum (BLE_SRC_BLE, BLE_SRC_WIFI) ready for future WiFi RSSI integration without modifying the kinematics or display layers.
  • proxvec (Kinematics layer): Converts smoothed RSSI to abstract grid coordinates via a log-distance path-loss lookup table (no floating-point math). Per-target finite state machine (NEW -> APPROACHING -> STATIONARY -> RECEDING -> LOST) with radial velocity tracking. Configurable alarm radius triggers when a target enters the red zone.
  • radar_ui (Presentation layer): LVGL canvas-based radar display. 320x240 RGB565 framebuffer (adapts to H2_LCD_WIDTH/H2_LCD_HEIGHT). Features: 4 concentric range rings, rotating sweep line with dim trail, color-coded target blips (green=detection, orange=tracking, red=alarm), velocity vectors for approaching targets, and a flashing "!! ALERT !!" overlay when any target is in the alarm zone.
  • Input controls: ROTATE cycles sensitivity (4 presets: -40, -50, -60, -70 dBm near-threshold), PLAY toggles scan pause/resume, BACK exits. Status bar shows live target and alarm counts.
  • Module is a multi-source binary (bledsp.c + proxvec.c + radar_ui.c
    • proxalarm.c) -- first Orebolt OS module to use this pattern. Makefile.h2-core-v6.2 updated to support multi-source MODULES entries.

Changed

• Module count: 19 .mod binaries + 1 standalone daemon (was 18 + 1).
• Documentation audit: all module descriptions in README.md and ARCHITECTURE.md aligned to actual v1.5 implementations. Five previously-incorrect module descriptions fixed (deploy, extract, noise, probe, nettaps).
• LICENSE.md section 8 added: "BitChat Naming: Nominative Fair Use" with full independent implementation disclaimer.
• Stale references purged: module counts (18 -> 19), version strings, "addon-emulator-1.0 package" reference in main.c removed.

[v1.5] -- 2026-07-14

The "Implementations Restored" Release

v1.4 shipped 18 module slots with zero functional code -- every module was a build-linkable stub that displayed a label and logged init/deinit. v1.5 restores all 12 original module implementations from the v1.3 upstream source set, adapted to the v1.4 build infrastructure and header API.

Fixed

• emulator_input_mapper build target no longer links against LVGL. v1.4's Makefile.h2-core-v6.1 compiled the mapper stub with -llvgl, which would break the real standalone uinput daemon. v1.5's Makefile.h2-core-v6.2 builds the mapper with zero LVGL flags or libraries -- it is a pure uinput daemon.
• main.c restored to fork/exec launcher model. v1.4's main.c ran a single monolithic LVGL event loop with all modules as stub callbacks. v1.5 restores the v1.3 fork/exec broker: the launcher shows the module menu, fork+execs the selected .mod binary, and waitpid() blocks until the child exits. Each module binary initializes its own LVGL instance and runs its own event loop.
• h2_ui.h merges v1.3 and v1.4 APIs. Provides both the init_h2_graphics_runtime() inline bootstrap (for standalone .mod binaries) and the h2_module_t registration API (for the launcher menu). Also defines H2 input event code constants (H2_KEY_PLAY, H2_KEY_BACK, etc.) used uniformly across all modules.
• log_manager.h merges v1.3 and v1.4 logging. Provides both the v1.4 structured log level interface (LOG_INF/DBG/ERR macros, log_init/log_write/log_close) and the v1.3 flash-safe timed coalescer (timed_log_init/timed_log_write/timed_log_flush_to_media) with 64KB RAM buffer and configurable windowed disk flush.
• S99broker OREBOLT_VERSION fixed to 1.5 (was still "1.4").

Changed

• Module count in Makefile: 18 .mod binaries + 1 standalone daemon. v1.4's Makefile listed 18 entries including emulator_input_mapper as an LVGL module. v1.5 lists 18 .mod entries (rfid/wifi/glitch/ pwdb/bitchat remain stubs) plus a separate mapper target that builds the standalone daemon without LVGL.
• Sub-Makefile bumped: Makefile.h2-core-v6.1 -> Makefile.h2-core-v6.2, Makefile.orebolt-v1.4 -> Makefile.orebolt-v1.5.
• Master Makefile updated to reference v6.2 and v1.5 sub-makefiles.
• radar module now links against -lbluetooth for BlueZ HCI calls.
• All restored modules use H2_KEY_BACK/H2_KEY_PLAY constants instead of hardcoded key codes (158/164), and include LOG_INF/LOG_ERR calls.
• vault upgraded to full PIN auth module. The original v1.3/v1.5 entropy-only display has been replaced with the complete Master Manifest vault implementation: 4-digit PIN entry with rotary encoder, non-volatile failure tracking, 300s lockout penalty, and dual wired/wireless identity modes with automatic USB/BLE state enforcement based on cable detection.
• studio upgraded to UAC2 Mixer Console. The original v1.3/v1.5 frequency analyzer has been replaced with the complete Master Manifest studio implementation: 4-channel mixer (GAME/DISCORD/ MIC/MUSIC) with per-channel volume bars, USB Consumer Control HID commands via /dev/hidg1 (vol up/down/mute), NEXT/PREV key channel switching, and hardware mute toggle with visual feedback.
• S99broker now sets system volumes to maximum on boot via amixer sset 'Master' 100% unmute and amixer sset 'Headphone' 100% unmute, matching the Master Manifest boot sequence.

Added

• 13 fully functional module implementations restored from v1.3 and Master Manifest:
  • vault -- Crypto Security Token Vault Gateway. Full PIN authentication system (default 4-2-9-1) with rotary digit entry, non-volatile failure tracking via /data/vault/failures.dat, 3-attempt lockout with 300s penalty countdown. Dual identity modes: WIRED (USB composite gadget via enable_vault_usb.sh) and WIRELESS BLE (via enable_vault_ble.sh) with automatic switching based on USB cable detection. RAM key purge on BACK exit.
  • nettaps -- USB Virtual Network Tap. Selectable time-window coalescer (30s/1m/2m/5m/10m), raw AF_PACKET capture on usb0, IP packet parsing, live LVGL console, flash-safe timed disk flush.
  • scalpel -- Acoustic Scalpel Live Sound Synthesizer. NEW module from Master Manifest (Asset V). POSIX-threaded audio synthesis writing to /dev/dsp at 44.1kHz. SINE and SQUARE waveforms with real-time frequency tuning (20 Hz - 20 kHz) via rotary encoder in 10 Hz steps. PLAY toggles waveform.
  • deploy -- Flash Storage Manager. statvfs("/") display of total/used/free MB with percentage, manual sync() via PLAY button.
  • studio -- Studio Audio Class 2.0 Streaming Control Console. 4-channel mixer (GAME/DISCORD/MIC/MUSIC) with per-channel volume bars, NEXT/PREV key channel switching, PLAY toggles hardware mute. Sends USB Consumer Control HID commands (volume up/down/mute) to host via /dev/hidg1. DAC link status display (PCM 24-bit / 192 kHz).
  • probe -- I2C Bus Hardware Scanner. Probes /dev/i2c-0 address space 0x03-0x77, displays responding devices with green highlighting.
  • vterm -- FreeDOS Emulation Bridge. fork+exec dosbox with custom config, SIGTERM cleanup on BACK key, waitpid(WNOHANG) monitoring.
  • radar -- BLE Device Radar Scanner. BlueZ HCI inquiry with RSSI (primary) or standard inquiry (fallback), 19-cell hexagonal heatmap grid, 3-tier RSSI color coding, auto-repeating scan loop.
  • pauto -- Payload Automation (HID Keystroke Injector). Full OreBolt macro command language parser (DELAY, STRING, REM, modifier+key combos), USB HID keycode table (a-z, A-Z, 0-9, punctuation, F1-F12), rotary-scrollable payload picker, 8-byte report via /dev/hidg0.
  • extract -- Mass Storage Extractor. Recursive copy from /mnt/target_media to /data/loot_drop/extracted/, skips symlinks, 4KB chunk copy, displays file/dir/byte counts.
  • noise -- USB Hardware TRNG Stream. Generates 32-byte true entropy blocks via getrandom(GRND_RANDOM), pipes to host over CDC ACM serial (/dev/ttyGS0) at 100Hz.
  • reset -- System Stack Purge/Reset. 3-state machine (CONFIRM->RUNNING->DONE), kills dosbox, brings usb0 down, deletes /data/loot_drop contents, calls sync().
  • emulate -- Universal Retro Game Launcher. 17-type ROM database (NES/FDS/SNES/GB/GBC/GBA/Genesis/SMS/GameGear/PCE/ Atari2600/NeoGeoP), recursive /data/roms/ scan, 13-system filter with rapid-rotate cycling, fork+exec emulator launch, BACK kills child with SIGTERM.
• emulator_input_mapper standalone daemon -- fully integrated from addon-emulator-1.0 (no longer a separate addon package). Full 456-line uinput gamepad translator: rotary encoder to d-pad (V-mode/H-mode toggle, 3s auto-revert), PLAY/BACK to A/B (short) and START/SELECT (long 1.5s), PREV/NEXT to L/R shoulders, combo buttons for X/Y. Creates "H2 Virtual Gamepad" via /dev/uinput. Now built with -fstack-protector-strong -D_FORTIFY_SOURCE=2.
• S98emulator-input init script upgraded from addon-emulator-1.0. Replaces the minimal start-stop-daemon wrapper with full PID tracking, daemon existence checks, graceful TERM→KILL escalation (2s timeout), stale pidfile detection, and status command.
• ROM directory structure created in overlay/data/roms/ for 11 systems: nes, snes, gb, gbc, gba, genesis, sms, gg, pce, atari2600, ngp. Directories are created both at build time (makefile rom-dirs target) and shipped in the overlay tree.
• overlay/data/bt_config/paired_macs.txt -- Trusted accessory MAC allow-list for bt_input_daemon.sh autoconnect.
• overlay/data/chat_config/macros.txt -- 10 pre-defined BitChat mesh command templates (STATUS/ALERT/CMD/TEST/PANIC types).

Still Stubs (5 modules)

The following modules added in v1.4 remain as stubs pending real hardware implementations:

• rfid -- RFID reader (no hardware spec yet)
• wifi -- WiFi management (no driver support yet)
• glitch -- Glitch/fault injection (hardware-dependent)
• pwdb -- Password database (design phase)
• bitchat -- Mesh frontend (liborebolt.a has mod_bitchat_mesh.c with bloom filter, but the .mod UI stub needs real BLE mesh code)

[v1.4] -- 2026-07-13

Rebrand: "Project Orebolt" -> "OreBolt OS"

The project has been rebranded from "Project Orebolt" to OreBolt OS. The v1.4 release is a build-and-licensing cleanup pass. All 18 module .c files are build-linkable stubs. See the full v1.4 changelog for details on the SoC correction, SHA256SUMS fix, and AGPL licensing.

[v1.3] -- 2026-07-13 (pre-cleanup)

Initial public drop. Shipped the overlay tree and all 12 module implementations as standalone fork/exec binaries. Targeted the wrong SoC (T31 instead of X1000E). See v1.4 changelog for cleanup details.