@jtarrio/signals 0.9.0

package/dist/sources/generators.js

@@ -0,0 +1,238 @@
+// Copyright 2025 Jacobo Tarrio Barreiro. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { IqPool } from "../dsp/buffers.js";
+import { Preemphasis } from "../dsp/filters.js";
+/** Returns a generator for a tone at the given frequency with the given amplitude. */
+export function tone(freq, amplitude, phase) {
+    if (phase === undefined)
+        phase = 0;
+    return (sample, rate, centerFreq, I, Q) => {
+        const delta = (freq - centerFreq) / rate;
+        if (delta >= 0.5 || -0.5 >= delta) {
+            I.fill(0);
+            Q.fill(0);
+            return;
+        }
+        const p = 2 * Math.PI * delta * (sample % rate) + phase;
+        let a = Math.cos(p);
+        let b = Math.sin(p);
+        const f = 2 * Math.PI * delta;
+        const c = Math.cos(f);
+        const d = Math.sin(f);
+        for (let i = 0; i < I.length; ++i) {
+            I[i] = a * amplitude;
+            Q[i] = b * amplitude;
+            const xa = a * c - b * d;
+            const xb = b * c + a * d;
+            a = xa;
+            b = xb;
+        }
+    };
+}
+/** Returns a generator for noise with a given maximum amplitude. */
+export function noise(amplitude, random) {
+    if (random === undefined)
+        random = Math.random;
+    return (_sample, _rate, _centerFreq, I, Q) => {
+        for (let i = 0; i < I.length; ++i) {
+            let r = amplitude * Math.sqrt(random());
+            let t = random() * 2 * Math.PI;
+            I[i] = r * Math.cos(t);
+            Q[i] = r * Math.sin(t);
+        }
+    };
+}
+/** Returns a generator that adds the outputs of all the provided generators together. */
+export function sum(...generators) {
+    let pool = new IqPool(1, 65536);
+    return (sample, rate, centerFreq, I, Q) => {
+        I.fill(0);
+        Q.fill(0);
+        let [J, R] = pool.get(I.length);
+        for (let g of generators) {
+            g(sample, rate, centerFreq, J, R);
+            for (let i = 0; i < I.length; ++i) {
+                I[i] += J[i];
+                Q[i] += R[i];
+            }
+        }
+    };
+}
+/**
+ * Returns a generator that multiplies the output of the carrier generator
+ * with the output of the signal generator.
+ * The signal generator always receives a center frequency of 0 Hz.
+ */
+export function product(carrier, signal) {
+    let pool = new IqPool(1, 65536);
+    return (sample, rate, centerFreq, I, Q) => {
+        let [J, R] = pool.get(I.length);
+        carrier(sample, rate, centerFreq, I, Q);
+        signal(sample, rate, 0, J, R);
+        for (let i = 0; i < I.length; ++i) {
+            const a = I[i];
+            const b = Q[i];
+            const c = J[i];
+            const d = R[i];
+            I[i] = a * c - b * d;
+            Q[i] = a * d + b * c;
+        }
+    };
+}
+/**
+ * Returns a generator that multiplies every sample by the given gain.
+ */
+export function amplify(gain, signal) {
+    return (sample, rate, centerFreq, I, Q) => {
+        signal(sample, rate, centerFreq, I, Q);
+        for (let i = 0; i < I.length; ++i) {
+            I[i] *= gain;
+            Q[i] *= gain;
+        }
+    };
+}
+/** Returns the real part of another generator's output. */
+export function real(signal) {
+    return (sample, rate, centerFreq, I, Q) => {
+        signal(sample, rate, centerFreq, I, Q);
+        Q.fill(0);
+    };
+}
+/**
+ * Returns a generator that amplitude-modulates the output
+ * of the signal generator using a modulation factor of 2.
+ * Only the I component of the signal is used as the input.
+ * The signal generator always receives a center frequency of 0 Hz.
+ */
+export function modulateAM(carrierFreq, amplitude, signal) {
+    let pool = new IqPool(1, 65536);
+    const carrier = tone(carrierFreq, amplitude);
+    return (sample, rate, centerFreq, I, Q) => {
+        const delta = (carrierFreq - centerFreq) / rate;
+        if (delta >= 0.5 || -0.5 >= delta) {
+            I.fill(0);
+            Q.fill(0);
+            return;
+        }
+        let [J, R] = pool.get(I.length);
+        carrier(sample, rate, centerFreq, I, Q);
+        signal(sample, rate, 0, J, R);
+        for (let i = 0; i < I.length; ++i) {
+            const c = (1 + J[i]) / 2;
+            I[i] *= c;
+            Q[i] *= c;
+        }
+    };
+}
+/**
+ * Returns a generator that frequency-modulates the output
+ * of the signal generator using the given maximum frequency deviation.
+ * Only the I component of the signal is used as the input.
+ * The signal generator always receives a center frequency of 0 Hz.
+ */
+export function modulateFM(carrierFreq, maximumDeviation, amplitude, signal) {
+    let pool = new IqPool(1, 65536);
+    let phase = 0;
+    return (sample, rate, centerFreq, I, Q) => {
+        const delta = (carrierFreq - centerFreq) / rate;
+        if (delta >= 0.5 || -0.5 >= delta) {
+            I.fill(0);
+            Q.fill(0);
+            return;
+        }
+        const maxF = maximumDeviation / rate;
+        let [J, R] = pool.get(I.length);
+        signal(sample, rate, 0, J, R);
+        let sigSum = 0;
+        let p = phase;
+        for (let i = 0; i < I.length; ++i) {
+            const angle = 2 * Math.PI * p;
+            I[i] = amplitude * Math.cos(angle);
+            Q[i] = amplitude * Math.sin(angle);
+            p += delta + maxF * J[i];
+            sigSum += J[i];
+        }
+        phase += delta * I.length + maxF * sigSum;
+        phase -= Math.floor(phase);
+    };
+}
+/**
+ * Returns a generator that applies pre-emphasis to the output of another signal generator.
+ * This pre-emphasis is just the opposite to the de-emphasis produced by an IIR single-pole
+ * low-pass filter with the given time constant.
+ */
+function preemphasis(tcMicros, signal) {
+    let prevRate;
+    let filterI;
+    let filterQ;
+    return (sample, rate, centerFreq, I, Q) => {
+        if (prevRate !== rate) {
+            prevRate = rate;
+            filterI = new Preemphasis(rate, tcMicros / 1e6);
+            filterQ = filterI.clone();
+        }
+        signal(sample, rate, centerFreq, I, Q);
+        filterI.inPlace(I);
+        filterQ.inPlace(Q);
+    };
+}
+/**
+ * Returns a generator that avoids recomputing the signal
+ * if called twice with the same parameters.
+ */
+function cache(signal) {
+    let lastSample;
+    let lastRate;
+    let lastCenterFreq;
+    let pool = new IqPool(1, 1024);
+    let cache = [
+        new Float32Array(0),
+        new Float32Array(0),
+    ];
+    return (sample, rate, centerFreq, I, Q) => {
+        if (lastSample !== sample ||
+            lastRate !== rate ||
+            lastCenterFreq !== centerFreq ||
+            cache[0].length !== I.length) {
+            cache = pool.get(I.length);
+            signal(sample, rate, centerFreq, cache[0], cache[1]);
+            lastSample = sample;
+            lastRate = rate;
+            lastCenterFreq = centerFreq;
+        }
+        I.set(cache[0]);
+        Q.set(cache[1]);
+    };
+}
+export function wbfmSignal(left, rightOrTcMicros, tcMicros) {
+    let right;
+    if (typeof rightOrTcMicros === "number") {
+        tcMicros = rightOrTcMicros;
+    }
+    else {
+        right = rightOrTcMicros;
+    }
+    if (tcMicros === undefined)
+        tcMicros = 50;
+    if (right === undefined)
+        return amplify(0.9, preemphasis(tcMicros, real(left)));
+    const pilot = real(tone(19000, 0.1, -Math.PI / 2));
+    const shift = real(tone(38000, 1, -Math.PI / 2));
+    const l = cache(preemphasis(tcMicros, real(left)));
+    const r = cache(preemphasis(tcMicros, real(right)));
+    const apb = amplify(0.45, sum(l, r));
+    const amb = amplify(0.45, sum(l, amplify(-1, r)));
+    return sum(apb, pilot, product(amb, shift));
+}
+//# sourceMappingURL=generators.js.map

