src: Drop unused 'include <device/pciexp.h>'
[coreboot.git] / Documentation / distributions.md
blob1deff6349dd266525a13f252fe08641321d83546
1 # Distributions
3 coreboot doesn't provide binaries but provides a toolbox that others can use
4 to build boot firmware for all kinds of purposes. These third-parties can be
5 broadly separated in two groups: Those shipping coreboot on their hardware,
6 and those providing after-market firmware to extend the usefulness of devices.
9 ## Hardware shipping with coreboot
11 ### Purism
13 [Purism](https://www.puri.sm) sells laptops with a focus on user privacy and
14 security; part of that effort is to minimize the amount of proprietary and/or
15 binary code. Their laptops ship with a blob-free OS and coreboot firmware
16 with a neutralized Intel Management Engine (ME) and SeaBIOS as the payload.
18 ### ChromeOS Devices
20 All ChromeOS devices ([Chromebooks](https://chromebookdb.com/), Chromeboxes,
21 Chromebit, etc) released from 2012 onward use coreboot for their main system
22 firmware. Additionally, starting with the 2013 Chromebook Pixel, the firmware
23 running on the Embedded Controller (EC - a small microcontroller which provides
24 functions like battery management, keyboard support, and sensor interfacing)
25 is open source as well.
27 ### Libretrend
29 [Libretrend](https://libretrend.com) sells the Librebox, a NUC-like PC which
30 ships with coreboot firmware.
33 ### PC Engines APUs
35 [PC Engines](https://pcengines.ch) designs and sells embedded PC hardware that
36 ships with coreboot and support upstream maintenance for the devices through a
37 third party, [3mdeb](https://3mdeb.com). They provide current and tested
38 firmware binaries on [GitHub](https://pcengines.github.io).
40 ## After-market firmware
42 ### Libreboot
44 [Libreboot](https://libreboot.org) is a downstream coreboot distribution that
45 provides ready-made firmware images for supported devices: those which can be
46 built entirely from source code. Their copy of the coreboot repository is
47 therefore stripped of all devices that require binary components to boot.
49 ### MrChromebox
51 [MrChromebox](https://mrchromebox.tech/) provides upstream coreboot firmware
52 images for the vast majority of x86-based Chromebooks and Chromeboxes, using
53 Tianocore as the payload to provide a modern UEFI bootloader. Why replace
54 coreboot with coreboot? Mr Chromebox's images are built using upstream
55 coreboot (vs Google's older, static tree/branch), include many features and
56 fixes not found in the stock firmware, and offer much broader OS compatibility
57 (i.e., they run Windows as well as Linux). They also offer updated CPU
58 microcode, as well as firmware updates for the device's embedded controller
59 (EC). This firmware "takes the training wheels off" your ChromeOS device :)
61 ### John Lewis
63 [John Lewis](https://johnlewis.ie/custom-chromebook-firmware) also provides
64 replacement firmware for ChromeOS devices, for the express purpose of
65 running Linux on Chromebooks. John Lewis' firmware supports a much smaller
66 set of devices, and uses SeaBIOS as the payload to support Legacy BIOS booting.
67 His firmware images are significantly older, and not actively maintained or
68 supported, but worth a look if you need Legacy Boot support and is not
69 available via Mr Chromebox's firmware.
71 ### Heads
73 [Heads](http://osresearch.net) is an open source custom firmware and OS
74 configuration for laptops and servers that aims to provide slightly better
75 physical security and protection for data on the system. Unlike
76 [Tails](https://tails.boum.org/), which aims to be a stateless OS that leaves
77 no trace on the computer of its presence, Heads is intended for the case where
78 you need to store data and state on the computer.
80 Heads is not just another Linux distribution – it combines physical hardening
81 of specific hardware platforms and flash security features with custom coreboot
82 firmware and a Linux boot loader in ROM.
84 ### Skulls
86 [Skulls](https://github.com/merge/skulls) provides firmware images for
87 laptops like the Lenovo Thinkpad X230. It uses upstream coreboot, an easy
88 to use payload like SeaBIOS and Intel's latest microcode update.
90 It simplifies installation and includes compact documentation. Skulls also
91 enables easy switching to [Heads](#heads) and back.