@openmouse/protocol 0.1.0

package/dist/steelseries/aerox5.js

@@ -0,0 +1,294 @@
+/**
+ * SteelSeries Aerox 5 (wired-only) configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - rivalcfg `rivalcfg/devices/aerox5.py` — the primary source for every
+ *   command byte and default here. This profile covers only `1038:1850`
+ *   ("SteelSeries Aerox 5", endpoint 3) — the plain wired mouse, **not** the
+ *   separately-sold Aerox 5 Wireless. See `./aerox5-wireless.ts` for that
+ *   device: it is a genuinely different command layout (different DPI
+ *   command polling-rate byte values, different RGB zone packing, extra
+ *   sleep/dim timers, a fixed-argument rainbow command, and a battery read),
+ *   not just this module with different product ids swapped in. Do not
+ *   assume the two share a codec.
+ * - rivalcfg `rivalcfg/devices/dpi/truemove_air.py` — the DPI byte table for
+ *   this device's TrueMove Air sensor. **Not** `./rival3.ts`'s
+ *   `TRUEMOVE_CORE_DPI_TO_BYTE` (Aerox 3's sensor) — reused verbatim here
+ *   from `./rival3-wireless.ts`'s `TRUEMOVE_AIR_DPI_TO_BYTE` instead, since
+ *   `aerox5.py`'s `output_choices: truemove_air.choices` is byte-for-byte
+ *   the same table rivalcfg already uses for the Rival 3 Wireless (both spot
+ *   checked: 400→0x04, 1600→0x12, 18000→0xD6).
+ * - rivalcfg `rivalcfg/handlers/multidpi_range_choice.py` — the DPI preset
+ *   packet shape, same handler as Aerox 3/Rival 3 Wireless, `dpi_length_byte: 1`
+ *   (one byte per preset, unlike Rival 3 Wireless's two). **`first_preset: 0`
+ *   here** — unlike Aerox 3 and Rival 3 Wireless (both `first_preset: 1`),
+ *   `aerox5.py` encodes the selected index directly with no +1 offset. This
+ *   is the one place this device's DPI framing differs from Aerox 3's
+ *   despite sharing the same command byte and one-byte preset width.
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` / `reactive_rgbcolor.py` — RGB
+ *   value encoding, byte-identical to `./aerox3.ts`'s usage.
+ * - rivalcfg `rivalcfg/handlers/range.py` — LED brightness (linear 0–100
+ *   passthrough, `range_length_byte` omitted so 1 byte).
+ * - rivalcfg `rivalcfg/handlers/buttons/buttons.py` — the fixed-width button
+ *   field layout, 5 bytes/button, but **9 physical buttons plus scroll
+ *   up/down** (`button1`…`button9`, `scrollup`, `scrolldown` — 11 slots, 55
+ *   bytes total) instead of Aerox 3's 6 buttons plus scroll (8 slots).
+ *   Offsets step by 5 for buttons 1–9 (`0x00`…`0x28`) then scroll up/down
+ *   continue the same stride (`0x2D`, `0x32`).
+ *
+ * ## Why this is a separate protocol family from Aerox 3 despite similar shape
+ *
+ * Superficially close to `./aerox3.ts` (same `0x2D`/`0x2B`/`0x21`/`0x26`/
+ * `0x23`/`0x22`/`0x2A`/`0x27`/`0x11 00` command bytes, same RGB zone
+ * bitmask-and-padding packing), but genuinely different in the details that
+ * matter for correctness:
+ *
+ * - Different DPI sensor table (TrueMove Air vs. TrueMove Core) — same
+ *   command byte, disjoint value bytes.
+ * - `first_preset: 0` vs. Aerox 3's `first_preset: 1` (see above).
+ * - 9 buttons + scroll vs. Aerox 3's 6 buttons + scroll — different packet
+ *   length and offsets past button 5.
+ * - `aerox5.py`'s `rainbow_effect` and `default_lighting` choice tables are
+ *   byte-identical to `aerox3.py`'s, confirmed by direct comparison, not
+ *   assumed — reused as identical constants rather than re-derived.
+ *
+ * Given these differences, PID `0x1850` is registered under its own family
+ * (`"aerox5"`), not folded into `"aerox3"`.
+ *
+ * No corroborating libratbag or OpenRGB source for `1038:1850` specifically
+ * was available in this environment (no local libratbag checkout, and
+ * OpenRGB's SteelSeries controller files were not reachable this pass) —
+ * every command byte above is sourced from rivalcfg alone, same
+ * single-source caveat cluster 2 flagged for the Rival 3 Wireless. This
+ * should be treated as unverified beyond rivalcfg until corroborated or
+ * hardware-tested.
+ *
+ * Every command is an HID output report, report id `0x00`, on the vendor
+ * configuration interface (`"endpoint": 3`). This module is write-only —
+ * `aerox5.py` defines no getter for any setting and no firmware-query
+ * command, same as Aerox 3. Settings apply immediately; the save command
+ * (`11 00`) persists them to onboard flash. None of this has been verified
+ * on physical hardware by this project.
+ */
+import { TRUEMOVE_AIR_DPI_TO_BYTE } from "./rival3-wireless.js";
+export const AEROX5_REPORT_ID = 0x00;
+/** One-byte command prefixes; the payload is the prefix plus its arguments. */
+export const AEROX5_COMMAND = {
+    dpiPresets: [0x2d],
+    pollingRate: [0x2b],
+    reactiveColor: [0x26],
+    ledBrightness: [0x23],
+    rainbowEffect: [0x22],
+    buttonsMapping: [0x2a],
+    defaultLighting: [0x27],
+    zoneColor: [0x21],
+};
+/** `11 00` — same byte-pair as Aerox 3's save command. */
+export const AEROX5_SAVE_COMMAND = [0x11, 0x00];
+export const AEROX5_POLLING_RATES = [125, 250, 500, 1000];
+const POLLING_RATE_TO_BYTE = new Map([
+    [1000, 0x01],
+    [500, 0x02],
+    [250, 0x03],
+    [125, 0x04],
+]);
+export const AEROX5_DPI_MIN = 100;
+export const AEROX5_DPI_MAX = 18000;
+export const AEROX5_DPI_STEP = 100;
+export const AEROX5_MAX_DPI_PRESETS = 5;
+export class Aerox5ProtocolError extends Error {
+}
+/** The 180 DPI values the shared TrueMove Air sensor table can express, ascending. */
+export function steelseriesAerox5DpiOptions() {
+    return [...TRUEMOVE_AIR_DPI_TO_BYTE.keys()].sort((a, b) => a - b);
+}
+/**
+ * `2D <count> <selected> <v1>…<vN>` — replaces the mouse's whole preset
+ * table. One byte per DPI (`dpi_length_byte: 1`). `selectedIndex` is 0-based
+ * and encoded 0-based on the wire (`first_preset: 0` — unlike Aerox 3's
+ * `first_preset: 1`, no +1 offset here).
+ */
+export function steelseriesAerox5EncodeDpiPresets(presets, selectedIndex) {
+    if (presets.length < 1 || presets.length > AEROX5_MAX_DPI_PRESETS) {
+        throw new Aerox5ProtocolError(`SteelSeries Aerox 5 supports 1–${AEROX5_MAX_DPI_PRESETS} DPI presets.`);
+    }
+    if (!Number.isInteger(selectedIndex) || selectedIndex < 0 || selectedIndex >= presets.length) {
+        throw new Aerox5ProtocolError(`Selected DPI preset must be an index into the ${presets.length} presets being written.`);
+    }
+    const encoded = presets.map((dpi) => {
+        const byte = TRUEMOVE_AIR_DPI_TO_BYTE.get(dpi);
+        if (byte === undefined) {
+            throw new Aerox5ProtocolError(`SteelSeries Aerox 5 DPI must be ${AEROX5_DPI_MIN}–${AEROX5_DPI_MAX.toLocaleString()} in ${AEROX5_DPI_STEP} DPI steps.`);
+        }
+        return byte;
+    });
+    return new Uint8Array([...AEROX5_COMMAND.dpiPresets, presets.length, selectedIndex, ...encoded]);
+}
+/** `2B <v>` with 1000→0x01, 500→0x02, 250→0x03, 125→0x04 — same mapping as Aerox 3. */
+export function steelseriesAerox5EncodePollingRate(pollingRateHz) {
+    const byte = POLLING_RATE_TO_BYTE.get(pollingRateHz);
+    if (byte === undefined) {
+        throw new Aerox5ProtocolError("SteelSeries Aerox 5 supports 125, 250, 500, or 1000 Hz polling.");
+    }
+    return new Uint8Array([...AEROX5_COMMAND.pollingRate, byte]);
+}
+function encodeRgb(r, g, b) {
+    for (const channel of [r, g, b]) {
+        if (!Number.isInteger(channel) || channel < 0 || channel > 255) {
+            throw new Aerox5ProtocolError("RGB channels must be integers 0–255.");
+        }
+    }
+    return [r, g, b];
+}
+/**
+ * `21 <bitmask> <padding for skipped zones> <r> <g> <b>` — identical packing
+ * to `./aerox3.ts`'s zone-color command: zone 1 = top LED, zone 2 = middle
+ * LED, zone 3 = bottom LED.
+ */
+export function steelseriesAerox5EncodeZoneColor(zone, r, g, b) {
+    const [red, green, blue] = encodeRgb(r, g, b);
+    if (zone === 1) {
+        return new Uint8Array([...AEROX5_COMMAND.zoneColor, 0x01, red, green, blue]);
+    }
+    if (zone === 2) {
+        return new Uint8Array([...AEROX5_COMMAND.zoneColor, 0x02, 0x00, 0x00, 0x00, red, green, blue]);
+    }
+    if (zone === 3) {
+        return new Uint8Array([
+            ...AEROX5_COMMAND.zoneColor, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, red, green, blue,
+        ]);
+    }
+    throw new Aerox5ProtocolError("SteelSeries Aerox 5 has zones 1 (top), 2 (middle), and 3 (bottom) only.");
+}
+/**
+ * `26 00 00 00 00 00` when disabled, `26 01 00 <r> <g> <b>` when enabled —
+ * byte-identical to `./aerox3.ts`'s reactive-color command.
+ */
+export function steelseriesAerox5EncodeReactiveColor(color) {
+    if (color === null) {
+        return new Uint8Array([...AEROX5_COMMAND.reactiveColor, 0x00, 0x00, 0x00, 0x00, 0x00]);
+    }
+    const [r, g, b] = encodeRgb(color.r, color.g, color.b);
+    return new Uint8Array([...AEROX5_COMMAND.reactiveColor, 0x01, 0x00, r, g, b]);
+}
+/** `23 <v>` — linear 0–100 passthrough. */
+export function steelseriesAerox5EncodeLedBrightness(percent) {
+    if (!Number.isInteger(percent) || percent < 0 || percent > 100) {
+        throw new Aerox5ProtocolError("SteelSeries Aerox 5 LED brightness must be an integer 0–100.");
+    }
+    return new Uint8Array([...AEROX5_COMMAND.ledBrightness, percent]);
+}
+/** Byte-identical to `AEROX3_RAINBOW_ZONES`, confirmed by direct comparison of the two device files. */
+export const AEROX5_RAINBOW_ZONES = {
+    all: 0b111,
+    bottom: 0b100,
+    middle: 0b010,
+    top: 0b001,
+    "bottom-middle": 0b110,
+    "middle-top": 0b011,
+    "bottom-top": 0b101,
+};
+/** `22 <bitmask>` — rainbow effect on the selected zone(s); cleared by setting a color. */
+export function steelseriesAerox5EncodeRainbowEffect(zones) {
+    const byte = AEROX5_RAINBOW_ZONES[zones];
+    if (byte === undefined) {
+        throw new Aerox5ProtocolError(`SteelSeries Aerox 5 rainbow zones must be one of: ${Object.keys(AEROX5_RAINBOW_ZONES).join(", ")}.`);
+    }
+    return new Uint8Array([...AEROX5_COMMAND.rainbowEffect, byte]);
+}
+/** Byte-identical to `AEROX3_DEFAULT_LIGHTING`, confirmed by direct comparison of the two device files. */
+export const AEROX5_DEFAULT_LIGHTING = {
+    off: [0x00, 0x00],
+    reactive: [0x00, 0x01],
+    rainbow: [0x01, 0x00],
+    "reactive-rainbow": [0x01, 0x01],
+};
+/** `27 <v1> <v2>` — what the mouse lights up as before a host ever connects. */
+export function steelseriesAerox5EncodeDefaultLighting(mode) {
+    const bytes = AEROX5_DEFAULT_LIGHTING[mode];
+    if (bytes === undefined) {
+        throw new Aerox5ProtocolError(`SteelSeries Aerox 5 default lighting must be one of: ${Object.keys(AEROX5_DEFAULT_LIGHTING).join(", ")}.`);
+    }
+    return new Uint8Array([...AEROX5_COMMAND.defaultLighting, ...bytes]);
+}
+/** `11 00` — commit the current settings to onboard flash. */
+export function steelseriesAerox5SaveCommand() {
+    return new Uint8Array(AEROX5_SAVE_COMMAND);
+}
+/**
+ * `buttons_mapping.buttons` from `aerox5.py`, id + byte offset into the
+ * packet — 9 physical buttons (this mouse's extra side-button cluster over
+ * Aerox 3's 6) plus scroll up/down, 11 slots total.
+ */
+export const AEROX5_BUTTONS = {
+    button1: { id: 0x01, offset: 0x00 },
+    button2: { id: 0x02, offset: 0x05 },
+    button3: { id: 0x03, offset: 0x0a },
+    button4: { id: 0x04, offset: 0x0f },
+    button5: { id: 0x05, offset: 0x14 },
+    button6: { id: 0x06, offset: 0x19 },
+    button7: { id: 0x07, offset: 0x1e },
+    button8: { id: 0x08, offset: 0x23 },
+    button9: { id: 0x09, offset: 0x28 },
+    scrollUp: { id: 0x31, offset: 0x2d },
+    scrollDown: { id: 0x32, offset: 0x32 },
+};
+const AEROX5_BUTTON_FIELD_LENGTH = 5;
+const AEROX5_BUTTON_DISABLE = 0x00;
+const AEROX5_BUTTON_DPI_SWITCH = 0x30;
+const AEROX5_BUTTON_KEYBOARD = 0x51;
+const AEROX5_BUTTON_MULTIMEDIA = 0x61;
+/**
+ * `2A` + one 55-byte (`11 buttons × 5-byte field length`) packet, zero-filled
+ * except where a mapping is given. Unmapped buttons are left as all-zero
+ * fields (rivalcfg instead fills in per-button defaults; this codec leaves
+ * that policy to the caller — pass every button explicitly for parity with
+ * rivalcfg's default profile).
+ */
+export function steelseriesAerox5EncodeButtonsMapping(mapping) {
+    const names = Object.keys(AEROX5_BUTTONS);
+    const packet = new Array(names.length * AEROX5_BUTTON_FIELD_LENGTH).fill(0x00);
+    for (const [name, action] of Object.entries(mapping)) {
+        const slot = AEROX5_BUTTONS[name];
+        if (!slot) {
+            throw new Aerox5ProtocolError(`Unknown SteelSeries Aerox 5 button "${name}".`);
+        }
+        const { offset } = slot;
+        switch (action.type) {
+            case "button": {
+                packet[offset] = AEROX5_BUTTONS[action.target].id;
+                break;
+            }
+            case "disabled": {
+                packet[offset] = AEROX5_BUTTON_DISABLE;
+                break;
+            }
+            case "dpiSwitch": {
+                packet[offset] = AEROX5_BUTTON_DPI_SWITCH;
+                break;
+            }
+            case "keyboard": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new Aerox5ProtocolError("Keyboard scan codes must be integers 0–255.");
+                }
+                packet[offset] = AEROX5_BUTTON_KEYBOARD;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            case "multimedia": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new Aerox5ProtocolError("Multimedia key codes must be integers 0–255.");
+                }
+                packet[offset] = AEROX5_BUTTON_MULTIMEDIA;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            default: {
+                throw new Aerox5ProtocolError(`Unsupported SteelSeries Aerox 5 button action.`);
+            }
+        }
+    }
+    return new Uint8Array([...AEROX5_COMMAND.buttonsMapping, ...packet]);
+}
+//# sourceMappingURL=aerox5.js.map

