fwupd/plugins/synapticsmst
Richard Hughes c125ec02ed Clarify what the platform ID actually is by renaming it
It wasn't hugely clear what the platform ID was actually meant to represent. In
some cases it was being used like a physical ID, in others it was a logical ID,
and in others it was both. In some cases it was even used as a sysfs path.

Clear up all the confusion by splitting the platform ID into two parts, an
optional *physical* ID to represent the electrical connection, and an optional
*logical* ID to disambiguate composite devices with the same physical ID.

Also create an explicit sysfs_path getter for FuUdevDevice to make this clear.

This allows WAIT_FOR_REPLUG to always work, rather than depending on the order
that the GUIDs were added, and that the kernel would always return the same
sysfs path (which it doesn't have to do, especially for hidraw devices).
2018-09-06 16:22:46 +01:00
..
tests synapticsmst: add a test suite 2017-02-02 21:43:42 -06:00
fu-plugin-synapticsmst.c Clarify what the platform ID actually is by renaming it 2018-09-06 16:22:46 +01:00
fu-self-test.c trivial: Remove duplicate header includes 2018-09-04 08:22:39 -05:00
meson.build synapticsmst: Set parentage for Dell WD15/TB16/TB18 docks through quirks 2018-08-28 18:30:00 +01:00
README.md trivial: synaptics: update the device name to be more sensible 2017-02-01 16:43:50 -06:00
synapticsmst-common.c synapticsmst: Plumb error handling everywhere return codes are used 2018-08-13 11:11:27 -05:00
synapticsmst-common.h synapticsmst: Plumb error handling everywhere return codes are used 2018-08-13 11:11:27 -05:00
synapticsmst-device.c synapticsmst: Allow using a custom flag 'skip-restart' 2018-08-29 07:55:27 +01:00
synapticsmst-device.h trivial: Remove duplicate header includes 2018-09-04 08:22:39 -05:00
synapticsmst.quirk trivial: move all Dell dock related quirks into dell.quirk 2018-09-05 08:10:52 -05:00

Synaptics MST

This plugin supports querying and flashing Synaptics MST hubs used in Dell systems and docks.

Requirements

(Kernel) DP Aux Interface

Kernel 4.6 introduced an DRM DP Aux interface for manipulation of the registers needed to access an MST hub. This patch can be backported to earlier kernels: e94cb37b34

libsmbios

At compilation time and runtime you will need libsmbios_c version 2.3.0 or later

If you don't want or need this functionality you can use the --disable-dell option.

Usage

Supported devices will be displayed in # fwupdmgr get-devices output.

Here is an example output from a Dell WD15 dock:

Dell WD15/TB16 wired Dock Synaptics VMM3332
  Guid:                 653cd006-5433-57db-8632-0413af4d3fcc
  DeviceID:             MST-1-1-0-0
  Plugin:               synapticsmst
  Flags:                allow-online
  Version:              3.10.002
  Created:              2017-01-13
  Modified:             2017-01-13
  Trusted:              none

Payloads can be flashed just like any other plugin from LVFS.

Supported devices

Not all Dell systems or accessories contain MST hubs. Here is a sample list of systems known to support them however:

  1. Dell WD15 dock
  2. Dell TB16 dock
  3. Latitude E5570
  4. Latitude E5470
  5. Latitude E5270
  6. Latitude E7470
  7. Latitude E7270
  8. Latitude E7450
  9. Latitude E7250
  10. Latitude E5550
  11. Latitude E5450
  12. Latitude E5250
  13. Latitude Rugged 5414
  14. Latitude Rugged 7214
  15. Latitude Rugged 7414