Documentation is now handled by the same processes we use for code: Add something to the Documentation/ directory in the coreboot repo, and it will be rendered to https://doc.coreboot.org/. Contributions welcome!
Board Status
Semi-automated crowdsourced information about what boards and versions of coreboot are known to work together.
For many years the list of Supported Motherboards was maintained by a small handful of people with wiki access. This was challenging in a couple of ways: Wiki access was different from repository commit access, and the process of updating the wiki is somewhat tedious especially if we want an ongoing list of which coreboot versions work on a particular mainboard.
To address this problem the board_status.sh script was created to glean some basic information using cbmem and the kernel log on a machine that had successfully booted coreboot. The script (both shell and Go versions) reside under the util/board_status directory.
board_status.sh gathers build information and runtime information. Build information includes data from git such as the repository from where the code came from. Runtime information includes CBMEM data and kernel log.
In a nutshell, here are the steps involved:
To upload results the user must have an account with commit rights on coreboot.org which you can obtain by following the Git wiki page (under "Register with gerrit"). This is simply to prevent spam and abuse. If you have an idea for how to improve this so that more people can contribute without needing an account please let us know on the Mailinglist!
Currently the only thing that is tested is whether or not the machine booted successfully. Other tests may be added in the future, but for now the lowest common denominator is simply a test of whether the machine booted far enough to run the board_status script.
In this use case, the coreboot is built and run on the same machine. If the user is not root sudo will be used to invoke cbmem.
Steps:
In this use case coreboot is built on a separate machine from the DUT. The DUT is configured to allow root login via SSH pubkey authentication, and the script runs cbmem on the DUT via SSH.
Steps:
The util/board_status/set_up_live_image.sh script was added to help set up Ubuntu so that board status can be obtained via SSH. This is especially convenient for developers who wish to report results on multiple devices and need quick and easy setup.
In this use case coreboot is build on a separate machine from the DUT. The DUT is assumed to not have network access. Since we don't run the cbmem command on the DUT in this mode the user should set serial console verbosity high enough to produce meaningful output.
Also, since we do not log into the machine (via SSH) the coreboot_console.txt file may contain both coreboot and kernel messages. If kernel messages are desired, then the user must also set kernel serial console verbosity high enough to produce meaningful output.
Steps: