OpenLogi

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:

MX Master 4 Pointer tab with DPI and SmartShift cards

SmartShift sits beside DPI on the Pointer tab.
  • Wheel mode switches between Free spin and Ratchet.
  • Sensitivity sets the ratchet release threshold. The GUI range is 8–50; the default is 16. 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% to 100% of the wheel's maximum force. It appears only when 0x2111 advertises TUNABLE_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 devices

The 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.

On this page