fwupd/plugins/ebitdo
Richard Hughes f50ff2c27e Decouple the version format from the version itself
If we say that the version format should be the same for the `version_lowest`
and the `version_bootloader` then it does not always make sense to set it at
the same time.

Moving the `version_format` to a standalone first-class property also means it
can be typically be set in the custom device `_init()` function, which means we
don't need to worry about *changing* ther version format as set by the USB and
UDev superclass helpers.
2020-02-25 14:00:09 +00:00
..
data Updated: Add support for 8BitDo M30. 2019-04-09 12:38:24 -04:00
ebitdo.quirk ebitdo: Add SN30Pro+ to recognized quirk list (Fixes: #1503) 2019-10-28 11:31:32 +00:00
fu-ebitdo-common.c ebitdo: Modernize the plugin to use FuFirmware 2019-10-31 09:21:35 -05:00
fu-ebitdo-common.h ebitdo: Modernize the plugin to use FuFirmware 2019-10-31 09:21:35 -05:00
fu-ebitdo-device.c Decouple the version format from the version itself 2020-02-25 14:00:09 +00:00
fu-ebitdo-device.h ebitdo: Use klass_device->write_firmware like other plugins 2019-10-09 20:02:16 +01:00
fu-ebitdo-firmware.c trivial: Provide some defines for common image names 2019-11-08 09:30:09 -06:00
fu-ebitdo-firmware.h ebitdo: Modernize the plugin to use FuFirmware 2019-10-31 09:21:35 -05:00
fu-plugin-ebitdo.c Set the protocol per-device not per-plugin 2019-11-25 18:01:54 +00:00
meson.build Convert libfwupdprivate to a shared library libfwupdplugin 2019-11-27 11:32:43 +00:00
README.md trivial: Document the use of vendor-id in each plugin 2019-12-11 18:10:44 +00:00

8Bitdo Support

Introduction

This plugin can flash the firmware on the 8Bitdo game pads.

Ebitdo support is supported directly by this project with the embedded libebitdo library and is possible thanks to the vendor open sourcing the flashing tool.

The 8Bitdo devices share legacy USB VID/PIDs with other projects and so we have to be a bit careful to not claim other devices as our own.

Firmware Format

The daemon will decompress the cabinet archive and extract a firmware blob in an unspecified binary file format. The binary file has a vendor-specific header that is used when flashing the image.

This plugin supports the following protocol ID:

  • com.8bitdo

GUID Generation

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

  • USB\VID_2DC8&PID_AB11&REV_0001
  • USB\VID_2DC8&PID_AB11
  • USB\VID_2DC8

Vendor ID Security

The vendor ID is set from the USB vendor, which is set to various different values depending on the model and device mode. The list of USB VIDs used is:

  • USB:0x2DC8
  • USB:0x0483
  • USB:0x1002
  • USB:0x1235
  • USB:0x2002
  • USB:0x8000