@openmouse/protocol 0.1.0

package/dist/drivers/endgame/egg-we-hid.js

@@ -0,0 +1,514 @@
+import { WE_CMD_GET_POWER, WE_CMD_READ_EEPROM, WE_CMD_WRITE_EEPROM, WE_MAX_EEPROM_CHUNK, WE_OFF, WE_PAYLOAD_LEN, WE_REPORT_ID, weBuildCmdPayload, weBuildReadEepromPayload, weBuildWriteEepromPayload, weDecodeProfile, weEncodeLod, weIsValidCpi, wePackScalarPair, weParseReadEepromResponse, weParseWriteEepromResponse, weEncodeReportRate, weIsValidPollingRate, wePatchActiveDpi, WE_POLLING_RATES, } from "@openmouse/protocol/endgame-gear-we";
+/**
+ * Endgame Gear WE-series (OP1we).
+ *
+ * Cable + wireless dongle: FF02 feature 8 ↔ FF01 input 9, checksum sum-to-0x55.
+ * Battery GetPower 0x04; profile ReadEEPROM 0x08 / WriteEEPROM 0x07.
+ * Prefer cable when both are present. Wireless uses the same cmds with
+ * slightly longer spacing between EEPROM chunks.
+ */
+const EGG_VENDOR_ID = 0x3367;
+const OP1WE_CABLE_PIDS = new Set([0x1962, 0x1972]);
+const OP1WE_RECEIVER_PIDS = new Set([0x1961, 0x1970]);
+/** XM2we receiver revisions observed in WebHID hardware reports. */
+const XM2WE_RECEIVER_PIDS = new Set([0x1960, 0x1968, 0x1982]);
+const EGG_8K_PRODUCT_IDS = new Set([0x1964, 0x1966, 0x1976, 0x1978, 0x1980]);
+/**
+ * Wire report ID of the OP1-8K config protocol's command feature report
+ * (EGG_REPORT.command in endgame-gear/op1.ts). The OP1w 4K v2 wireless
+ * receiver reuses PID 0x1970 from the older, unrelated OP1we dongle
+ * (OP1WE_RECEIVER_PIDS below), so PID alone cannot tell them apart — see
+ * issue #107. Any device exposing this feature report speaks the OP1-8K
+ * protocol and must be left to EggOp1HidClient regardless of its PID.
+ */
+const EGG_OP1_COMMAND_REPORT_ID = 0xa1;
+const USAGE_PAGE_CMD = 0xff02;
+const USAGE_PAGE_NOTIFY = 0xff01;
+const REPORT_NOTIFY = 0x09;
+const CMD_TIMEOUT_MS = 900;
+const WIRED_POLL_INTERVAL_MS = 30_000;
+/** Slower status refresh on the dongle to avoid flooding the RF path. */
+const WIRELESS_POLL_INTERVAL_MS = 45_000;
+const WIRELESS_EEPROM_GAP_MS = 35;
+/** Profile bytes needed for DPI + LOD + debounce (+ stages). */
+const PROFILE_END = 0xb5;
+export class EggWeHidClient {
+    /** Max report rate for this model (OEM UI: 125 / 250 / 500 / 1000 Hz). */
+    static MAX_POLLING_HZ = 1000;
+    cmdDevice = null;
+    notifyDevice = null;
+    channelsResolved = false;
+    responseWaiter = null;
+    onInputReport = (event) => {
+        if (event.reportId !== REPORT_NOTIFY)
+            return;
+        const bytes = new Uint8Array(event.data.buffer.slice(event.data.byteOffset, event.data.byteOffset + event.data.byteLength));
+        const waiter = this.responseWaiter;
+        if (!waiter || bytes[0] !== waiter.command)
+            return;
+        window.clearTimeout(waiter.timer);
+        this.responseWaiter = null;
+        waiter.resolve(bytes);
+    };
+    device;
+    constructor(device) {
+        this.device = device;
+    }
+    static fromAuthorizedDevices(devices) {
+        const primary = this.pickDevices(devices)[0];
+        if (!primary)
+            return null;
+        const client = new EggWeHidClient(primary);
+        client.bindPeers(devices);
+        return client;
+    }
+    static isSupported(device) {
+        if (device.vendorId !== EGG_VENDOR_ID)
+            return false;
+        if (EGG_8K_PRODUCT_IDS.has(device.productId))
+            return false;
+        // PID-based exclusion above only covers the wired OP1-8K family. A
+        // receiver PID here (e.g. 0x1970) can also belong to a newer OP1-8K-v2
+        // wireless model that happens to reuse it; the descriptor is the only
+        // reliable signal in that case.
+        if (this.hasOp1EightKCommandReport(device))
+            return false;
+        return OP1WE_CABLE_PIDS.has(device.productId)
+            || OP1WE_RECEIVER_PIDS.has(device.productId)
+            || XM2WE_RECEIVER_PIDS.has(device.productId);
+    }
+    static hasOp1EightKCommandReport(device) {
+        return this.listFeatureReports(device).some((report) => report.reportId === EGG_OP1_COMMAND_REPORT_ID);
+    }
+    static isReceiverDevice(device) {
+        if (OP1WE_RECEIVER_PIDS.has(device.productId) || XM2WE_RECEIVER_PIDS.has(device.productId))
+            return true;
+        const name = (device.productName || "").toLowerCase();
+        return name.includes("receiver") || name.includes("dongle");
+    }
+    static displayNameForDevice(device) {
+        const name = (device.productName || "").toLowerCase();
+        return XM2WE_RECEIVER_PIDS.has(device.productId) || name.includes("xm2")
+            ? "Endgame Gear XM2we"
+            : "Endgame Gear OP1we";
+    }
+    static pickDevices(devices) {
+        const we = devices.filter((device) => this.isSupported(device));
+        if (we.length === 0)
+            return [];
+        const ranked = [...we].sort((left, right) => {
+            const receiverDelta = Number(this.isReceiverDevice(left)) - Number(this.isReceiverDevice(right));
+            if (receiverDelta !== 0)
+                return receiverDelta;
+            return this.supportScore(right) - this.supportScore(left);
+        });
+        return ranked[0] ? [ranked[0]] : [];
+    }
+    static supportScore(device) {
+        if (!this.isSupported(device))
+            return 0;
+        let score = 1;
+        if (OP1WE_CABLE_PIDS.has(device.productId))
+            score += 8;
+        if (OP1WE_RECEIVER_PIDS.has(device.productId))
+            score += 2;
+        if (!this.isReceiverDevice(device))
+            score += 4;
+        const pages = this.usagePages(device);
+        if (pages.has(USAGE_PAGE_CMD))
+            score += 10;
+        if (pages.has(USAGE_PAGE_NOTIFY))
+            score += 10;
+        if (pages.has(0xff04))
+            score += 4;
+        const features = this.listFeatureReports(device);
+        const inputs = this.listInputReports(device);
+        if (features.some((report) => report.reportId === WE_REPORT_ID && report.payloadLength >= 15))
+            score += 6;
+        if (inputs.some((report) => report.reportId === REPORT_NOTIFY && report.payloadLength >= 15))
+            score += 6;
+        if (features.length > 0)
+            score += 2;
+        return score;
+    }
+    get pollIntervalMs() {
+        return this.isWirelessPath() ? WIRELESS_POLL_INTERVAL_MS : WIRED_POLL_INTERVAL_MS;
+    }
+    isWirelessPath() {
+        return EggWeHidClient.isReceiverDevice(this.device);
+    }
+    ownsDevice(device) {
+        return device === this.device
+            || device === this.cmdDevice
+            || device === this.notifyDevice;
+    }
+    displayName() {
+        const devices = [this.device, this.cmdDevice, this.notifyDevice].filter((device) => device !== null);
+        return devices.some((device) => EggWeHidClient.displayNameForDevice(device).includes("XM2we"))
+            ? "Endgame Gear XM2we"
+            : "Endgame Gear OP1we";
+    }
+    /**
+     * Pair FF02 (cmd) + FF01 (notify) for this transport only.
+     * Cable primary → cable peers; receiver primary → receiver peers.
+     */
+    bindPeers(devices) {
+        const wireless = this.isWirelessPath();
+        const peers = devices.filter((candidate) => candidate.vendorId === this.device.vendorId
+            && candidate.productId === this.device.productId
+            && EggWeHidClient.isReceiverDevice(candidate) === wireless);
+        const pool = peers.length > 0 ? peers : [this.device];
+        const cmd = pool.find((d) => EggWeHidClient.hasCmdChannel(d)) ?? null;
+        const notify = pool.find((d) => EggWeHidClient.hasNotifyChannel(d)) ?? null;
+        this.cmdDevice = cmd ?? (EggWeHidClient.hasCmdChannel(this.device) ? this.device : null);
+        this.notifyDevice = notify
+            ?? (EggWeHidClient.hasNotifyChannel(this.device) ? this.device : null);
+        this.channelsResolved = true;
+    }
+    async open() {
+        if (!this.channelsResolved) {
+            const authorized = typeof navigator !== "undefined" && navigator.hid
+                ? await navigator.hid.getDevices()
+                : [];
+            this.bindPeers(authorized);
+        }
+        const channels = this.resolvedChannels();
+        if (!channels) {
+            if (!this.device.opened)
+                await this.device.open();
+            return;
+        }
+        if (!channels.cmd.opened)
+            await channels.cmd.open();
+        if (channels.notify !== channels.cmd && !channels.notify.opened) {
+            await channels.notify.open();
+        }
+        channels.notify.removeEventListener("inputreport", this.onInputReport);
+        channels.notify.addEventListener("inputreport", this.onInputReport);
+    }
+    describeCollections() {
+        const parts = [];
+        const cmd = this.cmdDevice ?? this.device;
+        const notify = this.notifyDevice;
+        const features = EggWeHidClient.listFeatureReports(cmd)
+            .map((report) => `feat 0x${report.reportId.toString(16)}/${report.payloadLength}B`);
+        if (features.length)
+            parts.push(features.join(" · "));
+        if (notify) {
+            const inputs = EggWeHidClient.listInputReports(notify)
+                .filter((report) => report.reportId === REPORT_NOTIFY)
+                .map((report) => `in 0x${report.reportId.toString(16)}/${report.payloadLength}B`);
+            if (inputs.length)
+                parts.push(inputs.join(" · "));
+        }
+        return parts.join(" · ") || "no vendor reports";
+    }
+    getDpiOptions() {
+        const values = [];
+        for (let dpi = 50; dpi <= 12800; dpi += 50)
+            values.push(dpi);
+        return values;
+    }
+    get supportedPollingRates() {
+        // Same four rates as Endgame Gear WE Series software (upper bound 1000 Hz).
+        return [...WE_POLLING_RATES];
+    }
+    async readStatus() {
+        const meta = this.productMeta();
+        const wireless = meta.viaReceiver;
+        let batteryPercent = null;
+        let batteryState = "Unknown";
+        let profile = null;
+        try {
+            await this.open();
+            const battery = await this.readBatteryOnce();
+            batteryPercent = battery.percent;
+            batteryState = battery.state;
+            profile = await this.readProfile();
+        }
+        catch (error) {
+            console.info("[OpenMouse WE] readStatus failed:", error instanceof Error ? error.message : error);
+        }
+        return {
+            brand: "Endgame Gear",
+            name: meta.name,
+            batteryPercent,
+            batteryState,
+            dpi: profile?.dpi ?? 800,
+            pollingRateHz: profile?.pollingRateHz ?? 1000,
+            supportedPollingRates: this.supportedPollingRates,
+            activeProfile: null,
+            connectionType: wireless ? "Wireless" : "Wired",
+            connectionDetail: wireless ? "2.4 GHz receiver" : "USB",
+            debounceMs: null,
+            liftOffDistance: profile?.lod ?? null,
+            // Do not set eggCpiStages — that flag selects OP1 8K advanced UI.
+            firmware: [],
+            ui: {
+                family: "egg-we",
+                settingsReady: profile !== null,
+                hideLodLow: true,
+                hideUnsupportedPollingRates: true,
+                hideProcessingCard: true,
+                forceShowBattery: true,
+                pollingNote: `${meta.name.replace("Endgame Gear ", "")} supports up to 1,000 Hz (125 / 250 / 500 / 1000).`,
+                defaultDisplayName: meta.name,
+            },
+        };
+    }
+    async setDpi(dpi) {
+        if (!weIsValidCpi(dpi) || !this.getDpiOptions().includes(dpi)) {
+            throw new Error("OP1we CPI must be between 50 and 12,800 in 50 CPI steps.");
+        }
+        await this.open();
+        const mem = await this.readProfileMemory();
+        const profile = weDecodeProfile(mem);
+        wePatchActiveDpi(mem, dpi, profile.activeDpiLevel);
+        const off = WE_OFF.dpiStages + profile.activeDpiLevel * WE_OFF.dpiStageBytes;
+        await this.writeEeprom(off, [...mem.subarray(off, off + WE_OFF.dpiStageBytes)]);
+        const confirmed = weDecodeProfile(await this.readProfileMemory());
+        if (confirmed.dpi !== dpi) {
+            throw new Error(`The mouse kept ${confirmed.dpi} CPI instead of ${dpi} CPI.`);
+        }
+        return confirmed.dpi;
+    }
+    async setPollingRate(rate) {
+        if (!weIsValidPollingRate(rate)) {
+            throw new Error("OP1we supports 125, 250, 500, or 1000 Hz report rate.");
+        }
+        await this.open();
+        const encoded = weEncodeReportRate(rate);
+        const [v, c] = wePackScalarPair(encoded);
+        await this.writeEeprom(WE_OFF.reportRate, [v, c]);
+        const confirmed = weDecodeProfile(await this.readProfileMemory());
+        if (confirmed.pollingRateHz !== rate) {
+            throw new Error(`The mouse kept ${confirmed.pollingRateHz.toLocaleString()} Hz instead of ${rate.toLocaleString()} Hz.`);
+        }
+        return confirmed.pollingRateHz;
+    }
+    async setLiftOffDistance(value) {
+        if (value === "Low") {
+            throw new Error("The OP1we supports Medium or High lift-off distance only.");
+        }
+        const raw = weEncodeLod(value);
+        await this.open();
+        const [v, c] = wePackScalarPair(raw);
+        await this.writeEeprom(WE_OFF.lod, [v, c]);
+        const profile = weDecodeProfile(await this.readProfileMemory());
+        if (profile.lod !== value) {
+            throw new Error(`The mouse kept ${profile.lod ?? "unknown"} LOD instead of ${value}.`);
+        }
+    }
+    async close() {
+        if (this.responseWaiter) {
+            window.clearTimeout(this.responseWaiter.timer);
+            this.responseWaiter.reject(new Error("The OP1we device was closed."));
+            this.responseWaiter = null;
+        }
+        const notify = this.notifyDevice;
+        if (notify)
+            notify.removeEventListener("inputreport", this.onInputReport);
+        const unique = new Set([
+            this.device,
+            ...(this.cmdDevice ? [this.cmdDevice] : []),
+            ...(this.notifyDevice ? [this.notifyDevice] : []),
+        ]);
+        for (const device of unique) {
+            if (device.opened)
+                await device.close().catch(() => undefined);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Profile EEPROM
+    // ---------------------------------------------------------------------------
+    async readProfile() {
+        return weDecodeProfile(await this.readProfileMemory());
+    }
+    async readProfileMemory() {
+        const mem = new Uint8Array(PROFILE_END);
+        let addr = 0;
+        while (addr < PROFILE_END) {
+            const len = Math.min(WE_MAX_EEPROM_CHUNK, PROFILE_END - addr);
+            const chunk = await this.readEeprom(addr, len);
+            mem.set(chunk, addr);
+            addr += len;
+            // Space RF commands on the dongle so the cursor does not stall.
+            if (this.isWirelessPath() && addr < PROFILE_END) {
+                await this.delay(WIRELESS_EEPROM_GAP_MS);
+            }
+        }
+        return mem;
+    }
+    async readEeprom(addr, length) {
+        const channels = this.requireChannels();
+        const payload = weBuildReadEepromPayload(addr, length);
+        const response = await this.transact(channels, WE_CMD_READ_EEPROM, payload);
+        const data = weParseReadEepromResponse(response, addr, length);
+        if (!data) {
+            throw new Error(`OP1we ReadEEPROM failed at 0x${addr.toString(16)} len=${length} `
+                + `raw=[${this.toHex(response)}]`);
+        }
+        return data;
+    }
+    async writeEeprom(addr, data) {
+        const channels = this.requireChannels();
+        const payload = weBuildWriteEepromPayload(addr, data);
+        const response = await this.transact(channels, WE_CMD_WRITE_EEPROM, payload);
+        if (!weParseWriteEepromResponse(response)) {
+            throw new Error(`OP1we WriteEEPROM failed at 0x${addr.toString(16)} raw=[${this.toHex(response)}]`);
+        }
+        if (this.isWirelessPath())
+            await this.delay(WIRELESS_EEPROM_GAP_MS);
+    }
+    delay(milliseconds) {
+        return new Promise((resolve) => window.setTimeout(resolve, milliseconds));
+    }
+    // ---------------------------------------------------------------------------
+    // GetPower + transport
+    // ---------------------------------------------------------------------------
+    productMeta() {
+        const viaReceiver = EggWeHidClient.isReceiverDevice(this.device);
+        return { name: this.displayName(), wired: !viaReceiver, viaReceiver };
+    }
+    requireChannels() {
+        const channels = this.resolvedChannels();
+        if (!channels) {
+            throw new Error("OP1we vendor channels missing. Authorize FF02 (command) and FF01 (notify).");
+        }
+        return channels;
+    }
+    resolvedChannels() {
+        if (!this.cmdDevice || !EggWeHidClient.hasCmdChannel(this.cmdDevice))
+            return null;
+        const notify = this.notifyDevice
+            ?? (EggWeHidClient.hasNotifyChannel(this.cmdDevice) ? this.cmdDevice : null);
+        if (!notify)
+            return null;
+        return { cmd: this.cmdDevice, notify };
+    }
+    async readBatteryOnce() {
+        try {
+            const channels = this.requireChannels();
+            const payload = weBuildCmdPayload(WE_CMD_GET_POWER);
+            const response = await this.transact(channels, WE_CMD_GET_POWER, payload);
+            const parsed = this.parseGetPowerResponse(response);
+            if (parsed.percent === null)
+                return { percent: null, state: "Unknown" };
+            if (parsed.charging) {
+                return { percent: parsed.percent, state: parsed.percent >= 99 ? "Full" : "Charging" };
+            }
+            return { percent: parsed.percent, state: parsed.percent >= 99 ? "Full" : "Discharging" };
+        }
+        catch {
+            return { percent: null, state: "Unknown" };
+        }
+    }
+    parseGetPowerResponse(response) {
+        let data = response;
+        if (data[0] === REPORT_NOTIFY && data.byteLength > WE_PAYLOAD_LEN - 1) {
+            data = data.subarray(1);
+        }
+        if (data.byteLength < 7)
+            return { percent: null, charging: false };
+        if (data[0] !== WE_CMD_GET_POWER || data[1] !== 0)
+            return { percent: null, charging: false };
+        const power = data[5];
+        if (power === undefined || power > 100)
+            return { percent: null, charging: false };
+        return { percent: power, charging: (data[6] ?? 0) !== 0 };
+    }
+    failWaiter(error) {
+        const waiter = this.responseWaiter;
+        if (!waiter)
+            return;
+        window.clearTimeout(waiter.timer);
+        this.responseWaiter = null;
+        waiter.reject(error);
+    }
+    async transact(channels, command, payload) {
+        this.failWaiter(new Error("Superseded by another OP1we request."));
+        const responsePromise = new Promise((resolve, reject) => {
+            const timer = window.setTimeout(() => {
+                if (this.responseWaiter?.resolve === resolve)
+                    this.responseWaiter = null;
+                reject(new Error(`Timed out waiting for OP1we cmd 0x${command.toString(16)}.`));
+            }, CMD_TIMEOUT_MS);
+            this.responseWaiter = { command, resolve, reject, timer };
+        });
+        channels.notify.removeEventListener("inputreport", this.onInputReport);
+        channels.notify.addEventListener("inputreport", this.onInputReport);
+        if (payload.byteLength !== WE_PAYLOAD_LEN) {
+            throw new Error("WE payload must be 16 bytes.");
+        }
+        // Ensure ArrayBuffer-backed view for WebHID typings.
+        const copy = new Uint8Array(payload);
+        try {
+            await channels.cmd.sendFeatureReport(WE_REPORT_ID, copy.buffer);
+        }
+        catch (error) {
+            this.failWaiter(error instanceof Error ? error : new Error(String(error)));
+        }
+        return responsePromise;
+    }
+    toHex(bytes) {
+        return [...bytes].map((byte) => byte.toString(16).padStart(2, "0")).join(" ");
+    }
+    // ---------------------------------------------------------------------------
+    // Descriptor helpers
+    // ---------------------------------------------------------------------------
+    static hasCmdChannel(device) {
+        const pages = this.usagePages(device);
+        if (pages.has(USAGE_PAGE_CMD))
+            return true;
+        return this.listFeatureReports(device)
+            .some((report) => report.reportId === WE_REPORT_ID && report.payloadLength >= 15);
+    }
+    static hasNotifyChannel(device) {
+        const pages = this.usagePages(device);
+        if (pages.has(USAGE_PAGE_NOTIFY))
+            return true;
+        return this.listInputReports(device)
+            .some((report) => report.reportId === REPORT_NOTIFY && report.payloadLength >= 15);
+    }
+    static usagePages(device) {
+        const pages = new Set();
+        const visit = (collections) => {
+            for (const collection of collections) {
+                pages.add(collection.usagePage);
+                visit(collection.children);
+            }
+        };
+        visit(device.collections);
+        return pages;
+    }
+    static listFeatureReports(device) {
+        return this.listReports(device, "featureReports");
+    }
+    static listInputReports(device) {
+        return this.listReports(device, "inputReports");
+    }
+    static listReports(device, kind) {
+        const found = [];
+        const visit = (collections) => {
+            for (const collection of collections) {
+                for (const report of collection[kind]) {
+                    found.push({
+                        reportId: report.reportId,
+                        payloadLength: this.reportPayloadLength(report),
+                    });
+                }
+                visit(collection.children);
+            }
+        };
+        visit(device.collections);
+        return found;
+    }
+    static reportPayloadLength(report) {
+        let bits = 0;
+        for (const item of report.items ?? []) {
+            bits += item.reportSize * item.reportCount;
+        }
+        return bits === 0 ? 0 : Math.ceil(bits / 8);
+    }
+}
+//# sourceMappingURL=egg-we-hid.js.map

package/dist/drivers/endgame/egg-we-hid.js.map

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

package/dist/drivers/fantech/hid.d.ts

@@ -0,0 +1,106 @@
+import type { MouseStatus } from "../mouse-types.ts";
+export declare const CMD: {
+    readonly GET_ALL_PARAMS: 159;
+    readonly GET_DPI: 144;
+    readonly SET_DPI: 16;
+    readonly GET_REPORT_RATE: 131;
+    readonly SET_REPORT_RATE: 8;
+    readonly GET_DEBOUNCE: 132;
+    readonly SET_DEBOUNCE: 4;
+    readonly SET_PROFILE: 2;
+};
+/**
+ * Report rate encoding for Fantech mice.
+ *
+ * This table is also the single source of truth for `supportedPollingRates`:
+ * a rate the driver cannot encode must never reach the UI, which renders one
+ * button per advertised rate and would throw on click. 250 Hz is deliberately
+ * absent — Fantech's own spec sheet lists it for the WG14P, but its wire
+ * encoding has never been captured, and inventing a code byte would silently
+ * set some other rate. Add it here, and nowhere else, once a capture confirms
+ * the value.
+ */
+export declare const REPORT_RATE_ENCODE: Record<number, number>;
+export declare const REPORT_RATE_DECODE: Record<number, number>;
+export declare const FANTECH_REPORT_ID = 0;
+export declare const FANTECH_REPORT_SIZE = 64;
+/** DPI slots the Family B report layout has room for (bytes [8..23] X, [24..39] Y). */
+export declare const FANTECH_MAX_DPI_SLOTS = 8;
+/**
+ * Fantech vendor HID control.
+ *
+ * Transport: vendor usage page 0xFFFF, usage 0x02 under VID 0x3151.
+ * The WG14P Yari Pro exposes a 64-byte feature report on this interface
+ * for DPI and configuration settings.
+ *
+ * Protocol: Fantech command-based protocol (Family B).
+ * - Send command as first byte of 64-byte feature report
+ * - Read response as 64-byte feature report
+ * - DPI stored as LE uint16 in bytes [8+h*2..9+h*2] (X) and [24+h*2..25+h*2] (Y)
+ * - Report rate encoded as 0=8000, 1=4000, 2=2000, 3=1000, 4=500, 5=125
+ *
+ * NOT every VID 0x3151 mouse speaks Family B, and the ones that do not are
+ * indistinguishable from the ones that do until you ask them something. The
+ * 2.4G receiver sold as PID 0x402D presents byte-for-byte the interface
+ * described above — vendor page 0xFFFF, usage 0x02, one unnumbered 64-byte
+ * feature report — and ACKs every SET_FEATURE write without error, yet
+ * answers GET_DPI, GET_REPORT_RATE, GET_ALL_PARAMS and GET_DEBOUNCE alike
+ * with 64 zero bytes (measured on Windows across 0-500ms read delays and
+ * three different command layouts).
+ *
+ * Reading those zeros as data is worse than failing outright: byte 2 of a
+ * blank response decodes to report-rate code 0 = 8000 Hz, and a zero DPI used
+ * to fall back to 1600, so `readStatus()` returned a perfectly plausible
+ * "ready" mouse whose every number was invented. Each read below therefore
+ * rejects a blank response, and `readStatus()` throws when nothing answers at
+ * all — the caller treats that as "try the next candidate driver" (see
+ * `connectToInterface()` in the desktop app under `src/native-hid/scan.ts`).
+ */
+export declare class FantechHidClient {
+    device: HIDDevice;
+    currentProfile: number;
+    constructor(device: HIDDevice);
+    static isSupported(device: HIDDevice): boolean;
+    /**
+     * Only the rates this driver can actually put on the wire. Derived from
+     * REPORT_RATE_ENCODE so the list the UI renders and the list
+     * `setReportRate()` accepts cannot drift apart.
+     */
+    get supportedPollingRates(): number[];
+    getDpiOptions(): number[];
+    open(): Promise<void>;
+    close(): Promise<void>;
+    /** Send a command and return the raw response, answered or not. */
+    sendCommand(cmd: number, ...payload: number[]): Promise<Uint8Array>;
+    /**
+     * Send a command that must be answered, rejecting a response that carries no
+     * answer at all. A device on a different protocol family still ACKs the
+     * feature write and hands back a zero-filled buffer, which is exactly what
+     * used to be decoded into invented DPI and polling-rate readings — see the
+     * class docs.
+     */
+    sendQuery(cmd: number, ...payload: number[]): Promise<Uint8Array>;
+    /** Read a response report. */
+    readResponse(): Promise<Uint8Array>;
+    /**
+     * Read current DPI settings for the active slot. Throws when the device does
+     * not answer, or answers without a usable DPI — a caller must never be handed
+     * a fabricated default it cannot tell apart from a real reading.
+     */
+    getDpi(): Promise<{
+        dpiX: number;
+        dpiY: number;
+        slot: number;
+        numSlots: number;
+    }>;
+    /** Set DPI for a specific slot, leaving every other slot exactly as it was. */
+    setDpiForSlot(dpiX: number, dpiY: number, slot?: number): Promise<number>;
+    /** Get current report/polling rate. Throws when the device does not answer. */
+    getReportRate(): Promise<number>;
+    /** Set report/polling rate. */
+    setReportRate(hz: number): Promise<number>;
+    readStatus(): Promise<MouseStatus>;
+    setDpi(dpi: number, dpiY?: number): Promise<number>;
+    setPollingRate(rate: number): Promise<number>;
+}
+//# sourceMappingURL=hid.d.ts.map

package/dist/drivers/fantech/hid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hid.d.ts","sourceRoot":"","sources":["../../../src/drivers/fantech/hid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,eAAO,MAAM,GAAG;;;;;;;;;CAUN,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOrD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAErD,CAAC;AAEF,eAAO,MAAM,iBAAiB,IAAO,CAAC;AACtC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAavC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,cAAc,SAAK;gBAEP,MAAM,EAAE,SAAS;IAI7B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAmB9C;;;;OAIG;IACH,IAAI,qBAAqB,IAAI,MAAM,EAAE,CAIpC;IAED,aAAa,IAAI,MAAM,EAAE;IAOnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,mEAAmE;IAC7D,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAUzE;;;;;;OAMG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAevE,8BAA8B;IACxB,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IASzC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAqBF,+EAA+E;IACzE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC1E,+EAA+E;IACzE,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAWtC,+BAA+B;IACzB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB1C,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAiDlC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOhD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CASpD"}