proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2026-01-10 13:01:04 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
4a78fed13c
fwupd/plugins/pixart-rf
History
Richard Hughes 0c51630991 Check firmware magic in a more standard way 
Some parsers are ignoring the magic when using _FLAG_IGNORE_CHECKSUM
(which is wrong; fuzzers have no problem with enforcing a static prefix)
and other either disregard the offset or check the magic in an unsafe
way. Also, use FWUPD_ERROR_INVALID_FILE consistently for magic failure.

Add a vfunc, and move all the clever code into one place.
2022-07-14 14:48:15 +01:00
..
tests Move the fuzzing files into the plugin directories 2021-10-22 15:24:05 +01:00
fu-plugin-pixart-rf.c Speed up the daemon startup by ~2% by doing dlsym much less 2021-11-09 12:02:07 +00:00
fu-pxi-ble-device.c Split out the dump helpers to a new source file 2022-06-14 14:36:52 -05:00
fu-pxi-ble-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-pxi-common.c Split out the memory helpers to a new source file 2022-06-14 14:36:52 -05:00
fu-pxi-common.h Rename fu_udev_device_ioctl_full() as we broke ABI 2022-06-03 13:47:11 -05:00
fu-pxi-firmware.c Check firmware magic in a more standard way 2022-07-14 14:48:15 +01:00
fu-pxi-firmware.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-pxi-receiver-device.c Split out the dump helpers to a new source file 2022-06-14 14:36:52 -05:00
fu-pxi-receiver-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-pxi-wireless-device.c Split out the dump helpers to a new source file 2022-06-14 14:36:52 -05:00
fu-pxi-wireless-device.h trivial: reformat the whole tree to match new format 2021-08-24 11:18:40 -05:00
fu-self-test.c Move the fuzzing files into the plugin directories 2021-10-22 15:24:05 +01:00
meson.build Build the quirk files into the daemon as a GResource 2022-06-30 18:52:24 +01:00
pixart-rf.quirk add new device support pixart-rf 2022-06-27 23:08:42 -05:00
README.md trivial: update markdown for pre-commit style 2021-07-18 14:42:47 -05:00

README.md

PixArt RF Devices

Introduction

This plugin allows the user to update any supported Pixart RF Device using a custom HID-based OTA protocol

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:

  • com.pixart.rf

GUID Generation

These devices use the standard HIDRAW DeviceInstanceId values for both Pixart Imaging, Inc and Primax Electronics, Ltd, e.g.

  • HIDRAW\VEN_093A&DEV_2801
  • HIDRAW\VEN_0461&DEV_4EEF
  • HIDRAW\VEN_0461&DEV_4EEF&NAME_${NAME}
  • HIDRAW\VEN_0461&DEV_4EEF&MODEL_${MODEL_NAME}

Additionally, a custom GUID values including the name is used, e.g.

Update Behavior

The 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:0x093A

External Interface Access

This plugin requires ioctl HIDIOCSFEATURE and HIDIOCGFEATURE access.