proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-05-14 21:57:34 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
0143c67c76
fwupd/plugins/vli
History
Richard Hughes 83a21cb7cd vli: Allow chained usb hub devices where the parent needs GPIOB reset 
As both hub devices share a FuVliUsbhubDeviceClass instance we cannot 'hijack'
the vfuncs depending on object type. This allows the downstream hub to proxy to
the upstream hub where a GPIOB reset can be performed.
2020-06-09 11:56:30 +01:00
..
fu-plugin-vli.c vli: Only reboot the USB hub once 2020-04-02 13:23:40 +01: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 vli: Add support for the PS186 device 2020-02-11 12:08:37 +00:00
fu-vli-common.h vli: Add support for the PS186 device 2020-02-11 12:08:37 +00:00
fu-vli-device.c vli: Add no-guid-matching for all VLI devices 2020-05-15 16:38:18 +01: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 vli: Rename FuVliUsbhubPdFirmware to FuVliPdFirmware 2020-01-02 13:24:13 +00:00
fu-vli-pd-common.h vli: Always expect the VL103 header at 0x1003 or 0x4000 2020-03-10 12:09:27 +00:00
fu-vli-pd-device.c vli: Do not modify the class vfuncs depending on device type 2020-06-09 11:30:49 +01: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 vli: Fix compile warning introduced in 75cc9161c5 2020-03-10 12:16:09 +00:00
fu-vli-pd-firmware.h vli: Always expect the VL103 header at 0x1003 or 0x4000 2020-03-10 12:09:27 +00:00
fu-vli-pd-parade-device.c Decouple the version format from the version itself 2020-02-25 14:00:09 +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 vli: Do not fall back to the recovery write for usbhubs 2020-03-10 12:07:28 +00:00
fu-vli-usbhub-common.h vli: Have one 'DeviceKind' for all objects 2020-01-02 13:24:13 +00:00
fu-vli-usbhub-device.c vli: Allow chained usb hub devices where the parent needs GPIOB reset 2020-06-09 11:56:30 +01:00
fu-vli-usbhub-device.h trivial: Fix up some argument names with additional docs 2020-03-19 06:43:42 +00:00
fu-vli-usbhub-firmware.c vli: Have one 'DeviceKind' for all objects 2020-01-02 13:24:13 +00:00
fu-vli-usbhub-firmware.h vli: Have one 'DeviceKind' for all objects 2020-01-02 13:24:13 +00:00
fu-vli-usbhub-i2c-common.c vli: Have one 'DeviceKind' for all objects 2020-01-02 13:24:13 +00:00
fu-vli-usbhub-i2c-common.h vli: Fix the error enum values for the MSP430 2020-03-10 15:09:15 +00:00
fu-vli-usbhub-i2c-device.c vli: Port to fu_device_retry() 2020-03-28 12:46:03 +00:00
fu-vli-usbhub-i2c-device.h vli: Rename the vli_usbhub plugin to vli 2020-01-02 13:24:13 +00:00
fu-vli-usbhub-pd-device.c vli: Add two standard USB instance IDs for shared-PD devices 2020-04-30 11:06:28 +01:00
fu-vli-usbhub-pd-device.h vli: Rename FuVliUsbhubPdFirmware to FuVliPdFirmware 2020-01-02 13:24:13 +00:00
meson.build vli: Add support for the PS186 device 2020-02-11 12:08:37 +00:00
README.md vli: Add support for the PS186 device 2020-02-11 12:08:37 +00:00
vli-pd.quirk vli: Remove a copy-and-paste mistake 2020-05-15 16:38:18 +01:00
vli-usbhub-lenovo.quirk vli: Use GPIOB to reset the VL817 found in two Lenovo products 2020-04-30 11:06:28 +01: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 just one extra GUID, e.g.

  • USB\VID_17EF&PID_3083&DEV_VL102

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