proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-06-05 06:51:40 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
cf9ebdb703
fwupd/plugins/elantp
History
Richard Hughes faa7871b08 Remove duplicate ->probe() calls to speed up startup by 150ms 
Now incorporate is fixed to copy across the properties we need in the
superclass, we don't need to do the subclass ->probe().

Note, we still need to do the subclassed ->probe() when using
FU_UDEV_DEVICE_FLAG_VENDOR_FROM_PARENT or when looking at properties
on the parent device.

This also removes the spurious 'already set GType to FuVliUsbhubDevice,
ignoring FuVliUsbhubDevice' messages when running the daemon.
2022-06-14 21:01:57 +01:00
..
tests Move the fuzzing files into the plugin directories 2021-10-22 15:24:05 +01:00
elantp.quirk Simplify the quirk file format 2021-03-03 08:30:34 +00:00
fu-elantp-common.h Add fu_common_sum8() common functionality 2021-11-26 18:33:11 +03:00
fu-elantp-firmware.c trivial: Remove fu_byte_array_set_size_full() 2022-06-14 14:36:52 -05:00
fu-elantp-firmware.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-elantp-hid-device.c Remove duplicate ->probe() calls to speed up startup by 150ms 2022-06-14 21:01:57 +01:00
fu-elantp-hid-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-elantp-i2c-device.c Remove duplicate ->probe() calls to speed up startup by 150ms 2022-06-14 21:01:57 +01:00
fu-elantp-i2c-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-plugin-elantp.c Add plugin quirk keys earlier in the startup process 2022-05-09 11:13:52 +01:00
fu-self-test.c Move the fuzzing files into the plugin directories 2021-10-22 15:24:05 +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

Elan TouchPad

Introduction

This plugin allows updating Touchpad devices from Elan. Devices are enumerated using HID and raw I²C nodes. The I²C mode is used for firmware recovery.

Firmware Format

The daemon will decompress the cabinet archive and extract a firmware blob in an unspecified binary file format.

This plugin supports the following protocol ID:

  • tw.com.emc.elantp

GUID Generation

These device uses the standard DeviceInstanceId values, e.g.

  • HIDRAW\VEN_04F3&DEV_3010

Additionally another instance ID is added which corresponds to the module ID:

  • HIDRAW\VEN_04F3&DEV_3010&MOD_1234

These devices also use custom GUID values for the IC configuration, e.g.

  • ELANTP\ICTYPE_09

Additionally another instance ID is added which corresponds to the IC type & module ID:

  • ELANTP\ICTYPE_09&MOD_1234

Update Behavior

The device usually presents in HID mode, and the firmware is written to the device by switching to a IAP mode where the touchpad is nonfunctional. Once complete the device is reset to get out of IAP mode and to load the new firmware version.

On flash failure the device is nonfunctional, but is recoverable by writing to the i2c device. This is typically much slower than updating the device using HID and also requires a model-specific HWID quirk to match.

Vendor ID Security

The vendor ID is set from the HID vendor, for example set to HIDRAW:0x17EF

Quirk Use

This plugin uses the following plugin-specific quirks:

ElantpIcPageCount

The IC page count.

Since: 1.4.6

ElantpIapPassword

The IAP password.

Since: 1.4.6

External Interface Access

This plugin requires ioctl access to HIDIOCSFEATURE and HIDIOCGFEATURE.