- Solaar
- Linux Device Manager for Logitech Unifying Receivers and Devices.
- Supported Devices
- Prebuilt packages
- Manual installation
- Known Issues
- License
- Thanks
- Logitech Unifying Receiver
- Contents
- Installation
- Usage
- ltunify
- Solaar
- libratbag
- pairingtool
- Known Problems
- Wrong device (pairing tool only)
- Keyboard layout via xorg.conf
- Logitech touchpad keyboard K400r with unifying receiver M325
- Solaar ‘Permission denied’
- Wireless Keyboard does not work while booting (cannot enter luks passphrase)
- MouseJack Vulnerability
- Keyboard or mouse does not wake pc from sleep
- Lag of the wireless device
- Lagging scrolling
- See also
- Logitech Unifying Receiver и Linux
Solaar
Linux Device Manager for Logitech Unifying Receivers and Devices.
Solaar is a Linux manager for many Logitech keyboards, mice, and trackpads that connect wirelessly to a USB Unifying, Lightspeed, or Nano receiver, connect directly via a USB cable, or connect via Bluetooth. Solaar does not work with peripherals from other companies.
Documentation here is for the current version of Solaar. Some Linux distributions distribute old versions of Solaar. If you are using an old version and something described here does not work you should upgrade using one of the methods described below.
Solaar can be used as a GUI application or via its command-line interface. Both interfaces are able to list the connected devices and show information about each device, often including battery status. Solaar is able to pair and unpair devices with receivers as supported by the device and receiver. Solaar can also control some changeable features of devices, such as smooth scrolling or function key behavior. Solaar keeps track of these changed settings on a per-computer basis and the GUI application restores them whenever a device connects. (Devices forget most settings when powered down.) For more information on how to use Solaar see the usage page, and for more information on its capabilities see the capabilities page.
Solaar’s GUI normally uses an icon in the system tray and starts with its main window visible. This aspect of Solaar depends on having an active system tray, which is not the default situation for recent versions of Gnome. For information on to set up a system tray under Gnome see the capabilities page.
Solaar’s GUI can be started in several ways
- —window=show (the default) starts with its main window visible,
- —window=hide starts with its main window hidden,
- —window=only does not use the system tray, and starts with main window visible.
For more information on Solaar’s command-line interface use the help option, as in solaar —help .
Solaar does not process normal input from devices. It is thus unable to fix problems that arise from incorrect handling of mouse movements or keycodes by Linux drivers or other software.
Solaar has progressed past version 1.0. Problems with earlier versions should not be reported as bugs. Instead, upgrade to a recent version or manually install the current version from GitHub. Some capabilities of Solaar have been developed by observing the behavior of Logitech receivers and devices and generalizing from these observations. If your Logitech receiver or device behaves strangely this may be caused by an incorrect behavior generalization. Please report such experiences by creating an issue in the Solaar repository.
Supported Devices
Solaar will detect all devices paired with supported Unifying, Lightspeed, or Nano receivers, and at the very least display some basic information about them. Solaar will detect some Logitech devices that connect via a USB cable or Bluetooth.
Solaar can pair and unpair a Logitech device showing the Unifying logo (Solaar’s version of the logo) with any Unifying receiver and can pair and unpair Lightspeed devices with Lightspeed receivers for the same model. Solaar can pair some Logitech devices with Logitech Nano receivers but not all Logitech devices can be paired with Nano receivers. Logitech devices without a Unifying logo generally cannot be paired with Unifying receivers.
Solaar does not handle connecting or disconnecting via Bluetooth, which is done using the usual Bluetooth mechanisms.
For a partial list of supported devices and their features, see the devices page.
Prebuilt packages
Up-to-date prebuilt packages are available for some Linux distros (e.g., Fedora 33+) in their standard repositories. If a recent version of Solaar is not available from the standard repositories for your distribution you can try one of these packages.
- Arch solaar package in the community repository
- Ubuntu/Kubuntu 16.04+: use the solaar package from universe repository
- Ubuntu/Kubuntu stable packages: use the Solaar stable ppa, courtesy of gogo
- Ubuntu/Kubuntu git build packages: use the Solaar git ppa, courtesy of gogo
- a Gentoo package, courtesy of Carlos Silva and Tim Harder
- a Mageia package, courtesy of David Geiger
Solaar uses a standard system tray implementation; solaar-gnome3 is no longer required for gnome or unity integration.
Manual installation
See the installation page for the step-by-step procedure for manual installation.
Known Issues
If some icons appear broken in the application, make sure you’ve properly configured the Gtk theme and icon theme in your control panel.
There are several implementations of the system tray. Some of these have problems that can result in missing or wrong-sized icons.
The icon in the system tray can show up as ‘black on black’ in dark themes or as non-symbolic when the theme uses symbolic icons. This is due to problems in some system tray implementations. Changing to a different theme may help. The —battery-icons=symbolic option can be used to force symbolic icons.
Sometimes the system tray icon does not show up. The cause of this is unknown. Either wait a while and try again or try with the —window=hide option.
Running the command-line application while the GUI application is also running may occasionally cause either of them to become confused about the state of the devices.
Some Linux drivers view or modify the setting Scroll Wheel Resolution to implement smooth scrolling. If Solaar changes this setting after the driver is set up scrolling can be either very fast or very slow. To fix this problem click on the icon at the right edge of the setting to set it to “Ignore this setting”. The mouse has to be reset (e.g., by turning it off and on again) before this fix will take effect.
Many gaming mice have both the ONBOARD PROFILES feature and the REPORT RATE feature. On these mice changing the Polling Rate setting requires modifying a setting in the ONBOARD PROFILES feature, which can modify how the mouse works. Changing the Polling Rate setting to “Ignore this setting” (see above) prevents Solaar from modifying the ONBOARD PROFILES feature. The mouse has to be reset (e.g., by turning it off and on again) before this fix will take effect.
License
This software is distributed under the terms of the GNU Public License, v2.
Thanks
This project began as a third-hand clone of Noah K. Tilton’s logitech-solar-k750 project on GitHub (no longer available). It was developed further thanks to the diggings in Logitech’s HID++ protocol done by many other people:
Also, thanks to Douglas Wagner, Julien Gascard, and Peter Wu for helping with application testing and supporting new devices.
Источник
Logitech Unifying Receiver
The Logitech Unifying Receiver is a wireless receiver using 2.4 GHz band radio communication that can connect up to six compatible wireless mice and keyboards to your computer. The input device that comes with the receiver is already paired with it and should work out of the box through plug and play. Logitech officially supports pairing of additional devices just through their Windows and macOS software.
Pairing and unpairing on Linux is supported by a number of tools, listed thereafter:
ltunify is a command-line C program that can perform pairing, unpairing and listing of devices. Solaar is a graphical Python program that integrates in your system tray and allows you to configure additional features of your input device such as swapping the functionality of Fn keys. libratbag is a configurable mice daemon that allows you to configure your devices, it has a GTK based graphical frontend app, piper.
Contents
Installation
Several solutions are available:
The following packages use the plugdev user group, create it if it does not exist, and add users to this group to avoid the need of running these as root:
Do not forget to relogin to apply user’s group membership. After installation, run
and then replug reciever. After that you will not need root permissions.
Usage
pairingtool can only be used for pairing and does not provide feedback, it also needs to know the device name for pairing. ltunify, Solaar and libratbag can detect the receiver automatically.
ltunify
Examples on unpairing a device, pairing a new device and showing a list of all devices:
Solaar
Solaar has a GUI and CLI. Example CLI pairing session:
To disable autostart of Solaar, remove /etc/xdg/autostart/solaar.desktop .
libratbag
Currently, piper is not able to pair/manage devices for unifying receivers but libratbag does include a lur-command command line tool that is able to do this.
pairingtool
To find the device that the receiver has, therefore take a look at the outputs of
This will show the names of your receiver, for example hidraw0 .
Now switch off the device that you want to pair (if it was on) and execute your compiled program with the appropriate device as argument:
Now switch on the device you want to pair. After a few seconds your new device should work properly.
Known Problems
Wrong device (pairing tool only)
On some systems there is more than one device that has the same name. In that case you will receive the following error message when the wrong device is choosen:
Keyboard layout via xorg.conf
With kernel 3.2 the Unifying Receiver got its own kernel module hid_logitech_dj which does not work flawlessly together with keyboard layout setting set via xorg.conf. A temporary workaround is to use xorg-setxkbmap and set the layout manually. For example for a German layout with no deadkeys one has to execute:
To automate this process one could add this line to xinitrc or the according autostart file of your windows manager respectively desktop environment.
Logitech touchpad keyboard K400r with unifying receiver M325
The Logitech keyboard K400r with integrated touchpad comes with Logitech unifying receiver M325 so the above mentioned about the keyboard layout will apply here too.
Also the integrated touchpad is recognized as ‘pointer’ instead of ‘touchpad’ so you cannot use the Touchpad Synaptics drivers. Two finger horizontal scrolling and tapclick will work but in order to have a middle mouse button emulated you will have to add
to your evdev.conf. Now third button is emulated by pressing both buttons simultaneously.
Solaar ‘Permission denied’
Is it possible to have the error:
In this case, you can physically remove the Unifying Receiver and re-insert it, and re-run the command (as described in the second point of installation part on the official site [1]).
Wireless Keyboard does not work while booting (cannot enter luks passphrase)
While booting it is impossible to input anything with a Logitech wireless Keyboard (e. g. Logitech MK700). The cause of the problem is the own hid module for Logitech devices since Kernel 3.2.
A workaround is adding hid-logitech-hidpp to MODULES in /etc/mkinitcpio.conf :
and recreate the initrd for the kernel:
MouseJack Vulnerability
Several security vulnerabilities of the system have been reported and you may be in particular affected by the MouseJack Vulnerability if your firmware has not been updated recently.
It is possible to display the current firmware’s version by running:
RQR12 firmware with version earlier than 012.008.00030 and RQR24 firmware versions earlier than 024.006.00030 are affected by this vulnerability and should be updated.
The firmware can be updated using fwupd like so:
If everything looks good, apply the update:
Keyboard or mouse does not wake pc from sleep
Lag of the wireless device
Because the receiver uses the 2.4 GHz frequency band also used by Bluetooth and Wi-Fi 802.11, it is possible in some circumstances of heavy Wi-Fi usage close to the receiver to experience lag or disturbances in communication with the devices. This is unlikely because the receiver confines its communication to channels unused by the majority of 802.11 solutions and it is able to quickly change channel within the band if it detects any interference from another device. However, some users have experienced interferences.
Switching on/off the device will force the search for a «quiet» channel and may solve the issue.
This problem can also manifest if there is electrical noise from USB3 sockets on the motherboard, and it is located close to or in one. Moving the receiver to a USB hub or the end of an extension cable may fix this.
Lagging scrolling
If you have several receivers in system, for example you use multi-device keyboard and mouse and passthrough one of the receivers while using pci passthrough setup and after you turned off your guest machine, that receiver got appeared in the host OS, the input may become laggy. While mouse moving is good, the scrolling with wheel is unacceptably slow (scrolling step is very small). In that situation, unplugging and replugging the receiver may help (however, it may fall to this laggy mode just after several seconds again). Also if you use multi-device peripherals (for example, MX Master mouse), you may just reswitch to the current port with the device-number button.
This problem also happens even when you have only one unifying receiver in the system. This occurs with receivers based on the TI chip (C-U0008 and firmware RQR24), for example, with firmware RQR24.07_B0030. To check your receiver’s firmware, run the following command:
See also
Logiops — Logitech Options alternative for configuring supported mice and keyboards
Источник
Logitech Unifying Receiver и Linux
Кратко: Logitech Unifying Receiver приёмник у беспроводных устройств Logitech к одному которому можно слинковать до 6 устройст. При этом устройство, с которым вместе идёт приёмник уже заранее слинковано с ним и работает из коробки.
Проблема в том, что бы добавить новое устройство. Для этого нужен софт, и софт этот есть был только под Windows и под Mac OS X. Хорошо, что слинковав устройства на одном компе можно было использовать их на остальных без проблем. Но, согласитесь, не удобно.
Не волновал бы меня этот факт если бы не стал обладателем манипулятора Logitech M510 и в ожидании прихода с amazon.com Logitech K800 (заказывал с амазона только с одной целью: получить клавиатуру с «американской» раскладкой, т.е. с широким левым shift и узким enter, отсутствие русских букв не смущает: на нетбуке, с которым уже не первый год, их тоже отродясь не было).
Поэтому начался поиск. Первый результат официального форума Logitech неутешительный: линкуйте устройства в Win/Mac пользуйтесь везде.
Но дальше была просто сказка: почти сразу находится английская статья, описывающая утилиту Solaar (раз,два), далее ссылка на Арчвики из которой узнаётся о ещё двух (правда чисто консольных) утилитах: ltunify и pairingtool
Опробовал только Solaar, хоть она и написана на Python (личное предвзятое отношение), но зато имеет и GUI и CLI версию.
Для владельцев Debian & Ubunu установка не станет проблемой: добавляете репозиторий, делаете atp-get update , а дальше pt-get install solaar . На официальном сайте есть так же пакеты для OpenSuSE, для ArchLinux есть пакет в AUR. Последний и использовал.
Надо заметить, что при установке не говорится о таких полезных вещах, как:
- для работы нужно пользователя добавить в группу plugdev, делаем сами:
И перелогиниваемся, что бы изменения вступили в силу. - после установки нужно или перегрузить машину или заставить udev перечитать правила:
и переподключить ресивер.
Но у меня Solaar и после этого отказался видеть приёмник. Как оказалось, проблема была в моём LTS ядре 3.0.x (обновление сегодня утром принесло LTS ядро 3.10, так что проблем больше не будет), т.к. полноценная поддержка ресиверов появилась только в ядрах 3.2.
После обновления и перезагрузки с новым ядром устройство моментально увиделось. Как оказалось, помимо линковки устройств, программа так же позволяет менять некоторые настройки самих устройств, отображать некоторые статусы и отлинковывать их (даже если устройство не подключено и находится в недосягаемости, к примеру, потеряли). Для моей M510 настроек/статусов получилось немного:
- уровень заряда батареи
- включение/выключение плавной прокрутки
Поддерживаемые (гарантированно) устройства и фичи перечислены в табличке на официальном сайте: pwr.github.io/Solaar/devices.html, но даже если вашего устройства там нет, есть вероятность, что оно заработает. По крайней мере слинковать его можно будет. Думаю, в таком случае, следует связаться с автором и рассказать, что за устройство и как работает, для пополнения коллекции.
На этом всё. Придёт K800 посмотрю как с ней подружится.
Источник