// Commander X16 Emulator
// Copyright (c) 2019 Michael Steil
// All rights reserved. License: 2-clause BSD

#pragma once

#include <inttypes.h>
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

void vera_spi_init();
void vera_spi_step(int mhz, int clocks);
uint8_t vera_spi_read(uint8_t address);
// Side-effect-free read of the same registers, for debug views. Unlike
// vera_spi_read(), does not start an autotx transfer.
uint8_t vera_spi_peek(uint8_t address);
void vera_spi_write(uint8_t address, uint8_t value);

// ─── Debugger accessor ───────────────────────────────────────────────────────
// Side-effect-free snapshot of VERA SPI state. Safe to call every frame from
// the debugger while the emulation is running.

typedef struct {
	bool    ss;            // slave-select (chip-select) asserted
	bool    busy;          // transfer currently in flight
	bool    autotx;        // auto-transmit mode active
	uint8_t sending_byte;  // byte currently being clocked out
	uint8_t received_byte; // last byte received from card
	float   outcounter;    // clock-cycle progress toward transfer completion
} vera_spi_debug_state_t;

void vera_spi_debug_get_state(vera_spi_debug_state_t *out);

#ifdef __cplusplus
}
#endif