From 4100c83390d1396796153c6a53fd2fde5998560c Mon Sep 17 00:00:00 2001 From: "Peter F. Patel-Schneider" Date: Sat, 19 Mar 2022 21:57:22 -0400 Subject: [PATCH] release 1.1.2 --- ChangeLog.md | 8 +++++--- docs/_config.yml | 2 +- docs/devices.md | 30 ++++++++++++++++-------------- docs/i18n.md | 2 +- docs/index.md | 2 +- lib/solaar/__init__.py | 2 +- setup.py | 3 ++- 7 files changed, 27 insertions(+), 22 deletions(-) diff --git a/ChangeLog.md b/ChangeLog.md index c818c1e59..145fc772b 100644 --- a/ChangeLog.md +++ b/ChangeLog.md @@ -1,5 +1,7 @@ -# 1.1.2rc2 +# 1.1.2 +* Update documentation on supported devices and translations +* Include evdev as a dependency * Try to use uinput for fake input if XTest extension not available * Add Nano receiver C542 for M190 mice * Broaden range of HID++ Bluetooth devices @@ -10,9 +12,9 @@ * Add setting for PERSISTENT_REMAPPABLE_ACTION, common keyboard and mouse cases only * Split Test rule condition into Test and TestBytes and support in rule editor * Fix bug in speed-change setting -* Support Backlight and Backlight3 features +* Support Backlight3 feature * Ensure that settings are pushed in resume -* Update German translation +* Update German, Polish, and zh_CN translations * Determine device number for direct-connected devices from protocol * fix bug in add and delete button actions in rule editor * dispose of no-op notifications quickly diff --git a/docs/_config.yml b/docs/_config.yml index d22813df5..b73cc9825 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -4,7 +4,7 @@ tagline: Linux Device Manager for Logitech Unifying Receivers and Devices. owner: pwr-Solaar owner_url: https://github.com/pwr-Solaar repository: pwr-Solaar/Solaar -version: 1.1.2rc2 +version: 1.1.2 show_downloads: false encoding: utf-8 theme: jekyll-theme-slate diff --git a/docs/devices.md b/docs/devices.md index 0c6affb33..a7130fd07 100644 --- a/docs/devices.md +++ b/docs/devices.md @@ -7,9 +7,8 @@ layout: page Solaar only supports Logitech receivers and devices that use the Logitech proprietary HID++ protocol. -Solaar supports most Logitech Nano and Unifying receivers. +Solaar supports most Logitech Nano, Unifying, and Bolt receivers. Solaar supports some Lightspeed receivers. -Solaar does not currently support Bolt receivers. See the receiver table below for the list of currently supported receivers. Solaar supports most recent and many older Logitech devices @@ -32,22 +31,24 @@ open an enhancement issue requesting that it be supported. ## Adding new receivers and devices Adding a new receiver requires knowing whether the receiver is a regular -Unifying receiver, a Nano receiver, or a Lightspeed receiver. Add a line to +Unifying receiver, a Nano receiver, a Bolt receiver, or a Lightspeed receiver. Add a line to `../lib/logitech_receiver/base_usb.py` defining the receiver as one of these. If the receiver has an unusual number of pairing slots, then this also needs to be specified. Then add the receiver to the tuple of receivers (ALL). -Most new devices do not need to be known to Solaar to work. However, an -entry in `lib/logitech-receiver/descriptors.py` can provide a better name for -the device and a feature list can speed up Solaar startup a bit. The -arguments to the _D function are the device's long name, its short name -(codename), its HID++ protocol version, its wireless product ID (wpid), and -a tuple of known feature settings (from `lib/logitech/settings_templates.py`). -If the device can connect via a USB cable its USB product ID should be included. -If the device can connect via Bluetooth its Bluetooth product ID should be included. - -If a USB device connects via a USB interface other than the default, add that information. -This is the main reason for new devices that use the HID++ protocol to need support information in Solaar. +Most new devices do not need to be known to Solaar to work. +The _D function in `../lib/logitech_receiver/descriptors.py` makes a device known to Solaar. +The usual arguments to the _D function are the device's long name, its short name +(codename), and its HID++ protocol version. +Devices that use HID++ 1.0 need a tuple of known registers (registers) and settings (settings). +Settings can be provided for Devices that use HID++ 2.0 or later, +but Solaar can determine these from the device. +If the device can connect to a receiver, provide its wireless product ID (wpid), +If the device can connect via Bluetooth, provide its Bluetooth product ID (btid). +If the device can connect via a USB cable, provide its USB product ID (usbid), +and the interface it uses to send and receiver HID++ messages (interface - default 2). +The use of a non-default USB interface is the main reason for requiring information about +modern devices to be added to Solaar. ### Supported Receivers @@ -73,6 +74,7 @@ This is the main reason for new devices that use the HID++ protocol to need supp | 046d:c53d | Lightspeed | 1 | | 046d:c53f | Lightspeed | 1 | | 046d:c541 | Lightspeed | 1 | +| 046d:c542 | Nano | 1 | | 046d:c545 | Lightspeed | 1 | | 046d:c547 | Lightspeed | 1 | | 046d:c548 | Bolt | 6 | diff --git a/docs/i18n.md b/docs/i18n.md index 249b930cf..fe0facb67 100644 --- a/docs/i18n.md +++ b/docs/i18n.md @@ -34,7 +34,7 @@ the source root): You can edit the translation iteratively, just repeat from step 3. If the upstream changes, do a `git pull` and then repeat from step 2. -Before opening a pull request, please run `./tools/po-update.sh` again. It will +Before opening a pull request, please run `./tools/po-update.sh ` again. This will format and sort the translation file, and ensure a minimal diff when updating a translation. diff --git a/docs/index.md b/docs/index.md index b3ed96c46..7ef35f9d6 100644 --- a/docs/index.md +++ b/docs/index.md @@ -47,7 +47,7 @@ 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 +Solaar has progressed past version 1.1. Problems with earlier versions should not be reported as bugs. Instead, upgrade to a recent version or manually install the current version from [GitHub](https://github.com/pwr-Solaar/Solaar). Some capabilities of Solaar have been developed by observing the behavior of diff --git a/lib/solaar/__init__.py b/lib/solaar/__init__.py index 4695fe7b4..305591095 100644 --- a/lib/solaar/__init__.py +++ b/lib/solaar/__init__.py @@ -16,5 +16,5 @@ ## with this program; if not, write to the Free Software Foundation, Inc., ## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. -__version__ = '1.1.2rc2' +__version__ = '1.1.2' NAME = 'Solaar' diff --git a/setup.py b/setup.py index 423880685..fb0a0fc6c 100755 --- a/setup.py +++ b/setup.py @@ -8,7 +8,7 @@ from distutils.core import setup # from solaar import NAME, __version__ -__version__ = '1.1.2rc2' +__version__ = '1.1.2' NAME = 'Solaar' @@ -61,6 +61,7 @@ def _data_files(): # os_requires=['gi.repository.GObject (>= 2.0)', 'gi.repository.Gtk (>= 3.0)'], python_requires='>=3.6', install_requires=[ + 'evdev (>= 1.3.0)', 'pyudev (>= 0.13)', 'PyYAML (>= 3.12)', 'python-xlib (>= 0.27)',