Manage Logitech Receivers on Linux with Solaar

Solaar serves as an open-source device manager that allows the Linux operating system to interact with, monitor, and configure Logitech wireless hardware. Because Logitech does not provide an official version of its Logi Options+ software for Linux, Solaar bridges this gap by communicating directly with Logitech Unifying and Bolt receivers. This article details how the Linux system architecture utilizes Solaar to pair devices, monitor battery levels, and adjust hardware-level peripheral settings through both graphical and command-line interfaces.

Kernel Integration and User-Space Permissions

Linux manages input hardware at the kernel level using drivers like hid-logitech-dj and generic HID interfaces such as hidraw. When a Logitech Unifying Receiver is plugged into a USB port, the Linux kernel creates corresponding device nodes (such as /dev/hidraw*) to handle data transmission.

To allow Solaar to interact with these devices without requiring administrative (root) privileges, Linux relies on udev rules. Solaar packages provide custom udev configurations, typically placed in /etc/udev/rules.d/ or /usr/lib/udev/rules.d/. These rules identify the vendor ID for Logitech devices and grant read/write access to the active desktop user via access control lists (ACLs) or specific user groups like plugdev.

Communication via the HID++ Protocol

Logitech Unifying Receivers and compatible peripherals communicate using Logitech's proprietary HID++ protocol (versions 1.0, 2.0, and 4.5+). Solaar functions as an interpreter between Linux user-space applications and this protocol.

Through HID++ commands sent over the raw HID interface, Solaar can:

• Query the receiver to identify connected devices.
• Read unique device identifiers, firmware versions, and supported feature sets.
• Request battery voltage and operational status updates from active peripherals.

Device Pairing and Unpairing

A core utility of the Logitech Unifying Receiver is its ability to connect up to six compatible devices simultaneously to a single USB dongle. Solaar gives Linux systems full access to this functionality:

• Pairing: Solaar puts the receiver into a pairing state. When an unassigned Logitech mouse or keyboard is powered off and back on within range, the receiver negotiates the connection and writes the pairing directly to the receiver's internal memory.
• Unpairing: Solaar sends a direct instruction to the receiver to forget a specific slot or hardware ID, freeing up space for another peripheral.

Because pairing data is stored on the receiver itself, any configurations made via Solaar persist even if the receiver is moved to another computer or boot environment.

Peripheral Configuration and Feature Control

Beyond basic input handling, Solaar allows Linux users to toggle hardware features that are otherwise locked to defaults on non-Windows platforms. These adjustments include:

• SmartShift and Scroll Wheel Tuning: Adjusting the sensitivity threshold where the mouse wheel switches between ratchet and free-spin modes.
• DPI Sensitivity: Configuring precise sensor sensitivity stages on supported mice.
• Function Key Inversion: Toggling whether the top row of a keyboard acts as standard function keys (F1–F12) or media control keys by default.
• Gestures and Key Remapping: Rebinding mouse buttons and divert keys to custom actions or system shortcuts.

Desktop and Command-Line Integration

Solaar integrates into the Linux desktop environment via a background daemon and system tray indicator. The tray applet uses system notification specifications (such as libnotify) to alert users when a peripheral's battery drops below a critical threshold.

For headless servers or lightweight window managers (such as i3 or sway), Solaar includes a command-line interface (solaar). Administrators can run commands such as solaar show to inspect connected hardware details or solaar config to modify hardware settings directly from shell scripts.