proxmox-mirrors/fwupd
1
0
Fork 0
mirror of https://git.proxmox.com/git/fwupd synced 2025-05-22 05:21:21 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
94e3d24f55
fwupd/plugins/cros-ec
History
Mario Limonciello 8aa5d41eb7 Add external interface messages
2020-10-26 12:05:20 -05:00
..
data cros-ec: Initial skeleton 2020-05-29 06:55:40 +01:00
cros-ec.quirk cros-ec: Add support for quiche and gingerbread boards 2020-10-11 07:34:49 +01:00
fu-cros-ec-common.c cros-ec: Parse version number into triplet 2020-05-29 06:55:40 +01:00
fu-cros-ec-common.h trivial: cros-ec: Use fu-memcpy-safe 2020-06-20 07:24:32 +01:00
fu-cros-ec-firmware.c cros-ec: Save new firmware version on successful write 2020-08-28 10:48:03 -07:00
fu-cros-ec-firmware.h cros-ec: Save new firmware version on successful write 2020-08-28 10:48:03 -07:00
fu-cros-ec-usb-device.c cros-ec: Increase remove delay for reenumeration to 20s. 2020-10-11 07:34:49 +01:00
fu-cros-ec-usb-device.h cros-ec: Add usb_findit functionality 2020-05-29 06:55:40 +01:00
fu-plugin-cros-ec.c cros-ec: Add cros-ec-firmware 2020-06-20 07:24:32 +01:00
meson.build cros-ec: Add cros-ec-firmware 2020-06-20 07:24:32 +01:00
README.md Add external interface messages 2020-10-26 12:05:20 -05:00

README.md

Chrome OS EC Support

Introduction

This plugin provides support for the firmware updates for Chrome OS EC project based devices.

Initially, it supports the USB endpoint updater, but lays the groundwork for future updaters which use other update methods other than the USB endpoint.

This is based on the chromeos ec project's usb_updater2 application [1].

Information about the USB update protocol is available at [2].

Firmware Format

The daemon will decompress the cabinet archive and extract a firmware blob in the Google fmap [3] file format.

This plugin supports the following protocol ID:

  • com.google.usb.crosec

GUID Generation

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

  • USB\VID_18D1&PID_501A

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:0x18D1

External interface access

This plugin requires read/write access to /dev/bus/usb.

[1] https://chromium.googlesource.com/chromiumos/platform/ec/+/master/extra/usb_updater/usb_updater2.c [2] https://chromium.googlesource.com/chromiumos/platform/ec/+/master/docs/usb_updater.md [3] https://www.chromium.org/chromium-os/firmware-porting-guide/fmap