fwupd/plugins/hailuck
Richard Hughes e87fc05ab9 Speed up the daemon startup by ~2% by doing dlsym much less
We were calling g_module_symbol() 2703 times, which is actually more
expensive than you'd think.

It also means the plugins are actually what we tell people they are:
A set of vfuncs that get run. The reality before that they were dlsym'd
functions that get called at pretty random times.
2021-11-09 12:02:07 +00:00
..
data hailuck: Add an plugin for the Pinebook Pro laptop 2020-11-09 16:17:34 +00:00
fu-hailuck-bl-device.c Allow overriding the firmware GType from a quirk file 2021-11-08 15:53:41 +00:00
fu-hailuck-bl-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-hailuck-common.c trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-hailuck-common.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-hailuck-kbd-device.c Allow using a per-device global percentage completion 2021-09-13 14:28:15 +01:00
fu-hailuck-kbd-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-hailuck-kbd-firmware.c trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-hailuck-kbd-firmware.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-hailuck-tp-device.c Allow using a per-device global percentage completion 2021-09-13 14:28:15 +01:00
fu-hailuck-tp-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-plugin-hailuck.c Speed up the daemon startup by ~2% by doing dlsym much less 2021-11-09 12:02:07 +00:00
hailuck.quirk Simplify the quirk file format 2021-03-03 08:30:34 +00:00
meson.build Move the plugin build logic to the plugins themselves 2021-02-18 14:46:20 +00:00
README.md trivial: update markdown for pre-commit style 2021-07-18 14:42:47 -05:00

Hailuck

Introduction

Hailuck produce the firmware used on the keyboard and trackpad used in the Pinebook Pro laptops.

Firmware Format

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

This plugin supports the following protocol ID:

  • com.hailuck.kbd
  • com.hailuck.tp

GUID Generation

These devices use the standard USB DeviceInstanceId values, e.g.

  • USB\VID_0603&PID_1020

Update Behavior

The keyboard device usually presents in runtime mode, but on detach it re-enumerates with a different USB VID and PID in bootloader mode. On attach the device again re-enumerates back to the runtime mode.

For this reason the REPLUG_MATCH_GUID internal device flag is used so that the bootloader and runtime modes are treated as the same device.

The touchpad firmware is deployed when the device is in normal runtime mode, and the device will reset when the new firmware has been written.

Vendor ID Security

The vendor ID is set from the USB vendor, in this instance set to USB:0x0603

External Interface Access

This plugin requires read/write access to /dev/bus/usb.