Framework Laptop 12 Driver & Setup Troubleshooting Guide

This guide walks you through the most common driver and setup problems on the Framework Laptop 12, from a blank screen after first boot to Wi-Fi that won’t connect or audio that crackles. You’ll learn the exact order to check things, what to reinstall, and how to avoid the mistakes that send people down the wrong path.

What You’ll Need

A second computer or phone with internet access (to download drivers if the laptop can’t connect)
A USB drive (8 GB or larger) formatted as FAT32, if you need to transfer drivers
A USB-C to USB-A adapter if your flash drive is USB-A only (the Framework 12 has USB-C ports)
A small Phillips-head screwdriver (only if you need to reseat the SSD or RAM)
Your Framework Laptop 12 serial number (printed on the bottom, or in the BIOS)

Step-by-Step

Start with a clean boot. If the laptop won’t turn on or hangs on the logo, hold the power button for 15 seconds to force a shutdown, then press it once to turn on. If it still hangs, unplug the charger, hold the power button for 30 seconds (this drains residual power), then plug in and try again.
Check the BIOS first. Press F2 repeatedly during boot to enter the BIOS. If you can’t get in, the problem is likely hardware (keyboard, SSD, RAM) rather than drivers. In the BIOS, check that the SSD is detected under “Storage”. If it’s not listed, reseat the SSD (see Common Mistakes below for how to do it safely).
Install the latest BIOS update. Even if your laptop boots, an outdated BIOS can cause driver conflicts. Go to Framework’s support page for the Laptop 12, download the BIOS update, and run it from a USB drive (the updater will guide you). Do this before installing Windows or Linux if you’re setting up fresh.
Install Windows with internet, or prepare drivers first. If you’re doing a clean install, the Windows installer usually fetches critical drivers automatically. If you’re offline, download the “Framework Laptop 12 Driver Bundle” from Framework’s website on another computer, extract it to a USB drive, and point the installer to that folder when it asks for drivers.
Run Windows Update repeatedly. After first boot, go to Settings > Windows Update and click “Check for updates”. Let it install everything, restart, and check again. Repeat until there are no more updates. This often fixes Wi-Fi, audio, and graphics issues because Framework pushes driver updates through Windows Update.
Install the Framework Toolbox. Download and install the Framework Toolbox from their support page. This utility scans your hardware and installs the exact drivers for your configuration. Run it, let it finish, and restart.
If Wi-Fi is missing or unstable: Open Device Manager (right-click Start > Device Manager), look under “Network adapters”. If you see a device with a yellow exclamation mark, right-click it and select “Update driver” > “Search automatically”. If that fails, download the Intel Wi-Fi driver from Framework’s site (the Laptop 12 uses an Intel Wi-Fi 7 module) and install it manually. Also check that airplane mode isn’t on (Fn+F2 toggles it).
If audio crackles or is missing: Right-click the speaker icon in the system tray, select “Sound settings”, then “Troubleshoot”. If that doesn’t help, go to Device Manager, expand “Audio inputs and outputs”, right-click the speakers, and select “Uninstall device” (check “Delete the driver software for this device”), then restart. Windows will reinstall the driver automatically.
If the display is blurry or the wrong resolution: Right-click the desktop > Display settings > Advanced display. Make sure the resolution is set to the native 2880×1920 (or 1920×1280 if you have the matte panel). If the option is missing, install the Intel Iris Xe graphics driver from Framework’s site.
If the keyboard backlight or function keys don’t work: These are controlled by the embedded controller (EC). Update the EC firmware from Framework’s support page. Also check that the keyboard is properly seated – the Laptop 12’s keyboard is removable, so press gently around the edges to make sure it’s clipped in.
If the laptop won’t charge: Try both USB-C ports with the original charger. If it charges on one but not the other, the port may be damaged. If neither works, check the charger’s LED – if it’s off, the charger might be dead. Try a USB-C PD charger (65W or higher) to confirm.
If you’re using Linux: Framework provides a Linux support page with kernel patches and firmware updates. For Ubuntu 24.04 or later, most drivers work out of the box. If you have issues, install the latest kernel (6.8+) and the `fwupd` tool to update firmware.

Common Mistakes

Forcing a shutdown during Windows update. If the screen is stuck at “Working on updates”, wait at least 30 minutes before forcing a shutdown. Interrupting can corrupt the driver stack.
Reseating the SSD without disconnecting the battery. The Framework 12’s battery is internal. Always disconnect it (unplug the connector) before touching the SSD or RAM to avoid shorting components.
Downloading drivers from third-party sites. Only use Framework’s official support page or Windows Update. Third-party sites often have outdated or malicious drivers.
Skipping the BIOS update. Many driver issues are actually BIOS bugs. Always update the BIOS before troubleshooting drivers.
Assuming a dead port is a driver issue. If a USB-C port stops working, test it with a known-good device. If it still doesn’t work, it’s hardware – contact Framework support.
Using the wrong architecture. Make sure you download the 64-bit (x64) drivers, not ARM or 32-bit versions, unless you specifically have the ARM model.

