mirror of
https://git.proxmox.com/git/fwupd
synced 2025-06-03 05:46:20 +00:00
6101067f03
The coreboot plugin never actually gained the ability to write. As it stands a coreboot system now adds *two* system-firmware devices (from both flashrom and coreboot) which isn't ideal. Just allow flashrom to enumerate quirked devices and add coreboot-specific metadata as required. If we require some kind of cbfs parsing then we can do that in FuFlashromDevice->prepare_firmware().
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
Flashrom
|
|
========
|
|
|
|
Introduction
|
|
------------
|
|
|
|
This plugin uses `flashrom` to update the system firmware.
|
|
|
|
Firmware Format
|
|
---------------
|
|
|
|
The daemon will decompress the cabinet archive and extract a firmware blob in
|
|
an unspecified binary file format, which is typically the raw input for an
|
|
EEPROM programmer.
|
|
|
|
This plugin supports the following protocol ID:
|
|
|
|
* org.flashrom
|
|
|
|
Coreboot Version String
|
|
-----------------------
|
|
|
|
The coreboot version string can have an optional prefix (see below).
|
|
After the optional prefix the *major*, *minor* string follows and finally
|
|
the *build string*, containing the exact commit and repository state, follows.
|
|
|
|
For example `4.10-989-gc8a4e4b9c5-dirty`
|
|
|
|
**Exception on Lenovo devices:**
|
|
|
|
The thinkpad_acpi kernel module requires a specific pattern in the DMI version
|
|
string. To satisfy those requirements coreboot adds the CBETxxxx prefix to the
|
|
DMI version string on all Lenovo devices.
|
|
|
|
For example `CBET4000 4.10-989-gc8a4e4b9c5-dirty`
|
|
|
|
The coreboot DMI version string always starts with `CBET`.
|
|
|
|
GUID Generation
|
|
---------------
|
|
|
|
These device uses hardware ID values which are derived from SMBIOS.
|
|
|
|
* HardwareID-3
|
|
* HardwareID-4
|
|
* HardwareID-5
|
|
* HardwareID-6
|
|
* HardwareID-10
|
|
|
|
These device uses hardware ID values which are derived from SMBIOS. They should
|
|
match the values provided by `fwupdtool hwids` or the `ComputerHardwareIds.exe`
|
|
Windows utility.
|
|
|
|
Vendor ID Security
|
|
------------------
|
|
|
|
The vendor ID is set from the BIOS vendor, for example `DMI:Google`
|
|
|
|
External interface access
|
|
---
|
|
This plugin requires access to all interfaces that `libflashrom` has been compiled for.
|
|
This typically is `/sys/bus/spi` but there may be other interfaces as well.
|