// Commander X16 Emulator

// Copyright (c) 2021 Michael Steil

// All rights reserved. License: 2-clause BSD

#ifndef _RTC_H_

#define _RTC_H_

#include <stdint.h>

#include <stdbool.h>

#ifdef __cplusplus

extern "C" {

#endif

void rtc_i2c_data(uint8_t v);

void rtc_init(bool set_system_time);

void rtc_set_system_time();

void rtc_step(int c);

uint8_t rtc_read();

void rtc_write();

// ─── Debugger accessor ───────────────────────────────────────────────────────

// Side-effect-free snapshot of RTC state. Safe to call every frame from the

// debugger while the emulation is running.

//

// Calendar fields are plain integers (not BCD). `nvram` is a copy of the

// 64-byte battery-backed NVRAM owned by the RTC.

typedef struct {

	bool    running;        // oscillator is running (ST bit)

	bool    h24;            // 24-hour mode (true) vs 12-hour AM/PM mode (false)

	int     seconds;        // 0-59

	int     minutes;        // 0-59

	int     hours;          // 0-23 (always stored as 24h internally)

	int     day_of_week;    // 1-7 (1=Monday per MCP7940N convention)

	int     day;            // 1-31

	int     month;          // 1-12

	int     year;           // 0-99 (years since 2000)

	uint8_t i2c_data_pos;   // write position in the internal I2C data buffer

	uint8_t nvram[0x40];    // copy of the 64-byte NVRAM (battery-backed)

	bool    nvram_dirty;    // NVRAM has been written since last save

} rtc_debug_state_t;

void rtc_debug_get_state(rtc_debug_state_t *out);

#ifdef __cplusplus

}

#endif

#endif