Plugin: USI Dock

Introduction

This plugin uses the MCU to write all the dock firmware components. The MCU version is provided by the DMC bcdDevice.

This plugin supports the following protocol ID:

  • com.usi.dock

GUID Generation

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

  • USB\VID_17EF&PID_7226

Additionally, some extra “component ID” instance IDs are added.

  • USB\VID_17EF&PID_7226&CID_USB3
  • USB\VID_17EF&PID_7226&CID_40B0&DMCVER_10.10

Update Behavior

The device usually presents in runtime mode, but on detach re-enumerates with the same USB PID in an unlocked mode. On attach the device again re-enumerates back to the runtime locked mode.

Vendor ID Security

The vendor ID is set from the USB vendor.

Quirk Use

This plugin uses the following plugin-specific quirks:

Flags=verfmt-hp

Use the HP-style quad version format.

Since: 1.7.4

Flags=set-chip-type

Workaround a provisioning problem by setting the chip type when the new update has completed.

Since: 1.9.2

External Interface Access

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

Version Considerations

This plugin has been available since fwupd version 1.7.4.

Owners

Anyone can submit a pull request to modify this plugin, but the following people should be consulted before making major or functional changes:

  • Victor Cheng: victor-cheng