mirror of
https://github.com/RetroPortingToolKit/psxrecomp
synced 2026-10-26 02:11:36 -04:00
Alex Vanderveen
31015ceab1
Wire MotK-style lobby (recomp-net submodule, WS client, match_caps), netplay delay-sync, and launcher UX so host sim settings stay aligned across peers. Co-authored-by: Cursor <cursoragent@cursor.com>
125 lines
4.5 KiB
C
125 lines
4.5 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
|
|
# ifdef PSX_NO_DEBUG_TOOLS
|
|
# define STARVATION_RING_ENABLED 0
|
|
# else
|
|
# define STARVATION_RING_ENABLED 1
|
|
# endif
|
|
#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);
|
|
|
|
/* Rematch / session_reboot: clear ring + watchdog so a prior match cannot
|
|
* poison the next dump or leave s_dump_done set. */
|
|
void starvation_ring_reset(void);
|
|
|
|
/* 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 */
|