proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2026-03-28 20:34:51 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
d1015cc2a2
fwupd/src
History
Richard Hughes d1015cc2a2 Do not show Unknown [***] for every client connection 
Ignore the initial client state change from UNKNOWN to IDLE which was being set
as part of the fix in fb36f22.

Fixes https://github.com/fwupd/fwupd/issues/2766
2021-01-14 14:22:36 +00:00
..
fuzzing libfwupdplugin: Subclass FuFirmware in FuSmbios 2021-01-05 15:59:30 +00:00
fu-agent.c Never iterate the global default main context 2021-01-11 09:13:46 +00:00
fu-config.c Cancel the file monitor before disposal to avoid a potential deadlock 2020-09-01 20:59:56 +01:00
fu-config.h Allow blocking specific firmware releases by checksum 2020-08-10 17:14:15 +01:00
fu-debug.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-debug.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-device-list.c Allow specifying more than one VendorID for a device 2021-01-04 22:30:20 +00:00
fu-device-list.h Correctly order devices when using logical parents 2020-09-14 10:13:33 -05:00
fu-engine-helper.c Allow firmware to require specific features from front-end clients 2020-06-27 15:43:57 +01:00
fu-engine-helper.h Move MOTD population into the daemon 2020-01-16 10:33:43 -06:00
fu-engine-request.c Allow firmware to require specific features from front-end clients 2020-06-27 15:43:57 +01:00
fu-engine-request.h Allow firmware to require specific features from front-end clients 2020-06-27 15:43:57 +01:00
fu-engine.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-engine.h Allow using fwupdtool as non-root for firmware commands 2020-12-10 20:43:54 +00:00
fu-firmware-dump.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-history.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-history.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-idle.c trivial: Always clear the mutex before clearing the thing it protects 2020-06-22 21:55:50 +01:00
fu-idle.h trivial: Remove G_BEGIN_DECLS from all private headers 2019-10-09 20:02:16 +01:00
fu-install-task.c trivial: Show what the device does support if the protocol match fails 2020-10-20 18:21:04 +01:00
fu-install-task.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-keyring-utils.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-keyring-utils.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-main.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-offline.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-plugin-list.c Export FwupdPlugin so we can convey enumerated system errors to the end user 2020-10-13 15:56:49 +01:00
fu-plugin-list.h trivial: Remove G_BEGIN_DECLS from all private headers 2019-10-09 20:02:16 +01:00
fu-polkit-agent.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-polkit-agent.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-progressbar.c Do not show Unknown [***] for every client connection 2021-01-14 14:22:36 +00:00
fu-progressbar.h trivial: Move progressbar out of libfwupdplugin 2019-11-27 08:18:02 -06:00
fu-remote-list.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-remote-list.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-security-attr.c Check the AMI test key if not installed for HSI-1 2021-01-05 17:09:02 +00:00
fu-security-attr.h Use the security attributes to construct a better name 2020-07-01 20:10:39 +01:00
fu-self-test.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-systemd.c trivial: Remove excess #include 2021-01-13 20:06:08 +00:00
fu-systemd.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-tool.c trivial: in the no updatable devices case, show error again 2021-01-14 07:40:07 -06:00
fu-util-common.c trivial: Show the translated update state in fwupdmgr 2021-01-13 10:21:20 -06:00
fu-util-common.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-util.c trivial: in the no updatable devices case, show error again 2021-01-14 07:40:07 -06:00
fwupd.gresource.xml Add initial build files and enough code to launch a simple D-Bus daemon 2015-02-26 18:16:40 +00:00
meson.build Make libarchive optional for fuzzing 2021-01-13 20:12:37 +00:00
org.freedesktop.fwupd.xml trivial: Remove traces of the UA HSI suffixes 2020-11-06 09:57:03 +00:00
README.md Allow server metadata to set the version format on some devices 2020-02-26 15:45:40 +00:00
scripting.txt Add a section to man page on scripting 2020-11-11 12:50:13 -06:00

README.md

