2
1
Fork 0
mirror of https://git.savannah.gnu.org/git/gnuboot.git synced 2025-01-04 07:17:40 +01:00
gnuboot/resources/coreboot/README.debug
Adrien 'neox' Bourmault 56c59af861
packages: roms_helper: boot: add support for debug configuration
When a computer does not boot at all or the result is only a deep black screen,
a very useful option can be to use a serial connector to get UART debug console
and read it, looking for any useful hint. However, enabling UART debug console
with a sufficient level of details slows down the boot process in most cases.

This commit adds the capability to build debug images, using a special
configuration file for coreboot with debug options. This is a simplistic way
that works for now, but should be improved later on.

These debug images will be generated in the bin-dbg/ directory instead
of bin/ where regular images are located.

Signed-off-by: Adrien 'neox' Bourmault <neox@gnu.org>
Acked-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
2024-12-07 13:51:20 +01:00

16 lines
704 B
Text

GNU Boot also builds some debug images that are shipped in separate
debug archives (like gnuboot-0.1-rc3_x200_8mb_debug.tar.xz).
The debug images have the following differences with the regular
images:
- The serial port is enabled, its speed is set to 115200, and the
Coreboot debug level is set to 7. It's possible to bring it up to 8
without recompiling the image by modifying the cmos.default file
inside the image. In addition POST codes are also printed on the
serial port.
- When the computer has a Coreboot build setting for that (all
computers but QEMU have that), memory debugging is enabled. This can
help diagnose RAM compatibility issues to potentially fix them in
Coreboot.