fwupd/plugins/wacom-raw/README.md
2021-07-18 14:42:47 -05:00

59 lines
1.2 KiB
Markdown

# Wacom RAW
## Introduction
This plugin updates integrated Wacom AES and EMR devices. They are typically
connected using I²C and not USB.
## GUID Generation
The HID DeviceInstanceId values are used, e.g. `HIDRAW\VEN_056A&DEV_4875`.
## Firmware Format
The daemon will decompress the cabinet archive and extract a firmware blob in
Intel HEX file format.
This plugin supports the following protocol ID:
* com.wacom.raw
## Quirk Use
This plugin uses the following plugin-specific quirks:
### WacomI2cFlashBlockSize
Block size to transfer firmware.
Since: 1.2.4
### WacomI2cFlashBaseAddr
Base address for firmware.
Since: 1.2.4
### WacomI2cFlashSize
Maximum size of the firmware zone.
Since: 1.2.4
## Update Behavior
The device usually presents in runtime mode, but on detach re-enumerates with a
different HIDRAW PID in a bootloader mode. On attach the device 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.
## Vendor ID Security
The vendor ID is set from the udev vendor, in this instance set to `HIDRAW:0x056A`
## External Interface Access
This plugin requires ioctl `HIDIOCSFEATURE` access.