package/dist/steelseries/aerox5.js.map

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

package/dist/steelseries/aerox9-wireless.d.ts

@@ -0,0 +1,213 @@
+/**
+ * SteelSeries Aerox 9 Wireless configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - rivalcfg `rivalcfg/devices/aerox9_wireless_wired.py` — the primary source
+ *   for every command byte, product id, and default here, for the mouse's
+ *   USB-cabled mode (`1038:185A`, plus the WOW Edition `0x1876`).
+ * - rivalcfg `rivalcfg/devices/aerox9_wireless_wireless.py` — the 2.4 GHz
+ *   dongle mode (`1038:1858`, WOW Edition `0x1874`). Read in full and diffed
+ *   directly against the wired-mode file: it is **not** a separate command
+ *   set. It is `aerox9_wireless_wired.py`'s settings dict comprehended
+ *   through one `_patch_command` helper that (1) ORs `0b01000000` (`0x40`)
+ *   into every command's first byte and (2) adds a 64-byte `readback_length`.
+ *   This is the exact same transform cluster 3 found for the Aerox 5
+ *   Wireless (`./aerox5-wireless.ts`'s `applyWirelessFlag`) — confirmed here
+ *   by direct `diff` of the two device files, not assumed from precedent.
+ *   This module implements that transform (`applyAerox9WirelessFlag`, named
+ *   distinctly from `./aerox5-wireless.ts`'s `applyWirelessFlag` to avoid a
+ *   re-export collision in `./index.ts`) rather than hand-duplicating the
+ *   wired-mode byte tables.
+ * - rivalcfg `rivalcfg/devices/dpi/truemove_air.py` — same TrueMove Air
+ *   sensor table as Aerox 5 / Aerox 5 Wireless / Rival 3 Wireless — imported
+ *   from `./rival3-wireless.ts`'s `TRUEMOVE_AIR_DPI_TO_BYTE`, not re-derived
+ *   (same `input_range`/`output_choices` reference).
+ * - rivalcfg `rivalcfg/handlers/multidpi_range_choice.py` — `dpi_length_byte: 1`,
+ *   `first_preset: 0` (same as Aerox 5 and Aerox 5 Wireless — not 1, unlike
+ *   Aerox 3 and Rival 3 Wireless), `max_preset_count: 5`.
+ * - rivalcfg `rivalcfg/handlers/range.py` — `sleep_timer`/`dim_timer`: same
+ *   linear range-to-range mapping as Aerox 5 Wireless, same output ranges
+ *   (`sleep_timer`: `[0x000000, 0x124F80, 60000]` against `[0, 20, 1]`
+ *   minutes, i.e. `minutes * 60000` ms; `dim_timer`:
+ *   `[0x000000, 0x124F80, 1000]` against `[0, 1200, 1]` seconds, i.e.
+ *   `seconds * 1000` ms), little-endian 3 bytes (`range_length_byte: 3`).
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` / `reactive_rgbcolor.py` — RGB
+ *   value encoding, same as every other SteelSeries family in this codebase.
+ * - rivalcfg `rivalcfg/handlers/none.py` — `rainbow_effect` is a fixed
+ *   no-argument enable, `22 FF` (`62 FF` wireless), same shape as Aerox 5
+ *   Wireless's — **not** the plain Aerox 5's zone-bitmask choice.
+ *
+ * ## No button-mapping command in this device's rivalcfg profile
+ *
+ * Despite SteelSeries marketing the Aerox 9 (Wireless) as a 9-button
+ * "MMO-style" mouse, `aerox9_wireless_wired.py` defines **no**
+ * `buttons_mapping` setting and no button-remap command at all — confirmed
+ * by reading the full settings dict, which has exactly nine entries
+ * (`sensitivity`, `polling_rate`, `z1_color`, `z2_color`, `z3_color`,
+ * `reactive_color`, `sleep_timer`, `dim_timer`, `rainbow_effect`,
+ * `default_lighting`) plus `battery_level`/`save_command`, none of them a
+ * buttons handler. This is unlike `./aerox5.ts` and `./aerox5-wireless.ts`,
+ * both of which do define one. This module therefore exposes no button
+ * remap function — there is nothing in the reference implementation to
+ * reconstruct it from, not an oversight.
+ *
+ * ## Why wired-cable-mode and 2.4 GHz-dongle-mode share one module
+ *
+ * Same pattern as Aerox 5 Wireless: one physical mouse, two USB product-id
+ * groups depending on how the host currently sees it, driven by the same
+ * command set modulo the fixed `applyAerox9WirelessFlag` transform. Every command
+ * byte in `AEROX9_WIRELESS_COMMAND` below is the wired-mode value;
+ * `applyAerox9WirelessFlag` produces the 2.4 GHz-mode byte on demand.
+ *
+ * ## Why this is a separate protocol family from Aerox 5 / Aerox 5 Wireless
+ *
+ * Aerox 9 Wireless shares several command bytes with Aerox 5 Wireless
+ * (`0x2D`/`0x2B`/`0x29`/`0x22`/`0x27`/`0x92`/`0x11 00`, the same
+ * `_patch_command` wireless-flag transform, the same `readback_length: 64`),
+ * but is a genuinely different device profile, confirmed by direct
+ * comparison of the two rivalcfg files rather than assumed from the shared
+ * "Aerox" naming and similar wireless architecture:
+ *
+ * - RGB zone commands are `21 01 <zone> <r> <g> <b>` here, same fixed-packet
+ *   shape as Aerox 5 Wireless's `steelseriesAerox5WirelessEncodeZoneColor`,
+ *   confirmed byte-identical (`z1_color`/`z2_color`/`z3_color` commands
+ *   `[0x21, 0x01, 0x00/0x01/0x02]` match exactly) — reused here as a
+ *   structurally identical function rather than imported, so each family's
+ *   codec stays self-contained.
+ * - `dim_timer`'s command is `23 0F 01 00 00`, byte-identical to Aerox 5
+ *   Wireless's.
+ * - No button-mapping command at all (see above) — Aerox 5 Wireless has one.
+ * - Distinct product-id space entirely: `0x185A`/`0x1876` (wired),
+ *   `0x1858`/`0x1874` (2.4 GHz) — none overlap Aerox 5 Wireless's
+ *   `0x1852`/`0x1854`/`0x185C`/`0x185E`/`0x1860`/`0x1862`, or any PID
+ *   claimed by clusters 1–3.
+ *
+ * PIDs are therefore registered under their own family
+ * (`"aerox9-wireless"`), never `"aerox5-wireless"`.
+ *
+ * No corroborating libratbag or OpenRGB source for any of these PIDs was
+ * available in this environment (no local libratbag checkout, and OpenRGB's
+ * SteelSeries controller files were not reachable this pass) — every command
+ * byte above is sourced from rivalcfg alone, same single-source caveat
+ * clusters 2 and 3 flagged for their devices. This should be treated as
+ * unverified beyond rivalcfg until corroborated or hardware-tested.
+ *
+ * Every command is an HID output report, report id `0x00`, on the vendor
+ * configuration interface (`"endpoint": 3` for every model in both rivalcfg
+ * files). DPI presets, polling rate, zone colors, reactive color, sleep/dim
+ * timers, rainbow, and default lighting are write-only — neither rivalcfg
+ * file defines a getter for any of them. Battery level **is** readable (see
+ * below). Settings apply immediately; the save command (`11 00`,
+ * wireless-mode `51 00`) persists them to onboard flash. None of this has
+ * been verified on physical hardware by this project.
+ *
+ * ## Battery read
+ *
+ * `aerox9_wireless_wired.py` defines a `battery_level` block identical in
+ * shape to Aerox 5 Wireless's: an output-report write of `0x92` gets a
+ * 2-byte input-report reply, where `data[1] & 0b10000000` is the charging
+ * flag and `((data[1] & ~0b10000000) - 1) * 5` is the percentage (coarse
+ * 0–100 scale in steps of 5). Confirmed byte-for-byte identical to
+ * `aerox5_wireless_wired.py`'s `battery_level` block by direct comparison —
+ * not assumed. 2.4 GHz mode additionally needs `0x92 | 0x40 = 0xD2`, produced
+ * by `applyAerox9WirelessFlag`. This is the same battery-response shape as
+ * `./aerox5-wireless.ts` and a **different** shape from
+ * `./rival3-wireless.ts`'s `AA 01` / 3-byte-reply / plain-percentage-byte
+ * battery read — do not conflate the three devices' battery decoding.
+ */
+export declare const AEROX9_WIRELESS_REPORT_ID = 0;
+/** Wired-cable-mode command bytes; OR `WIRELESS_FLAG` into byte 0 for 2.4 GHz mode. */
+export declare const AEROX9_WIRELESS_COMMAND: {
+    readonly dpiPresets: readonly [45];
+    readonly pollingRate: readonly [43];
+    readonly zoneColor: readonly [33, 1];
+    readonly reactiveColor: readonly [38];
+    readonly sleepTimer: readonly [41];
+    readonly dimTimer: readonly [35, 15, 1, 0, 0];
+    readonly rainbowEffect: readonly [34, 255];
+    readonly defaultLighting: readonly [39];
+    readonly batteryLevel: readonly [146];
+};
+/** `11 00` wired-mode / `51 00` 2.4 GHz-mode — see `applyAerox9WirelessFlag`. */
+export declare const AEROX9_WIRELESS_SAVE_COMMAND: readonly [17, 0];
+/**
+ * `_patch_command`: OR `0b01000000` into the command's first byte. Pass the
+ * wired-mode command bytes from `AEROX9_WIRELESS_COMMAND` /
+ * `AEROX9_WIRELESS_SAVE_COMMAND`; returns the 2.4 GHz-mode equivalent.
+ */
+export declare function applyAerox9WirelessFlag(command: readonly number[]): number[];
+export declare const AEROX9_WIRELESS_POLLING_RATES: readonly [125, 250, 500, 1000];
+export declare const AEROX9_WIRELESS_DPI_MIN = 100;
+export declare const AEROX9_WIRELESS_DPI_MAX = 18000;
+export declare const AEROX9_WIRELESS_DPI_STEP = 100;
+export declare const AEROX9_WIRELESS_MAX_DPI_PRESETS = 5;
+export declare const AEROX9_WIRELESS_BATTERY_RESPONSE_LENGTH = 2;
+export declare class Aerox9WirelessProtocolError extends Error {
+}
+/** The 180 DPI values the shared TrueMove Air sensor table can express, ascending. */
+export declare function steelseriesAerox9WirelessDpiOptions(): number[];
+/**
+ * `2D <count> <selected> <v1>…<vN>` (or `6D …` in 2.4 GHz mode). One byte
+ * per DPI; `selectedIndex` is 0-based and encoded 0-based on the wire
+ * (`first_preset: 0`).
+ */
+export declare function steelseriesAerox9WirelessEncodeDpiPresets(presets: readonly number[], selectedIndex: number, wireless: boolean): Uint8Array;
+/** `2B <v>` (`6B` wireless) with 1000→0x00, 500→0x01, 250→0x02, 125→0x03. */
+export declare function steelseriesAerox9WirelessEncodePollingRate(pollingRateHz: number, wireless: boolean): Uint8Array;
+export type Aerox9WirelessZone = 1 | 2 | 3;
+/**
+ * `21 01 <zone-index> <r> <g> <b>` (`61 01 …` wireless) — a fixed 6-byte
+ * packet. Zone 1 = top LED, zone 2 = middle LED, zone 3 = bottom LED (strip
+ * order, per `z1_color`/`z2_color`/`z3_color`'s CLI flag labels).
+ */
+export declare function steelseriesAerox9WirelessEncodeZoneColor(zone: Aerox9WirelessZone, r: number, g: number, b: number, wireless: boolean): Uint8Array;
+/**
+ * `26 00 00 00 00 00` when disabled, `26 01 00 <r> <g> <b>` when enabled
+ * (`66 …` wireless) — same shape as every other SteelSeries family here.
+ */
+export declare function steelseriesAerox9WirelessEncodeReactiveColor(color: {
+    r: number;
+    g: number;
+    b: number;
+} | null, wireless: boolean): Uint8Array;
+/**
+ * `29 <ms LE24>` (`69 …` wireless) — idle minutes before sleep, `0` disables.
+ * Encoded as `minutes * 60000` milliseconds, little-endian 3 bytes.
+ */
+export declare function steelseriesAerox9WirelessEncodeSleepTimer(minutes: number, wireless: boolean): Uint8Array;
+/**
+ * `23 0F 01 00 00 <ms LE24>` (`63 …` wireless) — idle seconds before the LEDs
+ * dim, `0` disables. Encoded as `seconds * 1000` milliseconds, little-endian
+ * 3 bytes.
+ */
+export declare function steelseriesAerox9WirelessEncodeDimTimer(seconds: number, wireless: boolean): Uint8Array;
+/** `22 FF` (`62 FF` wireless) — enables the rainbow effect on all zones; a color write clears it. */
+export declare function steelseriesAerox9WirelessEncodeRainbowEffect(wireless: boolean): Uint8Array;
+/** Byte-identical to `./aerox5-wireless.ts`'s `AEROX5_WIRELESS_DEFAULT_LIGHTING`, confirmed by direct comparison. */
+export declare const AEROX9_WIRELESS_DEFAULT_LIGHTING: {
+    readonly off: readonly [0, 0];
+    readonly reactive: readonly [0, 1];
+    readonly rainbow: readonly [1, 0];
+    readonly "reactive-rainbow": readonly [1, 1];
+};
+export type Aerox9WirelessDefaultLighting = keyof typeof AEROX9_WIRELESS_DEFAULT_LIGHTING;
+/** `27 <v1> <v2>` (`67 …` wireless) — what the mouse lights up as before a host ever connects. */
+export declare function steelseriesAerox9WirelessEncodeDefaultLighting(mode: Aerox9WirelessDefaultLighting, wireless: boolean): Uint8Array;
+/** `11 00` wired-mode / `51 00` 2.4 GHz-mode — commit the current settings to onboard flash. */
+export declare function steelseriesAerox9WirelessSaveCommand(wireless: boolean): Uint8Array;
+/** `92` wired-mode / `D2` 2.4 GHz-mode — the device answers with a two-byte input report. */
+export declare function steelseriesAerox9WirelessBatteryQuery(wireless: boolean): Uint8Array;
+export interface Aerox9WirelessBattery {
+    /** `((data[1] & ~0x80) - 1) * 5` in rivalcfg — a coarse 0–100 scale in steps of 5. */
+    level: number;
+    /** `bool(data[1] & 0b10000000)` in rivalcfg. */
+    isCharging: boolean;
+}
+/**
+ * Decode the two-byte battery response: `data[0]` is unused by rivalcfg's
+ * lambdas, `data[1]`'s top bit is the charging flag and the remaining 7 bits
+ * (1-indexed, hence `- 1`) scaled by 5 give the percentage.
+ */
+export declare function steelseriesAerox9WirelessDecodeBattery(payload: Uint8Array): Aerox9WirelessBattery;
+//# sourceMappingURL=aerox9-wireless.d.ts.map

