ac6502 1.2.0 → 1.4.0

package/dist/components/IO/StorageCard.d.ts

@@ -0,0 +1,74 @@
+import { IO } from '../IO';
+/**
+ * StorageCard - Emulates a Compact Flash card in 8-bit IDE mode
+ *
+ * Emulates a 128MB CF card with ATA-style register interface.
+ * Uses LBA (Logical Block Addressing) for sector access.
+ *
+ * Register Map (address & 0x07):
+ * $00: Data Register (read/write)
+ * $01: Error Register (read) / Feature Register (write)
+ * $02: Sector Count Register (read/write)
+ * $03: LBA0 Register (read/write) - bits 0-7 of LBA
+ * $04: LBA1 Register (read/write) - bits 8-15 of LBA
+ * $05: LBA2 Register (read/write) - bits 16-23 of LBA
+ * $06: LBA3 Register (read/write) - bits 24-27 of LBA + mode bits
+ * $07: Status Register (read) / Command Register (write)
+ *
+ * Supported Commands:
+ * 0x20, 0x21: Read Sector(s)
+ * 0x30, 0x31: Write Sector(s)
+ * 0xC0: Erase Sector
+ * 0xEC: Identify Drive
+ * 0xEF: Set Features (accepted but not implemented)
+ */
+export declare class StorageCard implements IO {
+    private static readonly STORAGE_SIZE;
+    private static readonly SECTOR_SIZE;
+    private static readonly SECTOR_COUNT;
+    private static readonly STATUS_ERR;
+    private static readonly STATUS_DRQ;
+    private static readonly STATUS_RDY;
+    private static readonly ERR_AMNF;
+    private static readonly ERR_ABRT;
+    private static readonly ERR_IDNF;
+    private storage;
+    private identity;
+    private buffer;
+    private bufferIndex;
+    private commandDataSize;
+    private sectorOffset;
+    private error;
+    private feature;
+    private sectorCount;
+    private lba0;
+    private lba1;
+    private lba2;
+    private lba3;
+    private status;
+    private command;
+    private isIdentifying;
+    private isTransferring;
+    raiseIRQ: () => void;
+    raiseNMI: () => void;
+    constructor();
+    read(address: number): number;
+    write(address: number, data: number): void;
+    tick(frequency: number): void;
+    reset(coldStart: boolean): void;
+    private executeCommand;
+    private readBuffer;
+    private writeBuffer;
+    private sectorIndex;
+    private sectorValid;
+    private generateIdentity;
+    /**
+     * Load storage data from a file
+     * If the file doesn't exist, storage remains empty (initialized to 0x00)
+     */
+    loadFromFile(filePath: string): Promise<void>;
+    /**
+     * Save storage data to a file
+     */
+    saveToFile(filePath: string): Promise<void>;
+}

package/dist/components/IO/Terminal.d.ts

@@ -0,0 +1,19 @@
+import { IO } from '../IO';
+import { VTAC } from 'vtac-terminal';
+/**
+ * Terminal - Emulates the VTAC fantasy terminal
+ *
+ * Register Map:
+ * $00: Data / Status Register
+ *   Write: sends byte to VTAC for processing
+ *   Read:  always returns 0 (bit 7 is a busy flag on the real device; busy is never set here)
+ */
+export declare class Terminal implements IO {
+    raiseIRQ: () => void;
+    raiseNMI: () => void;
+    readonly vtac: VTAC;
+    read(address: number): number;
+    write(address: number, data: number): void;
+    tick(frequency: number): void;
+    reset(coldStart: boolean): void;
+}

package/dist/components/IO/Terminal.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Terminal = void 0;
+const vtac_terminal_1 = require("vtac-terminal");
+/**
+ * Terminal - Emulates the VTAC fantasy terminal
+ *
+ * Register Map:
+ * $00: Data / Status Register
+ *   Write: sends byte to VTAC for processing
+ *   Read:  always returns 0 (bit 7 is a busy flag on the real device; busy is never set here)
+ */
+class Terminal {
+    constructor() {
+        this.raiseIRQ = () => { };
+        this.raiseNMI = () => { };
+        this.vtac = new vtac_terminal_1.VTAC();
+    }
+    read(address) {
+        // Status register: bit 7 is busy flag on real device, never busy in emulation
+        return 0;
+    }
+    write(address, data) {
+        const register = address & 0x00;
+        if (register === 0x00) {
+            this.vtac.parse(data);
+        }
+    }
+    tick(frequency) { }
+    reset(coldStart) { }
+}
+exports.Terminal = Terminal;
+//# sourceMappingURL=Terminal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.js","sourceRoot":"","sources":["../../../src/components/IO/Terminal.ts"],"names":[],"mappings":";;;AACA,iDAAoC;AAEpC;;;;;;;GAOG;AACH,MAAa,QAAQ;IAArB;QAEE,aAAQ,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;QACnB,aAAQ,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;QAEV,SAAI,GAAS,IAAI,oBAAI,EAAE,CAAA;IAiBlC,CAAC;IAfC,IAAI,CAAC,OAAe;QAClB,8EAA8E;QAC9E,OAAO,CAAC,CAAA;IACV,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAY;QACjC,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAA;QAC/B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAiB,IAAS,CAAC;IAChC,KAAK,CAAC,SAAkB,IAAS,CAAC;CAEnC;AAtBD,4BAsBC"}

