proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2026-03-28 09:59:03 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
562dfb3bc6
fwupd/plugins/elantp
History
Richard Hughes bf72d393fd Split up FuUsbDevice into ->open() and ->setup() 
Before this change calling FuUsbDevice->open() opened the device, and
also unconditionally added various GUIDs and InstanceIDs which we
normally do in setup.
Then fu_device_setup() would call the FuSubclass->setup() vfunc which
would have no way of either opting out of the FuUsbDevice->setup()-like
behaviour, or controlling if the parent class ->setup is run before or
after the subclass setup.

Split up FuUsbDevice->open() into clear ->open() and ->setup() phases
and add the parent class calls where appropriate.

This means that ->setup() now behaves the same as all the other vfuncs.
2021-06-17 16:21:41 +01:00
..
elantp.quirk Simplify the quirk file format 2021-03-03 08:30:34 +00:00
fu-elantp-common.c elantp: Add a plugin to update Elan Touchpads using HID 2020-09-01 12:17:44 +01:00
fu-elantp-common.h elaptp: Allow recovery when the HID firmware fails to load 2020-09-14 16:19:45 +01:00
fu-elantp-firmware.c trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
fu-elantp-firmware.h trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
fu-elantp-hid-device.c Split up FuUsbDevice into ->open() and ->setup() 2021-06-17 16:21:41 +01:00
fu-elantp-hid-device.h trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
fu-elantp-i2c-device.c trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
fu-elantp-i2c-device.h trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
fu-plugin-elantp.c trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
fu-self-test.c trivial: fixup includes for a variety of plugins 2021-06-14 10:12:45 +01:00
meson.build Allow objects to deserialize to XML 2021-03-15 12:07:30 +00:00
README.md Add a new internal flag to opt-in to GUID matching 2021-02-25 15:47:25 +00: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:

Quirk Description Minimum fwupd version
ElantpIcPageCount The IC page count 1.4.6
ElantpIapPassword The IAP password 1.4.6

External interface access

This plugin requires ioctl access to HIDIOCSFEATURE and HIDIOCGFEATURE.