FreeBSD on Framewok

FreeBSD is not currently an officially supported Operating System on Framework Computer systems. This repository documents the current state of how well FreeBSD works on our systems and helps you set it up.

Systems

System	Mainboard	Status
Framework 12	Intel 13th Gen	Working well
Framework 13	Intel 11th Gen	Working well
Framework 13	Intel 12th Gen	Working well
Framework 13	Intel 13th Gen	Working well
Framework 13	Intel Core Ultra Series 1	Working with DRM 6.6 (FreeBSD 15)
Framework 13	AMD 7040 Series	Working with DRM 6.2 (FreeBSD 14.2)
Framework 13	AMD AI 300 Series	Working, no GUI yet
Framework 16	AMD 7040 Series	Working with DRM 6.2 (FreeBSD 14.2)
Framework Desktop	AMD AI Max 300 Series	Working, no GUI yet

Preparation

1. Install latest FreeBSD from installer
2. Create your user, adding it to the wheel group
3. Reboot into installed system
4. Log into root
5. Install sudo: pkg install sudo
6. Run visudo and remove # from infront of the line with wheel
7. Log out and log into your user
8. sudo pkg install git py311-ansible
9. git clone https://github.com/FrameworkComputer/freebsd-on-framework
10. cd freebsd-on-framework
11. Run sudo ls and type your password to unlock passwordless sudo
12. Run your desired Playbook, e.g. ansible-playbook kde-xorg.yml

Playbooks

• kde-xorg.yml KDE on Xorg

TODO: KDE on Wayland

Hardware Support

Generic

• Framework 12 Touchpad
• Framework 13 Touchpad
• Framework 16 Touchpad
• Fingerprint Reader (Fixes contributed by Framework)
• Ambient Light Sensor (I2C HID)
  • Work-in-progress by Framework
• Display Brightness control
• Built-in Speakers
• Built-in Camera
• Built-in Microphone
• Headset Speaker
• Headset Microphone
  • AMD Ryzen 7040 13in/16in (Realtek ALC295)
  • Intel 11th Gen (Realtek ALC295)
  • Intel 11th-13th Gen (Tempo 92HD95B)
  • Intel Core Ultra Series 1 (Realtek ALC285)
  • AMD Ryzen AI 300 (Realtek ALC295)
  • Framework 12 Intel 13th Gen (Realtek ALC295)
  • Framework Desktop - Back (Realtek ALC ALC623)
  • Framework Desktop - Front (Realtek ALC ALC623)

Intel Mainboards

• UEFI Framebuffer (SCFB)
• Intel GPU driver (11th-13th Gen)
  • Working with drm-61-kmod on 12th Gen
• Intel GPU driver (Intel Core Ultra)
  • Needs at least 6.6, not in FreeBSD yet, see below for details
• Intel AX210 WiFi
  • Only 802.22g support in FreeBSD, up to 54Mbit
• Intel AX210 Bluetooth
  • Not supported in FreeBSD kernel yet, see below
• Suspend (S3) on 11th-13th Gen
  • Works with Intel GPU driver, not with SCFB
  • Wakes up only on power button, or lid, not keyboard press
• Suspend (S0ix) on Intel Core Ultra
  • Not supported yet by FreeBSD, see below
• Intel P-State power measurements
  • Work-in-progress by Framework

AMD Mainboards

• AMD GPU driver
  • Working with drm-61-kmod
• Suspend (S0ix)
  • Not supported yet by FreeBSD, see below

Expansion Cards

• USB-C
• USB-A
• MicroSD
• SD
• SSD
• Audio
• Ethernet (ure by default and cdce driver)
• HDMI
  • Works with Intel GPU driver, does not work with SCFB
• DisplayPort
  • Works with Intel GPU driver, does not work with SCFB

Framework 13 - Intel Core Ultra Series 1

The graphics driver in FreeBSD 14.1 does not work on this Intel CPU generation. At least DRM 6.6 is needed, which can be built with FreeBSD 15-CURRENT and drm-kmod PR #283.

Framework Desktop (AMD Ryzen AI Max 300)

• USB-A
• USB-C
• SSD
• Ethernet (RealTek NIC, RTL8126)
  • In-tree driver does not attach
  • The realtek-re-kmod driver attaches, but doesn't appear to work
• AMD GPU
  • amdgpu 6.6 fails to attach, "Fatal error during GPU init"
• RZ717 MediaTek WiFi
• AMD HDA audio controller
  • Driver attaches, untested
• SOC Serial Console
  • Can work with userspace (cu)
  • Can't boot if trying to make kernel print to id

uart2: <16950 or compatible> iomem 0xfedc9000-0xfedc9fff,0xfedc7000-0xfedc7fff irq11 on acpi0

Framework 12 - Intel 13th Gen

• Touchscreen
• Touchscreen - Stylus
• G-Sensor (Screen Rotation)
  • No driver yet
• Tablet Mode
  • No driver yet - WIP by Framework
• Suspend
  • Can suspend
  • But won't wake from keyboard, touchpad or touchscreen, only power button
  • And then after resume, immediately powers off
• Built-in Speaker
• Built-in Mic
• Audio jack speaker
• Audio jack mic -> not showing up
• DRM driver (6.1, 6.6)
• AX211 WiFi
  • Can scan with iwlwifi
  • Not able to connect to networks
• AX211 Bluetooth

Interacting with the hardware

Please refer to Hardware Interaction for details. The commands there are especially useful for Linux users coming to FreeBSD.

Known issues

• WiFi Driver (iwlwifi) sometimes crashes on shutdown or resume from S3)
  • Workaround
• iwlwifi limited to 802.11g speed
  • Workaround by using a Linux virtual machine
• AX210 Bluetooth not supported yet
  • https://reviews.freebsd.org/D44861
• RZ616, RZ717 not supported yet
  • https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264300
• S0ix and s2idle not supported yet
  • https://reviews.freebsd.org/D17675
  • https://reviews.freebsd.org/D17676
• AMD IOMMU Driver WIP
  • https://reviews.freebsd.org/D47256