proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-06-05 00:17:54 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
0cbcac93cd
fwupd/plugins/cfu
History
Richard Hughes c4ca026294 Allow devices to build instance IDs more easily 
Provide a device instance builder that allows plugins to easily
create multiple instance IDs based on parent attributes.

Also fix a lot of the instance ID orders, so that we add more generic
IDs first, and more specific IDs after.
2022-03-03 09:13:29 +00:00
..
cfu.quirk cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00
fu-cfu-device.c cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00
fu-cfu-device.h cfu: Add an initial outline CFU plugin 2021-10-15 18:38:36 +01:00
fu-cfu-module.c Allow devices to build instance IDs more easily 2022-03-03 09:13:29 +00: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 Convert build system to use meson tristate features 2022-02-28 08:34:48 -06: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.