[KB-009] How do I get the spinner and trackball to work with Batocera?

Product: Tankstick MAX | Platform: Batocera/RetroArch | Confidence: High

Answer:

The spinner and trackball work with Batocera but do not auto-configure by default. You need to perform a quick setup:

In Batocera's Game Options menu, the setting to enable the trackball may be labeled as 'Optical Device'; enabling this setting also activates the spinner functionality.

Map the spinner and trackball axes under Controller Mapping

Assign the correct mouse index for the spinner and trackball in RetroArch

Note: The upper side buttons on the Tankstick MAX are mapped as mouse clicks for the trackball. This is by design and cannot be reassigned as separate hotkeys.

═══ Revision Layer (v1.5 | 2026-01-12) ═══

Additional Trackball Setup for RetroPie/MAME (appended, not replacing original):

RetroPie/RetroArch Setup: Navigate to Settings > Input > RetroPad Binds > Port 1 Controls and set the mouse index to HID 1241:1111 (used by the tankstick's trackball + spinners). Save configuration on exit.

On Raspberry Pi 4 RetroPie setups, connect the trackball/spinner USB or mixer output before booting the Pi; support has recommended the top-left USB port because it is often recognized first for mouse input. If the exact RetroArch menu labels differ from the written guide, look for the equivalent Port 1 mouse index setting and select the device shown as HID 1241:1111. If no display name appears, try mouse index 0, 1, or 2, save the configuration on exit, and retest in game. One confirmed case reported that the spinners started working after finding the equivalent setting and saving the change. Another mixer case was fixed by resetting RetroArch settings to default, reprogramming the Tankstick controls, and then setting Port 1 Mouse Index back to HID 1241:1111.

For the X-Arcade Spinner/Trackball Mixer Adapter V1.03 firmware update, if the updater reports that ch375dll.dll is missing, place the missing DLL in the firmware software folder and make sure the filename is exactly CH375DLL.DLL. One confirmed case still failed until the DLL filename matched exactly, then the customer reported that spinner and trackball games worked without issues. Another confirmed V1.03 update case restored mixer trackball sensitivity to a much better/normal feel after support provided the current firmware upgrade link.

A confirmed Raspberry Pi RetroPie test reported that the mixer adapter allowed NES Zapper games to use the trackball and Atari games to use the spinner. Some arcade games may still need the existing script/button switching path; one tester still needed it for Arkanoid.

In-Game Configuration: If trackball still doesn't work, press TAB in the game to open the MAME menu and configure input for the trackball option.

The Tankstick Max spinner is recommended for arcade titles such as Tempest and Arkanoid, while the trackball is ideal for games like Marble Madness. For arcade titles such as Tempest, spinners are not automatically detected by default and must be manually configured as optical devices within the in-game input settings to function correctly.

AdvanceMAME Alternative: For Golden Tee and similar games, AdvanceMAME may provide better trackball support. Install via RetroPie Setup, verify trackball is recognized as /dev/input/mouseX, then access TAB menu to map Track X/Y analog to ball axes.

OpenEmu is reported to be inconsistent and potentially unreliable for MAME/arcade support on Apple Silicon (M1/M-series) Macs. RetroArch is the recommended emulator frontend for Apple Silicon (M1/M-series) Macs as it is actively maintained and offers better stability for arcade emulation compared to OpenEmu. Users may improve functionality by granting 'Input Monitoring' permissions in macOS Security settings or using an experimental OpenEmu build. In OpenEmu, the MAME core (labeled as 'Arcade') is not installed automatically; users must navigate to Preferences > Cores to manually install the Arcade core before ROM files can be added to the system.

MAME ROM Compatibility: MAME ROMs must be matched to their specific emulator core version (e.g., a MAME2003-Plus ROM must be launched using the MAME2003-Plus core) to ensure the game launches and functions correctly. ROM/core version mismatches are a common reason for games failing to launch in systems like Batocera or RetroArch. Note: On the Tankstick MAX, the trackball and spinner share the same mouse interface and are recognized by the host system as a single composite mouse device. The Tankstick MAX utilizes separate cables for joystick input and mouse input. When using the Tankstick Max trackball on a PS5, the trackball USB should be plugged directly into the console's USB port rather than through a Wingman adapter, as it functions as a separate USB mouse device. The X-Arcade trackball and spinner are recognized as composite mouse devices on consoles such as the PlayStation 5 and PlayStation 2; consequently, functionality is strictly dependent on whether the specific game being played natively supports mouse input. The standalone 3" USB trackball assembly does not include CLR, MODE, or TURBO functions, as these are not part of the trackball hardware; it is designed to function strictly as a standard USB mouse input device. The trackball and spinner mixer kit is not compatible with the original Xbox console because it functions as a USB composite HID device, which the legacy Xbox USB drivers do not support. Current X-Arcade Tankstick Max units include built-in mixer functionality, eliminating the need for customers to purchase separate booster kit or mixer adapters. To verify if the spinner booster is installed on a Tankstick Max, plug the unit into a PC; if it appears as a single mouse device, the booster is already installed by default. While the spinner booster/mixer kit consolidates the trackball and spinners into a single USB output, it does not change the device's hardware profile; it continues to be recognized as a mouse device and does not function as a gamepad or PlayStation-style controller. The Tankstick MAX includes pre-installed spinners and a trackball but does not include the VR hardware modes, integrated lighting controls and effects for both the control panel and the marquee, or the dedicated turbo and mode controls found in the Arcade2TV-XR (Tankstick VR) model. Additionally, the Arcade2TV-XR features a more flexible interface for custom button remapping and additional switchable operating modes compared to the Tankstick Max. For Arcade2TV-XR, green flashing mode (X-Input mode) is recommended for standard arcade use with RetroArch to ensure the controller is recognized as two standard Xbox controllers without overlapping mappings, avoiding the input conflicts found in Pinball mode. In Purple Mode (dedicated Pinball mode), several buttons intentionally overlap, which can cause duplicate inputs in non-pinball software such as RetroArch. When the Arcade2TV-XR is in Purple (Pinball) mode, Batocera will detect two joysticks, but only one is active while the other is non-functional and should be ignored; this configuration still allows flipper buttons to be mapped as a single controller. For Batocera, green flashing mode allows the system to automatically detect the left controller as Player 1. When the Tankstick is in X-Input mode, configuring the controls in the Batocera system for Player 1 typically causes Player 2 mappings to carry over automatically or require only minimal adjustment. To verify if X-Input is working correctly at the Windows level, users can press 'Windows key + R', type 'joy.cpl', press Enter, select the X-Arcade controller, and then click 'Properties' to view and test button and joystick inputs. When the X-Arcade is in X-Input mode, it presents to the operating system as a standard gamepad with fixed button and axis assignments; any desired remapping must be performed within the specific game or application's internal settings. Note: DirectInput remapping on the Arcade2TV-XR is currently limited and cannot be performed across the two separate player devices. Evidence: Support thread 2025-06, keywords: trackball, RetroArch, mouse index, Golden Tee, AdvanceMAME, PS3, PS5, composite mouse, MAME ROM compatibility, joy.cpl, X-Input, Purple Mode