mirror of
https://git.proxmox.com/git/fwupd
synced 2025-05-09 13:42:49 +00:00
56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# Realtek MST
|
|
|
|
## Introduction
|
|
|
|
This plugin updates the firmware of DisplayPort MST hub devices made by Realtek,
|
|
such as the RTD2141b and RTD2142.
|
|
|
|
These devices communicate over I²C, via the DisplayPort aux channel. Devices
|
|
are declared by system firmware, and quirks specify the aux channel to which
|
|
the device is connected for a given system.
|
|
|
|
System firmware must specify the device's presence because while they can be
|
|
identified partially through the presence of Realtek's OUI in the Branch
|
|
Device OUI fields of DPCD (DisplayPort Configuration Data), they do not have
|
|
unique Device Identification strings.
|
|
|
|
This plugin was neither written, verified, supported or endorsed by Realtek
|
|
Semiconductor Corp.
|
|
|
|
## Firmware Format
|
|
|
|
The daemon will decompress the cabinet archive and extract a firmware blob in
|
|
an unspecified binary file format, which is written to the partition of the
|
|
device flash that is not currently running.
|
|
|
|
This plugin supports the following protocol ID:
|
|
|
|
* com.realtek.rtd2142
|
|
|
|
## GUID Generation
|
|
|
|
Devices use custom DeviceInstanceId values derived from device names
|
|
provided by system firmware and read from sysfs, like:
|
|
|
|
* REALTEK-MST\NAME_10EC2142:00
|
|
* REALTEK-MST\NAME_10EC2142:00&FAMILY_Google_Hatch
|
|
|
|
## Quirk Use
|
|
|
|
This plugin uses the following plugin-specific quirks:
|
|
|
|
### RealtekMstDpAuxName
|
|
|
|
Specifies the name of the drm_dp_aux_dev channel over which the device should be reached.
|
|
|
|
Since: 1.6.2
|
|
|
|
## Vendor ID security
|
|
|
|
The vendor ID is specified by system firmware (such as ACPI tables).
|
|
|
|
## External Interface Access
|
|
|
|
This plugin requires access to i2c buses associated with the specified
|
|
DisplayPort aux channel, usually `/dev/i2c-5` or similar.
|