#### Plugin: Lenovo Dock

## Introduction

The Lenovo dock plugin is used by various Lenovo docking stations.

## Firmware Format

The daemon will decompress the cabinet archive and extract two firmware binary files from a zip archive payload. In this zip file there must be two files:

- `*_composite_image.bin`
- `*_usage_information_table.bin`

This plugin supports the following protocol ID:

- `com.lenovo.dock`

## GUID Generation

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

- `HIDRAW\VEN_17EF&DEV_111E`

## Update Behavior

The device is unlocked and the firmware images are sent to the device. The dock is then rebooted where the firmware is written, and then the dock re-appears.

## Quirk Use

This plugin uses the following plugin-specific quirks:

### LenovoDockImagePid

The PID to expect from the image, falling back to the device PID if not set.

Since: 2.1.2

## Vendor ID Security

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

## External Interface Access

This plugin requires read/write access to `/dev/hidraw*`.

## Version Considerations

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