Framework Embedded Controller Suite

A collection of tools that interact with the embedded controller in the Framework Laptop.

Ongoing Work⌗

• DHowett/ectool (HowettNET GitLab) , an isolated CMake build of ectool for Linux and Windows
• DHowett/keyboard-overdrive , a project to bring QMK-like customizability to the Framework Laptop’s keyboard
• A Windows driver, CrosEC ( DHowett/FrameworkWindowsUtils ), that allows userspace applications to communicate with the EC.
• ECTool.efi ( DHowett/FrameworkHacksPkg ), a UEFI commandline interface to the EC

Completed Work⌗

• “EC Card 2”, a closed case debugging expansion card for the Framework Laptop
• Patches for the Linux Kernel that maintainn support for the Framework Laptop via the cros_ec_lpcs driver:
  • Initial support for the Framework Laptop (shipped in 5.19)
  • Quirks for the Framework Laptop 13 (AMD) and Laptop 16 (landed for 6.10)
• UEFI drivers (from the same repository as ECTool.efi)
  • FrameworkKeyMapDriver, an example driver that uses the EC to remap Caps Lock to Esc before the OS boots, and regardless of which OS you are using.
  • ChassisIntrusionPCRMeasurementDriver, a driver that measures the chassis intrusion counter into PCR[6]. If you use this driver and bind your TPM-based full disk encryption to PCR[6], it will invalidate the sealed key and prompt for a password on the next boot after a chassis intrusion.
• An upstream pull request (now merged) to Framework that adds MEC EC support to their build of ectool
• A fork of the Chromium project’s ectool ( DHowett/fw-ectool ), which implements the MEC LPC protocol. It only works on Linux. Discontinued.