ac6502 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # 6502 Emulator
 
-A comprehensive, cycle-accurate emulator for the [A.C. Wright Design 6502](https://github.com/acwright/6502) computer system, built with TypeScript and Node.js.
+A comprehensive, cycle-accurate emulator for the [A.C. Wright 6502](https://github.com/acwright/6502) computer system, built with TypeScript and Node.js.
 
 ## Overview
 
@@ -258,4 +258,4 @@ A.C. Wright
 
 ## Contributing
 
-This project is part of the [A.C. Wright Design 6502](https://github.com/acwright/6502) hardware project. Contributions, issues, and feature requests are welcome!
+This project is part of the [A.C. Wright Design 6502](https://github.com/acwright/6502) hardware project. Contributions, issues, and feature requests are welcome!

package/dist/components/IO/EmptyCard.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmptyCard = void 0;
+class EmptyCard {
+    constructor() {
+        this.raiseIRQ = () => { };
+        this.raiseNMI = () => { };
+    }
+    read(address) {
+        return 0;
+    }
+    write(address, data) { }
+    tick(frequency) { }
+    reset(coldStart) { }
+}
+exports.EmptyCard = EmptyCard;
+//# sourceMappingURL=EmptyCard.js.map

package/dist/components/IO/EmptyCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyCard.js","sourceRoot":"","sources":["../../../src/components/IO/EmptyCard.ts"],"names":[],"mappings":";;;AAEA,MAAa,SAAS;IAAtB;QAEE,aAAQ,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;QACnB,aAAQ,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;IAUrB,CAAC;IARC,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAY,IAAS,CAAC;IAC7C,IAAI,CAAC,SAAiB,IAAS,CAAC;IAChC,KAAK,CAAC,SAAkB,IAAS,CAAC;CAEnC;AAbD,8BAaC"}

package/dist/components/IO/GPIOAttachments/GPIOKeypadAttachment.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GPIOKeypadAttachment = void 0;
+const GPIOAttachment_1 = require("./GPIOAttachment");
+/**
+ * USB HID keycode to keypad value mapping
+ * Maps USB HID usage IDs to the 5-bit keypad codes ($00-$17) per the 6502 Keypad Mapping table
+ *
+ * Keypad layout (4 columns × 6 rows = 24 keys):
+ *   $00 = ◄  $01=1  $02=2  $03=3
+ *   $04 = 4  $05=5  $06=6  $07=7
+ *   $08 = 8  $09=9  $0A=0  $0B=►
+ *   $0C = F  $0D=E  $0E=D  $0F=C
+ *   $10 = ESC  $11=INS  $12=PGUP  $13=A
+ *   $14 = ▲/Enter  $15=DEL  $16=PGDN  $17=B
+ */
+const USB_HID_TO_KEYPAD = {
+    0x50: 0x00, // Left Arrow → ◄
+    0x1E: 0x01, // 1
+    0x1F: 0x02, // 2
+    0x20: 0x03, // 3
+    0x21: 0x04, // 4
+    0x22: 0x05, // 5
+    0x23: 0x06, // 6
+    0x24: 0x07, // 7
+    0x25: 0x08, // 8
+    0x26: 0x09, // 9
+    0x27: 0x0A, // 0
+    0x4F: 0x0B, // Right Arrow → ►
+    0x09: 0x0C, // f → F
+    0x08: 0x0D, // e → E
+    0x07: 0x0E, // d → D
+    0x06: 0x0F, // c → C
+    0x29: 0x10, // Escape → ESC
+    0x49: 0x11, // Insert → INS
+    0x4B: 0x12, // Page Up → PGUP
+    0x04: 0x13, // a → A
+    0x52: 0x14, // Up Arrow → ▲
+    0x28: 0x14, // Enter → ▲
+    0x4C: 0x15, // Delete → DEL
+    0x4E: 0x16, // Page Down → PGDN
+    0x05: 0x17, // b → B
+};
+/**
+ * GPIOKeypadAttachment - Emulates a 4×6 matrix keypad with a built-in hardware encoder
+ *
+ * The encoder converts a key press into a 5-bit code (PA0–PA4) that appears on the GPIO
+ * port.  Bits 5–7 are never driven by the keypad and always read as 0 when data is present.
+ *
+ * Behaviour mirrors a typical 74C922-style encoder:
+ * - On key press  → the 5-bit keypad code is latched and a CA1/CB1 interrupt is asserted
+ * - On port read  → the latched code is returned on bits 0–4 (bits 5–7 = 0)
+ * - clearInterrupts → clears the interrupt and the data-ready latch
+ * - Key releases  → ignored (encoder only reports on the falling edge of a keypress)
+ *
+ * The attachment may be wired to either Port A or Port B via the constructor parameter.
+ * CA1/CB1 is the DA (Data Available) interrupt line from the 74C922.
+ * CA2/CB2 is connected to the 74C922 OE (Output Enable) pin; data is only driven onto the
+ * bus when OE is asserted LOW by the 6522.
+ */
+class GPIOKeypadAttachment extends GPIOAttachment_1.GPIOAttachmentBase {
+    constructor(attachToPortA = true, priority = 0) {
+        super(priority, false, false, false, false);
+        this.keypadValue = 0x00;
+        this.dataReady = false;
+        this.interruptPending = false;
+        // OE state: CA2 for Port A, CB2 for Port B.  HIGH = output disabled (default).
+        this.oeState = true;
+        this.attachedToPortA = attachToPortA;
+        this.reset();
+    }
+    reset() {
+        super.reset();
+        this.keypadValue = 0x00;
+        this.dataReady = false;
+        this.interruptPending = false;
+        this.oeState = true; // OE disabled until explicitly asserted by the 6522
+    }
+    updateControlLines(ca1, ca2, cb1, cb2) {
+        // CA2 controls OE for Port A; CB2 controls OE for Port B.
+        // 74C922 OE is active-LOW, so a LOW signal enables the output.
+        this.oeState = this.attachedToPortA ? ca2 : cb2;
+    }
+    readPortA(ddr, or) {
+        // Only drive the bus when attached to Port A, OE is asserted (LOW), and data is latched
+        if (this.attachedToPortA && !this.oeState && this.dataReady) {
+            return this.keypadValue & 0x1F; // bits 0–4 only; bits 5–7 = 0
+        }
+        return 0xFF; // not driving the bus
+    }
+    readPortB(ddr, or) {
+        // Only drive the bus when attached to Port B, OE is asserted (LOW), and data is latched
+        if (!this.attachedToPortA && !this.oeState && this.dataReady) {
+            return this.keypadValue & 0x1F; // bits 0–4 only; bits 5–7 = 0
+        }
+        return 0xFF; // not driving the bus
+    }
+    hasCA1Interrupt() {
+        return this.attachedToPortA && this.interruptPending;
+    }
+    hasCB1Interrupt() {
+        return !this.attachedToPortA && this.interruptPending;
+    }
+    clearInterrupts(ca1, ca2, cb1, cb2) {
+        if ((this.attachedToPortA && ca1) || (!this.attachedToPortA && cb1)) {
+            this.interruptPending = false;
+            this.dataReady = false;
+        }
+    }
+    /**
+     * Notify the attachment of a USB HID key event.
+     * Key releases are ignored; only presses generate output on the GPIO port.
+     *
+     * @param usbHidKeycode - USB HID usage ID for the key
+     * @param pressed       - true for key-down, false for key-up
+     */
+    updateKey(usbHidKeycode, pressed) {
+        if (!pressed) {
+            return;
+        }
+        const keypadCode = USB_HID_TO_KEYPAD[usbHidKeycode];
+        if (keypadCode === undefined) {
+            return; // key is not present on this keypad
+        }
+        this.keypadValue = keypadCode;
+        this.dataReady = true;
+        this.interruptPending = true;
+    }
+    /**
+     * Returns the current latched keypad code (bits 0–4) or 0xFF if no data is ready.
+     */
+    getCurrentKey() {
+        return this.dataReady ? (this.keypadValue & 0x1F) : 0xFF;
+    }
+    /** Returns true when a key has been pressed and the latch has not yet been cleared. */
+    hasDataReady() {
+        return this.dataReady;
+    }
+}
+exports.GPIOKeypadAttachment = GPIOKeypadAttachment;
+//# sourceMappingURL=GPIOKeypadAttachment.js.map

package/dist/components/IO/GPIOAttachments/GPIOKeypadAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GPIOKeypadAttachment.js","sourceRoot":"","sources":["../../../../src/components/IO/GPIOAttachments/GPIOKeypadAttachment.ts"],"names":[],"mappings":"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"}