Code Monkey home page Code Monkey logo

coreboot's Introduction

coreboot README

coreboot is a Free Software project aimed at replacing the proprietary firmware (BIOS/UEFI) found in most computers. coreboot performs the required hardware initialization to configure the system, then passes control to a different executable, referred to in coreboot as the payload. Most often, the primary function of the payload is to boot the operating system (OS).

With the separation of hardware initialization and later boot logic, coreboot is perfect for a wide variety of situations. It can be used for specialized applications that run directly in the firmware, running operating systems from flash, loading custom bootloaders, or implementing firmware standards, like PC BIOS services or UEFI. This flexibility allows coreboot systems to include only the features necessary in the target application, reducing the amount of code and flash space required.

Source code

All source code for coreboot is stored in git. It is downloaded with the command:

git clone https://review.coreboot.org/coreboot.git.

Code reviews are done in the project's Gerrit instance.

The code may be browsed via coreboot's Gitiles instance.

The coreboot project also maintains a mirror of the project on github. This is read-only, as coreboot does not accept github pull requests, but allows browsing and downloading the coreboot source.

Payloads

After the basic initialization of the hardware has been performed, any desired "payload" can be started by coreboot.

See https://doc.coreboot.org/payloads.html for a list of some of coreboot's supported payloads.

Supported Hardware

The coreboot project supports a wide range of architectures, chipsets, devices, and mainboards. While not all of these are documented, you can find some information in the Architecture-specific documentation or the SOC-specific documentation.

For details about the specific mainboard devices that coreboot supports, please consult the Mainboard-specific documentation or the Board Status pages.

Releases

Releases are currently done by coreboot every quarter. The release archives contain the entire coreboot codebase from the time of the release, along with any external submodules. The submodules containing binaries are separated from the general release archives. All of the packages required to build the coreboot toolchains are also kept at coreboot.org in case the websites change, or those specific packages become unavailable in the future.

All releases are available on the coreboot download page.

Please note that the coreboot releases are best considered as snapshots of the codebase, and do not currently guarantee any sort of extra stability.

Build Requirements and building coreboot

The coreboot build, associated utilities and payloads require many additional tools and packages to build. The actual coreboot binary is typically built using a coreboot-controlled toolchain to provide reproducibility across various platforms. It is also possible, though not recommended, to make it directly with your system toolchain. Operating systems and distributions come with an unknown variety of system tools and utilities installed. Because of this, it isn't reasonable to list all the required packages to do a build, but the documentation lists the requirements for a few different Linux distributions.

To see the list of tools and libraries, along with a list of instructions to get started building coreboot, go to the Starting from scratch tutorial page.

That same page goes through how to use QEMU to boot the build and see the output.

Website and Mailing List

Further details on the project, as well as links to documentation and more can be found on the coreboot website:

https://www.coreboot.org

You can contact us directly on the coreboot mailing list:

https://doc.coreboot.org/community/forums.html

Copyrights and Licenses

Uncopyrightable files

There are many files in the coreboot tree that we feel are not copyrightable due to a lack of creative content.

"In order to qualify for copyright protection in the United States, a work must satisfy the originality requirement, which has two parts. The work must have “at least a modicum” of creativity, and it must be the independent creation of its author."

https://guides.lib.umich.edu/copyrightbasics/copyrightability

Similar terms apply to other locations.

These uncopyrightable files include:

  • Empty files or files with only a comment explaining their existence. These may be required to exist as part of the build process but are not needed for the particular project.
  • Configuration files either in binary or text form. Examples would be files such as .vbt files describing graphics configuration, .apcb files containing configuration parameters for AMD firmware binaries, and spd files as binary .spd or text *spd*.hex representing memory chip configuration.
  • Machine-generated files containing version numbers, dates, hash values or other "non-creative" content.

As non-creative content, these files are in the public domain by default. As such, the coreboot project excludes them from the project's general license even though they may be included in a final binary.

If there are questions or concerns about this policy, please get in touch with the coreboot project via the mailing list.

Copyrights

The copyright on coreboot is owned by quite a large number of individual developers and companies. A list of companies and individuals with known copyright claims is present at the top level of the coreboot source tree in the 'AUTHORS' file. Please check the git history of each of the source files for details.

Licenses

Because of the way coreboot began, using a significant amount of source code from the Linux kernel, it's licensed the same way as the Linux Kernel, with GNU General Public License (GPL) Version 2. Individual files are licensed under various licenses, though all are compatible with GPLv2. The resulting coreboot image is licensed under the GPL, version 2. All source files should have an SPDX license identifier at the top for clarification.

Files under coreboot/Documentation/ are licensed under CC-BY 4.0 terms. As an exception, files under Documentation/ with a history older than 2017-05-24 might be under different licenses.

Files in the coreboot/src/commonlib/bsd directory are all licensed with the BSD-3-clause license. Many are also dual-licensed GPL-2.0-only or GPL-2.0-or-later. These files are intended to be shared with libpayload or other BSD licensed projects.

The libpayload project contained in coreboot/payloads/libpayload may be licensed as BSD or GPL, depending on the code pulled in during the build process. All GPL source code should be excluded unless the Kconfig option to include it is set.

The Software Freedom Conservancy

Since 2017, coreboot has been a member of The Software Freedom Conservancy, a nonprofit organization devoted to ethical technology and driving initiatives to make technology more inclusive. The conservancy acts as coreboot's fiscal sponsor and legal advisor.

coreboot's People

Contributors

