proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-06-12 03:02:21 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
ad461d504d
fwupd/plugins/cfu
History
Richard Hughes a61bb37881 Build the quirk files into the daemon as a GResource 
Interestingly, this increases the `fwupd` binary size by ~30kb but
reduces the installed size of /usr/share/fwupd/quirks.d by ~330kb.
2022-06-30 18:52:24 +01:00
..
cfu.quirk cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00
fu-cfu-device.c Split out the memory helpers to a new source file 2022-06-14 14:36:52 -05:00
fu-cfu-device.h cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00
fu-cfu-module.c Remove the 'common' prefix when parsing version numbers 2022-06-14 14:36:52 -05:00
fu-cfu-module.h cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00
fu-plugin-cfu.c Speed up the daemon startup by ~2% by doing dlsym much less 2021-11-09 12:02:07 +00:00
meson.build Build the quirk files into the daemon as a GResource 2022-06-30 18:52:24 +01:00
README.md cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00

README.md

Component Firmware update

Introduction

CFU is a protocol from Microsoft to make it easy to install firmware on HID devices.

This protocol is unique in that it requires has a pre-download phase before sending the firmware to the microcontroller. This is so the device can check if the firmware is required and compatible. CFU also requires devices to be able to transfer the entire new transfer mode in runtime mode.

See https://docs.microsoft.com/en-us/windows-hardware/drivers/cfu/cfu-specification for more details.

This plugin supports the following protocol ID:

  • com.microsoft.cfu

GUID Generation

These devices use standard USB DeviceInstanceId values, as well as two extra for the component ID and the bank, e.g.

  • HIDRAW\VEN_17EF&DEV_7226&CID_01&BANK_1
  • HIDRAW\VEN_17EF&DEV_7226&CID_01
  • HIDRAW\VEN_17EF&DEV_7226

Update Behavior

The device has to support runtime updates and does not have a detach-into-bootloader mode -- but after the install has completed the device still has to reboot into the new firmware.

Vendor ID Security

The vendor ID is set from the USB vendor, in this instance set to HIDRAW:0x17EF

External Interface Access

This plugin requires read/write access to /dev/bus/usb.