ac6502 1.3.0 → 1.4.1

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

@@ -0,0 +1,120 @@
+import { IO } from '../IO';
+/**
+ * MOS 6581 SID (Sound Interface Device) Emulation
+ *
+ * Register Map ($00-$1C):
+ *   Voice 1: $00-$06
+ *   Voice 2: $07-$0D
+ *   Voice 3: $0E-$14
+ *   Filter:  $15-$17
+ *   Volume:  $18
+ *   Paddle:  $19-$1A (read-only)
+ *   OSC 3:   $1B (read-only)
+ *   ENV 3:   $1C (read-only)
+ *
+ * Each voice has:
+ *   Frequency  (16-bit, lo/hi)
+ *   Pulse Width (12-bit, lo/hi)
+ *   Control Register (waveform select, gate, sync, ring mod, test)
+ *   Attack/Decay (4-bit each)
+ *   Sustain/Release (4-bit each)
+ *
+ * Waveforms: Triangle, Sawtooth, Pulse, Noise
+ * Filter: 12-bit cutoff, resonance, low/band/high-pass, voice routing
+ *
+ * Clock rate: ~1 MHz (NTSC: 1,022,727 Hz, PAL: 985,248 Hz)
+ * Output: mono audio samples passed via callback to the host emulator
+ *
+ * Reference: MOS 6581 SID datasheet, reSID by Dag Lem
+ */
+/** Default SID clock rate (NTSC) */
+export declare const SID_CLOCK_NTSC = 1022727;
+export declare const SID_CLOCK_PAL = 985248;
+export declare const enum EnvelopeState {
+    ATTACK = 0,
+    DECAY = 1,
+    SUSTAIN = 2,
+    RELEASE = 3
+}
+export declare class SIDVoice {
+    accumulator: number;
+    frequency: number;
+    pulseWidth: number;
+    control: number;
+    prevGate: boolean;
+    noiseShift: number;
+    waveformOutput: number;
+    envelopeState: EnvelopeState;
+    envelopeLevel: number;
+    envelopeCounter: number;
+    attackRate: number;
+    decayRate: number;
+    sustainLevel: number;
+    releaseRate: number;
+    exponentialCounter: number;
+    exponentialCounterPeriod: number;
+    reset(): void;
+}
+export declare class Sound implements IO {
+    raiseIRQ: () => void;
+    raiseNMI: () => void;
+    /** Callback to push audio samples to the host emulator */
+    pushSamples?: (samples: Float32Array) => void;
+    /** Raw register file (write-only from CPU perspective, except reads at $19-$1C) */
+    private registers;
+    /** Three oscillator voices */
+    private voices;
+    /** Filter state */
+    private filterCutoff;
+    private filterResonance;
+    private filterRouting;
+    private filterMode;
+    private masterVolume;
+    /** Filter integrator state (continuous) */
+    private filterLP;
+    private filterBP;
+    private filterHP;
+    /** Cycle accumulator for sample rate conversion */
+    private cycleAccumulator;
+    /** Target audio sample rate */
+    sampleRate: number;
+    /** SID clock rate */
+    sidClock: number;
+    /** Internal sample buffer for pushing to host */
+    private sampleBuffer;
+    private sampleBufferIndex;
+    read(address: number): number;
+    write(address: number, data: number): void;
+    tick(frequency: number): void;
+    reset(coldStart: boolean): void;
+    private updateVoiceRegister;
+    private updateGlobalRegister;
+    private clockOneCycle;
+    private clockOscillator;
+    private generateWaveform;
+    private clockEnvelope;
+    /**
+     * Update the exponential counter period based on current envelope level.
+     * The real SID uses an exponential curve for decay/release by varying
+     * the counter period at specific envelope level thresholds.
+     */
+    private updateExponentialPeriod;
+    private generateSample;
+    /**
+     * Convert the 11-bit filter cutoff register value to a frequency in Hz.
+     * The SID's cutoff mapping is complex and varies between chips.
+     * This approximation covers the usable range (~30 Hz to ~12 kHz).
+     */
+    private computeFilterCutoff;
+    private flushSampleBuffer;
+    /** Get a voice for inspection */
+    getVoice(index: number): SIDVoice;
+    /** Get current register value */
+    getRegister(reg: number): number;
+    /** Get current filter cutoff frequency in Hz */
+    getFilterCutoffHz(): number;
+    /** Get master volume (0-15) */
+    getMasterVolume(): number;
+    /** Get filter routing bitmask */
+    getFilterRouting(): number;
+}