docs: document PRO X 2 Superstrike features, device entry, and capabilities
This commit is contained in:
Caio Quirino
parent
b00891bb48
commit
f3423b24c4
|
|
@ -188,6 +188,42 @@ Solaar uses the standard US keyboard layout. This currently only matters for th
|
|||
This is an experimental feature and may be modified or even eliminated.
|
||||
|
||||
|
||||
### HITS Tuning (Hall-Effect Inductive Trigger Switch)
|
||||
|
||||
Some gaming mice (such as the PRO X 2 Superstrike) feature hall-effect magnetic switches on their primary buttons instead of traditional mechanical switches. These switches expose tunable parameters via the `SUPERSTRIKE_TUNING` HID++ feature (`0x1B0C`).
|
||||
|
||||
Solaar supports three per-button settings for each primary button (left = 0, right = 1):
|
||||
|
||||
- **Actuation Point** (`superstrike-tuning_actuation-{0,1}`): How deep the button must be pressed to register a click. Range 1–10, where 1 is the shallowest (hair trigger) and 10 is the deepest (full press). Default is 5.
|
||||
- **Rapid Trigger Level** (`superstrike-tuning_rapid-trigger-level-{0,1}`): Sensitivity of rapid re-actuation after partial release. Range 1–5, where 1 is the most sensitive and 5 is the least. This cannot be fully disabled.
|
||||
- **Click Haptics** (`superstrike-tuning_haptics-{0,1}`): Intensity of haptic feedback on click. Range 0–5, where 0 disables haptics and 5 is maximum intensity.
|
||||
|
||||
These settings are written directly to the device and persist across reconnections regardless of the onboard profile state.
|
||||
|
||||
### Extended DPI
|
||||
|
||||
Some gaming mice (such as the PRO X 2 Superstrike) support the `EXTENDED_ADJUSTABLE_DPI` feature (`0x2202`) which allows independent X and Y axis DPI configuration as well as lift-off distance (LOD) control. This is exposed via the `dpi_extended` setting:
|
||||
|
||||
```bash
|
||||
solaar config <device> dpi_extended "{X:1600, Y:1600, LOD:HIGH}"
|
||||
```
|
||||
|
||||
LOD values are `LOW` and `HIGH`. DPI range depends on the device sensor (up to 32000 DPI on the PRO X 2 Superstrike).
|
||||
|
||||
### Extended Report Rate
|
||||
|
||||
Some gaming mice (such as the PRO X 2 Superstrike) support the `EXTENDED_ADJUSTABLE_REPORT_RATE` feature (`0x8061`) which enables sub-millisecond polling rates beyond the standard 1 ms (1000 Hz). This is exposed via the `report_rate_extended` setting:
|
||||
|
||||
| Value | Polling Rate |
|
||||
|---------|-------------|
|
||||
| `8ms` | 125 Hz |
|
||||
| `4ms` | 250 Hz |
|
||||
| `2ms` | 500 Hz |
|
||||
| `1ms` | 1000 Hz |
|
||||
| `500us` | 2000 Hz |
|
||||
| `250us` | 4000 Hz |
|
||||
| `125us` | 8000 Hz |
|
||||
|
||||
### Onboard Profiles
|
||||
|
||||
Some mice store one or more profiles onboard. An onboard profile controls certain aspects of the behavior of the mouse, including the rate at which the mouse reports movement, the resolution of the the movement reports, what the mouse buttons do, LED effects, and maybe more. Solaar has a setting that switches between profiles or disables all profiles.
|
||||
|
|
|
|||
|
|
@ -211,6 +211,7 @@ so what is important for support is the USB WPID or Bluetooth model ID.
|
|||
|------------------------------|------|-------|
|
||||
| G604 Wireless Gaming Mouse | 4085 | 4.2 |
|
||||
| PRO X Superlight Wireless | 4093 | 4.2 |
|
||||
| PRO X 2 Superstrike | 40BD | 4.2 |
|
||||
|
||||
### Trackballs (Unifying)
|
||||
|
||||
|
|
|
|||
|
|
@ -33,6 +33,7 @@ Feature | ID | Status | Notes
|
|||
`UNIFIED_BATTERY` | `0x1004` | Supported | `get_battery`, read only
|
||||
`CHARGING_CONTROL` | `0x1010` | Unsupported |
|
||||
`LED_CONTROL` | `0x1300` | Unsupported |
|
||||
`FORCE_PAIRING` | `0x1500` | Unsupported |
|
||||
`GENERIC_TEST` | `0x1800` | Unsupported |
|
||||
`DEVICE_RESET` | `0x1802` | Unsupported |
|
||||
`OOBSTATE` | `0x1805` | Unsupported |
|
||||
|
|
@ -49,6 +50,7 @@ Feature | ID | Status | Notes
|
|||
`REPROG_CONTROLS_V2_2` | `0x1B02` | Unsupported |
|
||||
`REPROG_CONTROLS_V3` | `0x1B03` | Unsupported |
|
||||
`REPROG_CONTROLS_V4` | `0x1B04` | Partial Support | `ReprogrammableKeys`, `DivertKeys`, `MouseGesture`, `get_keys`
|
||||
`SUPERSTRIKE_TUNING` | `0x1B0C` | Supported | `SuperstrikeTuning` (actuation point, rapid trigger, click haptics)
|
||||
`REPORT_HID_USAGE` | `0x1BC0` | Unsupported |
|
||||
`PERSISTENT_REMAPPABLE_ACTION` | `0x1C00` | Supported | `PersistentRemappableAction`
|
||||
`WIRELESS_DEVICE_STATUS` | `0x1D4B` | Read only | status reporting from device
|
||||
|
|
@ -67,9 +69,12 @@ Feature | ID | Status | Notes
|
|||
`THUMB_WHEEL` | `0x2150` | Supported | `ThumbMode`, `ThumbInvert`
|
||||
`MOUSE_POINTER` | `0x2200` | Supported | `get_mouse_pointer_info`, read only
|
||||
`ADJUSTABLE_DPI` | `0x2201` | Supported | `AdjustableDpi`, `DpiSliding`
|
||||
`EXTENDED_ADJUSTABLE_DPI` | `0x2202` | Supported | `ExtendedAdjustableDpi` (X/Y DPI + lift-off distance)
|
||||
`POINTER_SPEED` | `0x2205` | Supported | `PointerSpeed`, `SpeedChange`, `get_pointer_speed_info`
|
||||
`ANGLE_SNAPPING` | `0x2230` | Unsupported |
|
||||
`SURFACE_TUNING` | `0x2240` | Unsupported |
|
||||
`XY_STATS` | `0x2250` | Unsupported |
|
||||
`WHEEL_STATS` | `0x2251` | Unsupported |
|
||||
`HYBRID_TRACKING` | `0x2400` | Unsupported |
|
||||
`FN_INVERSION` | `0x40A0` | Supported | `FnSwap`
|
||||
`NEW_FN_INVERSION` | `0x40A2` | Supported | `NewFnSwap`, `get_new_fn_inversion
|
||||
|
|
@ -101,6 +106,7 @@ Feature | ID | Status | Notes
|
|||
`MR` | `0x8030` | Supported | `MRKeyLED`
|
||||
`BRIGHTNESS_CONTROL` | `0x8040` | Supported | `BrightnessControl`
|
||||
`REPORT_RATE` | `0x8060` | Supported | `ReportRate`
|
||||
`EXTENDED_ADJUSTABLE_REPORT_RATE` | `0x8061` | Supported | `report_rate_extended` (sub-millisecond polling up to 8000 Hz)
|
||||
`COLOR_LED_EFFECTS` | `0x8070` | Supported | `LEDControl`, `LEDZoneSetting`
|
||||
`RGB_EFFECTS` | `0X8071` | Supported | `RGBControl`, `RGBEffectSetting`
|
||||
`PER_KEY_LIGHTING` | `0x8080` | Unsupported |
|
||||
|
|
|
|||
Loading…
Reference in New Issue