fwupd/plugins/pixart-rf
2021-04-20 08:05:31 +01:00
..
fu-plugin-pixart-rf.c Show a warning if the device has no GType and the plugin has no default 2021-04-15 16:52:56 +01:00
fu-pxi-device.c pixart-rf: Retry the SetReport after a successfull firmware update 2021-03-29 10:23:16 +01:00
fu-pxi-device.h Add plugin to update PixArt RF devices 2021-01-04 17:20:13 +00:00
fu-pxi-firmware.c Allow objects to deserialize to XML 2021-03-15 12:07:30 +00:00
fu-pxi-firmware.h pixart: Check firmware compatibility with hardware before flashing 2021-03-10 16:23:18 +01:00
fu-self-test.c Allow objects to deserialize to XML 2021-03-15 12:07:30 +00:00
meson.build Allow objects to deserialize to XML 2021-03-15 12:07:30 +00:00
pixart-rf.quirk Add cheetos mouse quirk in pixart-rf 2021-04-20 08:05:31 +01:00
README.md trivial: Codespell fixes 2021-03-19 16:42:33 +00:00

PixArt RF Devices Support

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.