fwupd/plugins/vli-usbhub
Richard Hughes 679d1c0f9a Add a plugin to update VIA USB hub hardware
Only protocol V1 hardware (VL810~VL813) is currently supported.
2019-10-24 12:52:18 +01:00
..
fu-plugin-vli-usbhub.c Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
fu-vli-usbhub-common.c Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
fu-vli-usbhub-common.h Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
fu-vli-usbhub-device.c Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
fu-vli-usbhub-device.h Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
fu-vli-usbhub-firmware.c Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
fu-vli-usbhub-firmware.h Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
meson.build Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
README.md Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00
vli-usbhub.quirk Add a plugin to update VIA USB hub hardware 2019-10-24 12:52:18 +01:00

VIA USB Hub 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.via.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

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

Quirk Use

This plugin uses the following plugin-specific quirks:

Quirk Description Minimum fwupd version
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 requried to query the other flash chip parameters. For example:

[DeviceInstanceId=USB\VID_2109&PID_0210]
Plugin = vli_usbhub
SpiCmdReadId = 0xf8
SpiCmdReadIdSz = 4

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