@jtarrio/webrtlsdr 0.0.1

package/dist/rtlsdr/rtlcom.js

@@ -0,0 +1,299 @@
+// Copyright 2024 Jacobo Tarrio Barreiro. All rights reserved.
+// Copyright 2013 Google Inc. 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";
+/** Low-level communications with the RTL2832U-base dongle. */
+export class RtlCom {
+    constructor(device) {
+        this.device = device;
+    }
+    device;
+    /** Set in the control messages' index field for write operations. */
+    static WRITE_FLAG = 0x10;
+    /** Claims the USB control interface. */
+    async claimInterface() {
+        try {
+            await this.device.claimInterface(0);
+        }
+        catch (e) {
+            throw new RadioError("Could not connect to the RTL-SDR stick. Are you using it in another application?", RadioErrorType.UsbTransferError, { cause: e });
+        }
+    }
+    /** Releases the USB control interface. */
+    async releaseInterface() {
+        await this.device.releaseInterface(0);
+    }
+    /** Returns branding information. */
+    getBranding() {
+        return {
+            manufacturer: this.device.manufacturerName,
+            model: this.device.productName,
+        };
+    }
+    /**
+     * Writes to a USB control register.
+     * @param address The register's address.
+     * @param value The value to write.
+     * @param length The number of bytes this value uses.
+     */
+    async setUsbReg(address, value, length) {
+        await this._setReg(0x100, address, value, length);
+    }
+    /**
+     * Writes to a 8051 system register.
+     * @param address The register's address.
+     * @param value The value to write.
+     */
+    async setSysReg(address, value) {
+        await this._setReg(0x200, address, value, 1);
+    }
+    /**
+     * Reads from a 8051 system register.
+     * @param address The register's address.
+     * @returns The value that was read.
+     */
+    async getSysReg(address) {
+        return this._getReg(0x200, address, 1);
+    }
+    /**
+     * Writes a value into a demodulator register.
+     * @param page The register page number.
+     * @param addr The register's address.
+     * @param value The value to write.
+     * @param len The width in bytes of this value.
+     * @returns a promise that resolves the value that was read back from the register.
+     */
+    async setDemodReg(page, addr, value, len) {
+        await this._setRegBuffer(page, (addr << 8) | 0x20, this._numberToBuffer(value, len, true));
+        return this._getReg(0x0a, 0x0120, 1);
+    }
+    /**
+     * Reads a value from an I2C register.
+     * @param addr The device's address.
+     * @param reg The register number.
+     * @returns a promise that resolves to the value in the register.
+     */
+    async getI2CReg(addr, reg) {
+        await this._setRegBuffer(0x600, addr, new Uint8Array([reg]).buffer);
+        return this._getReg(0x600, addr, 1);
+    }
+    /**
+     * Writes a value to an I2C register.
+     * @param addr The device's address.
+     * @param reg The register number.
+     * @param value The value to write.
+     */
+    async setI2CReg(addr, reg, value) {
+        await this._setRegBuffer(0x600, addr, new Uint8Array([reg, value]).buffer);
+    }
+    /**
+     * Reads a buffer from an I2C register.
+     * @param addr The device's address.
+     * @param reg The register number.
+     * @param len The number of bytes to read.
+     * @returns a promise that resolves to the read buffer.
+     */
+    async getI2CRegBuffer(addr, reg, len) {
+        await this._setRegBuffer(0x600, addr, new Uint8Array([reg]).buffer);
+        return this._getRegBuffer(0x600, addr, len);
+    }
+    async setGpioOutput(gpio) {
+        gpio = 1 << gpio;
+        let r = await this.getSysReg(0x3004);
+        await this.setSysReg(0x3004, r & ~gpio);
+        r = await this.getSysReg(0x3003);
+        await this.setSysReg(0x3003, r | gpio);
+    }
+    async setGpioBit(gpio, val) {
+        gpio = 1 << gpio;
+        let r = await this.getSysReg(0x3001);
+        r = val ? r | gpio : r & ~gpio;
+        await this.setSysReg(0x3001, r);
+    }
+    /**
+     * Does a bulk transfer from the device.
+     * @param length The number of bytes to read.
+     * @returns a promise that resolves to the data that was read.
+     */
+    async getSamples(length) {
+        let result = await this.device.transferIn(1, length);
+        if (result.status == "ok")
+            return result.data.buffer;
+        if (result.status == "stall") {
+            await this.device.clearHalt("in", 1);
+            return new ArrayBuffer(length);
+        }
+        throw new RadioError(`USB bulk read failed length 0x${length.toString(16)} status=${result.status}`, RadioErrorType.UsbTransferError);
+    }
+    /**
+     * Opens the I2C repeater.
+     * To avoid interference, the tuner is usually disconnected from the I2C bus.
+     * With the repeater open, the tuner can receive I2C messages.
+     */
+    async openI2C() {
+        await this.setDemodReg(1, 1, 0x18, 1);
+    }
+    /** Closes the I2C repeater. */
+    async closeI2C() {
+        await this.setDemodReg(1, 1, 0x10, 1);
+    }
+    /** Closes the connection. */
+    async close() {
+        await this.device.close();
+    }
+    /**
+     * Writes a value into a dongle's register.
+     * @param block The register's block number.
+     * @param reg The register number.
+     * @param value The value to write.
+     * @param length The width in bytes of this value.
+     */
+    async _setReg(block, reg, value, length) {
+        try {
+            await this._writeCtrlMsg(reg, block | RtlCom.WRITE_FLAG, this._numberToBuffer(value, length));
+        }
+        catch (e) {
+            throw new RadioError(`setReg failed block=0x${block.toString(16)} reg=${reg.toString(16)} value=${value.toString(16)} length=${length}`, RadioErrorType.UsbTransferError, { cause: e });
+        }
+    }
+    /**
+     * Reads a value from a dongle's register.
+     * @param block The register's block number.
+     * @param reg The register number.
+     * @param length The width in bytes of the value to read.
+     * @returns a promise that resolves to the decoded value.
+     */
+    async _getReg(block, reg, length) {
+        try {
+            return this._bufferToNumber(await this._readCtrlMsg(reg, block, length));
+        }
+        catch (e) {
+            throw new RadioError(`getReg failed block=0x${block.toString(16)} reg=${reg.toString(16)} length=${length}`, RadioErrorType.UsbTransferError, { cause: e });
+        }
+    }
+    /**
+     * Writes a buffer into a dongle's register.
+     * @param block The register's block number.
+     * @param reg The register number.
+     * @param buffer The buffer to write.
+     */
+    async _setRegBuffer(block, reg, buffer) {
+        try {
+            await this._writeCtrlMsg(reg, block | RtlCom.WRITE_FLAG, buffer);
+        }
+        catch (e) {
+            throw new RadioError(`setRegBuffer failed block=0x${block.toString(16)} reg=${reg.toString(16)}`, RadioErrorType.UsbTransferError, { cause: e });
+        }
+    }
+    /**
+     * Reads a buffer from a dongle's register.
+     * @param block The register's block number.
+     * @param reg The register number.
+     * @param length The length in bytes of the buffer to read.
+     * @returns a Promise that resolves to the read buffer.
+     */
+    async _getRegBuffer(block, reg, length) {
+        try {
+            return this._readCtrlMsg(reg, block, length);
+        }
+        catch (e) {
+            throw new RadioError(`getRegBuffer failed block=0x${block.toString(16)} reg=${reg.toString(16)} length=${length}`, RadioErrorType.UsbTransferError, { cause: e });
+        }
+    }
+    /**
+     * Decodes a buffer as a little-endian number.
+     * @param buffer The buffer to decode.
+     * @returns The decoded number.
+     */
+    _bufferToNumber(buffer) {
+        let len = buffer.byteLength;
+        let dv = new DataView(buffer);
+        if (len == 0) {
+            return 0;
+        }
+        else if (len == 1) {
+            return dv.getUint8(0);
+        }
+        else if (len == 2) {
+            return dv.getUint16(0, true);
+        }
+        else if (len == 4) {
+            return dv.getUint32(0, true);
+        }
+        throw new RadioError(`Cannot parse ${len}-byte number`, RadioErrorType.UsbTransferError);
+    }
+    /**
+     * Encodes a number into a buffer.
+     * @param value The number to encode.
+     * @param len The number of bytes to encode into.
+     * @param opt_bigEndian Whether to use a big-endian encoding.
+     */
+    _numberToBuffer(value, len, opt_bigEndian) {
+        let buffer = new ArrayBuffer(len);
+        let dv = new DataView(buffer);
+        if (len == 1) {
+            dv.setUint8(0, value);
+        }
+        else if (len == 2) {
+            dv.setUint16(0, value, !opt_bigEndian);
+        }
+        else if (len == 4) {
+            dv.setUint32(0, value, !opt_bigEndian);
+        }
+        else {
+            throw new RadioError(`Cannot write ${len}-byte number`, RadioErrorType.UsbTransferError);
+        }
+        return buffer;
+    }
+    /**
+     * Sends a USB control message to read from the device.
+     * @param value The value field of the control message.
+     * @param index The index field of the control message.
+     * @param length The number of bytes to read.
+     * @returns a promise that resolves to the read buffer.
+     */
+    async _readCtrlMsg(value, index, length) {
+        let ti = {
+            requestType: "vendor",
+            recipient: "device",
+            request: 0,
+            value: value,
+            index: index,
+        };
+        let result = await this.device.controlTransferIn(ti, Math.max(8, length));
+        if (result.status == "ok")
+            return result.data.buffer.slice(0, length);
+        throw new RadioError(`USB read failed value=0x${value.toString(16)} index=0x${index.toString(16)} status=${result.status}`, RadioErrorType.UsbTransferError);
+    }
+    /**
+     * Sends a USB control message to write to the device.
+     * @param value The value field of the control message.
+     * @param index The index field of the control message.
+     * @param buffer The buffer to write to the device.
+     */
+    async _writeCtrlMsg(value, index, buffer) {
+        let ti = {
+            requestType: "vendor",
+            recipient: "device",
+            request: 0,
+            value: value,
+            index: index,
+        };
+        let result = await this.device.controlTransferOut(ti, buffer);
+        if (result.status == "ok")
+            return;
+        throw new RadioError(`USB write failed value=0x${value.toString(16)} index=0x${index.toString(16)} status=${result.status}`, RadioErrorType.UsbTransferError);
+    }
+}
+//# sourceMappingURL=rtlcom.js.map

