fwupd/plugins/ata
Richard Hughes 56ac823af9 Set the protocol per-device not per-plugin
Some plugins have devices with more than one protocol. Logically the protocol
belongs to the device, not the plugin, and in the future we could use this to
further check firmware that's about to be deployed.

This is also not exported into libfwupd (yet?) as it's remains a debug-feature
only -- protocols are not actually required for devices to be added.
2019-11-25 18:01:54 +00:00
..
tests ata: Add a new plugin to upgrade firmware on ATA/ATAPI hardware 2019-01-29 22:28:09 +00:00
ata.quirk Set all FuUdevDevice plugins to use FU_QUIRKS_PLUGIN 2019-10-09 20:02:16 +01:00
fu-ata-device.c Set the protocol per-device not per-plugin 2019-11-25 18:01:54 +00:00
fu-ata-device.h trivial: Remove G_BEGIN_DECLS from all private headers 2019-10-09 20:02:16 +01:00
fu-plugin-ata.c Set the protocol per-device not per-plugin 2019-11-25 18:01:54 +00:00
fu-self-test.c ata: Default to the non-activation 0xE subcommand 2019-02-01 06:13:38 -06:00
meson.build Do not use efivar just to print a mixed endian GUID 2019-02-04 15:19:57 +00:00
README.md ata: Add a new plugin to upgrade firmware on ATA/ATAPI hardware 2019-01-29 22:28:09 +00:00

ATA

Introduction

This plugin allows updating ATA/ATAPI storage hardware. Devices are enumerated from the block devices and if ID_ATA_DOWNLOAD_MICROCODE is supported they can be updated with appropriate firmware file.

Updating ATA devices is more dangerous than other hardware such as DFU or NVMe and should be tested carefully with the help of the drive vendor.

The device GUID is read from the trimmed model string.

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:

  • org.t13.ata

GUID Generation

These device use the Microsoft DeviceInstanceId values, e.g.

  • IDE\VENDOR[40]REVISION[8]
  • IDE\0VENDOR[40]

See https://docs.microsoft.com/en-us/windows-hardware/drivers/install/identifiers-for-ide-devices for more details.

Quirk use

This plugin uses the following plugin-specific quirks:

Quirk Description Minimum fwupd version
AtaTransferBlocks Blocks to transfer, or 0xffff for max 1.2.4
AtaTransferMode The transfer mode, 0x3, 0x7 or 0xe 1.2.4