mirror of
https://git.proxmox.com/git/fwupd
synced 2026-03-27 16:09:15 +00:00
6235a8222a
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.
94 lines
1.9 KiB
Markdown
94 lines
1.9 KiB
Markdown
# 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`.
|