RomanNum3ral
/
Solaar
mirror of https://github.com/pwr-Solaar/Solaar.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: change device documentation to show less information

This commit is contained in:
Peter F. Patel-Schneider 2021-10-27 12:15:01 -04:00
parent 5480321f49
commit bc2f482300
1 changed files with 138 additions and 155 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

293
docs/devices.md
View File

@ -3,28 +3,36 @@ title: Supported Devices
layout: page
---
# Supported devices and receivers
# Supported receivers and devices
These tables provide a partial list of supported Logitech receivers and
devices and to what degree their
features are supported by Solaar. The information in these tables is
based on what devices users have been able to test Solaar with.
Solaar only supports Logitech receivers and devices that use the Logitech proprietary HID++ protocol.
The HID++ column specifies the device's HID++ version. Some devices report
version 4.5, but that is the same as version 2.0 as listed here.
For devices what support HID++ 2.0 or greater, Solaar is able to discover
the features the device supports.
Solaar supports most Logitech Nano and Unifying 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.
The Battery column specifies if Solaar is able to read the device's battery
level.
Solaar supports most recent and many older Logitech devices
(keyboards, mice, trackballs, and touchpads)
that can connect to supported receivers.
Solaar supports many recent Logitech devices that can connect via a USB cable,
but some such Logitech devices are not suited for use in Solaar because they do not use the HID++ protocol.
One example is the MX518 Gaming Mouse.
Solaar supports most recent Logitech devices that can connect via Bluetooth.
For mice, the DPI column specifies if the mouse's sensitivity is fixed (`-`),
can only be read (`R`), or can be read and changed by Solaar (`R/W`).
The device tables below provide a list of some of the devices that Solaar supports,
giving their product name, WPID product number, and HID++ protocol information..
The tables concentrate on older devices that have explicit support information in Solaar.
The best way to determine whether Solaar supports a device is to run Solaar while the device is connected.
If the device is supported, it will show up in the Solaar main window.
If it is not, and there is no issue about the device in the Solaar GitHub repository,
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, 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).
@ -38,17 +46,15 @@ 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.
Some Logitech devices are not suited for use in Solaar. If the device only
connects via a USB cable Solaar might not be able to do much or anything
with the device so it may not be useful to add it to Solaar. One example is
the MX518 Gaming Mouse.
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.
### Receivers
### Supported Receivers
| USB ID | Kind | Max Paired Devices |
------------|------------|--------------------|
| 046d:c517 | 27MHz old | 4 |
| 046d:c517 | 27MHz | 4 |
| 046d:c518 | Nano | 1 |
| 046d:c51a | Nano | 1 |
| 046d:c51b | Nano | 1 |
@ -61,177 +67,154 @@ the MX518 Gaming Mouse.
| 046d:c531 | Nano | 1 |
| 046d:c532 | Unifying | 6 |
| 046d:c534 | Nano | 2 |
| 046d:c537 | Nano | 2 |
| 046d:c539 | Lightspeed | 1 |
| 046d:c53a | Lightspeed | 1 |
| 046d:c53d | Lightspeed | 1 |
| 046d:c53f | Lightspeed | 1 |
| 046d:c545 | Lightspeed | 1 |
| 046d:c541 | Lightspeed | 1 |
| 046d:c545 | Lightspeed | 1 |
| 046d:c547 | Lightspeed | 1 |
| 17ef:6042 | Nano | 1 |
Some Nano receivers are only partly supported
as they do not fully implement the HID++ 1.0 protocol.
The receiver with USB Id 046d:c517 is an old 27 MHz receiver, supporting only
subset of HID++ 1.0 protocol. Only hardware pairing is supported.
### Keyboards (Unifying)
| Device | WPID | HID++ | Battery | Other supported features |
|------------------|------|-------|---------|-----------------------------------------|
| K230 | 400D | 2.0 | yes | |
| K270 | 4003 | 2.0 | yes | |
| K340 | 2007 | 1.0 | yes | |
| K350 | 200A | 1.0 | yes | |
| K360 | 4004 | 2.0 | yes | FN swap, reprog keys |
| K375s | 4071 | | | FN swap |
| K400 Touch | 400E | 2.0 | yes | FN swap |
| K400 Touch | 4024 | 2.0 | yes | FN swap |
| K400 Plus | 404D | 2.0 | | FN swap, disable keys, touchpad gestures|
| K520 | 2011 | 1.0 | yes | FN swap |
| K600 TV | 4078 | 2.0 | yes | FN swap |
| K750 Solar | 4002 | 2.0 | yes | FN swap, Lux reading, light button |
| K780 | 405B | 2.0 | yes | FN swap |
| K800 Illuminated | 2010 | 1.0 | yes | FN swap, reprog keys, LEDs |
| K800 (new ver) | 406E | 2.0 | yes | FN swap |
| K830 Illuminated | 4032 | 2.0 | yes | FN swap |
| MX Keys | 408A | 2.0 | yes | |
| N545 | 2006 | | yes | |
| TK820 | | 2.0 | yes | FN swap |
| Craft | 4066 | 2.0 | | |
| Device | WPID | HID++ |
|------------------|------|-------|
| K230 | 400D | 2.0 |
| K270 | 4003 | 2.0 |
| K340 | 2007 | 1.0 |
| K350 | 200A | 1.0 |
| K360 | 4004 | 2.0 |
| K375s | 4071 | |
| K400 Touch | 400E | 2.0 |
| K400 Touch | 4024 | 2.0 |
| K400 Plus | 404D | 2.0 |
| K520 | 2011 | 1.0 |
| K600 TV | 4078 | 2.0 |
| K750 Solar | 4002 | 2.0 |
| K780 | 405B | 2.0 |
| K800 Illuminated | 2010 | 1.0 |
| K800 (new ver) | 406E | 2.0 |
| K830 Illuminated | 4032 | 2.0 |
| MX Keys | 408A | 2.0 |
| N545 | 2006 | |
| TK820 | | 2.0 |
| Craft | 4066 | 2.0 |
* The [K750 Solar Keyboard][K750] can be queried for its solar charge status.
Pressing the `Light-Check` button on the keyboard will pop-up the application
window and display the current lighting value (Lux) as reported by the
keyboard, similar to Logitech's *Solar.app* for Windows.
* FN swap changes the way the function keys (`F1`–`F12`) work, i.e., whether holding `FN` while pressing the function keys will generate the standard `Fx` keycodes or the special function (yellow icons) keycodes.
### Mice (Unifying)
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|------------------|------|-------|---------|-------|-----------------------------------------|
| M150 | 4022 | 2.0 | | | |
| M185 | 4055 | 2.0 | | R/W | smooth scrolling |
| M310 | 4031 | 2.0 | yes | | |
| M310 | 4055 | 2.0 | | R/W | smooth scrolling |
| M317 | | | | | |
| M325 | 400A | 2.0 | yes | 1000 | smooth scrolling |
| M330 | | 2.0 | yes | 1000 | smooth scrolling |
| M345 | 4017 | 2.0 | yes | – | smooth scrolling |
| M350 | 101C | 1.0 | yes | | |
| M350 | 4080 | 2.0 | | | |
| M505 | 101D | 1.0 | yes | | smooth scrolling, side scrolling |
| M510 | 1025 | 1.0 | yes | | smooth scrolling, side scrolling |
| M510 | 4051 | 2.0 | yes | | smooth scrolling |
| M515 Couch | 4007 | 2.0 | yes | – | smooth scrolling |
| M525 | 4013 | 2.0 | yes | – | smooth scrolling |
| M560 | | 2.0 | yes | – | smooth scrolling |
| M585 | 406B | 2.0 | yes | R/W | smooth scrolling |
| M590 | 406B | 2.0 | yes | R/W | smooth scrolling |
| M600 Touch | 401A | 2.0 | yes | | |
| M705 Marathon | 101B | 1.0 | yes | – | smooth scrolling, side scrolling |
| M705 Marathon | 406D | 2.0 | yes | R/W | smooth scrolling |
| M720 Triathlon | 405E | 2.0 | yes | – | |
| T400 Zone Touch | | 2.0 | yes | | smooth scrolling |
| T620 Touch | | 2.0 | yes | | |
| Performance MX | 101A | 1.0 | yes | R/W | smooth scrolling, side scrolling |
| Anywhere MX | 1017 | 1.0 | yes | R/W | smooth scrolling, side scrolling |
| Anywhere MX 2 | 404A | 2.0 | yes | R/W | smooth scrolling |
| MX Master | 4041 | 2.0 | yes | R/W | smooth scrolling, smart shift |
| MX Master 2S | 4069 | 2.0 | yes | R/W | smooth scrolling, smart shift, gestures |
| Cube | | 2.0 | yes | | |
| Device | WPID | HID++ |
|------------------|------|-------|
| M150 | 4022 | 2.0 |
| M185 | 4055 | 2.0 |
| M310 | 4031 | 2.0 |
| M310 | 4055 | 2.0 |
| M317 | | |
| M325 | 400A | 2.0 |
| M330 | | 2.0 |
| M345 | 4017 | 2.0 |
| M350 | 101C | 1.0 |
| M350 | 4080 | 2.0 |
| M505 | 101D | 1.0 |
| M510 | 1025 | 1.0 |
| M510 | 4051 | 2.0 |
| M515 Couch | 4007 | 2.0 |
| M525 | 4013 | 2.0 |
| M560 | | 2.0 |
| M585 | 406B | 2.0 |
| M590 | 406B | 2.0 |
| M600 Touch | 401A | 2.0 |
| M705 Marathon | 101B | 1.0 |
| M705 Marathon | 406D | 2.0 |
| M720 Triathlon | 405E | 2.0 |
| T400 Zone Touch | | 2.0 |
| T620 Touch | | 2.0 |
| Performance MX | 101A | 1.0 |
| Anywhere MX | 1017 | 1.0 |
| Anywhere MX 2 | 404A | 2.0 |
| MX Master | 4041 | 2.0 |
| MX Master 2S | 4069 | 2.0 |
| Cube | | 2.0 |
### Mice (Nano)
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|------------------|------|-------|---------|-------|---------------------------------|
| G7 | 1002 | 1.0 | yes | – | |
| G700 | 1023 | 1.0 | yes | – | smooth scrolling, side scrolling|
| G700s | 102A | 1.0 | yes | – | smooth scrolling, side scrolling|
| V450 Nano | 1011 | 1.0 | yes | – | smooth scrolling |
| V550 Nano | 1013 | 1.0 | yes | – | smooth scrolling, side scrolling|
| VX Nano | 100B | 1.0 | yes | – | smooth scrolling, side scrolling|
| VX Nano | 100F | 1.0 | yes | – | smooth scrolling, side scrolling|
| M175 | 4008 | | yes | | |
| M185 (old) | 4038 | 2.0 | yes | R/W | smooth scrolling (note) |
| M185 (new) | 4054 | 2.0 | no | R/W | smooth scrolling (note) |
| M187 | 4019 | 2.0 | yes | | |
| M215 | 1020 | 1.0 | yes | | |
| M235 | 4055 | 2.0 | yes | R/W | smooth scrolling |
| M305 | 101F | 1.0 | yes | | side scrolling |
| M310 | 1024 | 1.0 | yes | | |
| M315 | | | yes | | |
| M330 | | ?.? | yes | ? | smooth scrolling |
| MX 1100 | 1014 | 1.0 | yes | – | smooth scrolling, side scrolling|
| Device | WPID | HID++ |
|------------------|------|-------|
| G7 | 1002 | 1.0 |
| G700 | 1023 | 1.0 |
| G700s | 102A | 1.0 |
| V450 Nano | 1011 | 1.0 |
| V550 Nano | 1013 | 1.0 |
| VX Nano | 100B | 1.0 |
| VX Nano | 100F | 1.0 |
| M175 | 4008 | |
| M185 (old) | 4038 | 2.0 |
| M185 (new) | 4054 | 2.0 |
| M187 | 4019 | 2.0 |
| M215 | 1020 | 1.0 |
| M235 | 4055 | 2.0 |
| M305 | 101F | 1.0 |
| M310 | 1024 | 1.0 |
| M315 | | |
| M330 | | ?.? |
| MX 1100 | 1014 | 1.0 |
* (old): M185 with P/N: 810-003496
* (new): M185 with P/N: 810-005238 or 810-005232
* (note): Currently, smooth scrolling events are not processed in xfce and this
setting is useful only to disable smooth scrolling.
### Mice (Mini)
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|-------------------|------|-------|---------|-------|---------------------------------|
| MX610 | 1001 | 1.0 | yes | | |
| MX610 left handed | 1004 | 1.0 | yes | | |
| MX620 | 100A | 1.0 | yes | | |
| MX620 | 1016 | 1.0 | yes | | |
| V400 | 1003 | 1.0 | yes | | |
| V450 | 1005 | 1.0 | yes | | |
| VX Revolution | 1006 | 1.0 | yes | | |
| VX Revolution | 100D | 1.0 | yes | | |
| MX Air | 1007 | 1.0 | yes | | |
| MX Air | 100E | 1.0 | yes | | |
| MX Revolution | 1008 | 1.0 | yes | | |
| MX Revolution | 100C | 1.0 | yes | | |
| Device | WPID | HID++ |
|-------------------|------|-------|
| MX610 | 1001 | 1.0 |
| MX610 left handed | 1004 | 1.0 |
| MX620 | 100A | 1.0 |
| MX620 | 1016 | 1.0 |
| V400 | 1003 | 1.0 |
| V450 | 1005 | 1.0 |
| VX Revolution | 1006 | 1.0 |
| VX Revolution | 100D | 1.0 |
| MX Air | 1007 | 1.0 |
| MX Air | 100E | 1.0 |
| MX Revolution | 1008 | 1.0 |
| MX Revolution | 100C | 1.0 |
### Trackballs (Unifying)
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|-------------------|------|-------|---------|-------|---------------------------------|
| M570 Trackball | | 1.0 | yes | – | |
| MX Ergo Trackball | | 2.0 | yes | – | |
| Device | WPID | HID++ |
|-------------------|------|-------|
| M570 Trackball | | 1.0 |
| MX Ergo Trackball | | 2.0 |
### Touchpads (Unifying)
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|------------------|------|-------|---------|-------|---------------------------------|
| Wireless Touch | 4011 | 2.0 | yes | | |
| T650 Touchpad | 4101 | 2.0 | yes | | smooth scrolling |
| Device | WPID | HID++ |
|------------------|------|-------|
| Wireless Touch | 4011 | 2.0 |
| T650 Touchpad | 4101 | 2.0 |
### Mice and Keyboards sold as combos
| Device | WPID | HID++ | Battery | Other supported features |
|------------------|------|-------|---------|-----------------------------------------|
| MK220 | | 2.0 | yes | |
| MK270 | 4023 | 2.0 | yes | reprog keys |
| MK320 | 200F | | | |
| MK330 | | | | |
| MK345 | 4023 | 2.0 | yes | reprog keys |
| MK520 | | M2/K1 | yes | FN swap, reprog keys |
| MK550 | | | | |
| MK700 | 2008 | 1.0 | yes | FN swap, reprog keys |
| MK710 | | 1.0 | yes | FN swap, reprog keys |
| EX100 keyboard | 0065 | 1.0 | yes | |
| EX100 mouse | 003f | 1.0 | yes | |
| Device | WPID | HID++ |
|------------------|------|-------|
| MK220 | | 2.0 |
| MK270 | 4023 | 2.0 |
| MK320 | 200F | |
| MK330 | | |
| MK345 | 4023 | 2.0 |
| MK520 | | M2/K1 |
| MK550 | | |
| MK700 | 2008 | 1.0 |
| MK710 | | 1.0 |
| EX100 keyboard | 0065 | 1.0 |
| EX100 mouse | 003f | 1.0 |
* The EX100 is an old, preunifying receiver and device set, supporting only part of HID++ 1.0 features
[solaar]: https://github.com/pwr-Solaar/Solaar
[logitech]: https://www.logitech.com
[unifying]: https://en.wikipedia.org/wiki/Logitech_Unifying_receiver
[G700s]: https://gaming.logitech.com/en-us/product/g700s-rechargeable-wireless-gaming-mouse
[K360]: http://logitech.com/product/keyboard-k360
[K700]: http://logitech.com/product/wireless-desktop-mk710
[K750]: http://logitech.com/product/k750-keyboard
[K800]: http://logitech.com/product/wireless-illuminated-keyboard-k800
[K830]: http://logitech.com/product/living-room-keyboard-k830
[M510]: http://logitech.com/product/wireless-mouse-m510
[M705]: http://logitech.com/product/marathon-mouse-m705
[P_MX]: http://logitech.com/product/performance-mouse-mx
[A_MX]: http://logitech.com/product/anywhere-mouse-mx
[M325]: http://logitech.com/product/wireless-mouse-m325
[M330]: https://www.logitech.com/en-us/product/m330-silent-plus