7afd7cba0d
In many plugins we've wanted to use ->prepare_firmware() to parse the firmware ahead of ->detach() and ->write_firmware() but this has the limitation that it can only return a single blob of data. For many devices, multiple binary blobs are required from one parsed image, for instance providing signatures, config and data blobs that have to be pushed to the device in different way. This also means we parse the firmware *before* we ask the user to detach. Break the internal FuDevice API to support these firmware types as they become more popular. This also allows us to move the Intel HEX and SREC parsing out of the dfu plugin as they are used by a few plugins now, and resolving symbols between plugins isn't exactly awesome. |
||
|---|---|---|
| .. | ||
| tests | ||
| ata.quirk | ||
| fu-ata-device.c | ||
| fu-ata-device.h | ||
| fu-plugin-ata.c | ||
| fu-self-test.c | ||
| meson.build | ||
| README.md | ||
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 |