Robert Allan JamesandClaude Sonnet 5
3699be964d
Introduces src/starkernel/heartbeat.c as the shared top/bottom-half implementation of heartbeat_init/tick/service/ticks/trust/state, replacing the per-architecture duplicates in amd64/riscv64/aarch64 timer.c. Each arch's timer.c now contributes only heartbeat_read_counter() (rdtsc / rdtime / CNTPCT_EL0). Per the GAP-A1 ruling the top half stays counter+ latch only; heartbeat_service() (called every REPL idle iteration, unconditionally per FABRIC.md's fidelity note) does the window/variance/ trust work outside interrupt context. vm_tick()'s call sites are unchanged -- the engine still runs on the virtual tick. Per FABRIC.md §26 (ruled 2026-08-03): wires Loop #7's execution-derived stable/volatile signal into the physical re-arm period. vm_runtime.c's existing Loop #7 site now calls heartbeat_set_adaptive_period_ns() with tick_target_ns ratio-rescaled onto a 10ms kernel base (not the hosted 10us HEARTBEAT_TICK_NS -- see §26.3 for the scale mismatch). Each architecture's re-arm function (apic_timer_rearm() on amd64/aarch64, riscv64_timer_rearm()) now converts heartbeat_next_period_ns() to its own raw counter units instead of a fixed constant; amd64 gained a rearm function it didn't previously need, since periodic-mode auto-reload never required one before this item. Verified: all three architectures build with no new warnings and boot cleanly to ok> with dict_hash=0x3d4e1daf289da94f, unchanged from the pre-change baseline -- no regression. Verified NOT achieved: live re-arm period variation under load. A temporary diagnostic (added and reverted) confirmed Loop #7 never actually fired during a live QEMU session -- a synthetic word-execution loop drove ~6,500 executions, past the 1000-tick inference frequency, without tripping vm_tick_inference_engine()'s pre-existing !vm->rolling_window.is_warm gate. That gate predates this item and was not investigated -- out of scope. FABRIC.md's Done-when is amended to record this honestly rather than claim it. Punch list §25 item 0.8 complete (per amended, weaker acceptance -- see the item's own annotation). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
96 lines
2.8 KiB
C
96 lines
2.8 KiB
C
/*
|
||
StarForth — Steady-State Virtual Machine Runtime
|
||
|
||
Copyright (c) 2023–2025 Robert A. James
|
||
All rights reserved.
|
||
|
||
This file is part of the StarForth project.
|
||
|
||
Licensed under the StarForth License, Version 1.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
|
||
You may obtain a copy of the License at:
|
||
https://github.com/star.4th@proton.me/StarForth/LICENSE.txt
|
||
|
||
This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||
express or implied, including but not limited to the warranties of
|
||
merchantability, fitness for a particular purpose, and noninfringement.
|
||
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
|
||
StarForth — Steady-State Virtual Machine Runtime
|
||
Copyright (c) 2023–2025 Robert A. James
|
||
All rights reserved.
|
||
|
||
This file is part of the StarForth project.
|
||
|
||
Licensed under the StarForth License, Version 1.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
|
||
You may obtain a copy of the License at:
|
||
https://github.com/star.4th@proton.me/StarForth/LICENSE.txt
|
||
|
||
This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||
express or implied, including but not limited to the warranties of
|
||
merchantability, fitness for a particular purpose, and noninfringement.
|
||
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
|
||
*/
|
||
|
||
/**
|
||
* apic.h - Local APIC interface
|
||
*/
|
||
|
||
#ifndef STARKERNEL_APIC_H
|
||
#define STARKERNEL_APIC_H
|
||
|
||
#include "uefi.h"
|
||
#include <stdint.h>
|
||
|
||
/* Heartbeat timer vector (user-defined IRQ space starts at 0x20) */
|
||
#define APIC_TIMER_VECTOR 0x20
|
||
|
||
/* Initialize Local APIC (enables APIC, sets spurious vector) */
|
||
int apic_init(BootInfo *boot_info);
|
||
|
||
/* Send End-of-Interrupt signal */
|
||
void apic_eoi(void);
|
||
|
||
/*
|
||
* Initialize APIC timer for periodic heartbeat.
|
||
* @param tsc_hz TSC frequency in Hz (for calibration)
|
||
* @param tick_hz Desired tick frequency (e.g., 100 = 100 Hz = 10ms period)
|
||
* @return 0 on success, -1 on failure
|
||
*/
|
||
int apic_timer_init(uint64_t tsc_hz, uint32_t tick_hz);
|
||
|
||
/**
|
||
* Start the APIC timer (enables periodic interrupts).
|
||
* Call this after IDT and heartbeat handler are set up.
|
||
*/
|
||
void apic_timer_start(void);
|
||
|
||
/**
|
||
* Stop the APIC timer (disables periodic interrupts).
|
||
*/
|
||
void apic_timer_stop(void);
|
||
|
||
/**
|
||
* Re-arm the APIC timer at the current adaptive period (item 0.8, §26).
|
||
* Recomputes the initial count from heartbeat_next_period_ns() and writes
|
||
* it to the ICR; a periodic-mode ICR write restarts the countdown
|
||
* immediately at the new value. Called once per tick from the ISR, before
|
||
* heartbeat_tick().
|
||
*/
|
||
void apic_timer_rearm(void);
|
||
|
||
/**
|
||
* Get the configured timer period in TSC ticks.
|
||
*/
|
||
uint64_t apic_timer_period_tsc(void);
|
||
|
||
#endif /* STARKERNEL_APIC_H */
|