arthurheymans avatar c0d3z3r0 avatar dhendrix avatar elyesh avatar felixheld avatar felixsinger avatar fishbaoz avatar i-c-o-n avatar jwerner-chromium avatar karthikr-google avatar kmalkki avatar leeleahy2 avatar madscientist159 avatar marcjones-syspro avatar marshall-dawson avatar martinlroth avatar mrchromebox avatar mrnuke avatar myleswatson avatar neuschaefer avatar paulmenzel avatar phcoder avatar quasisec avatar rminnich avatar sean-starlabs avatar siro20 avatar subrata-b avatar th3fanbus avatar uwehermann avatar wzeh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

coreboot's Issues

Status of Renoir and Matisse

I have a Gigabyte Aorus Pro X570 WiFi I would like coreboot on, and heard that it was being ported to newer AMD Chipsets, but I don’t see any definitions in the code for anything other than gen 1(Picasso) boards

Software hotkey support

Currently, some hotkeys are done in hardware.

The touchpad lock provides no visual notification of being activated, unlike the one we have from the WMI driver.

The keyboard brightness has no visual notification, and cannot be changed using software. On the darp5, the color of the keyboard is hardcoded and defaults to blue.

The airplane mode toggle has no visual notification, sometimes comes on at unexpected times, and it cannot be turned off using the toggle in the operating system. Only the airplane mode hotkey can turn it off.

The following needs to be done:

  • Switch EC to use software hotkeys
  • Release packages to support software airplane mode toggle
  • Update kernel with driver to support touchpad lock, keyboard brightness, and airplane mode LED
  • Potentially add support for software fan control

Rebase on coreboot 24.05

24.05 has some critical fixes for functionality on MTL (many cherry-picked to our 24.02 base) and upstreams many of our fixes.

galp3-b Webcam does not work

I'm not able to enable the webcam with F10 or the hardware does not see the webcam. It is not listed in 'lsusb'.

aaronhoneycutt@pop-os ~/g/fresh-install-script> lsusb
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 004: ID 8087:0a2b Intel Corp.
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
aaronhoneycutt@pop-os ~/g/fresh-install-script>

Upstream all models to coreboot

I was wondering why the lemp9 is current the only device from you which is upstream in the Coreboot Repo

In this Repo and firmware-open Repo

Why the are all not upstream in Coreboot? I think it's good that you develop Coreboot for these models, but I don't think it's good that they don't go upstream into Coreboot.

You (and other OEMs) are use Barebones from Clevo.

Internal Testing

Flash Coreboot with UEFI on the following machines:

  • Carl - galp2
  • Emma - galp2
  • Harris - galp2
  • May - galp2
  • Katie - galp3
  • Louisa - galp3-b
  • Aaron - galp3-b
  • Alex - galp3-b
  • Ben C. - galp3-b
  • Joshua - galp3-c (13 inch)
  • Jeremy - galp3-c (14 inch)
  • Ben S. - darp5 - after dock testing

Xen fails to boot on lemp10 firmware

Booting qubes 4.0.3; xen 4.8.5 as well as qubes 4.1; xen 4.14 on the Clevo L141MU with system76 firmware flashed via the system76-firmware tool results in a xen panic at boot: IO-APIC + timer doesn't work!
See attached picture for detailed error message while run with apic_verbosity=debug

IMG_20201207_084016

Failing to clone due to missing 3rd-party commit

Getting this error when running update.sh in firmware-open:

jacob@serw12:~/Work/firmware-open$ ./scripts/update.sh 
Already up to date.
fatal: remote error: want 6c0c4691e5bb446e0e428ebca595164709c59586 not valid
fatal: Fetched in submodule path 'coreboot/3rdparty/intel-microcode', but it did not contain 6c0c4691e5bb446e0e428ebca595164709c59586. Direct fetching of that commit failed.
fatal: 
fatal: Failed to recurse into submodule path 'coreboot'

Happens whether I clone via git:// or https://.

galp3-b Thunderbolt does not work

GNOME Settings shows that TBT is either disabled in the BIOS or has the incorrect security level.

Pop 18.10 Intel image
Latest SeaBIOS as of today.

About commit frequency

Hi System76!

I'm following coreboot source code for a few days. And getting updates more than one time in a day. I wanted to learn how you work, and do you have any other policy about your own hardware.

Thanks, happy hacking!

Missing System UUID? Required for some software to track....

Seems that there isn't a system uuid assigned by coreboot or by system76's build of it: or just specifically for oryp7?

07/20/2021 4.13 coreboot 2021-07-20_93c2809

From dmidecode:

Handle 0x0001, DMI type 1, 27 bytes
System Information
	Manufacturer: System76
	Product Name: Oryx Pro
	Version: oryp7
	Serial Number: 123456789
	UUID: Not Settable
	Wake-up Type: Reserved
	SKU Number: Not Specified
	Family: Not Specified

From working install of same Popos release:

Handle 0x0001, DMI type 1, 27 bytes
System Information
	Manufacturer: Dell Inc.
	Product Name: OptiPlex 9020M
	Version: 00
	Serial Number: ZZZZZZ
	UUID: 4c4c4544-AAAA-ZZZZ-XXXX-b3c04f323832
	Wake-up Type: Power Switch
	SKU Number: 0669
	Family: Not Specified

Removed identifiers....

This might or might not be a related issue:

acidanthera/bugtracker#711

OS:

# pop-upgrade release check
checking if pop-upgrade requires an update
      Current Release: 21.10
         Next Release: 22.04
New Release Available: false

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.