package/dist/rtlsdr/rtlcom.js.map

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

package/dist/rtlsdr/rtldevice.d.ts

@@ -0,0 +1,53 @@
+/** A block of samples returned by RtlDevice.readSamples() */
+export type SampleBlock = {
+    /** The frequency the radio was tuned at when these samples were captured. */
+    frequency: number;
+    /** The samples as an sequence of (U8, U8) pairs, where the first U8 is the I value and the second is the Q value. */
+    data: ArrayBuffer;
+    /** Whether the radio was in direct sampling mode. */
+    directSampling: boolean;
+};
+/** Interface for an RTL-type device. */
+export interface RtlDevice {
+    /** Sets the device's sample rate. */
+    setSampleRate(rate: number): Promise<number>;
+    /** Sets the frequency correction factor, in parts-per-million. */
+    setFrequencyCorrection(ppm: number): Promise<void>;
+    /** Returns the currently set frequency correction factor. */
+    getFrequencyCorrection(): number;
+    /** Sets the tuner's gain, or null for automatic gain control. */
+    setGain(gain: number | null): Promise<void>;
+    /** Returns the currently set tuner's gain. */
+    getGain(): number | null;
+    /** Sets the center frequency the device will be listening on. */
+    setCenterFrequency(freq: number): Promise<number>;
+    /** Sets the direct sampling method. */
+    setDirectSamplingMethod(method: DirectSampling): Promise<void>;
+    /** Returns the currently set direct sampling method. */
+    getDirectSamplingMethod(): DirectSampling;
+    /** Enables or disables the bias T, if equipped. */
+    enableBiasTee(enable: boolean): Promise<void>;
+    /** Returns whether the bias T is enabled. */
+    isBiasTeeEnabled(): boolean;
+    /** Resets the sample buffers. You must do this before you start reading samples. */
+    resetBuffer(): Promise<void>;
+    /** Reads the given number of samples. */
+    readSamples(length: number): Promise<SampleBlock>;
+    /** Shuts down the device. */
+    close(): Promise<void>;
+}
+/** Direct sampling modes. */
+export declare enum DirectSampling {
+    /** No direct sampling. */
+    Off = 0,
+    /** I channel. */
+    I = 1,
+    /** Q channel. */
+    Q = 2
+}
+/** Interface for classes that return RtlDevice instances. */
+export interface RtlDeviceProvider {
+    /** Returns an open device. */
+    get(): Promise<RtlDevice>;
+}
+//# sourceMappingURL=rtldevice.d.ts.map

