fwupd

mirror of https://git.proxmox.com/git/fwupd synced 2025-06-04 16:05:11 +00:00

History

Richard Hughes 99df74f0c2 Add API to wait for a device This allows us to ignore all the delays when the device is emulated, with the idea being to do dozens of device emulations in the CI tests. Also, do not call fu_progress_sleep() when the device is emulated.		2023-02-01 09:42:08 +00:00
..
fu-self-test.c	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-common.c	Add a flag to indicate the device is signed or unsigned	2022-02-22 19:12:06 +00:00
fu-vli-common.h	Add a flag to indicate the device is signed or unsigned	2022-02-22 19:12:06 +00:00
fu-vli-device.c	Add API to wait for a device	2023-02-01 09:42:08 +00:00
fu-vli-device.h	Share the Common Flash Memory Interface quirks between plugins	2021-10-20 12:19:39 +01:00
fu-vli-pd-common.c	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-pd-common.h	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-pd-device.c	Add API to wait for a device	2023-02-01 09:42:08 +00:00
fu-vli-pd-device.h	trivial: Remove the class structs for types that use G_DECLARE_FINAL_TYPE	2022-05-21 12:19:50 +01:00
fu-vli-pd-firmware.c	Set the firmware contents even when subclassing ->parse()	2022-09-10 09:16:05 +01:00
fu-vli-pd-firmware.h	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-pd-parade-device.c	Add API to wait for a device	2023-02-01 09:42:08 +00:00
fu-vli-pd-parade-device.h	trivial: Remove the class structs for types that use G_DECLARE_FINAL_TYPE	2022-05-21 12:19:50 +01:00
fu-vli-plugin.c	Build many more plugins as builtin	2022-09-28 17:01:23 +01:00
fu-vli-plugin.h	Build many more plugins as builtin	2022-09-28 17:01:23 +01:00
fu-vli-usbhub-common.c	Split out the string helpers to a new source file	2022-06-14 14:36:52 -05:00
fu-vli-usbhub-common.h	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-usbhub-device.c	Add API to wait for a device	2023-02-01 09:42:08 +00:00
fu-vli-usbhub-device.h	trivial: Remove the class structs for types that use G_DECLARE_FINAL_TYPE	2022-05-21 12:19:50 +01:00
fu-vli-usbhub-firmware.c	Set the firmware contents even when subclassing ->parse()	2022-09-10 09:16:05 +01:00
fu-vli-usbhub-firmware.h	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-usbhub-i2c-common.c	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-usbhub-i2c-common.h	trivial: reformat the whole tree to match new format	2021-08-24 11:18:40 -05:00
fu-vli-usbhub-msp430-device.c	Add API to wait for a device	2023-02-01 09:42:08 +00:00
fu-vli-usbhub-msp430-device.h	trivial: Remove the class structs for types that use G_DECLARE_FINAL_TYPE	2022-05-21 12:19:50 +01:00
fu-vli-usbhub-pd-device.c	trivial: Add new convenience API to make plugins simpler	2022-12-20 20:54:12 +00:00
fu-vli-usbhub-pd-device.h	trivial: Remove the class structs for types that use G_DECLARE_FINAL_TYPE	2022-05-21 12:19:50 +01:00
fu-vli-usbhub-rtd21xx-device.c	Add API to wait for a device	2023-02-01 09:42:08 +00:00
fu-vli-usbhub-rtd21xx-device.h	trivial: Remove the class structs for types that use G_DECLARE_FINAL_TYPE	2022-05-21 12:19:50 +01:00
meson.build	trivial: Ensure that G_TEST_SRCDIR is set for all self tests	2023-01-04 07:24:01 -06:00
README.md	Include the plugin README text in the generated docs	2023-01-10 14:58:30 +00:00
vli-bizlink.quirk	vli: Make the quirk files per-vendor and don't add all of them	2022-02-24 19:59:34 +00:00
vli-dell.quirk	vli: Make the quirk files per-vendor and don't add all of them	2022-02-24 19:59:34 +00:00
vli-goodway.quirk	vli: Remove the incorrect ParentGuid to prevent confusion	2022-10-07 16:25:27 -07:00
vli-hyper.quirk	vli: Make the quirk files per-vendor and don't add all of them	2022-02-24 19:59:34 +00:00
vli-lenovo.quirk	vli: Move more devices out of the installed list	2022-03-19 10:16:59 +00:00
vli-noinst.quirk	vli: Move more devices out of the installed list	2022-03-19 10:16:59 +00:00
vli-samsung.quirk	vli: Make the quirk files per-vendor and don't add all of them	2022-02-24 19:59:34 +00:00

README.md

title: Plugin: VIA

Introduction

This plugin is used to update USB hubs from VIA.

Firmware Format

The daemon will decompress the cabinet archive and extract a firmware blob in an undisclosed binary file format.

This plugin supports the following protocol ID:

com.vli.i2c
com.vli.pd
com.vli.usbhub

GUID Generation

These devices use the standard USB DeviceInstanceId values, e.g.

USB\VID_17EF&PID_3083&REV_0001
USB\VID_17EF&PID_3083
USB\VID_17EF

All VLI devices also use custom GUID values for the device type, e.g.

USB\VID_17EF&PID_3083&DEV_VL812B3

These devices also use custom GUID values for the SPI flash configuration, e.g.

CFI\FLASHID_37303840
CFI\FLASHID_3730
CFI\FLASHID_37

Optional PD child devices sharing the SPI flash use two extra GUIDs, e.g.

USB\VID_17EF&PID_3083&DEV_VL102
USB\VID_17EF&PID_3083&APP_26

Optional I²C child devices use just one extra GUID, e.g.

USB\VID_17EF&PID_3083&I2C_MSP430
USB\VID_17EF&PID_3083&I2C_PS186

Vendor ID Security

The vendor ID is set from the USB vendor, for example set to USB:0x2109

Quirk Use

This plugin uses the following plugin-specific quirks:

VliDeviceKind

Device kind, e.g. VL102.

Since: 1.3.7

VliSpiAutoDetect

SPI autodetect (default 0x1).

Since: 1.3.7

CfiDeviceCmdReadId

Flash command to read the ID.

Since: 1.3.3

CfiDeviceCmdReadIdSz

Size of the ReadId response.

The CfiDeviceCmdReadId and CfiDeviceCmdReadIdSz quirks have to be assigned to the device instance attribute, rather then the flash part as the ID is required to query the other flash chip parameters. For example:

[USB\VID_2109&PID_0210]
Plugin = vli
GType = FuVliUsbhubDevice
CfiDeviceCmdReadId = 0xf8
CfiDeviceCmdReadIdSz = 4

# W3IRDFLASHxxx
[CFI\\FLASHID_37303840]
CfiDeviceCmdChipErase = 0xc7
CfiDeviceCmdSectorErase = 0x20

External Interface Access

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