docs: change device documentation to show less information
This commit is contained in:
parent
5480321f49
commit
bc2f482300
293
docs/devices.md
293
docs/devices.md
|
@ -3,28 +3,36 @@ title: Supported Devices
|
||||||
layout: page
|
layout: page
|
||||||
---
|
---
|
||||||
|
|
||||||
# Supported devices and receivers
|
# Supported receivers and devices
|
||||||
|
|
||||||
These tables provide a partial list of supported Logitech receivers and
|
Solaar only supports Logitech receivers and devices that use the Logitech proprietary HID++ protocol.
|
||||||
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.
|
|
||||||
|
|
||||||
The HID++ column specifies the device's HID++ version. Some devices report
|
Solaar supports most Logitech Nano and Unifying receivers.
|
||||||
version 4.5, but that is the same as version 2.0 as listed here.
|
Solaar supports some Lightspeed receivers.
|
||||||
For devices what support HID++ 2.0 or greater, Solaar is able to discover
|
Solaar does not currently support Bolt receivers.
|
||||||
the features the device supports.
|
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
|
Solaar supports most recent and many older Logitech devices
|
||||||
level.
|
(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 (`-`),
|
The device tables below provide a list of some of the devices that Solaar supports,
|
||||||
can only be read (`R`), or can be read and changed by Solaar (`R/W`).
|
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 new receivers and devices
|
||||||
|
|
||||||
Adding a new receiver requires knowing whether the receiver is a regular
|
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.
|
`../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
|
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).
|
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 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 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
|
If a USB device connects via a USB interface other than the default, add that information.
|
||||||
connects via a USB cable Solaar might not be able to do much or anything
|
This is the main reason for new devices that use the HID++ protocol to need support information in Solaar.
|
||||||
with the device so it may not be useful to add it to Solaar. One example is
|
|
||||||
the MX518 Gaming Mouse.
|
|
||||||
|
|
||||||
|
|
||||||
### Receivers
|
### Supported Receivers
|
||||||
|
|
||||||
| USB ID | Kind | Max Paired Devices |
|
| USB ID | Kind | Max Paired Devices |
|
||||||
------------|------------|--------------------|
|
------------|------------|--------------------|
|
||||||
| 046d:c517 | 27MHz old | 4 |
|
| 046d:c517 | 27MHz | 4 |
|
||||||
| 046d:c518 | Nano | 1 |
|
| 046d:c518 | Nano | 1 |
|
||||||
| 046d:c51a | Nano | 1 |
|
| 046d:c51a | Nano | 1 |
|
||||||
| 046d:c51b | Nano | 1 |
|
| 046d:c51b | Nano | 1 |
|
||||||
|
@ -61,177 +67,154 @@ the MX518 Gaming Mouse.
|
||||||
| 046d:c531 | Nano | 1 |
|
| 046d:c531 | Nano | 1 |
|
||||||
| 046d:c532 | Unifying | 6 |
|
| 046d:c532 | Unifying | 6 |
|
||||||
| 046d:c534 | Nano | 2 |
|
| 046d:c534 | Nano | 2 |
|
||||||
|
| 046d:c537 | Nano | 2 |
|
||||||
| 046d:c539 | Lightspeed | 1 |
|
| 046d:c539 | Lightspeed | 1 |
|
||||||
| 046d:c53a | Lightspeed | 1 |
|
| 046d:c53a | Lightspeed | 1 |
|
||||||
| 046d:c53d | Lightspeed | 1 |
|
| 046d:c53d | Lightspeed | 1 |
|
||||||
| 046d:c53f | Lightspeed | 1 |
|
| 046d:c53f | Lightspeed | 1 |
|
||||||
| 046d:c545 | Lightspeed | 1 |
|
|
||||||
| 046d:c541 | Lightspeed | 1 |
|
| 046d:c541 | Lightspeed | 1 |
|
||||||
|
| 046d:c545 | Lightspeed | 1 |
|
||||||
|
| 046d:c547 | Lightspeed | 1 |
|
||||||
| 17ef:6042 | Nano | 1 |
|
| 17ef:6042 | Nano | 1 |
|
||||||
|
|
||||||
Some Nano receivers are only partly supported
|
Some Nano receivers are only partly supported
|
||||||
as they do not fully implement the HID++ 1.0 protocol.
|
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
|
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.
|
subset of HID++ 1.0 protocol. Only hardware pairing is supported.
|
||||||
|
|
||||||
|
|
||||||
### Keyboards (Unifying)
|
### Keyboards (Unifying)
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|------------------|------|-------|---------|-----------------------------------------|
|
|------------------|------|-------|
|
||||||
| K230 | 400D | 2.0 | yes | |
|
| K230 | 400D | 2.0 |
|
||||||
| K270 | 4003 | 2.0 | yes | |
|
| K270 | 4003 | 2.0 |
|
||||||
| K340 | 2007 | 1.0 | yes | |
|
| K340 | 2007 | 1.0 |
|
||||||
| K350 | 200A | 1.0 | yes | |
|
| K350 | 200A | 1.0 |
|
||||||
| K360 | 4004 | 2.0 | yes | FN swap, reprog keys |
|
| K360 | 4004 | 2.0 |
|
||||||
| K375s | 4071 | | | FN swap |
|
| K375s | 4071 | |
|
||||||
| K400 Touch | 400E | 2.0 | yes | FN swap |
|
| K400 Touch | 400E | 2.0 |
|
||||||
| K400 Touch | 4024 | 2.0 | yes | FN swap |
|
| K400 Touch | 4024 | 2.0 |
|
||||||
| K400 Plus | 404D | 2.0 | | FN swap, disable keys, touchpad gestures|
|
| K400 Plus | 404D | 2.0 |
|
||||||
| K520 | 2011 | 1.0 | yes | FN swap |
|
| K520 | 2011 | 1.0 |
|
||||||
| K600 TV | 4078 | 2.0 | yes | FN swap |
|
| K600 TV | 4078 | 2.0 |
|
||||||
| K750 Solar | 4002 | 2.0 | yes | FN swap, Lux reading, light button |
|
| K750 Solar | 4002 | 2.0 |
|
||||||
| K780 | 405B | 2.0 | yes | FN swap |
|
| K780 | 405B | 2.0 |
|
||||||
| K800 Illuminated | 2010 | 1.0 | yes | FN swap, reprog keys, LEDs |
|
| K800 Illuminated | 2010 | 1.0 |
|
||||||
| K800 (new ver) | 406E | 2.0 | yes | FN swap |
|
| K800 (new ver) | 406E | 2.0 |
|
||||||
| K830 Illuminated | 4032 | 2.0 | yes | FN swap |
|
| K830 Illuminated | 4032 | 2.0 |
|
||||||
| MX Keys | 408A | 2.0 | yes | |
|
| MX Keys | 408A | 2.0 |
|
||||||
| N545 | 2006 | | yes | |
|
| N545 | 2006 | |
|
||||||
| TK820 | | 2.0 | yes | FN swap |
|
| TK820 | | 2.0 |
|
||||||
| Craft | 4066 | 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)
|
### Mice (Unifying)
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|------------------|------|-------|---------|-------|-----------------------------------------|
|
|------------------|------|-------|
|
||||||
| M150 | 4022 | 2.0 | | | |
|
| M150 | 4022 | 2.0 |
|
||||||
| M185 | 4055 | 2.0 | | R/W | smooth scrolling |
|
| M185 | 4055 | 2.0 |
|
||||||
| M310 | 4031 | 2.0 | yes | | |
|
| M310 | 4031 | 2.0 |
|
||||||
| M310 | 4055 | 2.0 | | R/W | smooth scrolling |
|
| M310 | 4055 | 2.0 |
|
||||||
| M317 | | | | | |
|
| M317 | | |
|
||||||
| M325 | 400A | 2.0 | yes | 1000 | smooth scrolling |
|
| M325 | 400A | 2.0 |
|
||||||
| M330 | | 2.0 | yes | 1000 | smooth scrolling |
|
| M330 | | 2.0 |
|
||||||
| M345 | 4017 | 2.0 | yes | – | smooth scrolling |
|
| M345 | 4017 | 2.0 |
|
||||||
| M350 | 101C | 1.0 | yes | | |
|
| M350 | 101C | 1.0 |
|
||||||
| M350 | 4080 | 2.0 | | | |
|
| M350 | 4080 | 2.0 |
|
||||||
| M505 | 101D | 1.0 | yes | | smooth scrolling, side scrolling |
|
| M505 | 101D | 1.0 |
|
||||||
| M510 | 1025 | 1.0 | yes | | smooth scrolling, side scrolling |
|
| M510 | 1025 | 1.0 |
|
||||||
| M510 | 4051 | 2.0 | yes | | smooth scrolling |
|
| M510 | 4051 | 2.0 |
|
||||||
| M515 Couch | 4007 | 2.0 | yes | – | smooth scrolling |
|
| M515 Couch | 4007 | 2.0 |
|
||||||
| M525 | 4013 | 2.0 | yes | – | smooth scrolling |
|
| M525 | 4013 | 2.0 |
|
||||||
| M560 | | 2.0 | yes | – | smooth scrolling |
|
| M560 | | 2.0 |
|
||||||
| M585 | 406B | 2.0 | yes | R/W | smooth scrolling |
|
| M585 | 406B | 2.0 |
|
||||||
| M590 | 406B | 2.0 | yes | R/W | smooth scrolling |
|
| M590 | 406B | 2.0 |
|
||||||
| M600 Touch | 401A | 2.0 | yes | | |
|
| M600 Touch | 401A | 2.0 |
|
||||||
| M705 Marathon | 101B | 1.0 | yes | – | smooth scrolling, side scrolling |
|
| M705 Marathon | 101B | 1.0 |
|
||||||
| M705 Marathon | 406D | 2.0 | yes | R/W | smooth scrolling |
|
| M705 Marathon | 406D | 2.0 |
|
||||||
| M720 Triathlon | 405E | 2.0 | yes | – | |
|
| M720 Triathlon | 405E | 2.0 |
|
||||||
| T400 Zone Touch | | 2.0 | yes | | smooth scrolling |
|
| T400 Zone Touch | | 2.0 |
|
||||||
| T620 Touch | | 2.0 | yes | | |
|
| T620 Touch | | 2.0 |
|
||||||
| Performance MX | 101A | 1.0 | yes | R/W | smooth scrolling, side scrolling |
|
| Performance MX | 101A | 1.0 |
|
||||||
| Anywhere MX | 1017 | 1.0 | yes | R/W | smooth scrolling, side scrolling |
|
| Anywhere MX | 1017 | 1.0 |
|
||||||
| Anywhere MX 2 | 404A | 2.0 | yes | R/W | smooth scrolling |
|
| Anywhere MX 2 | 404A | 2.0 |
|
||||||
| MX Master | 4041 | 2.0 | yes | R/W | smooth scrolling, smart shift |
|
| MX Master | 4041 | 2.0 |
|
||||||
| MX Master 2S | 4069 | 2.0 | yes | R/W | smooth scrolling, smart shift, gestures |
|
| MX Master 2S | 4069 | 2.0 |
|
||||||
| Cube | | 2.0 | yes | | |
|
| Cube | | 2.0 |
|
||||||
|
|
||||||
### Mice (Nano)
|
### Mice (Nano)
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|------------------|------|-------|---------|-------|---------------------------------|
|
|------------------|------|-------|
|
||||||
| G7 | 1002 | 1.0 | yes | – | |
|
| G7 | 1002 | 1.0 |
|
||||||
| G700 | 1023 | 1.0 | yes | – | smooth scrolling, side scrolling|
|
| G700 | 1023 | 1.0 |
|
||||||
| G700s | 102A | 1.0 | yes | – | smooth scrolling, side scrolling|
|
| G700s | 102A | 1.0 |
|
||||||
| V450 Nano | 1011 | 1.0 | yes | – | smooth scrolling |
|
| V450 Nano | 1011 | 1.0 |
|
||||||
| V550 Nano | 1013 | 1.0 | yes | – | smooth scrolling, side scrolling|
|
| V550 Nano | 1013 | 1.0 |
|
||||||
| VX Nano | 100B | 1.0 | yes | – | smooth scrolling, side scrolling|
|
| VX Nano | 100B | 1.0 |
|
||||||
| VX Nano | 100F | 1.0 | yes | – | smooth scrolling, side scrolling|
|
| VX Nano | 100F | 1.0 |
|
||||||
| M175 | 4008 | | yes | | |
|
| M175 | 4008 | |
|
||||||
| M185 (old) | 4038 | 2.0 | yes | R/W | smooth scrolling (note) |
|
| M185 (old) | 4038 | 2.0 |
|
||||||
| M185 (new) | 4054 | 2.0 | no | R/W | smooth scrolling (note) |
|
| M185 (new) | 4054 | 2.0 |
|
||||||
| M187 | 4019 | 2.0 | yes | | |
|
| M187 | 4019 | 2.0 |
|
||||||
| M215 | 1020 | 1.0 | yes | | |
|
| M215 | 1020 | 1.0 |
|
||||||
| M235 | 4055 | 2.0 | yes | R/W | smooth scrolling |
|
| M235 | 4055 | 2.0 |
|
||||||
| M305 | 101F | 1.0 | yes | | side scrolling |
|
| M305 | 101F | 1.0 |
|
||||||
| M310 | 1024 | 1.0 | yes | | |
|
| M310 | 1024 | 1.0 |
|
||||||
| M315 | | | yes | | |
|
| M315 | | |
|
||||||
| M330 | | ?.? | yes | ? | smooth scrolling |
|
| M330 | | ?.? |
|
||||||
| MX 1100 | 1014 | 1.0 | yes | – | smooth scrolling, side scrolling|
|
| MX 1100 | 1014 | 1.0 |
|
||||||
|
|
||||||
* (old): M185 with P/N: 810-003496
|
* (old): M185 with P/N: 810-003496
|
||||||
* (new): M185 with P/N: 810-005238 or 810-005232
|
* (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)
|
### Mice (Mini)
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|-------------------|------|-------|---------|-------|---------------------------------|
|
|-------------------|------|-------|
|
||||||
| MX610 | 1001 | 1.0 | yes | | |
|
| MX610 | 1001 | 1.0 |
|
||||||
| MX610 left handed | 1004 | 1.0 | yes | | |
|
| MX610 left handed | 1004 | 1.0 |
|
||||||
| MX620 | 100A | 1.0 | yes | | |
|
| MX620 | 100A | 1.0 |
|
||||||
| MX620 | 1016 | 1.0 | yes | | |
|
| MX620 | 1016 | 1.0 |
|
||||||
| V400 | 1003 | 1.0 | yes | | |
|
| V400 | 1003 | 1.0 |
|
||||||
| V450 | 1005 | 1.0 | yes | | |
|
| V450 | 1005 | 1.0 |
|
||||||
| VX Revolution | 1006 | 1.0 | yes | | |
|
| VX Revolution | 1006 | 1.0 |
|
||||||
| VX Revolution | 100D | 1.0 | yes | | |
|
| VX Revolution | 100D | 1.0 |
|
||||||
| MX Air | 1007 | 1.0 | yes | | |
|
| MX Air | 1007 | 1.0 |
|
||||||
| MX Air | 100E | 1.0 | yes | | |
|
| MX Air | 100E | 1.0 |
|
||||||
| MX Revolution | 1008 | 1.0 | yes | | |
|
| MX Revolution | 1008 | 1.0 |
|
||||||
| MX Revolution | 100C | 1.0 | yes | | |
|
| MX Revolution | 100C | 1.0 |
|
||||||
|
|
||||||
### Trackballs (Unifying)
|
### Trackballs (Unifying)
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|-------------------|------|-------|---------|-------|---------------------------------|
|
|-------------------|------|-------|
|
||||||
| M570 Trackball | | 1.0 | yes | – | |
|
| M570 Trackball | | 1.0 |
|
||||||
| MX Ergo Trackball | | 2.0 | yes | – | |
|
| MX Ergo Trackball | | 2.0 |
|
||||||
|
|
||||||
### Touchpads (Unifying)
|
### Touchpads (Unifying)
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | DPI | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|------------------|------|-------|---------|-------|---------------------------------|
|
|------------------|------|-------|
|
||||||
| Wireless Touch | 4011 | 2.0 | yes | | |
|
| Wireless Touch | 4011 | 2.0 |
|
||||||
| T650 Touchpad | 4101 | 2.0 | yes | | smooth scrolling |
|
| T650 Touchpad | 4101 | 2.0 |
|
||||||
|
|
||||||
### Mice and Keyboards sold as combos
|
### Mice and Keyboards sold as combos
|
||||||
|
|
||||||
| Device | WPID | HID++ | Battery | Other supported features |
|
| Device | WPID | HID++ |
|
||||||
|------------------|------|-------|---------|-----------------------------------------|
|
|------------------|------|-------|
|
||||||
| MK220 | | 2.0 | yes | |
|
| MK220 | | 2.0 |
|
||||||
| MK270 | 4023 | 2.0 | yes | reprog keys |
|
| MK270 | 4023 | 2.0 |
|
||||||
| MK320 | 200F | | | |
|
| MK320 | 200F | |
|
||||||
| MK330 | | | | |
|
| MK330 | | |
|
||||||
| MK345 | 4023 | 2.0 | yes | reprog keys |
|
| MK345 | 4023 | 2.0 |
|
||||||
| MK520 | | M2/K1 | yes | FN swap, reprog keys |
|
| MK520 | | M2/K1 |
|
||||||
| MK550 | | | | |
|
| MK550 | | |
|
||||||
| MK700 | 2008 | 1.0 | yes | FN swap, reprog keys |
|
| MK700 | 2008 | 1.0 |
|
||||||
| MK710 | | 1.0 | yes | FN swap, reprog keys |
|
| MK710 | | 1.0 |
|
||||||
| EX100 keyboard | 0065 | 1.0 | yes | |
|
| EX100 keyboard | 0065 | 1.0 |
|
||||||
| EX100 mouse | 003f | 1.0 | yes | |
|
| EX100 mouse | 003f | 1.0 |
|
||||||
|
|
||||||
* The EX100 is an old, preunifying receiver and device set, supporting only part of HID++ 1.0 features
|
* 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
|
|
||||||
|
|
Loading…
Reference in New Issue