proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-07-24 17:16:12 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
0cbcac93cd
fwupd/plugins/dell-dock
History
Richard Hughes 8ebad4ea75 Specify an enumerated problem when inhibiting devices 
This allows us to make smarter policy decisions in the future on when
to show unavailable updates. It also means we can show translated
text in the frond-end clients.

Only problems the user can "fix" are enumerated. For example, opening
the laptop lid, or charging the device battery.
2022-05-19 13:09:03 -05:00
..
dell-dock.quirk dell-dock: set minimum version of EC 2022-04-08 18:15:50 +08:00
fu-dell-dock-common.c trivial: Show why more devices are not marked as updatable 2022-01-13 16:04:31 +00:00
fu-dell-dock-common.h trivial: Show why more devices are not marked as updatable 2022-01-13 16:04:31 +00:00
fu-dell-dock-hid.c trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-dell-dock-hid.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-dell-dock-hub.c Add a flag to indicate the device is signed or unsigned 2022-02-22 19:12:06 +00:00
fu-dell-dock-hub.h dell-dock:Add atomic support 2021-10-28 19:32:22 +08:00
fu-dell-dock-i2c-ec.c Specify an enumerated problem when inhibiting devices 2022-05-19 13:09:03 -05:00
fu-dell-dock-i2c-ec.h dell-dock:Add atomic support 2021-10-28 19:32:22 +08:00
fu-dell-dock-i2c-mst.c Set the context in the right place more often 2022-03-16 09:18:29 +00:00
fu-dell-dock-i2c-mst.h Set the context in the right place more often 2022-03-16 09:18:29 +00:00
fu-dell-dock-i2c-tbt.c Set the context in the right place more often 2022-03-16 09:18:29 +00:00
fu-dell-dock-i2c-tbt.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-dell-dock-status.c Set the context in the right place more often 2022-03-16 09:18:29 +00:00
fu-dell-dock-status.h Set the context in the right place more often 2022-03-16 09:18:29 +00:00
fu-dell-dock-usb-usb4.c Add a flag to indicate the device is signed or unsigned 2022-02-22 19:12:06 +00:00
fu-dell-dock-usb-usb4.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-plugin-dell-dock.c Add plugin quirk keys earlier in the startup process 2022-05-09 11:13:52 +01:00
meson.build Convert build system to use meson tristate features 2022-02-28 08:34:48 -06:00
README.md trivial: update markdown for pre-commit style 2021-07-18 14:42:47 -05:00

README.md

Dell USB-C Dock

Dell System

Unlike previous Dell USB-C devices, a Dell system is not needed for updating.

Components

The device contains components the following directly updatable components:

  • USB hubs
  • MST controller
  • Thunderbolt controller
  • Embedded controller

This plugin is used to perform the update on the USB hubs as well as the Dell Embedded controller. The USB hubs are updated directly over a USB HID endpoint while the embedded controller is updated using an I2C over HID interface.

The fwupd thunderbolt plugin is used for updating the Titan Ridge controller.

The MST controller is updated through either the DP Aux interface (SynapticsMST plugin) or I2C over HID interface provided by this plugin.

Device topology

When this plugin is used, devices present in other plugins may be shown in the topology of this dock. This is intentional as this plugin works together with those plugins to manage the flashing of all components.

Firmware Format

The daemon will decompress the cabinet archive and extract several firmware blobs with an unspecified binary file format.

This plugin supports the following protocol ID:

  • com.dell.dock
  • com.synaptics.mst

GUID Generation

These devices use several different generation schemes, e.g.

  • USB Hub1: USB\VID_413C&PID_B06F&hub
  • USB Hub2: USB\VID_413C&PID_B06E&hub
  • Embedded Controller: USB\VID_413C&PID_B06E&hub&embedded
  • Update Level: USB\VID_413C&PID_B06E&hub&status
  • MST Hub: MST-panamera-vmm5331-259
  • Thunderbolt Controller: TBT-00d4b070
  • USB4 Controller: TBT-00d4b071

Update Behavior

All devices will be updated the next time the usb-c plug from the dock is unplugged from the host.

Vendor ID Security

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

Quirk Use

This plugin uses the following plugin-specific quirks:

DellDockUnlockTarget

The EC argument needed for unlocking certain device usage.

Since: 1.1.3

DellDockBlobMajorOffset

The offset of the major version number in a payload.

Since: 1.1.3

DellDockBlobMinorOffset

The offset of the minor version number in a payload

Since: 1.1.3

DellDockBlobBuildOffset

The offset of the build version number in a payload

Since: 1.1.3

DellDockBlobVersionOffset

The offset of the ASCII representation of a version string in a payload.

Since: 1.1.3

DellDockBoardMin

The minimum board revision required to safely operate the plugin.

Since: 1.1.3

DellDockVersionLowest

The minimum component version required to safely operate the plugin.

Since: 1.1.3

DellDockBoard*

The board description of a board revision.

Since: 1.1.3

DellDockInstallDurationI2C

The duration of time required to install a payload via I2C.

Since: 1.1.3

External Interface Access

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