Tips

Create a system restore point before making major driver changes. Type “restore point” in the Start menu, and create one – it takes 30 seconds and can save you hours.
Keep the driver bundle on a USB drive. If you ever need to reinstall, you’ll have it ready.
Use the Framework community forum. Many issues have known workarounds posted there, and Framework staff actively respond.
If you’re dual-booting, install Windows first, then Linux. Linux’s bootloader will detect Windows, but the reverse is more complicated.
Check the BIOS version before and after updates. Write it down so you know what you’re running.
For battery issues, calibrate the battery once a month: charge to 100%, use it until it shuts off, then charge to 100% again. This helps the battery gauge stay accurate.

Troubleshooting

If the laptop won’t boot at all: Try a different charger and cable. If it still won’t power on, remove the bottom cover, disconnect the battery, wait 30 seconds, reconnect, and try again. If that fails, reseat the SSD and RAM. If it still won’t boot, contact Framework support – the motherboard may be faulty.

If Windows install fails mid-way: Check that the USB installer is created with the official Media Creation Tool (or Rufus for Linux ISOs). Re-download the ISO if you get errors. Also, try a different USB port – some USB-C ports may not be bootable on older BIOS versions.

If the touchpad is jittery: Update the touchpad driver from Framework’s site. If it persists, check that the palm rejection is enabled in Settings > Devices > Touchpad. If you’re using Linux, install the `libinput` gestures package.

If the screen flickers: This is often a graphics driver issue. Uninstall the Intel graphics driver completely (use Display Driver Uninstaller in Safe Mode), then reinstall the latest from Framework. If it still flickers, check the display cable connection – it’s located behind the bezel, but only open it if you’re comfortable.

If the laptop is slow after driver updates: Open Task Manager (Ctrl+Shift+Esc) and check for high CPU usage. If “System” or “Windows Driver Foundation” is using high CPU, a driver is stuck. Restart, and if it persists, roll back the last driver update via Device Manager > Properties > Driver > Roll Back Driver.

If you get a blue screen (BSOD): Note the error code. Common ones on the Framework 12 include `IRQL_NOT_LESS_OR_EQUAL` (usually a driver conflict) and `PAGE_FAULT_IN_NONPAGED_AREA` (often RAM or SSD). Boot into Safe Mode (hold Shift while clicking Restart) and uninstall the most recently installed driver. If the BSOD mentions a specific driver name, search for that driver plus “Framework 12” for a known fix.

Frequently Asked Questions

Why does my Framework 12 not detect the SSD after a BIOS update?

The BIOS update may have reset the storage settings. Enter the BIOS (F2), go to “Advanced” > “Storage”, and ensure the SSD is set to “AHCI” mode (not RAID). If it’s already AHCI, reseat the SSD – it may have shifted during shipping.

Can I use any USB-C charger with the Framework 12?

Yes, as long as it supports USB-C PD with at least 65W. Lower-wattage chargers will work but may not charge while under heavy load. Avoid cheap chargers that don’t follow USB-C spec – they can damage the port.

Why is my Wi-Fi slow even though the driver is up to date?

Check if you’re on a 5GHz or 6GHz band. The Intel Wi-Fi 7 module supports 6GHz, but your router may not. Also, update the Wi-Fi driver from Intel’s site (not just Framework’s) – Intel releases fixes more frequently. If it’s still slow, try disabling the “Wi-Fi Power Saving” feature in Device Manager > Network adapter > Power Management.

Do I need to install drivers for the expansion cards?

No. The expansion cards (USB-C, HDMI, DisplayPort, etc.) are plug-and-play. If a card isn’t recognized, reseat it firmly – it should click into place. If it still isn’t recognized, try a different port, as the port’s connector may be damaged.

How do I reset the BIOS if I locked myself out?

There’s a CMOS reset button on the motherboard. Remove the bottom cover, look for a small button labeled “CMOS” near the battery connector, press and hold it for 10 seconds with the battery disconnected, then reconnect and boot. This resets all BIOS settings to defaults.

Why does my audio sound muffled after a Windows update?

Windows Update may have replaced the audio driver with a generic one. Go to Device Manager, right-click the audio device, select “Update driver” > “Browse my computer” > “Let me pick from a list”, and choose the “Realtek (or Intel) Audio” driver instead of “Microsoft” one. If that doesn’t help, uninstall the audio driver and let Windows reinstall it.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →