ac6502 1.3.0 → 1.4.1

package/dist/components/IO/Attachments/Attachment.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Interface for devices that can be attached to GPIO ports
+ */
+export interface Attachment {
+    /**
+     * Reset the attachment to its initial state
+     */
+    reset(): void;
+    /**
+     * Update the attachment state based on CPU clock ticks
+     * @param cpuFrequency - The CPU frequency in Hz
+     */
+    tick(cpuFrequency: number): void;
+    /**
+     * Read data from Port A
+     * @param ddr - Data Direction Register value
+     * @param or - Output Register value
+     * @returns The data to be read from the port
+     */
+    readPortA(ddr: number, or: number): number;
+    /**
+     * Read data from Port B
+     * @param ddr - Data Direction Register value
+     * @param or - Output Register value
+     * @returns The data to be read from the port
+     */
+    readPortB(ddr: number, or: number): number;
+    /**
+     * Write data to Port A
+     * @param value - The value being written
+     * @param ddr - Data Direction Register value
+     */
+    writePortA(value: number, ddr: number): void;
+    /**
+     * Write data to Port B
+     * @param value - The value being written
+     * @param ddr - Data Direction Register value
+     */
+    writePortB(value: number, ddr: number): void;
+    /**
+     * Check if the attachment is enabled
+     * @returns true if enabled, false otherwise
+     */
+    isEnabled(): boolean;
+    /**
+     * Get the priority of this attachment (lower values = higher priority)
+     * @returns The priority value
+     */
+    getPriority(): number;
+    /**
+     * Clear interrupt flags
+     * @param ca1 - Clear CA1 interrupt
+     * @param ca2 - Clear CA2 interrupt
+     * @param cb1 - Clear CB1 interrupt
+     * @param cb2 - Clear CB2 interrupt
+     */
+    clearInterrupts(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    /**
+     * Update control line states
+     * @param ca1 - CA1 control line state
+     * @param ca2 - CA2 control line state
+     * @param cb1 - CB1 control line state
+     * @param cb2 - CB2 control line state
+     */
+    updateControlLines(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    /**
+     * Check if CA1 interrupt is pending
+     * @returns true if interrupt is pending
+     */
+    hasCA1Interrupt(): boolean;
+    /**
+     * Check if CA2 interrupt is pending
+     * @returns true if interrupt is pending
+     */
+    hasCA2Interrupt(): boolean;
+    /**
+     * Check if CB1 interrupt is pending
+     * @returns true if interrupt is pending
+     */
+    hasCB1Interrupt(): boolean;
+    /**
+     * Check if CB2 interrupt is pending
+     * @returns true if interrupt is pending
+     */
+    hasCB2Interrupt(): boolean;
+}
+/**
+ * Base abstract class for GPIO attachments with common functionality
+ */
+export declare abstract class AttachmentBase implements Attachment {
+    protected priority: number;
+    protected enabled: boolean;
+    protected ca1Interrupt: boolean;
+    protected ca2Interrupt: boolean;
+    protected cb1Interrupt: boolean;
+    protected cb2Interrupt: boolean;
+    constructor(priority: number, ca1Interrupt?: boolean, ca2Interrupt?: boolean, cb1Interrupt?: boolean, cb2Interrupt?: boolean);
+    reset(): void;
+    tick(cpuFrequency: number): void;
+    readPortA(ddr: number, or: number): number;
+    readPortB(ddr: number, or: number): number;
+    writePortA(value: number, ddr: number): void;
+    writePortB(value: number, ddr: number): void;
+    isEnabled(): boolean;
+    getPriority(): number;
+    clearInterrupts(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    updateControlLines(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    hasCA1Interrupt(): boolean;
+    hasCA2Interrupt(): boolean;
+    hasCB1Interrupt(): boolean;
+    hasCB2Interrupt(): boolean;
+}

package/dist/components/IO/Attachments/Attachment.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentBase = void 0;
+/**
+ * Base abstract class for GPIO attachments with common functionality
+ */
+class AttachmentBase {
+    constructor(priority, ca1Interrupt = false, ca2Interrupt = false, cb1Interrupt = false, cb2Interrupt = false) {
+        this.priority = priority;
+        this.enabled = true;
+        this.ca1Interrupt = ca1Interrupt;
+        this.ca2Interrupt = ca2Interrupt;
+        this.cb1Interrupt = cb1Interrupt;
+        this.cb2Interrupt = cb2Interrupt;
+    }
+    reset() {
+        this.enabled = true;
+        this.ca1Interrupt = false;
+        this.ca2Interrupt = false;
+        this.cb1Interrupt = false;
+        this.cb2Interrupt = false;
+    }
+    tick(cpuFrequency) {
+        // Default: no action
+    }
+    readPortA(ddr, or) {
+        return 0xFF;
+    }
+    readPortB(ddr, or) {
+        return 0xFF;
+    }
+    writePortA(value, ddr) {
+        // Default: no action
+    }
+    writePortB(value, ddr) {
+        // Default: no action
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    getPriority() {
+        return this.priority;
+    }
+    clearInterrupts(ca1, ca2, cb1, cb2) {
+        if (ca1)
+            this.ca1Interrupt = false;
+        if (ca2)
+            this.ca2Interrupt = false;
+        if (cb1)
+            this.cb1Interrupt = false;
+        if (cb2)
+            this.cb2Interrupt = false;
+    }
+    updateControlLines(ca1, ca2, cb1, cb2) {
+        // Default: no action
+    }
+    hasCA1Interrupt() {
+        return this.ca1Interrupt;
+    }
+    hasCA2Interrupt() {
+        return this.ca2Interrupt;
+    }
+    hasCB1Interrupt() {
+        return this.cb1Interrupt;
+    }
+    hasCB2Interrupt() {
+        return this.cb2Interrupt;
+    }
+}
+exports.AttachmentBase = AttachmentBase;
+//# sourceMappingURL=Attachment.js.map

package/dist/components/IO/Attachments/Attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Attachment.js","sourceRoot":"","sources":["../../../../src/components/IO/Attachments/Attachment.ts"],"names":[],"mappings":";;;AAoGA;;GAEG;AACH,MAAsB,cAAc;IAQlC,YACE,QAAgB,EAChB,eAAwB,KAAK,EAC7B,eAAwB,KAAK,EAC7B,eAAwB,KAAK,EAC7B,eAAwB,KAAK;QAE7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QACzB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;IAC3B,CAAC;IAED,IAAI,CAAC,YAAoB;QACvB,qBAAqB;IACvB,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,EAAU;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,EAAU;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,GAAW;QACnC,qBAAqB;IACvB,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,GAAW;QACnC,qBAAqB;IACvB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,eAAe,CAAC,GAAY,EAAE,GAAY,EAAE,GAAY,EAAE,GAAY;QACpE,IAAI,GAAG;YAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QAClC,IAAI,GAAG;YAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QAClC,IAAI,GAAG;YAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;QAClC,IAAI,GAAG;YAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;IACpC,CAAC;IAED,kBAAkB,CAAC,GAAY,EAAE,GAAY,EAAE,GAAY,EAAE,GAAY;QACvE,qBAAqB;IACvB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;CACF;AArFD,wCAqFC"}

package/dist/components/IO/Attachments/JoystickAttachment.d.ts

@@ -0,0 +1,53 @@
+import { AttachmentBase } from './Attachment';
+/**
+ * JoystickAttachment - Emulates a joystick/gamepad connected to GPIO port
+ *
+ * Buttons are active-low (0 = pressed, 1 = released)
+ * Can be attached to either Port A or Port B
+ */
+export declare class JoystickAttachment extends AttachmentBase {
+    static readonly BUTTON_UP = 1;
+    static readonly BUTTON_DOWN = 2;
+    static readonly BUTTON_LEFT = 4;
+    static readonly BUTTON_RIGHT = 8;
+    static readonly BUTTON_A = 16;
+    static readonly BUTTON_B = 32;
+    static readonly BUTTON_SELECT = 64;
+    static readonly BUTTON_START = 128;
+    private buttonState;
+    private attachedToPortA;
+    constructor(attachToPortA?: boolean, priority?: number);
+    reset(): void;
+    readPortA(ddr: number, or: number): number;
+    readPortB(ddr: number, or: number): number;
+    /**
+     * Update the joystick button state
+     * @param buttons - Button state byte (1 = pressed, 0 = released)
+     */
+    updateJoystick(buttons: number): void;
+    /**
+     * Get the current button state
+     * @returns The button state byte
+     */
+    getButtonState(): number;
+    /**
+     * Check if a specific button is pressed
+     * @param button - Button bit mask to check
+     * @returns true if button is pressed
+     */
+    isButtonPressed(button: number): boolean;
+    /**
+     * Press a button (set its bit)
+     * @param button - Button bit mask to press
+     */
+    pressButton(button: number): void;
+    /**
+     * Release a button (clear its bit)
+     * @param button - Button bit mask to release
+     */
+    releaseButton(button: number): void;
+    /**
+     * Clear all button presses
+     */
+    releaseAllButtons(): void;
+}

package/dist/components/IO/Attachments/JoystickAttachment.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JoystickAttachment = void 0;
+const Attachment_1 = require("./Attachment");
+/**
+ * JoystickAttachment - Emulates a joystick/gamepad connected to GPIO port
+ *
+ * Buttons are active-low (0 = pressed, 1 = released)
+ * Can be attached to either Port A or Port B
+ */
+class JoystickAttachment extends Attachment_1.AttachmentBase {
+    constructor(attachToPortA = true, priority = 0) {
+        // Call parent constructor with priority and no control line interrupts
+        super(priority, false, false, false, false);
+        this.attachedToPortA = attachToPortA;
+        this.buttonState = 0x00;
+        this.reset();
+    }
+    reset() {
+        super.reset();
+        this.buttonState = 0x00;
+    }
+    readPortA(ddr, or) {
+        if (this.attachedToPortA) {
+            // Return inverted button state (active-low)
+            return (~this.buttonState) & 0xFF;
+        }
+        return 0xFF;
+    }
+    readPortB(ddr, or) {
+        if (!this.attachedToPortA) {
+            // Return inverted button state (active-low)
+            return (~this.buttonState) & 0xFF;
+        }
+        return 0xFF;
+    }
+    /**
+     * Update the joystick button state
+     * @param buttons - Button state byte (1 = pressed, 0 = released)
+     */
+    updateJoystick(buttons) {
+        this.buttonState = buttons & 0xFF;
+    }
+    /**
+     * Get the current button state
+     * @returns The button state byte
+     */
+    getButtonState() {
+        return this.buttonState;
+    }
+    /**
+     * Check if a specific button is pressed
+     * @param button - Button bit mask to check
+     * @returns true if button is pressed
+     */
+    isButtonPressed(button) {
+        return (this.buttonState & button) !== 0;
+    }
+    /**
+     * Press a button (set its bit)
+     * @param button - Button bit mask to press
+     */
+    pressButton(button) {
+        this.buttonState |= button;
+    }
+    /**
+     * Release a button (clear its bit)
+     * @param button - Button bit mask to release
+     */
+    releaseButton(button) {
+        this.buttonState &= ~button;
+    }
+    /**
+     * Clear all button presses
+     */
+    releaseAllButtons() {
+        this.buttonState = 0x00;
+    }
+}
+exports.JoystickAttachment = JoystickAttachment;
+// Joystick button bit masks
+JoystickAttachment.BUTTON_UP = 0x01;
+JoystickAttachment.BUTTON_DOWN = 0x02;
+JoystickAttachment.BUTTON_LEFT = 0x04;
+JoystickAttachment.BUTTON_RIGHT = 0x08;
+JoystickAttachment.BUTTON_A = 0x10;
+JoystickAttachment.BUTTON_B = 0x20;
+JoystickAttachment.BUTTON_SELECT = 0x40;
+JoystickAttachment.BUTTON_START = 0x80;
+//# sourceMappingURL=JoystickAttachment.js.map

package/dist/components/IO/Attachments/JoystickAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoystickAttachment.js","sourceRoot":"","sources":["../../../../src/components/IO/Attachments/JoystickAttachment.ts"],"names":[],"mappings":";;;AAAA,6CAA6C;AAE7C;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,2BAAc;IAcpD,YAAY,gBAAyB,IAAI,EAAE,WAAmB,CAAC;QAC7D,uEAAuE;QACvE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;QAC3C,IAAI,CAAC,eAAe,GAAG,aAAa,CAAA;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,IAAI,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;IAED,KAAK;QACH,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,EAAU;QAC/B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,4CAA4C;YAC5C,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;QACnC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,EAAU;QAC/B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,4CAA4C;YAC5C,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;QACnC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAe;QAC5B,IAAI,CAAC,WAAW,GAAG,OAAO,GAAG,IAAI,CAAA;IACnC,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,MAAc;QAC5B,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1C,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,MAAc;QACxB,IAAI,CAAC,WAAW,IAAI,MAAM,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,MAAc;QAC1B,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;;AAzFH,gDA0FC;AAzFC,4BAA4B;AACZ,4BAAS,GAAG,IAAI,CAAA;AAChB,8BAAW,GAAG,IAAI,CAAA;AAClB,8BAAW,GAAG,IAAI,CAAA;AAClB,+BAAY,GAAG,IAAI,CAAA;AACnB,2BAAQ,GAAG,IAAI,CAAA;AACf,2BAAQ,GAAG,IAAI,CAAA;AACf,gCAAa,GAAG,IAAI,CAAA;AACpB,+BAAY,GAAG,IAAI,CAAA"}

package/dist/components/IO/Attachments/KeyboardEncoderAttachment.d.ts

@@ -0,0 +1,63 @@
+import { AttachmentBase } from './Attachment';
+/**
+ * KeyboardEncoderAttachment - Emulates a keyboard encoder that provides ASCII-encoded
+ * key data on both GPIO ports A and B.
+ *
+ * This attachment uses the VIA control lines to signal data availability:
+ * - CA2 LOW enables Port A
+ * - CB2 LOW enables Port B
+ * - CA1 interrupt signals data ready on Port A
+ * - CB1 interrupt signals data ready on Port B
+ *
+ * The encoder supports extensive modifier key combinations:
+ * - MENU key: 0x80 (alone), 0x90 (with Alt)
+ * - Function keys F1-F15: 0x81-0x8F (alone), 0x91-0x9F (with Alt)
+ * - Ctrl combinations: Control codes 0x00-0x1F
+ * - Alt+Shift: Extended character set 0xA0-0xFF
+ * - Alt: Extended character set 0xE0-0xFF
+ * - Shift: Uppercase letters and shifted symbols
+ */
+export declare class KeyboardEncoderAttachment extends AttachmentBase {
+    private asciiDataA;
+    private dataReadyA;
+    private interruptPendingA;
+    private enabledA;
+    private asciiDataB;
+    private dataReadyB;
+    private interruptPendingB;
+    private enabledB;
+    private shiftPressed;
+    private ctrlPressed;
+    private altPressed;
+    private menuPressed;
+    private stateCA1;
+    private stateCA2;
+    private stateCB1;
+    private stateCB2;
+    constructor(priority?: number);
+    reset(): void;
+    readPortA(ddrA: number, orA: number): number;
+    readPortB(ddrB: number, orB: number): number;
+    updateControlLines(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    hasCA1Interrupt(): boolean;
+    hasCB1Interrupt(): boolean;
+    clearInterrupts(ca1: boolean, ca2: boolean, cb1: boolean, cb2: boolean): void;
+    /**
+     * Map a USB HID keycode to ASCII with modifier keys applied
+     */
+    private mapKeyWithModifiers;
+    /**
+     * Update the keyboard state based on a USB HID key press or release
+     * @param usbHidKeycode USB HID keycode
+     * @param pressed true for key press, false for key release
+     */
+    updateKey(usbHidKeycode: number, pressed: boolean): void;
+    /**
+     * Check if Port A has data ready
+     */
+    hasDataReadyA(): boolean;
+    /**
+     * Check if Port B has data ready
+     */
+    hasDataReadyB(): boolean;
+}