fwupd/plugins/ata
Richard Hughes 5079f26f0e Never guess the version format from the version string
This leads to madness, as some formats are supersets of the detected types,
e.g. 'intel-me' is detected as 'quad' and 'bcd' is detected as 'pair'.

Where the version format is defined in a specification or hardcoded in the
source use a hardcoded enum value, otherwise use a quirk override.

Additionally, warn if the version does not match the defined version format
2019-04-30 09:25:41 +01:00
..
tests ata: Add a new plugin to upgrade firmware on ATA/ATAPI hardware 2019-01-29 22:28:09 +00:00
ata.quirk ata: Add a new plugin to upgrade firmware on ATA/ATAPI hardware 2019-01-29 22:28:09 +00:00
fu-ata-device.c Never guess the version format from the version string 2019-04-30 09:25:41 +01:00
fu-ata-device.h Use '#pragma once' to avoid a lot of boilerplate 2019-02-09 08:42:30 -06:00
fu-plugin-ata.c ata: Support delayed activation 2019-02-27 09:04: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