From bc0bdb7e417a6432cd14941866d9d7e3162c09fb Mon Sep 17 00:00:00 2001 From: Leah Rowe via Gnuboot-patches Date: Sun, 14 Jan 2024 20:04:59 +0000 Subject: [PATCH] docs/install: replace Libreboot with GNUBoot Signed-off-by: Leah Rowe GNUtoo: rebased, removed inexistent "GNU Boot 20211122", removed new incomplete I945 Thinkpads flashing instructions. Acked-by: Denis 'GNUtoo' Carikli Acked-by: Adrien 'neox' Bourmault --- site/docs/install/index.md | 38 ++++++++++++++++---------------------- 1 file changed, 16 insertions(+), 22 deletions(-) diff --git a/site/docs/install/index.md b/site/docs/install/index.md index 38db94a..7c91e85 100644 --- a/site/docs/install/index.md +++ b/site/docs/install/index.md @@ -3,18 +3,18 @@ title: Installation instructions 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 get an error related to `/dev/mem` access, you should reboot with `iomem=relaxed` kernel parameter before running flashrom, or use a kernel that 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 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. -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. 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. 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 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) @@ -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 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 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 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 future, where those desktop boards do not have an onboard GPU and therefore an add-on GPU is always used.. @@ -136,9 +136,9 @@ following article: [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 -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 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. 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 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). @@ -174,7 +174,7 @@ carefully. 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. 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) -#### 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 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) 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 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 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. 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 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. 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` 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. 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 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. 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 -Libreboot. +GNU Boot. Refer to the following article:\ [Macbook2,1 and MacBook1,1 installation guide](../hardware/macbook21.md)