File: README.md

package info (click to toggle)
fwupd 2.0.20-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 32,504 kB
  • sloc: ansic: 277,388; python: 11,485; xml: 9,493; sh: 1,625; makefile: 167; cpp: 19; asm: 11; javascript: 9
file content (47 lines) | stat: -rw-r--r-- 1,304 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
---
title: Plugin: Intel USB4
---

## Introduction

This plugin supports the Goshen Ridge hardware which is a USB-4 controller from Intel.
These devices can updated using multiple interfaces, but this plugin only uses the XHCI interface.

## Firmware Format

The daemon will decompress the cabinet archive and extract a firmware blob in
an unspecified binary file format, with vendor specific header.

This plugin supports the following protocol ID:

* `com.intel.thunderbolt`

## GUID Generation

These devices use the standard USB DeviceInstanceId values for the USB Hub, e.g.

* `USB\VID_8087&PID_0B40` (quirk-only)

These devices also use a custom InstanceId, which is quite intentionally identical to thunderbolt
plugin:

* `TBT-{nvm_vendor_id}{nvm_product_id}`

## Update Behavior

By default the USB4 controller will reboot at the end of the update.

Some devices (e.g. inside some Dell docks) will instead be updated the next time the USB-C plug
from the dock is unplugged from the host, or when activated manually.

## Vendor ID Security

The vendor ID is set from the USB vendor, in this instance set to `USB:0x8087`

## External Interface Access

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

## Version Considerations

This plugin has been available since fwupd version `1.8.5`.