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:
parent
c9710f1e83
commit
bc0bdb7e41
|
@ -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)
|
||||||
|
|
Loading…
Reference in New Issue