proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-08-06 02:57:48 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
aeba5f7f53
fwupd/plugins/vli
History
Richard Hughes b3f9841924 Support more than one protocol for a given device 
Devices may want to support more than one protocol, and for some devices
(e.g. Unifying peripherals stuck in bootloader mode) you might not even be able
to query for the correct protocol anyway.
2021-03-01 16:14:36 +00:00
..
fu-plugin-vli.c Use FWUPD_COMPILATION define to indicate an in tree build 2021-01-22 14:01:25 -06:00
fu-self-test.c vli: Allow setting the device kind from a quirk 2020-01-02 13:24:13 +00:00
fu-vli-common.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-common.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-device.c Add a new internal flag to opt-in to GUID matching 2021-02-25 15:47:25 +00:00
fu-vli-device.h vli: Fix VL103 reboot from ROM mode to FW mode 2020-03-10 10:46:01 +00:00
fu-vli-pd-common.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-pd-common.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-pd-device.c Support more than one protocol for a given device 2021-03-01 16:14:36 +00:00
fu-vli-pd-device.h vli: Add support for standalone Single PD devices 2020-01-02 13:24:13 +00:00
fu-vli-pd-firmware.c Add fu_firmware_set_version_raw() 2021-02-16 15:24:29 +00:00
fu-vli-pd-firmware.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-pd-parade-device.c Support more than one protocol for a given device 2021-03-01 16:14:36 +00:00
fu-vli-pd-parade-device.h vli: Add support for the PS186 device 2020-02-11 12:08:37 +00:00
fu-vli-usbhub-common.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-usbhub-common.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-usbhub-device.c Support more than one protocol for a given device 2021-03-01 16:14:36 +00:00
fu-vli-usbhub-device.h vli: Rename FuVliUsbhubI2cDevice to FuVliUsbhubMsp430Device 2020-07-22 20:04:20 +01:00
fu-vli-usbhub-firmware.c Add fu_firmware_set_version_raw() 2021-02-16 15:24:29 +00:00
fu-vli-usbhub-firmware.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-usbhub-i2c-common.c Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-usbhub-i2c-common.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-usbhub-msp430-device.c Support more than one protocol for a given device 2021-03-01 16:14:36 +00:00
fu-vli-usbhub-msp430-device.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
fu-vli-usbhub-pd-device.c Support more than one protocol for a given device 2021-03-01 16:14:36 +00:00
fu-vli-usbhub-pd-device.h vli: Get the new firmware version when updating the PD device 2020-10-18 07:35:46 +01:00
fu-vli-usbhub-rtd21xx-device.c Support more than one protocol for a given device 2021-03-01 16:14:36 +00:00
fu-vli-usbhub-rtd21xx-device.h Only include the start year in the copyright header 2021-01-07 14:48:16 +00:00
meson.build Move the plugin build logic to the plugins themselves 2021-02-18 14:46:20 +00:00
README.md Add external interface messages 2020-10-26 12:05:20 -05:00
vli-pd.quirk vli: Fix the quirk key name for the Lenovo HDMI with power 2021-02-25 15:47:25 +00:00
vli-usbhub-hyper.quirk vli: Add support for Hyper hardware 2020-10-26 10:08:00 +00:00
vli-usbhub-lenovo.quirk trivial: tr_gen2 has same rtd21xx as mini dock 2020-11-16 08:50:25 +00:00
vli-usbhub.quirk vli: Define the device GType in the quirk file 2020-01-02 13:24:13 +00:00

README.md

VIA Support

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.

  • VLI_USBHUB\SPI_37303840
  • VLI_USBHUB\SPI_3730
  • VLI_USBHUB\SPI_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:

Quirk Description Minimum fwupd version
DeviceKind Device kind, e.g. VL102 1.3.7
SpiAutoDetect SPI autodetect (default 0x1) 1.3.7
SpiCmdChipErase Flash command to erase chip 1.3.3
SpiCmdChipErase Flash command to erase sector 1.3.3
SpiCmdReadId Flash command to read the ID 1.3.3
SpiCmdReadIdSz Size of the ReadId response 1.3.3

The SpiCmdReadId and SpiCmdReadIdSz 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:

[DeviceInstanceId=USB\VID_2109&PID_0210]
Plugin = vli
GType = FuVliUsbhubDevice
SpiCmdReadId = 0xf8
SpiCmdReadIdSz = 4

# W3IRDFLASHxxx
[Guid=VLI_USBHUB\\SPI_37303840]
SpiCmdChipErase = 0xc7
SpiCmdSectorErase = 0x20

External interface access

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