Quirk use

Quirks are defined by creating an INI style file in the compiled in quirk location (typically /usr/share/fwupd/quirks.d).

The quirk is declared by creating a group based upon the DeviceInstanceId or GUID and then mapping out values to keys.

All plugins

All fwupd devices support the following quirks:

Plugin

Sets the plugin to use for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the plugin name, e.g. csr
  • Minimum fwupd version: 1.1.0

Flags

Assigns optional quirks to use for a 8bitdo device

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the quirk, e.g. is-bootloader
  • Supported values:
    • none: no device quirks
    • is-bootloader: device is in bootloader mode
  • Minimum fwupd version: 1.0.3

Summary

Sets a summary for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • the device summary, e.g. An open source display colorimeter
  • Minimum fwupd version: 1.0.2

Icon

Adds an icon name for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the device icon name, e.g. media-removable
  • Minimum fwupd version: 1.0.2

Name

Sets a name for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the device name, e.g. ColorHug
  • Minimum fwupd version: 1.0.2

Guid

Adds an extra GUID for a specific hardware device. If the value provided is not already a suitable GUID, it will be converted to one.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the GUID, e.g. 537f7800-8529-5656-b2fa-b0901fe91696
  • Minimum fwupd version: 1.0.3

CounterpartGuid

Adds an counterpart GUID for a specific hardware device. If the value provided is not already a suitable GUID, it will be converted to one. A counterpart GUID is typically the GUID of the same device in bootloader or runtime mode, if they have a different device PCI or USB ID. Adding this type of GUID does not cause a "cascade" by matching using the quirk database.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the GUID, e.g. 537f7800-8529-5656-b2fa-b0901fe91696
  • Minimum fwupd version: 1.1.2

ParentGuid

Adds an extra GUID to mark as the parent device. If the value provided is not already a suitable GUID, it will be converted to one.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the GUID, e.g. 537f7800-8529-5656-b2fa-b0901fe91696
  • Minimum fwupd version: 1.1.2

Children

Adds one or more virtual devices to a physical device. To set the object type of the child device use a pipe before the object type, for instance: FuRts54xxDeviceUSB\VID_0763&PID_2806&I2C_01 If the type of device is not specified the parent device type is used. If the values provided are not already suitable GUIDs, they will be converted.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: The virtual device, delimited by a comma
  • Minimum fwupd version: 1.1.2

Vendor

Sets a vendor name for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the vendor, e.g. Hughski Limited
  • Minimum fwupd version: 1.0.3

VendorId

Sets a vendor ID for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: the vendor, e.g. USB:0x123A
  • Minimum fwupd version: 1.1.2

Version

Sets a version for a specific hardware device.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: Version number, e.g. 1.2
  • Minimum fwupd version: 1.0.3

FirmwareSizeMin

Sets the minimum allowed firmware size.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: A number in bytes, e.g. 512
  • Minimum fwupd version: 1.1.2

FirmwareSizeMax

Sets the maximum allowed firmware size.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: A number in bytes, e.g. 1024
  • Minimum fwupd version: 1.1.2

InstallDuration

Sets the estimated time to flash the device

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: A number in seconds, e.g. 60
  • Minimum fwupd version: 1.1.3

VersionFormat

Sets the version format the device should use for conversion.

  • Key: the device ID, e.g. DeviceInstanceId=USB\VID_0763&PID_2806
  • Value: The quirk format, e.g. quad
  • Minimum fwupd version: 1.2.0

Plugin specific

Plugins may add support for additional quirks that are relevant only for those plugins. View them by looking at the README.md in plugin directories.

Example

Here is an example as seen in the CSR plugin.

[DeviceInstanceId=USB\VID_0A12&PID_1337]
Plugin = csr
Name = H05
Summary = Bluetooth Headphones
Icon = audio-headphones
Vendor = AIAIAI
[DeviceInstanceId=USB\VID_0A12&PID_1337&REV_2520]
Version = 1.2

Additional samples can be found in other plugins.