System76 EC

System76 EC is a GPLv3 licensed embedded controller firmware for System76 laptops.

Documentation

• Supported embedded controllers
• Flashing firmware
• Debugging
• Creating a custom keyboard layout
• Adding a new board

Dependencies

The complete set of dependencies can be installed using the deps.sh script from the Open Firmware repo.

Dependencies specific to EC development can be installed with:

sudo apt install \
  avr-libc \
  avrdude \
  gcc-avr \
  sdcc

lib.rs:

Library for accessing System76 ECs First, construct an access method, using an object implementing the Access trait. Next, an Ec object can be contructed, which exposes the command interface.

There are some differences between targets and features that are listed below:

• AccessHid requires the hidapi feature. Only functional on USB ECs.
• AccessLpcDirect requires the redox_hwio feature and a nightly compiler. This method is only recommended for use in firmware with LPC ECs, as mutual exclusion is not guaranteed.
• AccessLpcLinux requires the std feature and linux target_os. Recommended for LPC ECs, as this method can utilize mutual exclusion.
• EcLegacy, Pmc, and SuperIo all require the redox_hwio feature and a nightly compiler. It is only recommended to use these in firmware, as mutual exclusion is not guaranteed.