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
|
||||
---
|
||||
|
||||
# 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
|
||||
|
|
Loading…
Reference in New Issue