ac6502 1.3.0 → 1.4.0

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

@@ -0,0 +1,110 @@
+import { AttachmentBase } from './Attachment';
+/**
+ * HD44780 LCD Controller Emulation — GPIO Attachment
+ *
+ * Emulates a 16×2 (or configurable) character LCD with HD44780 controller
+ * connected via 8-bit parallel interface on a 65C22 VIA.
+ *
+ * Pin mapping (accent on VIA ports):
+ *   Port B (D0–D7): 8-bit data bus
+ *   Port A bit 5:   RS  (Register Select — 0 = command, 1 = data)
+ *   Port A bit 6:   RW  (Read/Write — 0 = write, 1 = read)
+ *   Port A bit 7:   E   (Enable — active-high strobe, latched on falling edge)
+ *
+ * Display modes:
+ *   Standard character display with 5×8 pixel characters
+ *   Supports CGRAM for up to 8 user-defined characters
+ *
+ * Output: pixel buffer (cols*(5+1)-1) × (rows*(8+1)-1) with values:
+ *   -1 = no pixel (inter-character gap)
+ *    0 = pixel off
+ *    1 = pixel on
+ *
+ * Reference: vrEmuLcd by Troy Schrapel
+ * https://github.com/visrealm/vrEmuLcd
+ */
+export declare const LCD_CMD_CLEAR = 1;
+export declare const LCD_CMD_HOME = 2;
+export declare const LCD_CMD_ENTRY_MODE = 4;
+export declare const LCD_CMD_ENTRY_MODE_INCREMENT = 2;
+export declare const LCD_CMD_ENTRY_MODE_SHIFT = 1;
+export declare const LCD_CMD_DISPLAY = 8;
+export declare const LCD_CMD_DISPLAY_ON = 4;
+export declare const LCD_CMD_DISPLAY_CURSOR = 2;
+export declare const LCD_CMD_DISPLAY_CURSOR_BLINK = 1;
+export declare const LCD_CMD_SHIFT = 16;
+export declare const LCD_CMD_SHIFT_DISPLAY = 8;
+export declare const LCD_CMD_SHIFT_RIGHT = 4;
+export declare const LCD_CMD_FUNCTION = 32;
+export declare const LCD_CMD_FUNCTION_LCD_2LINE = 8;
+export declare const LCD_CMD_SET_CGRAM_ADDR = 64;
+export declare const LCD_CMD_SET_DRAM_ADDR = 128;
+export declare class LCDAttachment extends AttachmentBase {
+    readonly cols: number;
+    readonly rows: number;
+    private entryModeFlags;
+    private displayFlags;
+    private scrollOffset;
+    /** 128-byte Display Data RAM */
+    private ddRam;
+    /** Current DDRAM pointer offset */
+    private ddPtr;
+    private dataWidthCols;
+    /** Character Generator RAM — 16 characters × 8 rows, stored column-major
+     *  as 16 × CHAR_WIDTH_PX bytes (matching vrEmuLcd cgRam layout) */
+    private cgRam;
+    /** Current CGRAM pointer (null when not in CGRAM mode) */
+    private cgPtr;
+    /** Pixel buffer: each byte is -1 (gap), 0 (off) or 1 (on) */
+    buffer: Int8Array;
+    readonly pixelsWidth: number;
+    readonly pixelsHeight: number;
+    private blinkAccumulator;
+    private blinkState;
+    private static readonly BLINK_PERIOD_MS;
+    private lastPortA;
+    private lastE;
+    constructor(cols?: number, rows?: number, priority?: number);
+    reset(): void;
+    tick(cpuFrequency: number): void;
+    /**
+     * Port A carries the control signals.
+     * We detect E falling edge to latch the bus.
+     */
+    writePortA(value: number, ddr: number): void;
+    readPortA(ddr: number, or: number): number;
+    readPortB(ddr: number, or: number): number;
+    private latchBus;
+    private lastPortBValue;
+    writePortB(value: number, ddr: number): void;
+    sendCommand(command: number): void;
+    writeByte(data: number): void;
+    private readByte;
+    readAddress(): number;
+    private incrementDdPtr;
+    private decrementDdPtr;
+    private doShift;
+    /**
+     * Get the 5-column font data for a character.
+     * Characters 0–15 come from CGRAM; 16–255 from ROM.
+     */
+    private charBits;
+    private getDataOffset;
+    updatePixels(): void;
+    /** Get the raw DDRAM contents */
+    getDDRam(): Uint8Array;
+    /** Get the current DDRAM address pointer */
+    getDDPtr(): number;
+    /** Get the display flags */
+    getDisplayFlags(): number;
+    /** Get the entry mode flags */
+    getEntryModeFlags(): number;
+    /** Get scroll offset */
+    getScrollOffset(): number;
+    /** Get CGRAM pointer (null if not in CGRAM mode) */
+    getCGPtr(): number | null;
+    /** Read the text content of a specific display row */
+    getRowText(row: number): string;
+    /** Pixel state at a given coordinate: -1 (gap), 0 (off), 1 (on) */
+    pixelState(x: number, y: number): number;
+}