Framework Laptop

The Framework laptop, released in 2021, focuses on extreme repairability. The DIY edition in particular, comes without an OS and the devs and community are currently focused on supporting Arch Linux as an alternative to Windows.

Expansion cards
The Framework Laptop features four modular expansion card slots allowing for custom port configurations. Each connects to an underlying USB-C interface. See https://frame.work/marketplace/expansion-cards

Installation
(Write the necessary steps to get Gentoo onto this system. Try to document any special step that each user will need to reproduce on their system. Includes getting special drivers or firmware from a manufacturer website, etc.)

Firmware
Firmware from is needed for the GPU, wireless, and bluetooth interfaces. The TigerLake GPU firmware in particular needs to be loaded immediately at boot, so it must be included as a kernel blob or on an init ramdisk.

Kernel
There have been significant stability issues with Wifi and Bluetooth in kernels prior to 5.14.15, so we're starting there, although it's not yet stable in portage at this time.

Emerge
(Optional section. If the platform requires any user space packages or kernel patches, mention them here).

Configuration
(Explain any additional configuration or special customization for this hardware platform. Could be anything from BIOS settings to assigning proper media key functionality.)

Example 1
(Example: Do this in order to get these keys working.)

Troubleshooting
(Optional section.)

(Troubleshoot issues in this section. Separate issues by best describing the error with a new section name. Remove this section and subsections if no issues are known.)

Issue 1
When X happens, Y is how you fix it.

External resources
(Optional section.)


 * (Link to external resources (outside the Wiki) using bullet points in this section. It is common for the information in this section to full sentences that are links.)