mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-28 10:59:16 -04:00
Matthew Stanley
12934ed2c5
- runtime/src/data_shards.c + include: read-before-write recorder fed from the memory chokepoints; byte-verified replay (kernel-bless pattern); recorded-cycle credit in slices through psx_advance_cycles + psx_check_interrupts_at; purity poisons (MMIO/DMA/thread-switch/budget); .dss persistence under the unified cache dir; TCP data_shards cmd. - emitter: [data_shards] funcs -> psx_datashard_enter at entry + psx_datashard_ret at jr-$ra sites (rolls cg-hash). - obs: phase_hot set=static keyed on new g_psx_last_fn_entry entry stamp (current_func dispatch stamp survives post-IRQ resumption and pooled 55% of static samples on kernel 0xF40); TCP starv_ring query for the always-on PC-sample ring. - docs/DATA_SHARDS.md: design, soundness model, gates, FMV exclusion.
117 lines
4.3 KiB
C
117 lines
4.3 KiB
C
/*
|
|
* starvation_ring.h — Always-on diagnostic ring for capturing SIO/MMIO
|
|
* state immediately before a TCP-starvation hang.
|
|
*
|
|
* Phase 1.0e-e2 debug aid. Scope: diagnostic-only. Records every SIO MMIO
|
|
* event (TX_DATA write, RX read, STAT read, CTRL write) plus a snapshot
|
|
* of all SIO bus state at that moment. Watchdog monitors host wall-clock
|
|
* since last debug_server_poll; if it exceeds a threshold, the ring is
|
|
* flushed to disk and the process aborts cleanly so the dump survives.
|
|
*
|
|
* NOT for permanent use. Disabled by setting STARVATION_RING_ENABLED=0.
|
|
*/
|
|
#ifndef PSXRECOMP_STARVATION_RING_H
|
|
#define PSXRECOMP_STARVATION_RING_H
|
|
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef STARVATION_RING_ENABLED
|
|
#define STARVATION_RING_ENABLED 1
|
|
#endif
|
|
|
|
#define STARVATION_RING_CAP (1 << 14) /* 16K entries */
|
|
|
|
typedef enum {
|
|
SR_EVT_NONE = 0,
|
|
SR_EVT_TX_DATA_WRITE = 1,
|
|
SR_EVT_RX_DATA_READ = 2,
|
|
SR_EVT_STAT_READ = 3,
|
|
SR_EVT_CTRL_WRITE = 4,
|
|
SR_EVT_MODE_WRITE = 5,
|
|
SR_EVT_BAUD_WRITE = 6,
|
|
SR_EVT_SHIFT_START = 7,
|
|
SR_EVT_BUFFER_LOAD = 8,
|
|
SR_EVT_TX_DROPPED = 9,
|
|
SR_EVT_SHIFT_DONE = 10,
|
|
SR_EVT_ACK_FIRE = 11,
|
|
SR_EVT_SELECT_ASSERT = 12,
|
|
SR_EVT_SELECT_DEASS = 13,
|
|
SR_EVT_RESET = 14,
|
|
SR_EVT_PC_SAMPLE = 15, /* periodic PC sample, no MMIO event */
|
|
} StarvationEventKind;
|
|
|
|
typedef struct {
|
|
uint64_t seq; /* monotonic sequence */
|
|
uint64_t psx_cycle_count; /* guest cycle clock at event */
|
|
uint64_t host_us; /* host monotonic time in microseconds */
|
|
uint32_t current_func; /* g_debug_current_func_addr */
|
|
uint32_t last_store_pc; /* g_debug_last_store_pc */
|
|
uint16_t sio_ctrl;
|
|
uint16_t sio_stat;
|
|
uint8_t tx_data; /* on TX_DATA writes; else 0 */
|
|
uint8_t rx_data; /* on RX_DATA reads; else 0 */
|
|
uint8_t kind; /* StarvationEventKind */
|
|
uint8_t in_exception;
|
|
uint8_t shift_active;
|
|
uint8_t tx_buffered;
|
|
uint8_t pending_ack;
|
|
uint8_t bus_owner; /* SioBusOwner */
|
|
uint8_t active_device; /* DEV_NONE/PAD/MEMCARD */
|
|
uint8_t mc_state;
|
|
uint8_t pad_state;
|
|
uint8_t selected_slot;
|
|
uint8_t g_sio_timing_active;
|
|
uint8_t tx_rdy_visible; /* (sio_stat & 1) at event time */
|
|
uint8_t tx_em_visible; /* (sio_stat & 4) at event time */
|
|
uint8_t pad8;
|
|
uint16_t pad16;
|
|
int shift_remaining; /* cycles left on shifter */
|
|
int ack_remaining; /* cycles left on ack */
|
|
uint32_t bus_byte_index;
|
|
uint32_t i_stat;
|
|
uint32_t i_mask;
|
|
} StarvationEntry;
|
|
|
|
void starvation_ring_record(uint8_t kind, uint8_t tx, uint8_t rx,
|
|
uint16_t ctrl, uint16_t stat,
|
|
int shift_active, int shift_remaining,
|
|
int tx_buffered, int pending_ack,
|
|
int ack_remaining,
|
|
uint8_t bus_owner, uint32_t bus_byte_index,
|
|
uint8_t active_device, uint8_t mc_state,
|
|
uint8_t pad_state, uint8_t selected_slot,
|
|
int g_sio_timing_active);
|
|
|
|
/* Watchdog: call from debug_server_poll() to refresh the heartbeat.
|
|
* If too much wall-time passes without a refresh AND the BIOS is
|
|
* actively running (post-boot), the ring is dumped and the process
|
|
* aborts. */
|
|
void starvation_watchdog_heartbeat(void);
|
|
|
|
/* Run watchdog check from a hot path (e.g. psx_advance_cycles). */
|
|
void starvation_watchdog_check(void);
|
|
|
|
/* Manual dump-to-file (for testing / TCP probe). Filename can be NULL. */
|
|
void starvation_ring_dump(const char *path);
|
|
|
|
/* Periodic PC sample. Caller responsible for throttling. */
|
|
void starvation_ring_pc_sample(void);
|
|
|
|
/* Ring query (TCP `starv_ring`): total events recorded so far, and a copy
|
|
* of the entry with sequence number `seq` (0 = first ever). Returns 1 and
|
|
* fills *out when `seq` is still resident in the ring; 0 when evicted or
|
|
* not yet written. Same-thread with the writers (emu/main thread), so the
|
|
* copy is tear-free. */
|
|
uint64_t starvation_ring_total(void);
|
|
int starvation_ring_get(uint64_t seq, StarvationEntry *out);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* PSXRECOMP_STARVATION_RING_H */
|