Framework Laptop

Framework is a new company selling a fully modular and serviceable laptop ecosystem, similar to what exists in the desktop computer space. These laptops have the CPU soldered to the motherboard, they're treated as a single unit. Beyond that, all other components are removable, customizable, and replaceable, including the option to purchase a "DIY" laptop that comes without RAM, storage, networking, or even external I/O ports. The External I/O ports are provided via removable modules.

Ensure you have the latest BIOS installed (version 3.07 at time of writing) and are using an up-to-date -current or stable/13 snapshot, or FreeBSD 13.1 when available (once drm-fbsd13-kmod is version 5.5).

This page is a work in progress.

1. Quirks

2. Hardware


Intel® Core™ i5-1135G7

Intel® Core™ i7-1165G7

Intel® Core™ i7-1185G7


Integrated Intel® Iris® Xe Graphics (See CPU links for details)
Requires DRM-KMOD 5.5 or higher. Fails to initialize with DRM-KMOD 5.4.


Dual-channel DDR4 SO-DIMM slots, support for up to 32GB per slot. XMP support currently not available


13.5in, 2256x1504, 3:2 ratio, IPS, non-touch


PCIe Gen 4 M.2 NVMe slot, x4 lanes


E-key Wi-Fi module slot, not BIOS locked. All tested modules so far work (if drivers are available)
Pre-built laptop ships with Intel AX210 (vPro optional), supported by iwlwifi(4). (See Quirks for issues)


USB-attached AX210 Intel Bluetooth module (See Quirks for issues)


Realtek ALC295 HDA CODEC (Pre Oct-2021 - works)

Tempo 92HD95B (From Oct-2021 - DAC/speakers work, other paths untested)


Realtek Webcam


PixArt PIXA3854 (See Quirks for issues)


Framework LION 55Wh, ACPI accessible



3. Modular I/O

The Framework Laptop contains four recessed Thunderbolt 4 modular bays, each with a USB-C connector interface and support for charging the laptop. These modules allow for changing the external I/O on the laptop without the need for adapters, dongles, or protruding adapters. These modules sit flush with the side of the laptop. Each module has the same form factor in a plastic housing. Modules below are pictured without their housing to showcase their internal components.

Framework Module Ports Framework Module

3.1. USB-A

Straight pass-through, nothing special.

USB-A Module USB-A Module USB-A Module

3.2. USB-C

Straight pass-through, nothing special. This module is also used with the laptop's USB-C charging adapter.

USB-C Module USB-C Module USB-C Module

3.3. Micro-SD Card Reader

Module appears to have an intrusion detection sensor. Currently untested with FreeBSD.

Micro-SD Card Reader Module Micro-SD Card Reader Module Micro-SD Card Reader Module

3.4. HDMI

HDMI 2.0 spec. Hot-plugging displays working as expected. Resolutions up to 4k/60Hz and 1440p/120Hz are supported. On supported displays, EDID data for higher bandwidth resolutions such as 4k/120Hz are passed to FreeBSD, however these output no video.

HDMI Module HDMI Module HDMI Module

3.5. DisplayPort

Currently untested with FreeBSD.

DisplayPort Module DisplayPort Module DisplayPort Module

3.6. SSD

There are currently two SSD sizes available: 250GB and 1TB. The smaller 250GB size has been tested and is what is pictured below. The Framework Laptop will boot off of these drives and into FreeBSD exactly as expected.

250GB SSD Module 250GB SSD Module 250GB SSD Module 250GB SSD Module

4. References

Laptops/Framework_Laptop (last edited 2022-05-17T16:12:46+0000 by BjoernZeeb)