package/dist/rtlsdr/rtldevice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtldevice.d.ts","sourceRoot":"","sources":["../../src/rtlsdr/rtldevice.ts"],"names":[],"mappings":"AAcA,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IACxB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,qHAAqH;IACrH,IAAI,EAAE,WAAW,CAAC;IAClB,qDAAqD;IACrD,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,kEAAkE;IAClE,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,6DAA6D;IAC7D,sBAAsB,IAAI,MAAM,CAAC;IACjC,iEAAiE;IACjE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,OAAO,IAAI,MAAM,GAAG,IAAI,CAAC;IACzB,iEAAiE;IACjE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,uCAAuC;IACvC,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,wDAAwD;IACxD,uBAAuB,IAAI,cAAc,CAAC;IAC1C,mDAAmD;IACnD,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,6CAA6C;IAC7C,gBAAgB,IAAI,OAAO,CAAC;IAC5B,oFAAoF;IACpF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,yCAAyC;IACzC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClD,6BAA6B;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,6BAA6B;AAC7B,oBAAY,cAAc;IACxB,0BAA0B;IAC1B,GAAG,IAAA;IACH,iBAAiB;IACjB,CAAC,IAAA;IACD,iBAAiB;IACjB,CAAC,IAAA;CACF;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3B"}