package/dist/sources/generators.js.map

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

package/dist/sources/provider.d.ts

@@ -0,0 +1,7 @@
+import { SignalSource, SignalSourceProvider } from "../radio/signal_source.js";
+export declare class SimpleProvider implements SignalSourceProvider {
+    private instance;
+    constructor(instance: SignalSource);
+    get(): Promise<SignalSource>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/sources/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/sources/provider.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAE/E,qBAAa,cAAe,YAAW,oBAAoB;IAC7C,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAEpC,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;CAGnC"}

package/dist/sources/provider.js

@@ -0,0 +1,23 @@
+// Copyright 2025 Jacobo Tarrio Barreiro. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export class SimpleProvider {
+    instance;
+    constructor(instance) {
+        this.instance = instance;
+    }
+    async get() {
+        return this.instance;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/sources/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/sources/provider.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAIjC,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;IAAG,CAAC;IAE9C,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/sources/push.d.ts

@@ -0,0 +1,30 @@
+import { SampleBlock, SignalSource } from "../radio/signal_source.js";
+/**
+ * A SignalSource that gets samples from a "push" source.
+ *
+ * You use PushSource when your signal comes in the form of events
+ * or callbacks that arrive regularly (push events).
+ *
+ * Whenever you receive the push event or callback, you must call
+ * pushSamples(). This function will use the provided samples to resolve
+ * pending reads, and then store the remainder in a buffer.
+ *
+ * The push source is expected to deliver its signals in real time.
+ */
+export declare class PushSource implements SignalSource {
+    constructor();
+    private sampleRate;
+    private centerFrequency;
+    private I;
+    private Q;
+    private outPool;
+    private pendingReads;
+    setParameter<V>(_property: string, _value: V): Promise<void | V>;
+    setSampleRate(sampleRate: number): Promise<number>;
+    setCenterFrequency(freq: number): Promise<number>;
+    startReceiving(): Promise<void>;
+    pushSamples(I: Float32Array, Q: Float32Array, frequency?: number): void;
+    readSamples(length: number): Promise<SampleBlock>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=push.d.ts.map

package/dist/sources/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/sources/push.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGtE;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,YAAW,YAAY;;IAU7C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,CAAC,CAAoB;IAC7B,OAAO,CAAC,CAAC,CAAoB;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAkB;IAEhC,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAEhE,aAAa,CAAC,UAAU,EAAE,MAAM;IAOhC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM;IAiChE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAe3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/sources/push.js

@@ -0,0 +1,106 @@
+// Copyright 2025 Jacobo Tarrio Barreiro. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { Float32RingBuffer, IqPool } from "../dsp/buffers.js";
+import { PendingReadRing } from "./read_ring.js";
+/**
+ * A SignalSource that gets samples from a "push" source.
+ *
+ * You use PushSource when your signal comes in the form of events
+ * or callbacks that arrive regularly (push events).
+ *
+ * Whenever you receive the push event or callback, you must call
+ * pushSamples(). This function will use the provided samples to resolve
+ * pending reads, and then store the remainder in a buffer.
+ *
+ * The push source is expected to deliver its signals in real time.
+ */
+export class PushSource {
+    constructor() {
+        this.sampleRate = 1024000;
+        this.centerFrequency = 0;
+        this.I = new Float32RingBuffer(Math.max(65536, this.sampleRate / 10));
+        this.Q = new Float32RingBuffer(this.I.capacity);
+        this.outPool = new IqPool(16, 65536);
+        this.pendingReads = new PendingReadRing(8);
+    }
+    sampleRate;
+    centerFrequency;
+    I;
+    Q;
+    outPool;
+    pendingReads;
+    async setParameter(_property, _value) { }
+    async setSampleRate(sampleRate) {
+        this.sampleRate = sampleRate;
+        this.I = new Float32RingBuffer(Math.max(65536, this.sampleRate / 10));
+        this.Q = new Float32RingBuffer(this.I.capacity);
+        return this.sampleRate;
+    }
+    async setCenterFrequency(freq) {
+        this.centerFrequency = freq;
+        return this.centerFrequency;
+    }
+    async startReceiving() {
+        this.I.clear();
+        this.Q.clear();
+    }
+    pushSamples(I, Q, frequency) {
+        if (frequency !== undefined)
+            this.centerFrequency = frequency;
+        let pos = 0;
+        while (this.pendingReads.hasPendingRead() && pos < I.length) {
+            const remaining = I.length - pos;
+            const readSize = this.pendingReads.nextReadSize();
+            if (readSize > this.I.available + remaining)
+                break;
+            let [oI, oQ] = this.outPool.get(readSize);
+            let copied = this.I.moveTo(oI);
+            if (copied > 0)
+                this.Q.moveTo(oQ);
+            if (copied < oI.length) {
+                const end = pos + oI.length - copied;
+                oI.set(I.subarray(pos, end), copied);
+                oQ.set(Q.subarray(pos, end), copied);
+                pos = end;
+            }
+            this.pendingReads.resolve({
+                I: oI,
+                Q: oQ,
+                frequency: this.centerFrequency,
+            });
+        }
+        if (pos < I.length) {
+            this.I.store(I.subarray(pos));
+            this.Q.store(Q.subarray(pos));
+            return;
+        }
+    }
+    readSamples(length) {
+        if (this.I.available < length || this.pendingReads.hasPendingRead()) {
+            return this.pendingReads.add(length);
+        }
+        let [oI, oQ] = this.outPool.get(length);
+        this.I.moveTo(oI);
+        this.Q.moveTo(oQ);
+        return Promise.resolve({
+            I: oI,
+            Q: oQ,
+            frequency: this.centerFrequency,
+        });
+    }
+    async close() {
+        this.pendingReads.cancel();
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/sources/push.js.map

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

package/dist/sources/read_ring.d.ts

@@ -0,0 +1,14 @@
+import { SampleBlock } from "../radio/signal_source.js";
+export declare class PendingReadRing {
+    constructor(length: number);
+    private pending;
+    private writePtr;
+    private readPtr;
+    private size;
+    add(length: number): Promise<SampleBlock>;
+    resolve(block: SampleBlock): void;
+    cancel(): void;
+    hasPendingRead(): boolean;
+    nextReadSize(): number;
+}
+//# sourceMappingURL=read_ring.d.ts.map

package/dist/sources/read_ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_ring.d.ts","sourceRoot":"","sources":["../../src/sources/read_ring.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAMxD,qBAAa,eAAe;gBACd,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAS;IAErB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAczC,OAAO,CAAC,KAAK,EAAE,WAAW;IAO1B,MAAM;IAaN,cAAc,IAAI,OAAO;IAIzB,YAAY,IAAI,MAAM;CAIvB"}

package/dist/sources/read_ring.js

@@ -0,0 +1,59 @@
+// Copyright 2025 Jacobo Tarrio Barreiro. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { RadioError, RadioErrorType } from "../errors.js";
+export class PendingReadRing {
+    constructor(length) {
+        this.pending = new Array(length);
+        this.writePtr = 0;
+        this.readPtr = 0;
+        this.size = 0;
+    }
+    pending;
+    writePtr;
+    readPtr;
+    size;
+    add(length) {
+        if (this.size == this.pending.length) {
+            throw new RadioError("Too many simultaneous reads", RadioErrorType.TransferError);
+        }
+        const { promise, resolve, reject } = Promise.withResolvers();
+        this.pending[this.writePtr] = { length, resolve, reject };
+        this.writePtr = (this.writePtr + 1) % this.pending.length;
+        this.size++;
+        return promise;
+    }
+    resolve(block) {
+        if (this.size == 0)
+            return;
+        this.pending[this.readPtr].resolve(block);
+        this.readPtr = (this.readPtr + 1) % this.pending.length;
+        this.size--;
+    }
+    cancel() {
+        while (this.size > 0) {
+            this.pending[this.readPtr].reject(new RadioError("Transfer has been canceled", RadioErrorType.TransferError));
+            this.readPtr = (this.readPtr + 1) % this.pending.length;
+            this.size--;
+        }
+    }
+    hasPendingRead() {
+        return this.size > 0;
+    }
+    nextReadSize() {
+        if (this.size == 0)
+            return 0;
+        return this.pending[this.readPtr].length;
+    }
+}
+//# sourceMappingURL=read_ring.js.map

package/dist/sources/read_ring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_ring.js","sourceRoot":"","sources":["../../src/sources/read_ring.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAO1D,MAAM,OAAO,eAAe;IAC1B,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAChB,CAAC;IAEO,OAAO,CAAgB;IACvB,QAAQ,CAAS;IACjB,OAAO,CAAS;IAChB,IAAI,CAAS;IAErB,GAAG,CAAC,MAAc;QAChB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,UAAU,CAClB,6BAA6B,EAC7B,cAAc,CAAC,aAAa,CAC7B,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAe,CAAC;QAC1E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,KAAkB;QACxB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;YAAE,OAAO;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACxD,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAC/B,IAAI,UAAU,CACZ,4BAA4B,EAC5B,cAAc,CAAC,aAAa,CAC7B,CACF,CAAC;YACF,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,YAAY;QACV,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC3C,CAAC;CACF"}

package/dist/sources/realtime.d.ts

@@ -0,0 +1,44 @@
+import { SampleBlock, SignalSource } from "../radio/signal_source.js";
+/**
+ * A function that generates samples.
+ * @param startSample The first sample's number.
+ * @param sampleRate The sample rate.
+ * @param centerFrequency The signal's center frequency.
+ * @param I An array to be populated with the I component values.
+ * @param Q An array to be populated with the Q component values.
+ */
+export type SampleGenerator = (startSample: number, sampleRate: number, centerFrequency: number, I: Float32Array, Q: Float32Array) => void;
+/**
+ * A SignalSource that gets samples from a SampleGenerator function in real time.
+ *
+ * This source holds a small buffer that it feeds by calling the generator
+ * function. Then, at periodic intervals, it checks if there are any pending
+ * reads and resolves them with the contents of the buffer.
+ */
+export declare class RealTimeSource implements SignalSource {
+    private generator;
+    constructor(generator: SampleGenerator);
+    private sampleRate;
+    private centerFrequency;
+    private I;
+    private Q;
+    private lastSampleInBuffer;
+    private inPool;
+    private outPool;
+    private pendingReads;
+    private running;
+    private firstTs;
+    setParameter<V>(_property: string, _value: V): Promise<void | V>;
+    setSampleRate(sampleRate: number): Promise<number>;
+    setCenterFrequency(freq: number): Promise<number>;
+    startReceiving(): Promise<void>;
+    readSamples(length: number): Promise<SampleBlock>;
+    close(): Promise<void>;
+    /** Schedules the next frame. */
+    private schedule;
+    /** Fills the buffer and resolves promises for samples that become available in this frame. */
+    private frame;
+    /** Fills the buffer with samples to satisfy future reads. */
+    private fillBuffer;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/sources/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/sources/realtime.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGtE;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,CAAC,EAAE,YAAY,EACf,CAAC,EAAE,YAAY,KACZ,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,YAAY;IACrC,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,eAAe;IAa9C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,CAAC,CAAoB;IAC7B,OAAO,CAAC,CAAC,CAAoB;IAC7B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAgB;IAEzB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAEhE,aAAa,CAAC,UAAU,EAAE,MAAM;IAOhC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,gCAAgC;IAChC,OAAO,CAAC,QAAQ;IAIhB,8FAA8F;IAC9F,OAAO,CAAC,KAAK;IAuCb,6DAA6D;IAC7D,OAAO,CAAC,UAAU;CAyBnB"}