@openmouse/protocol 0.1.0

package/dist/steelseries/aerox5-wireless.js

@@ -0,0 +1,389 @@
+/**
+ * SteelSeries Aerox 5 Wireless configuration protocol — pure encode/decode helpers.
+ *
+ * Reconstructed from public open-source implementations, not vendor software:
+ *
+ * - rivalcfg `rivalcfg/devices/aerox5_wireless_wired.py` — the primary source
+ *   for every command byte, product id, and default here, for the mouse's
+ *   USB-cabled mode (`1038:1854`, plus the Destiny 2 / Diablo IV cosmetic
+ *   editions `0x185E`/`0x1862`).
+ * - rivalcfg `rivalcfg/devices/aerox5_wireless_wireless.py` — the 2.4 GHz
+ *   dongle mode (`1038:1852`, editions `0x185C`/`0x1860`). Read in full: it
+ *   is **not** a separate command set, it is `aerox5_wireless_wired.py`'s
+ *   settings dict comprehended through one `_patch_command` helper that (1)
+ *   ORs `0b01000000` into every command's first byte and (2) adds a 64-byte
+ *   `readback_length`. This module implements that same transform
+ *   (`applyWirelessFlag`) instead of hand-duplicating the wired-mode byte
+ *   tables, so the two PID groups can never drift out of sync the way a
+ *   copy-paste would risk.
+ * - rivalcfg `rivalcfg/devices/dpi/truemove_air.py` — same TrueMove Air
+ *   sensor table as the plain (non-wireless) Aerox 5 — imported from
+ *   `./rival3-wireless.ts`'s `TRUEMOVE_AIR_DPI_TO_BYTE`, not re-derived.
+ * - rivalcfg `rivalcfg/handlers/multidpi_range_choice.py` — `dpi_length_byte: 1`,
+ *   `first_preset: 0` (same as the plain Aerox 5 — **not** 1, unlike Aerox 3
+ *   and Rival 3 Wireless).
+ * - rivalcfg `rivalcfg/handlers/range.py` — `sleep_timer`/`dim_timer`: linear
+ *   range-to-range mapping, 3-byte little-endian output. Traced by hand:
+ *   `sleep_timer`'s `output_range` is `[0x000000, 0x124F80, 60000]` against
+ *   `input_range` `[0, 20, 1]` (minutes) — `0x124F80` is 1,200,000, i.e.
+ *   20 minutes × 60000 ms/min, so the output value is simply
+ *   `minutes * 60000` — and `dim_timer`'s `output_range` is the same
+ *   `[0x000000, 0x124F80, 1000]` against `input_range` `[0, 1200, 1]`
+ *   (seconds), i.e. `seconds * 1000`. Both encode little-endian, 3 bytes
+ *   (`range_length_byte: 3`), per `helpers.uint_to_little_endian_bytearray`.
+ * - rivalcfg `rivalcfg/handlers/rgbcolor.py` / `reactive_rgbcolor.py` — RGB
+ *   value encoding, same as `./aerox3.ts`/`./aerox5.ts`.
+ * - rivalcfg `rivalcfg/handlers/none.py` — `rainbow_effect` here is a
+ *   fixed-argument `[0x22, 0xFF]` command with `value_type: "none"` (just
+ *   enables the effect on all zones; disabled by writing a color instead),
+ *   unlike the plain Aerox 5's zone-bitmask `rainbow_effect`.
+ * - rivalcfg `rivalcfg/handlers/buttons/buttons.py` — 9 buttons + scroll
+ *   up/down, byte-identical layout to `./aerox5.ts`'s `AEROX5_BUTTONS` (same
+ *   ids and offsets, confirmed by direct comparison of the two device
+ *   files) — reused here as `AEROX5_WIRELESS_BUTTONS`, a structurally
+ *   identical constant, rather than re-derived from scratch, since the two
+ *   device files' `buttons_mapping` blocks are identical.
+ *
+ * ## Why wired-cable-mode and 2.4 GHz-dongle-mode share one module
+ *
+ * This is the common SteelSeries wireless pattern also seen in Rival 3
+ * Wireless's sibling `rival3_wireless_gen2.py` (not implemented here, out of
+ * scope): one physical mouse, multiple USB product ids depending on how the
+ * host currently sees it, all driven by the same command set modulo a fixed
+ * per-transport transform. Concretely: `aerox5_wireless_wireless.py`'s
+ * `_patch_command` ORs `0b01000000` (`0x40`) into `command[0]` of every
+ * setting, `battery_level`, and `save_command` inherited from
+ * `aerox5_wireless_wired.py`, and adds `readback_length: 64` (an expected
+ * reply length this module does not need to model — no function here reads
+ * or validates a readback payload; callers that care can check the response
+ * length themselves). Every command byte in `AEROX5_WIRELESS_COMMAND` below
+ * is the wired-mode value; `applyWirelessFlag` produces the 2.4 GHz-mode
+ * byte from it on demand, so there is exactly one place either byte can be
+ * gotten wrong.
+ *
+ * ## Why this is a separate protocol family from the plain Aerox 5
+ *
+ * Despite the shared "Aerox 5" name and several identical command bytes
+ * (`0x2D`/`0x2B`/`0x26`/`0x2A`/`0x27`), `aerox5_wireless_wired.py` is a
+ * genuinely different command layout from `./aerox5.ts`'s plain
+ * `aerox5.py`, confirmed by direct comparison rather than assumed from the
+ * shared name:
+ *
+ * - Polling command `0x2B` shares the byte but **not** the value mapping:
+ *   `{125:0x03, 250:0x02, 500:0x01, 1000:0x00}` here vs. the plain Aerox 5's
+ *   `{125:0x04, 250:0x03, 500:0x02, 1000:0x01}` — writing the plain Aerox 5's
+ *   byte to this device would select the wrong rate.
+ * - RGB zone commands are a different packing entirely:
+ *   `21 01 <zone-index 0/1/2> <r> <g> <b>` here (fixed 6-byte packet, no
+ *   bitmask, no zero-padding growth) vs. the plain Aerox 5's
+ *   `21 <bitmask> <padding> <r> <g> <b>` (`./aerox5.ts`'s
+ *   `steelseriesAerox5EncodeZoneColor`). Do not reuse that function here.
+ * - `rainbow_effect` is a fixed no-argument enable (`22 FF`) here vs. the
+ *   plain Aerox 5's zone-bitmask choice.
+ * - This device has `sleep_timer` (`0x29`) and `dim_timer` (`0x23 0F 01 00 00`)
+ *   settings the plain Aerox 5 profile does not define at all — note
+ *   `dim_timer`'s command also collides on its first byte (`0x23`) with the
+ *   plain Aerox 5's `led_brightness` command; they are unrelated settings on
+ *   unrelated devices, not the same control.
+ * - This device has a `battery_level` read (`0x92`, 2-byte reply) the plain
+ *   Aerox 5 profile has no equivalent of at all (write-only, no getters).
+ *
+ * PIDs are therefore registered under their own family (`"aerox5-wireless"`),
+ * never `"aerox5"`.
+ *
+ * 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. 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, default lighting, and buttons 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
+ *
+ * `aerox5_wireless_wired.py` defines a `battery_level` block: 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 (a coarse 0–100
+ * scale in steps of 5, `- 1` because the raw byte is 1-indexed). This module
+ * exposes `steelseriesAerox5WirelessBatteryQuery` /
+ * `steelseriesAerox5WirelessDecodeBattery` for both transports (2.4 GHz mode
+ * additionally needs `0x92 | 0x40 = 0xD2`, produced by
+ * `applyWirelessFlag`). This is a **different battery-response shape** from
+ * `./rival3-wireless.ts`'s `AA 01` / 3-byte-reply / plain-percentage-byte
+ * battery read — do not conflate the two devices' battery decoding.
+ */
+import { TRUEMOVE_AIR_DPI_TO_BYTE } from "./rival3-wireless.js";
+export const AEROX5_WIRELESS_REPORT_ID = 0x00;
+/** `_WIRELESS_FLAG = 0b01000000` in `aerox5_wireless_wireless.py`. */
+const WIRELESS_FLAG = 0b01000000;
+/** Wired-cable-mode command bytes; OR `WIRELESS_FLAG` into byte 0 for 2.4 GHz mode. */
+export const AEROX5_WIRELESS_COMMAND = {
+    dpiPresets: [0x2d],
+    pollingRate: [0x2b],
+    zoneColor: [0x21, 0x01],
+    reactiveColor: [0x26],
+    sleepTimer: [0x29],
+    dimTimer: [0x23, 0x0f, 0x01, 0x00, 0x00],
+    buttonsMapping: [0x2a],
+    rainbowEffect: [0x22, 0xff],
+    defaultLighting: [0x27],
+    batteryLevel: [0x92],
+};
+/** `11 00` wired-mode / `51 00` 2.4 GHz-mode — see `applyWirelessFlag`. */
+export const AEROX5_WIRELESS_SAVE_COMMAND = [0x11, 0x00];
+/**
+ * `_patch_command`: OR `0b01000000` into the command's first byte. Pass the
+ * wired-mode command bytes from `AEROX5_WIRELESS_COMMAND` /
+ * `AEROX5_WIRELESS_SAVE_COMMAND`; returns the 2.4 GHz-mode equivalent.
+ */
+export function applyWirelessFlag(command) {
+    if (command.length === 0) {
+        throw new Aerox5WirelessProtocolError("Cannot apply the wireless flag to an empty command.");
+    }
+    return [command[0] | WIRELESS_FLAG, ...command.slice(1)];
+}
+export const AEROX5_WIRELESS_POLLING_RATES = [125, 250, 500, 1000];
+/** Different byte values than the plain Aerox 5's `POLLING_RATE_TO_BYTE` — see module doc comment. */
+const POLLING_RATE_TO_BYTE = new Map([
+    [1000, 0x00],
+    [500, 0x01],
+    [250, 0x02],
+    [125, 0x03],
+]);
+export const AEROX5_WIRELESS_DPI_MIN = 100;
+export const AEROX5_WIRELESS_DPI_MAX = 18000;
+export const AEROX5_WIRELESS_DPI_STEP = 100;
+export const AEROX5_WIRELESS_MAX_DPI_PRESETS = 5;
+export const AEROX5_WIRELESS_BATTERY_RESPONSE_LENGTH = 2;
+const BATTERY_CHARGING_FLAG = 0b10000000;
+export class Aerox5WirelessProtocolError extends Error {
+}
+/** The 180 DPI values the shared TrueMove Air sensor table can express, ascending. */
+export function steelseriesAerox5WirelessDpiOptions() {
+    return [...TRUEMOVE_AIR_DPI_TO_BYTE.keys()].sort((a, b) => a - b);
+}
+/**
+ * `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`, same as the plain Aerox 5).
+ */
+export function steelseriesAerox5WirelessEncodeDpiPresets(presets, selectedIndex, wireless) {
+    if (presets.length < 1 || presets.length > AEROX5_WIRELESS_MAX_DPI_PRESETS) {
+        throw new Aerox5WirelessProtocolError(`SteelSeries Aerox 5 Wireless supports 1–${AEROX5_WIRELESS_MAX_DPI_PRESETS} DPI presets.`);
+    }
+    if (!Number.isInteger(selectedIndex) || selectedIndex < 0 || selectedIndex >= presets.length) {
+        throw new Aerox5WirelessProtocolError(`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 Aerox5WirelessProtocolError(`SteelSeries Aerox 5 Wireless DPI must be ${AEROX5_WIRELESS_DPI_MIN}–${AEROX5_WIRELESS_DPI_MAX.toLocaleString()} in ${AEROX5_WIRELESS_DPI_STEP} DPI steps.`);
+        }
+        return byte;
+    });
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.dpiPresets) : AEROX5_WIRELESS_COMMAND.dpiPresets;
+    return new Uint8Array([...command, presets.length, selectedIndex, ...encoded]);
+}
+/** `2B <v>` (`6B` wireless) with 1000→0x00, 500→0x01, 250→0x02, 125→0x03. */
+export function steelseriesAerox5WirelessEncodePollingRate(pollingRateHz, wireless) {
+    const byte = POLLING_RATE_TO_BYTE.get(pollingRateHz);
+    if (byte === undefined) {
+        throw new Aerox5WirelessProtocolError("SteelSeries Aerox 5 Wireless supports 125, 250, 500, or 1000 Hz polling.");
+    }
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.pollingRate) : AEROX5_WIRELESS_COMMAND.pollingRate;
+    return new Uint8Array([...command, byte]);
+}
+function encodeRgb(r, g, b) {
+    for (const channel of [r, g, b]) {
+        if (!Number.isInteger(channel) || channel < 0 || channel > 255) {
+            throw new Aerox5WirelessProtocolError("RGB channels must be integers 0–255.");
+        }
+    }
+    return [r, g, b];
+}
+const ZONE_INDEX = { 1: 0x00, 2: 0x01, 3: 0x02 };
+/**
+ * `21 01 <zone-index> <r> <g> <b>` (`61 01 …` wireless) — a fixed 6-byte
+ * packet, **not** the plain Aerox 5's bitmask-plus-padding shape. Zone 1 =
+ * top LED, zone 2 = middle LED, zone 3 = bottom LED (strip order, per the
+ * source's CLI flag labels).
+ */
+export function steelseriesAerox5WirelessEncodeZoneColor(zone, r, g, b, wireless) {
+    const zoneIndex = ZONE_INDEX[zone];
+    if (zoneIndex === undefined) {
+        throw new Aerox5WirelessProtocolError("SteelSeries Aerox 5 Wireless has zones 1 (top), 2 (middle), and 3 (bottom) only.");
+    }
+    const [red, green, blue] = encodeRgb(r, g, b);
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.zoneColor) : AEROX5_WIRELESS_COMMAND.zoneColor;
+    return new Uint8Array([...command, zoneIndex, red, green, blue]);
+}
+/**
+ * `26 00 00 00 00 00` when disabled, `26 01 00 <r> <g> <b>` when enabled
+ * (`66 …` wireless) — same shape as `./aerox3.ts`/`./aerox5.ts`.
+ */
+export function steelseriesAerox5WirelessEncodeReactiveColor(color, wireless) {
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.reactiveColor) : AEROX5_WIRELESS_COMMAND.reactiveColor;
+    if (color === null) {
+        return new Uint8Array([...command, 0x00, 0x00, 0x00, 0x00, 0x00]);
+    }
+    const [r, g, b] = encodeRgb(color.r, color.g, color.b);
+    return new Uint8Array([...command, 0x01, 0x00, r, g, b]);
+}
+function encodeRangeLE3(value, min, max, unit, msPerUnit) {
+    if (!Number.isInteger(value) || value < min || value > max) {
+        throw new Aerox5WirelessProtocolError(`SteelSeries Aerox 5 Wireless ${unit} must be an integer ${min}–${max}.`);
+    }
+    const ms = value * msPerUnit;
+    return [ms & 0xff, (ms >> 8) & 0xff, (ms >> 16) & 0xff];
+}
+/**
+ * `29 <ms LE24>` (`69 …` wireless) — idle minutes before sleep, `0` disables.
+ * Encoded as `minutes * 60000` milliseconds, little-endian 3 bytes (see
+ * module doc comment for the range-handler derivation).
+ */
+export function steelseriesAerox5WirelessEncodeSleepTimer(minutes, wireless) {
+    const bytes = encodeRangeLE3(minutes, 0, 20, "sleep timer minutes", 60_000);
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.sleepTimer) : AEROX5_WIRELESS_COMMAND.sleepTimer;
+    return new Uint8Array([...command, ...bytes]);
+}
+/**
+ * `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 function steelseriesAerox5WirelessEncodeDimTimer(seconds, wireless) {
+    const bytes = encodeRangeLE3(seconds, 0, 1200, "dim timer seconds", 1_000);
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.dimTimer) : AEROX5_WIRELESS_COMMAND.dimTimer;
+    return new Uint8Array([...command, ...bytes]);
+}
+/** `22 FF` (`62 FF` wireless) — enables the rainbow effect on all zones; a color write clears it. */
+export function steelseriesAerox5WirelessEncodeRainbowEffect(wireless) {
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.rainbowEffect) : AEROX5_WIRELESS_COMMAND.rainbowEffect;
+    return new Uint8Array(command);
+}
+/** Byte-identical to the plain Aerox 5's `AEROX5_DEFAULT_LIGHTING` table. */
+export const AEROX5_WIRELESS_DEFAULT_LIGHTING = {
+    off: [0x00, 0x00],
+    reactive: [0x00, 0x01],
+    rainbow: [0x01, 0x00],
+    "reactive-rainbow": [0x01, 0x01],
+};
+/** `27 <v1> <v2>` (`67 …` wireless) — what the mouse lights up as before a host ever connects. */
+export function steelseriesAerox5WirelessEncodeDefaultLighting(mode, wireless) {
+    const bytes = AEROX5_WIRELESS_DEFAULT_LIGHTING[mode];
+    if (bytes === undefined) {
+        throw new Aerox5WirelessProtocolError(`SteelSeries Aerox 5 Wireless default lighting must be one of: ${Object.keys(AEROX5_WIRELESS_DEFAULT_LIGHTING).join(", ")}.`);
+    }
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.defaultLighting) : AEROX5_WIRELESS_COMMAND.defaultLighting;
+    return new Uint8Array([...command, ...bytes]);
+}
+/** `11 00` wired-mode / `51 00` 2.4 GHz-mode — commit the current settings to onboard flash. */
+export function steelseriesAerox5WirelessSaveCommand(wireless) {
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_SAVE_COMMAND) : AEROX5_WIRELESS_SAVE_COMMAND;
+    return new Uint8Array(command);
+}
+/** `92` wired-mode / `D2` 2.4 GHz-mode — the device answers with a two-byte input report. */
+export function steelseriesAerox5WirelessBatteryQuery(wireless) {
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.batteryLevel) : AEROX5_WIRELESS_COMMAND.batteryLevel;
+    return new Uint8Array(command);
+}
+/**
+ * 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 function steelseriesAerox5WirelessDecodeBattery(payload) {
+    if (payload.length < AEROX5_WIRELESS_BATTERY_RESPONSE_LENGTH) {
+        throw new Aerox5WirelessProtocolError("SteelSeries Aerox 5 Wireless battery response is shorter than two bytes.");
+    }
+    const statusByte = payload[1];
+    const isCharging = (statusByte & BATTERY_CHARGING_FLAG) !== 0;
+    const level = ((statusByte & ~BATTERY_CHARGING_FLAG) - 1) * 5;
+    return { level, isCharging };
+}
+/**
+ * `buttons_mapping.buttons` from `aerox5_wireless_wired.py` — byte-identical
+ * ids/offsets to `./aerox5.ts`'s `AEROX5_BUTTONS`, confirmed by direct
+ * comparison of the two device files, defined separately here rather than
+ * imported so each family's button table stays self-contained.
+ */
+export const AEROX5_WIRELESS_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_WIRELESS_BUTTON_FIELD_LENGTH = 5;
+const AEROX5_WIRELESS_BUTTON_DISABLE = 0x00;
+const AEROX5_WIRELESS_BUTTON_DPI_SWITCH = 0x30;
+const AEROX5_WIRELESS_BUTTON_KEYBOARD = 0x51;
+const AEROX5_WIRELESS_BUTTON_MULTIMEDIA = 0x61;
+/**
+ * `2A` (`6A` wireless) + 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 steelseriesAerox5WirelessEncodeButtonsMapping(mapping, wireless) {
+    const names = Object.keys(AEROX5_WIRELESS_BUTTONS);
+    const packet = new Array(names.length * AEROX5_WIRELESS_BUTTON_FIELD_LENGTH).fill(0x00);
+    for (const [name, action] of Object.entries(mapping)) {
+        const slot = AEROX5_WIRELESS_BUTTONS[name];
+        if (!slot) {
+            throw new Aerox5WirelessProtocolError(`Unknown SteelSeries Aerox 5 Wireless button "${name}".`);
+        }
+        const { offset } = slot;
+        switch (action.type) {
+            case "button": {
+                packet[offset] = AEROX5_WIRELESS_BUTTONS[action.target].id;
+                break;
+            }
+            case "disabled": {
+                packet[offset] = AEROX5_WIRELESS_BUTTON_DISABLE;
+                break;
+            }
+            case "dpiSwitch": {
+                packet[offset] = AEROX5_WIRELESS_BUTTON_DPI_SWITCH;
+                break;
+            }
+            case "keyboard": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new Aerox5WirelessProtocolError("Keyboard scan codes must be integers 0–255.");
+                }
+                packet[offset] = AEROX5_WIRELESS_BUTTON_KEYBOARD;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            case "multimedia": {
+                if (!Number.isInteger(action.code) || action.code < 0 || action.code > 255) {
+                    throw new Aerox5WirelessProtocolError("Multimedia key codes must be integers 0–255.");
+                }
+                packet[offset] = AEROX5_WIRELESS_BUTTON_MULTIMEDIA;
+                packet[offset + 1] = action.code;
+                break;
+            }
+            default: {
+                throw new Aerox5WirelessProtocolError("Unsupported SteelSeries Aerox 5 Wireless button action.");
+            }
+        }
+    }
+    const command = wireless ? applyWirelessFlag(AEROX5_WIRELESS_COMMAND.buttonsMapping) : AEROX5_WIRELESS_COMMAND.buttonsMapping;
+    return new Uint8Array([...command, ...packet]);
+}
+//# sourceMappingURL=aerox5-wireless.js.map

package/dist/steelseries/aerox5-wireless.js.map

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

package/dist/steelseries/aerox5.d.ts

@@ -0,0 +1,228 @@
+/**
+ * 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.
+ */
+export declare const AEROX5_REPORT_ID = 0;
+/** One-byte command prefixes; the payload is the prefix plus its arguments. */
+export declare const AEROX5_COMMAND: {
+    readonly dpiPresets: readonly [45];
+    readonly pollingRate: readonly [43];
+    readonly reactiveColor: readonly [38];
+    readonly ledBrightness: readonly [35];
+    readonly rainbowEffect: readonly [34];
+    readonly buttonsMapping: readonly [42];
+    readonly defaultLighting: readonly [39];
+    readonly zoneColor: readonly [33];
+};
+/** `11 00` — same byte-pair as Aerox 3's save command. */
+export declare const AEROX5_SAVE_COMMAND: readonly [17, 0];
+export declare const AEROX5_POLLING_RATES: readonly [125, 250, 500, 1000];
+export declare const AEROX5_DPI_MIN = 100;
+export declare const AEROX5_DPI_MAX = 18000;
+export declare const AEROX5_DPI_STEP = 100;
+export declare const AEROX5_MAX_DPI_PRESETS = 5;
+export declare class Aerox5ProtocolError extends Error {
+}
+/** The 180 DPI values the shared TrueMove Air sensor table can express, ascending. */
+export declare function steelseriesAerox5DpiOptions(): number[];
+/**
+ * `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 declare function steelseriesAerox5EncodeDpiPresets(presets: readonly number[], selectedIndex: number): Uint8Array;
+/** `2B <v>` with 1000→0x01, 500→0x02, 250→0x03, 125→0x04 — same mapping as Aerox 3. */
+export declare function steelseriesAerox5EncodePollingRate(pollingRateHz: number): Uint8Array;
+export type Aerox5Zone = 1 | 2 | 3;
+/**
+ * `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 declare function steelseriesAerox5EncodeZoneColor(zone: Aerox5Zone, r: number, g: number, b: number): Uint8Array;
+/**
+ * `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 declare function steelseriesAerox5EncodeReactiveColor(color: {
+    r: number;
+    g: number;
+    b: number;
+} | null): Uint8Array;
+/** `23 <v>` — linear 0–100 passthrough. */
+export declare function steelseriesAerox5EncodeLedBrightness(percent: number): Uint8Array;
+/** Byte-identical to `AEROX3_RAINBOW_ZONES`, confirmed by direct comparison of the two device files. */
+export declare const AEROX5_RAINBOW_ZONES: {
+    readonly all: 7;
+    readonly bottom: 4;
+    readonly middle: 2;
+    readonly top: 1;
+    readonly "bottom-middle": 6;
+    readonly "middle-top": 3;
+    readonly "bottom-top": 5;
+};
+export type Aerox5RainbowZones = keyof typeof AEROX5_RAINBOW_ZONES;
+/** `22 <bitmask>` — rainbow effect on the selected zone(s); cleared by setting a color. */
+export declare function steelseriesAerox5EncodeRainbowEffect(zones: Aerox5RainbowZones): Uint8Array;
+/** Byte-identical to `AEROX3_DEFAULT_LIGHTING`, confirmed by direct comparison of the two device files. */
+export declare const AEROX5_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 Aerox5DefaultLighting = keyof typeof AEROX5_DEFAULT_LIGHTING;
+/** `27 <v1> <v2>` — what the mouse lights up as before a host ever connects. */
+export declare function steelseriesAerox5EncodeDefaultLighting(mode: Aerox5DefaultLighting): Uint8Array;
+/** `11 00` — commit the current settings to onboard flash. */
+export declare function steelseriesAerox5SaveCommand(): Uint8Array;
+/**
+ * `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 declare const AEROX5_BUTTONS: {
+    readonly button1: {
+        readonly id: 1;
+        readonly offset: 0;
+    };
+    readonly button2: {
+        readonly id: 2;
+        readonly offset: 5;
+    };
+    readonly button3: {
+        readonly id: 3;
+        readonly offset: 10;
+    };
+    readonly button4: {
+        readonly id: 4;
+        readonly offset: 15;
+    };
+    readonly button5: {
+        readonly id: 5;
+        readonly offset: 20;
+    };
+    readonly button6: {
+        readonly id: 6;
+        readonly offset: 25;
+    };
+    readonly button7: {
+        readonly id: 7;
+        readonly offset: 30;
+    };
+    readonly button8: {
+        readonly id: 8;
+        readonly offset: 35;
+    };
+    readonly button9: {
+        readonly id: 9;
+        readonly offset: 40;
+    };
+    readonly scrollUp: {
+        readonly id: 49;
+        readonly offset: 45;
+    };
+    readonly scrollDown: {
+        readonly id: 50;
+        readonly offset: 50;
+    };
+};
+export type Aerox5ButtonName = keyof typeof AEROX5_BUTTONS;
+/**
+ * One button's target. `scrollUp`/`scrollDown` cannot be remap *targets*
+ * (`button_scroll_up`/`button_scroll_down` are `None` in `aerox5.py`) — only
+ * sources; attempting to target them is rejected, same rule as Aerox 3.
+ */
+export type Aerox5ButtonAction = {
+    type: "button";
+    target: Exclude<Aerox5ButtonName, "scrollUp" | "scrollDown">;
+} | {
+    type: "disabled";
+} | {
+    type: "dpiSwitch";
+} | {
+    type: "keyboard";
+    code: number;
+} | {
+    type: "multimedia";
+    code: number;
+};
+/**
+ * `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 declare function steelseriesAerox5EncodeButtonsMapping(mapping: Partial<Record<Aerox5ButtonName, Aerox5ButtonAction>>): Uint8Array;
+//# sourceMappingURL=aerox5.d.ts.map

package/dist/steelseries/aerox5.d.ts.map

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