SmartShift
Switch a mouse wheel between free-spin and ratchet, and set its automatic release and resistance where supported.
Use SmartShift in the Pointer tab to control a mouse wheel's free-spin and ratchet modes. OpenLogi uses HID++ 0x2111 smartShiftEnhanced, and also supports the older 0x2110 smartShiftWheel.
From the GUI
Select a mouse, then open Pointer. SmartShift controls appear when the device reports the feature:

- Wheel mode switches between Free spin and Ratchet.
- Sensitivity sets the ratchet release threshold. The GUI range is
8–50; the default is16. Higher values keep ratchet engaged longer. The slider is available only in ratchet mode without permanent ratchet. - Scrolling force sets tunable ratchet torque from
1%to100%of the wheel's maximum force. It appears only when0x2111advertisesTUNABLE_TORQUE. It is disabled in free-spin mode. - Permanent ratchet keeps the wheel ratcheted at every speed. It is available only in ratchet mode.
- Thumb Wheel Sensitivity is a per-device override. See Scrolling.
OpenLogi reads the current state when the panel opens. An offline device shows that SmartShift is unavailable. A pending read shows Reading SmartShift settings…. A failed read provides Couldn't read SmartShift settings. Click to retry.
Write confirmation
Since v0.8.14, OpenLogi confirms each SmartShift write with a device read. It marks the write confirmed only when the returned mode, auto_disengage, and tunable_torque match the requested state. A different reply or a failed read marks the write as failed.
In the config
OpenLogi stores SmartShift under the physical device key:
schema_version = 9
[devices."unit:6be9d300".smartshift]
mode = "ratchet"
auto_disengage = 16 # 8–254; 255 keeps permanent ratchet
tunable_torque = 50 # 1–100 percent; omit on unsupported devicesThe GUI exposes 8–50 for auto_disengage. The saved configuration accepts 8–254; 255 means permanent ratchet. The device keeps these settings in volatile memory, so the agent re-applies the saved state after reconnecting.
Command and API
Use the diagnostic command to set Scrolling force on a mouse that supports tunable torque:
openlogi diag smartshift --torque 60--torque accepts 1–100 percent. The openlogi api smartshift result includes tunable_torque as a 1–100 percentage, or null when the device has no tunable torque. The same result includes auto_disengage as an integer.
Status: macOS, Linux, and Windows. SmartShift uses 0x2111 smartShiftEnhanced or 0x2110 smartShiftWheel. Scrolling force requires 0x2111 with TUNABLE_TORQUE.