package/dist/rtlsdr/rtldevice.js

@@ -0,0 +1,24 @@
+// Copyright 2024 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.
+/** Direct sampling modes. */
+export var DirectSampling;
+(function (DirectSampling) {
+    /** No direct sampling. */
+    DirectSampling[DirectSampling["Off"] = 0] = "Off";
+    /** I channel. */
+    DirectSampling[DirectSampling["I"] = 1] = "I";
+    /** Q channel. */
+    DirectSampling[DirectSampling["Q"] = 2] = "Q";
+})(DirectSampling || (DirectSampling = {}));
+//# sourceMappingURL=rtldevice.js.map

package/dist/rtlsdr/rtldevice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtldevice.js","sourceRoot":"","sources":["../../src/rtlsdr/rtldevice.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;AA0CjC,6BAA6B;AAC7B,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,0BAA0B;IAC1B,iDAAG,CAAA;IACH,iBAAiB;IACjB,6CAAC,CAAA;IACD,iBAAiB;IACjB,6CAAC,CAAA;AACH,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB"}

package/dist/rtlsdr/tuner.d.ts

@@ -0,0 +1,20 @@
+/** Functions common to all tuner implementations. */
+export interface Tuner {
+    /** Sets the frequency, returning the actual frequency set. */
+    setFrequency(freq: number): Promise<number>;
+    /** Enables automatic gain. */
+    setAutoGain(): Promise<void>;
+    /** Sets manual gain to the given value in dB. */
+    setManualGain(gain: number): Promise<void>;
+    /** Sets the crystal frequency. */
+    setXtalFrequency(xtalFreq: number): void;
+    /** Returns the intermediate frequency this tuner uses. */
+    getIntermediateFrequency(): number;
+    /** Returns the minimum frequency this tuner can set. */
+    getMinimumFrequency(): number;
+    /** Closes the tuner. */
+    close(): Promise<void>;
+    /** Reopens the tuner. */
+    open(): Promise<void>;
+}
+//# sourceMappingURL=tuner.d.ts.map

package/dist/rtlsdr/tuner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuner.d.ts","sourceRoot":"","sources":["../../src/rtlsdr/tuner.ts"],"names":[],"mappings":"AAcA,qDAAqD;AACrD,MAAM,WAAW,KAAK;IACpB,8DAA8D;IAC9D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,8BAA8B;IAC9B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,iDAAiD;IACjD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,kCAAkC;IAClC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0DAA0D;IAC1D,wBAAwB,IAAI,MAAM,CAAC;IACnC,wDAAwD;IACxD,mBAAmB,IAAI,MAAM,CAAC;IAC9B,wBAAwB;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,yBAAyB;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/rtlsdr/tuner.js

@@ -0,0 +1,15 @@
+// Copyright 2024 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 {};
+//# sourceMappingURL=tuner.js.map

package/dist/rtlsdr/tuner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuner.js","sourceRoot":"","sources":["../../src/rtlsdr/tuner.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"}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@jtarrio/webrtlsdr",
+  "description": "Access RTL-SDR devices and receive and demodulate radio signals from your web application",
+  "version": "0.0.1",
+  "author": "Jacobo Tarrio <jtarrio@gmail.com>",
+  "license": "Apache-2.0",
+  "exports": {
+    "./*": "./dist/*.js"
+  },
+  "files": ["./dist"],
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "dependencies": {
+    "@types/w3c-web-usb": "^1.0.10"
+  }
+}