![]() It's actually quite hard to build a front-end for fwupd at the moment as you're never sure when the progress bar is going to zip back to 0% and start all over again. Some plugins go 0..100% for write, others go 0..100% for erase, then again for write, then *again* for verify. By creating a helper object we can easily split up the progress of the specific task, e.g. write_firmware(). We can encode at the plugin level "the erase takes 50% of the time, the write takes 40% and the read takes 10%". This means we can have a progressbar which goes up just once at a consistent speed. |
||
---|---|---|
.. | ||
elantp.quirk | ||
fu-elantp-common.c | ||
fu-elantp-common.h | ||
fu-elantp-firmware.c | ||
fu-elantp-firmware.h | ||
fu-elantp-hid-device.c | ||
fu-elantp-hid-device.h | ||
fu-elantp-i2c-device.c | ||
fu-elantp-i2c-device.h | ||
fu-plugin-elantp.c | ||
fu-self-test.c | ||
meson.build | ||
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
.