fwupd/plugins/vli
Richard Hughes 6235a8222a Share the Common Flash Memory Interface quirks between plugins
Now two plugins are using hardcoded SPI constants for various CFI chips,
and it makes sense to have some common quirk data that can be used by
both.

Add a FuSpiChip helper object that can be used by FuDevice subclasses
to get the specific SPI commands to use for each flash ID.
2021-10-20 12:19:39 +01:00
..
fu-plugin-vli.c Share the Common Flash Memory Interface quirks between plugins 2021-10-20 12:19:39 +01: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 trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-common.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-device.c Share the Common Flash Memory Interface quirks between plugins 2021-10-20 12:19:39 +01: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 Share the Common Flash Memory Interface quirks between plugins 2021-10-20 12:19:39 +01:00
fu-vli-pd-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-pd-firmware.c trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05: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 vli: Fix a potential crash when dumping Parade devices 2021-10-12 09:42:59 -05:00
fu-vli-pd-parade-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-usbhub-common.c trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -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 Share the Common Flash Memory Interface quirks between plugins 2021-10-20 12:19:39 +01:00
fu-vli-usbhub-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-usbhub-firmware.c trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05: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 Allow using a per-device global percentage completion 2021-09-13 14:28:15 +01:00
fu-vli-usbhub-msp430-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-usbhub-pd-device.c Restore the ABI for fu_device_detach() and provide new symbols 2021-09-17 16:35:21 +01:00
fu-vli-usbhub-pd-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-vli-usbhub-rtd21xx-device.c trivial: Remove some instances of 'slave' that crept in 2021-09-24 20:46:28 +01:00
fu-vli-usbhub-rtd21xx-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
meson.build Added VID PID for Minibons device 2021-05-26 10:22:29 +01:00
README.md Share the Common Flash Memory Interface quirks between plugins 2021-10-20 12:19:39 +01:00
vli-pd.quirk Mark the Lenovo VL103 no-power USB-C dongle as dual-image 2021-04-13 07:01:40 +01:00
vli-usbhub-bizlink.quirk vli: Remove deprecated quirk prefixes 2021-04-01 18:40:14 +01:00
vli-usbhub-hyper.quirk Simplify the quirk file format 2021-03-03 08:30:34 +00:00
vli-usbhub-lenovo.quirk vli: Be more specific when matching the MSP430 2021-06-17 17:09:48 +01:00
vli-usbhub-minibons.quirk Set hub2.0 as subcomponent of hub3.0 2021-05-27 18:52:00 +08:00
vli-usbhub.quirk Share the Common Flash Memory Interface quirks between plugins 2021-10-20 12:19:39 +01:00

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.