docs/install: replace Libreboot with GNUBoot

Signed-off-by: Leah Rowe <info@minifree.org>
GNUtoo: rebased, removed inexistent "GNU Boot 20211122", removed
new incomplete I945 Thinkpads flashing instructions.
Acked-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
Acked-by: Adrien 'neox' Bourmault <neox@gnu.org>
This commit is contained in:
Leah Rowe via Gnuboot-patches 2024-01-14 20:04:59 +00:00 committed by Denis 'GNUtoo' Carikli
parent c9710f1e83
commit bc0bdb7e41
Signed by: GNUtoo
GPG Key ID: 5F5DFCC14177E263
1 changed files with 16 additions and 22 deletions

View File

@ -3,18 +3,18 @@ title: Installation instructions
x-unreviewed: true x-unreviewed: true
... ...
This section relates to installing Libreboot on supported targets. This section relates to installing GNU Boot on supported targets.
NOTE: if running `flashrom -p internal` for software based flashing, and you NOTE: if running `flashrom -p internal` for software based flashing, and you
get an error related to `/dev/mem` access, you should reboot with get an error related to `/dev/mem` access, you should reboot with
`iomem=relaxed` kernel parameter before running flashrom, or use a kernel that `iomem=relaxed` kernel parameter before running flashrom, or use a kernel that
has `CONFIG_STRICT_DEVMEM` not enabled. has `CONFIG_STRICT_DEVMEM` not enabled.
Libreboot flashing can be risky business. Please ensure that you have external GNU Boot flashing can be risky business. Please ensure that you have external
flashing equipment, in case anything goes wrong. The general rule of thumb with flashing equipment, in case anything goes wrong. The general rule of thumb with
firmware is this: if it's non-free, replace it, but if you're already running firmware is this: if it's non-free, replace it, but if you're already running
free firmware and it works nicely for you, you do not need to update it. free firmware and it works nicely for you, you do not need to update it.
However, you might want to tweak it or try out newer releases of Libreboot if However, you might want to tweak it or try out newer releases of GNU Boot if
they have bug fixes for your board, and/or new security fixes. they have bug fixes for your board, and/or new security fixes.
If you're already running libre firmware on your board, you should decide for If you're already running libre firmware on your board, you should decide for
@ -32,7 +32,7 @@ the pre-compiled ROM images, but the build system does support other types
defined below. defined below.
NOTE: regardless of init type, on desktops, an external/add-on GPU can always NOTE: regardless of init type, on desktops, an external/add-on GPU can always
be used. On laptop hardware in Libreboot, libgfxinit will always be used. On be used. On laptop hardware in GNU Boot, libgfxinit will always be used. On
desktop/server hardware, if available, libgfxinit will also always be used by desktop/server hardware, if available, libgfxinit will also always be used by
default (but in that setup, SeaBIOS can be used if you want to use an add-on default (but in that setup, SeaBIOS can be used if you want to use an add-on
graphics card, e.g. on KCMA-D8, KGPE-D16, GA-G41M-ES2L) graphics card, e.g. on KCMA-D8, KGPE-D16, GA-G41M-ES2L)
@ -68,7 +68,7 @@ NOTE: no configs in libreboot are currently available that use this method.
With this method, coreboot is finding, loading and executing a VGA option ROM With this method, coreboot is finding, loading and executing a VGA option ROM
for your graphics hardware. This would not be done on laptops, because that for your graphics hardware. This would not be done on laptops, because that
implies supplying non-free binary blobs in Libreboot, so this setup would only implies supplying non-free binary blobs in GNU Boot, so this setup would only
ever be provided on desktop hardware where no GPU exists or where it is ever be provided on desktop hardware where no GPU exists or where it is
desirable for you to use an external/add-on graphics card desirable for you to use an external/add-on graphics card
@ -88,7 +88,7 @@ In this setup, coreboot is neither implementing libgfxinit / native graphics
initialization nor is it finding/loading/executing VGA option ROMs. In this initialization nor is it finding/loading/executing VGA option ROMs. In this
setup, SeaBIOS would most likely be used for that. setup, SeaBIOS would most likely be used for that.
The `normal` setup is supported in the Libreboot 20211122 build system, but not The `normal` setup is supported in the GNU Boot 20211122 build system, but not
currently used. It is there for desktop hardware that will be added in the currently used. It is there for desktop hardware that will be added in the
future, where those desktop boards do not have an onboard GPU and therefore an future, where those desktop boards do not have an onboard GPU and therefore an
add-on GPU is always used.. add-on GPU is always used..
@ -136,9 +136,9 @@ following article:
[ich9utils documentation](ich9utils.md) [ich9utils documentation](ich9utils.md)
Libreboot puts a default MAC address in the available ROM images, but this is GNU Boot puts a default MAC address in the available ROM images, but this is
a generic MAC address and it's identical on every ROM image. Technically, you a generic MAC address and it's identical on every ROM image. Technically, you
can use it but if you encounter other Libreboot users on the same ethernet can use it but if you encounter other GNU Boot users on the same ethernet
switch, using the same physical network as you, you will encounter a MAC switch, using the same physical network as you, you will encounter a MAC
address conflict. address conflict.
@ -146,7 +146,7 @@ NOTE: R500 thinkpads do not have an Intel gigabit ethernet NIC, so on that
laptop you can just flash the default ROM and you do not have to worry. laptop you can just flash the default ROM and you do not have to worry.
There are also some Intel X4X platforms that use an ICH10 southbridge, There are also some Intel X4X platforms that use an ICH10 southbridge,
supported in Libreboot, but these are flashed in a *descriptorless* setup, supported in GNU Boot, but these are flashed in a *descriptorless* setup,
which means that the MAC address is irrelevant (either there will be an Intel which means that the MAC address is irrelevant (either there will be an Intel
PHY module that is now unusable, and you use an add-on card, or it doesn't use PHY module that is now unusable, and you use an add-on card, or it doesn't use
an Intel PHY module and the onboard NIC is usable). an Intel PHY module and the onboard NIC is usable).
@ -174,7 +174,7 @@ carefully.
Run flashrom on host CPU Run flashrom on host CPU
------------------------ ------------------------
You can simply take any ROM image from the Libreboot project, and flash it. You can simply take any ROM image from the GNU Boot project, and flash it.
Boot a GNU+Linux distribution on the target device, and install flashrom. Boot a GNU+Linux distribution on the target device, and install flashrom.
In some cases, this is not possible or there are other considerations. Please In some cases, this is not possible or there are other considerations. Please
@ -229,12 +229,6 @@ the sections below:
[You must flash it externally](spi.md) [You must flash it externally](spi.md)
#### ASUS Chromebook C201 (Libreboot 20160907 only)
Ignore this section. Instead, refer to the following guide:
[ASUS Chromebook C201 installation guide](c201.md)
#### Lenovo ThinkPad X200/X200S/X200T/T400/T400S/T500/W500/R400/R500 running non-free Lenovo BIOS #### Lenovo ThinkPad X200/X200S/X200T/T400/T400S/T500/W500/R400/R500 running non-free Lenovo BIOS
If you're running one of these, it cannot be flashed internally if you're still If you're running one of these, it cannot be flashed internally if you're still
@ -254,7 +248,7 @@ Intel NIC.
[You must flash it externally](spi.md) [You must flash it externally](spi.md)
D410PT is more or less the same board as D510MO, but we would like more info D410PT is more or less the same board as D510MO, but we would like more info
about this board. If you have a D410PT mainboard, please [contact the Libreboot about this board. If you have a D410PT mainboard, please [contact the GNU Boot
project](../../contact.md) before you flash it. When you do so, please reference this project](../../contact.md) before you flash it. When you do so, please reference this
paragraph on this web page. paragraph on this web page.
@ -267,7 +261,7 @@ and you must flash both chips. Refer to the guide:\
#### Macbook1,1 running non-free Apple EFI firmware #### Macbook1,1 running non-free Apple EFI firmware
This laptop requires external flashing. Remove the mainboard and refer to This laptop requires external flashing. Remove the mainboard and refer to
the [external flashing guide](spi.md); if Libreboot is already running, you the [external flashing guide](spi.md); if GNU Boot is already running, you
can flash internally. can flash internally.
MacBook2,1 can be flashed internally. MacBook2,1 can be flashed internally.
@ -320,7 +314,7 @@ Download and build flashrom, using the instructions
on [the Git page](../../git.md), and download the `bucts` software using the on [the Git page](../../git.md), and download the `bucts` software using the
notes on that very same page. notes on that very same page.
You can replace Lenovo BIOS with Libreboot, using flashrom running on the host You can replace Lenovo BIOS with GNU Boot, using flashrom running on the host
CPU. However, there are some considerations. CPU. However, there are some considerations.
Firstly, make sure that the yellow CMOS battery is installed, and functioning Firstly, make sure that the yellow CMOS battery is installed, and functioning
@ -343,7 +337,7 @@ can set the machine to boot using that lower 64KiB bootblock, which is
read-write. You do this by setting the BUC.TS register to 1, using the `bucts` read-write. You do this by setting the BUC.TS register to 1, using the `bucts`
program referenced below. program referenced below.
Libreboot ROM images already have the upper 64KiB bootblock copied to the lower GNU Boot ROM images already have the upper 64KiB bootblock copied to the lower
one, so you don't have to worry about copying it yourself. one, so you don't have to worry about copying it yourself.
If you build flashrom using the libreboot build system, there will be three If you build flashrom using the libreboot build system, there will be three
@ -435,7 +429,7 @@ If it said VERIFIED, shut down. If it didn't say VERIFIED, make sure bucts is
still set to 1, and consult the libreboot project on IRC for advice, and avoid still set to 1, and consult the libreboot project on IRC for advice, and avoid
shutting down your system until you get help. shutting down your system until you get help.
If all went well, Libreboot should now be booting and you should be able to If all went well, GNU Boot should now be booting and you should be able to
boot into your operating system. boot into your operating system.
If you messed up, there are external flashing instructions. See main navigation If you messed up, there are external flashing instructions. See main navigation
@ -476,7 +470,7 @@ TARGET: Apple Macbook2,1, Macbook1,1 and iMac5,2 (i945 platform)
---------------------------------------------------------------- ----------------------------------------------------------------
iMac5,2 is essentially the same board as Macbook2,1, and it is compatible with iMac5,2 is essentially the same board as Macbook2,1, and it is compatible with
Libreboot. GNU Boot.
Refer to the following article:\ Refer to the following article:\
[Macbook2,1 and MacBook1,1 installation guide](../hardware/macbook21.md) [Macbook2,1 and MacBook1,1 installation guide](../hardware/macbook21.md)