fwupd/plugins/focalfp
Richard Hughes c4b7f42e43 Only compress one version of the builtin-quirks
Saving the quirks in the GResource section worked well, but it made the build
system very complicated and also meant the .data section was duplicated in
both `fwupd` and `fwupdtool` -- negating a lot of the hard-fought savings.

Simplify this feature so that we just `cat` all the quirk files together, then
gzip them into a single file. This means that at startup fwupd only needs to
check the mtime of one file, and weirdly it's actually faster to load a smaller
compressed file from disk that it is to load multiple uncompressed files.
2022-09-27 12:44:04 +01:00
..
focalfp.quirk focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00
fu-focalfp-firmware.c focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00
fu-focalfp-firmware.h focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00
fu-focalfp-hid-device.c focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00
fu-focalfp-hid-device.h focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00
fu-plugin-focalfp.c focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00
meson.build Only compress one version of the builtin-quirks 2022-09-27 12:44:04 +01:00
README.md focalfp: Add new plugin to update touchpads from focaltech 2022-09-27 09:13:08 +01:00

Focal TouchPad

Introduction

This plugin allows updating Touchpad devices from Focal. Devices are enumerated using HID . 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.focalfp

GUID Generation

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

  • HIDRAW\VEN_2808&DEV_0106

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:

External Interface Access

This plugin requires ioctl access to HIDIOCSFEATURE and HIDIOCGFEATURE.