package/dist/components/IO/VIA.d.ts

@@ -0,0 +1,105 @@
+import { IO } from '../IO';
+import { Attachment } from './Attachments/Attachment';
+/**
+ * VIA - Emulates the 65C22 VIA (Versatile Interface Adapter)
+ *
+ * The 65C22 VIA provides:
+ * - Two 8-bit bidirectional I/O ports (Port A and Port B)
+ * - Two 16-bit timers with interrupt generation
+ * - Shift register for serial I/O
+ * - Handshaking lines for data transfer
+ */
+export declare class VIA implements IO {
+    private static readonly VIA_ORB;
+    private static readonly VIA_ORA;
+    private static readonly VIA_DDRB;
+    private static readonly VIA_DDRA;
+    private static readonly VIA_T1CL;
+    private static readonly VIA_T1CH;
+    private static readonly VIA_T1LL;
+    private static readonly VIA_T1LH;
+    private static readonly VIA_T2CL;
+    private static readonly VIA_T2CH;
+    private static readonly VIA_SR;
+    private static readonly VIA_ACR;
+    private static readonly VIA_PCR;
+    private static readonly VIA_IFR;
+    private static readonly VIA_IER;
+    private static readonly VIA_ORA_NH;
+    private static readonly IRQ_CA2;
+    private static readonly IRQ_CA1;
+    private static readonly IRQ_SR;
+    private static readonly IRQ_CB2;
+    private static readonly IRQ_CB1;
+    private static readonly IRQ_T2;
+    private static readonly IRQ_T1;
+    private static readonly IRQ_IRQ;
+    private static readonly MAX_ATTACHMENTS_PER_PORT;
+    private regORB;
+    private regORA;
+    private regDDRB;
+    private regDDRA;
+    private regT1C;
+    private regT1L;
+    private regT2C;
+    private regT2L;
+    private regSR;
+    private regACR;
+    private regPCR;
+    private regIFR;
+    private regIER;
+    private CA1;
+    private CA2;
+    private CB1;
+    private CB2;
+    private T1_running;
+    private T2_running;
+    private T1_IRQ_enabled;
+    private T2_IRQ_enabled;
+    private tickCounter;
+    private ticksPerMicrosecond;
+    private portA_attachments;
+    private portB_attachments;
+    private portA_attachmentCount;
+    private portB_attachmentCount;
+    raiseIRQ: () => void;
+    raiseNMI: () => void;
+    constructor();
+    reset(coldStart: boolean): void;
+    read(address: number): number;
+    write(address: number, data: number): void;
+    tick(frequency: number): void;
+    private updateIRQ;
+    private setIRQFlag;
+    private clearIRQFlag;
+    private readPortA;
+    private readPortB;
+    private writePortA;
+    private writePortB;
+    private updateCA2;
+    private updateCB2;
+    private notifyAttachmentsControlLines;
+    private sortAttachmentsByPriority;
+    /**
+     * Attach a GPIO device to Port A
+     * @param attachment - The attachment to add
+     */
+    attachToPortA(attachment: Attachment): void;
+    /**
+     * Attach a GPIO device to Port B
+     * @param attachment - The attachment to add
+     */
+    attachToPortB(attachment: Attachment): void;
+    /**
+     * Get a Port A attachment by index
+     * @param index - The attachment index
+     * @returns The attachment or null if not found
+     */
+    getPortAAttachment(index: number): Attachment | null;
+    /**
+     * Get a Port B attachment by index
+     * @param index - The attachment index
+     * @returns The attachment or null if not found
+     */
+    getPortBAttachment(index: number): Attachment | null;
+}