package/dist/steelseries/aerox9-wireless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aerox9-wireless.d.ts","sourceRoot":"","sources":["../../src/steelseries/aerox9-wireless.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHG;AAIH,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAK9C,uFAAuF;AACvF,eAAO,MAAM,uBAAuB;;;;;;;;;;CAU1B,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,kBAAwB,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAK5E;AAED,eAAO,MAAM,6BAA6B,gCAAiC,CAAC;AAU5E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,uCAAuC,IAAI,CAAC;AAIzD,qBAAa,2BAA4B,SAAQ,KAAK;CAAG;AAEzD,sFAAsF;AACtF,wBAAgB,mCAAmC,IAAI,MAAM,EAAE,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,OAAO,GAChB,UAAU,CAsBZ;AAED,6EAA6E;AAC7E,wBAAgB,0CAA0C,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,CAS/G;AAWD,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAI3C;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,kBAAkB,EACxB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,OAAO,GAChB,UAAU,CAUZ;AAED;;;GAGG;AACH,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACjD,QAAQ,EAAE,OAAO,GAChB,UAAU,CAOZ;AAUD;;;GAGG;AACH,wBAAgB,yCAAyC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,CAIxG;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,CAItG;AAED,qGAAqG;AACrG,wBAAgB,4CAA4C,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAG1F;AAED,qHAAqH;AACrH,eAAO,MAAM,gCAAgC;;;;;CAKnC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,MAAM,OAAO,gCAAgC,CAAC;AAE1F,kGAAkG;AAClG,wBAAgB,8CAA8C,CAC5D,IAAI,EAAE,6BAA6B,EACnC,QAAQ,EAAE,OAAO,GAChB,UAAU,CASZ;AAED,gGAAgG;AAChG,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAGlF;AAED,6FAA6F;AAC7F,wBAAgB,qCAAqC,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAGnF;AAED,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,UAAU,GAAG,qBAAqB,CAUjG"}