2024-02-22 05:29:29 +00:00
|
|
|
/**
|
|
|
|
* @file Specific definitions of the event handlers (CPU & UI) used within this program
|
|
|
|
* @copyright Alexander Bass 2024
|
|
|
|
* @license GPL-3.0
|
|
|
|
*/
|
2024-02-16 08:44:20 +00:00
|
|
|
import { EventHandler } from "./eventHandler";
|
|
|
|
import { Instruction, ParameterType } from "./instructionSet";
|
2024-03-06 06:46:29 +00:00
|
|
|
import { u2, u3, u8 } from "./num";
|
2024-02-16 08:44:20 +00:00
|
|
|
|
2024-02-22 05:29:29 +00:00
|
|
|
//
|
|
|
|
// CPU Event Handler Definition
|
|
|
|
//
|
2024-02-16 05:17:23 +00:00
|
|
|
export enum CpuEvent {
|
|
|
|
MemoryChanged,
|
|
|
|
RegisterChanged,
|
|
|
|
ProgramCounterChanged,
|
2024-02-21 05:45:14 +00:00
|
|
|
InstructionParsed,
|
|
|
|
ParameterParsed,
|
|
|
|
InvalidParsed,
|
2024-02-16 08:44:20 +00:00
|
|
|
InstructionExecuted,
|
2024-02-22 05:29:29 +00:00
|
|
|
Cycle,
|
2024-02-16 05:17:23 +00:00
|
|
|
Print,
|
|
|
|
Reset,
|
2024-02-21 05:45:14 +00:00
|
|
|
Halt,
|
2024-02-23 06:37:12 +00:00
|
|
|
// ClockStarted,
|
|
|
|
// ClockStopped,
|
|
|
|
MemoryAccessed,
|
|
|
|
SwitchBank,
|
2024-02-25 01:33:54 +00:00
|
|
|
SetFlagCarry,
|
2024-02-16 05:17:23 +00:00
|
|
|
}
|
2024-02-16 08:44:20 +00:00
|
|
|
|
2024-02-23 06:37:12 +00:00
|
|
|
type VoidDataCpuEventList = CpuEvent.Halt | CpuEvent.Reset | CpuEvent.Cycle;
|
|
|
|
// | CpuEvent.ClockStarted
|
|
|
|
// | CpuEvent.ClockStopped;
|
2024-02-22 05:29:29 +00:00
|
|
|
|
2024-02-16 08:44:20 +00:00
|
|
|
interface CpuEventMap {
|
2024-02-25 01:33:54 +00:00
|
|
|
[CpuEvent.MemoryChanged]: { address: u8; bank: u2; value: u8 };
|
|
|
|
[CpuEvent.MemoryAccessed]: { address: u8; bank: u2; value: u8 };
|
2024-02-22 05:29:29 +00:00
|
|
|
[CpuEvent.RegisterChanged]: { register_no: u3; value: u8 };
|
2024-02-16 08:44:20 +00:00
|
|
|
[CpuEvent.ProgramCounterChanged]: { counter: u8 };
|
2024-02-21 05:45:14 +00:00
|
|
|
[CpuEvent.InstructionParsed]: { pos: u8; code: u8; instr: Instruction };
|
|
|
|
[CpuEvent.ParameterParsed]: { pos: u8; code: u8; param: ParameterType };
|
|
|
|
[CpuEvent.InvalidParsed]: { pos: u8; code: u8 };
|
2024-02-16 08:44:20 +00:00
|
|
|
[CpuEvent.InstructionExecuted]: { instr: Instruction };
|
2024-02-25 01:33:54 +00:00
|
|
|
[CpuEvent.SwitchBank]: { bank: u2 };
|
2024-02-16 08:44:20 +00:00
|
|
|
[CpuEvent.Print]: string;
|
2024-02-25 01:33:54 +00:00
|
|
|
[CpuEvent.SetFlagCarry]: boolean;
|
2024-02-16 08:44:20 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
export interface CpuEventHandler extends EventHandler<CpuEvent> {
|
2024-02-22 05:29:29 +00:00
|
|
|
listen<E extends VoidDataCpuEventList>(type: E, listener: () => void): void;
|
|
|
|
dispatch<E extends VoidDataCpuEventList>(type: E): void;
|
2024-02-16 08:44:20 +00:00
|
|
|
listen<E extends keyof CpuEventMap>(type: E, listener: (ev: CpuEventMap[E]) => void): void;
|
|
|
|
dispatch<E extends keyof CpuEventMap>(type: E, data: CpuEventMap[E]): void;
|
|
|
|
}
|
|
|
|
|
2024-02-22 05:29:29 +00:00
|
|
|
interface CpuEventHandlerConstructor {
|
|
|
|
new (): CpuEventHandler;
|
|
|
|
}
|
|
|
|
|
|
|
|
export const CpuEventHandler = EventHandler<CpuEvent> as CpuEventHandlerConstructor;
|
|
|
|
|
|
|
|
//
|
|
|
|
// Ui Event Handler Definition
|
|
|
|
//
|
|
|
|
|
2024-02-16 08:44:20 +00:00
|
|
|
export enum UiEvent {
|
2024-03-06 06:46:29 +00:00
|
|
|
// Maybe move these into a UI -> CPU signal system?
|
2024-02-16 08:44:20 +00:00
|
|
|
RequestCpuCycle,
|
2024-02-21 05:45:14 +00:00
|
|
|
RequestMemoryChange,
|
2024-03-06 06:46:29 +00:00
|
|
|
RequestRegisterChange,
|
|
|
|
// Ui Events
|
|
|
|
EditOn,
|
|
|
|
EditOff,
|
2024-02-16 08:44:20 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
interface UiEventMap {
|
2024-02-21 05:45:14 +00:00
|
|
|
[UiEvent.RequestCpuCycle]: number;
|
|
|
|
[UiEvent.RequestMemoryChange]: { address: u8; value: u8 };
|
2024-03-06 06:46:29 +00:00
|
|
|
[UiEvent.RequestRegisterChange]: { register_no: u3; value: u8 };
|
2024-02-16 08:44:20 +00:00
|
|
|
}
|
|
|
|
|
2024-03-06 06:46:29 +00:00
|
|
|
type VoidDataUiEventList = UiEvent.EditOn | UiEvent.EditOff;
|
|
|
|
|
2024-02-16 08:44:20 +00:00
|
|
|
export interface UiEventHandler extends EventHandler<UiEvent> {
|
|
|
|
listen<E extends keyof UiEventMap>(type: E, listener: (ev: UiEventMap[E]) => void): void;
|
|
|
|
dispatch<E extends keyof UiEventMap>(type: E, data: UiEventMap[E]): void;
|
2024-03-06 06:46:29 +00:00
|
|
|
listen<E extends VoidDataUiEventList>(type: E, listener: () => void): void;
|
|
|
|
dispatch<E extends VoidDataUiEventList>(type: E): void;
|
2024-02-16 08:44:20 +00:00
|
|
|
}
|
2024-02-22 05:29:29 +00:00
|
|
|
|
|
|
|
interface UiEventHandlerConstructor {
|
|
|
|
new (): UiEventHandler;
|
|
|
|
}
|
|
|
|
|
|
|
|
export const UiEventHandler = EventHandler<UiEvent> as UiEventHandlerConstructor;
|