The famous Logitech Trackman MarbleFX trackball has four buttons, of which the 4th (red) button was used to emulate a scroll wheel. To enable this, the trackball needs to be switched into a special Logitech PS/2 protocol, which enables the reporting of the additional button. This works well on Linux, but only if the trackball is connected via a native PS/2 port.
If a simple PS/2 <-> USB converter is used, the trackball operates in "legacy" 3-button Mouse mode, because those converters do not know how to switch and interpret the logitech protocol.
This project uses an Arduino Leonardo (or compatible boards, like the CMCU Beetle) to interface the TrackmanFX's PS/2 port to USB HID.
The smallest boards can be integrated directly into the trackball, so that the TrackmanFX appears as a "native" USB device.
One example of such a modification is here.
The code now (2026) does "high resolutin scrolling", which means that the scrolling is more fine grained than the default "120" units of a standard mouse scroll wheel. This has been tested on Windows 10, Windows 11 and Linux (kernel 6.4.0 and later) and worked for me "out of the box". In Windows, however, the USB HID descriptor for a device is apparently cached at installation time and no longer evaluated afterwards, so if you had an older version of this code running, you need to "uninstall" the mouse in device manager and then replug it to get it reinstalled.
The code now also supports horizontal scrolling. It does not do vertical scrolling (both horizontal and vertical at the same time) because lots of host software is confused by that.
The default mode of operation emulates the scroll wheel inside the microcontroller and needs no additional software setup. If you want the full experience of two-dimensional scrolling with the trackball when pressing the red button, you can pull pin 6 to ground and then configure button 8 for scrolling with xinput on X11, for example, just like with the native PS/2 connection.
The built in mouse jiggler can be disabled by pulling pin 7 to ground.
To swap mouse buttons from left to right (only useful on T-BC21 model...), pull pin 8 to ground.