Since 3Dconnexion does not have any open-source tool to change firmware settings for their CadMouse device, I have reverse engineered its configuration protocol by looking at USB captures from a Windows VM running its settings tool.
This needs HIDApi.
cc cadmousectl.c -o cadmousectl $(pkg-config --cflags --libs hidapi-hidraw)
Windows builds are availabe on the GitHub Releases page.
cc cadmousectl.c -o cadmousectl $(pkg-config --cflags --libs hidapi)
This tool needs write access to the USB device. The mouse loses its settings
each time it is disconnected. Therefore, you will probably want to set up
cadmousectl to run automatically. Each rules file needs to be modified
as necessary (the path to cadmousectl and the parameters).
Copy the rules/linux/99-cadmouse.rules file into /etc/udev/rules.d
and reload udevd.
Copy the rules/freebsd/cadmouse.conf file into /usr/local/etc/devd
and reload devd.
cadmousectl [-[lprsS] value]
| Option | Effect |
|---|---|
| -l | Enable (non-zero) or disable (zero) lift-off detection. |
| -p | Set polling rate (125, 250, 500, 1000). |
| -r | Remap buttons. Format is real_button:assigned_button.
Note The extra button was discovered by accident. Using this, you can assign an additional button to the wheel click. It will have id 11 on X11. |
| -s | Set speed (1-164). Cannot be used with -d |
| -d | Set speed in DPI (50-8200). Cannot be used with -s |
| -S | Set Smart Scroll mode. There are two additional modes which the Windows GUI does not expose.
Accelerated scrolling mode is different from the other modes in that it does not simulate a flywheel but instead sends more scroll wheel clicks the faster you scroll. |
This software is available under the terms of the ISC license as it appears in each source file.