proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2026-03-28 08:01:05 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
3dbf5fa8a4
fwupd/plugins/corsair
History
Richard Hughes c4b7f42e43 Only compress one version of the builtin-quirks 
Saving the quirks in the GResource section worked well, but it made the build
system very complicated and also meant the .data section was duplicated in
both `fwupd` and `fwupdtool` -- negating a lot of the hard-fought savings.

Simplify this feature so that we just `cat` all the quirk files together, then
gzip them into a single file. This means that at startup fwupd only needs to
check the mtime of one file, and weirdly it's actually faster to load a smaller
compressed file from disk that it is to load multiple uncompressed files.
2022-09-27 12:44:04 +01:00
..
corsair.quirk corsair: remove support for some devices 2022-09-02 14:39:19 +03:00
fu-corsair-bp.c corsair: Fix trivial -Wformat issue 2022-07-11 09:53:36 +01:00
fu-corsair-bp.h corsair: Flush input endpoint before sending commands 2022-06-06 07:51:16 +01:00
fu-corsair-common.c Remove the 'common' prefix when parsing version numbers 2022-06-14 14:36:52 -05:00
fu-corsair-common.h corsair: Use hex format constants 2022-07-21 15:28:24 +01:00
fu-corsair-device.c corsair: Fix two g_prefix_error() typos 2022-07-21 15:28:24 +01:00
fu-corsair-device.h corsair: add support for new devices 2022-05-26 09:21:35 +01:00
fu-plugin-corsair.c corsair: add support for new devices 2022-05-26 09:21:35 +01:00
meson.build Only compress one version of the builtin-quirks 2022-09-27 12:44:04 +01:00
README.md corsair: add support for new devices 2022-05-26 09:21:35 +01:00

README.md

Corsair

Introduction

This plugin allows to update firmware on Corsair mice and receivers:

  • SABRE RGB PRO WIRELESS
  • SLIPSTREAM WIRELESS USB Receiver
  • KATAR PRO WIRELESS
  • KATAR PRO XT Gaming Mouse
  • SABRE PRO Gaming Mouse

Code structure

All devices handled by one object (FuCorsairDevice). Receivers with wireless-only devices will be shown as two entities: parent device as a receiver and wireless device as a child. Difference in behavior is handled by private flags.

FuCorsairBp contains low-level protocol related routines. Device objects should call correct versions of these routines in order to update firmware. Correct routines chosen by device quirsks and private flags.

Wired mice update behavior

Mice and/or it's wireless adapter must be connected to host via USB cable to apply an update. The device is switched to bootloader mode to flash updates, and is reset automatically to new firmware after flashing.

Wireless mice update behavior

The receiver should be connected to host and the mouse should be turned on and not sleeping.

Quirk Use

This plugin uses the following plugin-specific quirks:

CorsairVendorInterfaceId

Some devices have non-standard USB interface for protocol communication. This quirk should be set if protocol interface is not 1.

Since: 1.8.0

CorsairSubdeviceId

Specifies ID of any wireless child device which can be updated. Polling will be turned on if a subdevice is not connected when parent is being probed.

Flags:legacy-attach

This flag is used if legacy attach command should be used

Flags:no-version-in-bl

This flag handles cases if device reports incorrect firmware version in bootloader mode.

Flags:is-subdevice

This flag tells device that it is a child device. All subdevice behavior tweaks will be applied.