libreboot / lbwww (public) (License: Unspecified) (since 2023-04-11) (hash sha1)
libreboot website (markdown files). https://libreboot.org/
List of commits:
Subject Hash Author Date (UTC)
9020sff/mt: say how to use gfxcard+iommu 253a3f7ca0e83af9ebbf14266117bd8bd742ae43 Leah Rowe 2024-10-05 01:42:41
add 7010/9010 sff index on docs/install 91db0835fae4071a7a2b326d04bdc4853bc12de7 Leah Rowe 2024-10-05 01:35:47
dell 7010 sff doc 83783a8e29b6e3af70b7e0a261cd30cb9264c79c Leah Rowe 2024-10-04 22:14:34
docs/install: Reference the Dell E4300 in HCL 75c7cfca929be1ca2688bbc364369a141d3fc77c Leah Rowe 2024-09-30 05:54:15
spelling d15337458dcf2b54121d614fc34fc012599ea068 Leah Rowe 2024-09-26 11:18:43
more clarification 3ac406b6f6bbf2598999e75f483af61fc640cd5f Leah Rowe 2024-09-26 11:17:56
more notes about timings on psx 10fdd82ab64f88c8cc934aaff2cea4eddf8d1651 Leah Rowe 2024-09-26 11:13:55
32 pin, not 32 bit f94d3707c402468d629b5cfbed18c8816f380835 Leah Rowe 2024-09-26 11:03:35
tidy up the playstation page d799f23069e48d53609529dae34d5b69695e7381 Leah Rowe 2024-09-26 10:57:31
spelling 8342c2e82921ab70dc27cf773e3655045453ae3b Leah Rowe 2024-09-26 07:12:26
grammar b11b3a4fa6d51478dd04897a2a1f7e5cec717233 Leah Rowe 2024-09-26 07:02:34
typo 6820d43705b410b265ba8acf3d9ebd8d51041875 Leah Rowe 2024-09-26 07:01:20
add playstation page to docs 0424b1f6a413339a18a39f35dc037463215fbafe Leah Rowe 2024-09-26 06:53:44
docs/install: add missing latitudes to hcl b3cb1d224f04af13368c3a6a0fd1953ccb25d84a Leah Rowe 2024-09-23 17:01:00
update docs/maintain/ c18402c8a7013e7811cd1994db1c51aa7017b504 Leah Rowe 2024-09-23 16:57:06
grub_cbfs: add -t raw to example cbfs command 025ac72aeeeee92698e05686ed5177f6763e3b7f Leah Rowe 2024-09-07 01:24:15
simplify docs/install and merge docs/hardware 09844d6258bd27026f53f9cdb731b4086c20fda3 Leah Rowe 2024-08-31 21:28:18
remove wrong info about 820 g2 2f1107f2ca852f154332046a871822663ca792ac Leah Rowe 2024-08-30 01:40:32
minor 820 g2 docs cleanup 2cf3d6911a46707ccd820d94194cbe4fc5af6148 Leah Rowe 2024-08-30 01:39:11
update the 820 g2 hp guide a6d33c415884f109b4b040e92bea2d31730f3704 Leah Rowe 2024-08-30 01:36:57
Commit 253a3f7ca0e83af9ebbf14266117bd8bd742ae43 - 9020sff/mt: say how to use gfxcard+iommu
A special kernel option is required:

intel_iommu=enable,igfx_off

Signed-off-by: Leah Rowe <info@minifree.org>
Author: Leah Rowe
Author date (UTC): 2024-10-05 01:42
Committer name: Leah Rowe
Committer date (UTC): 2024-10-05 01:42
Parent(s): 91db0835fae4071a7a2b326d04bdc4853bc12de7
Signer:
Signing key:
Signing status: N
Tree: b76625954fda6b67ee77919806478dcbaea7f153
File Lines added Lines deleted
site/docs/install/dell9020.md 32 7
File site/docs/install/dell9020.md changed (mode: 100644) (index 72712c2..50df552)
... ... OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
30 30 | **CPU** | Intel Haswell | | **CPU** | Intel Haswell |
31 31 | **Graphics** | Intel HD Graphics | | **Graphics** | Intel HD Graphics |
32 32 | **Memory** | DDR3 DIMMs (max 32GB, 4x8GB) | | **Memory** | DDR3 DIMMs (max 32GB, 4x8GB) |
33 | **Architecture** | x86_64 |
33 | **Architecture** | x86\_64 |
34 34 | **Original boot firmware** | Dell UEFI firmware | | **Original boot firmware** | Dell UEFI firmware |
35 | **Intel ME/AMD PSP** | Present. Can be disabled with me_cleaner. |
35 | **Intel ME/AMD PSP** | Present. Can be disabled with me\_cleaner. |
36 36 | **Flash chip** | 2x SOIC-8, 12MiB (8+4) (96Mbit) | | **Flash chip** | 2x SOIC-8, 12MiB (8+4) (96Mbit) |
37 37
38 38
 
... ... Graphics cards and IOMMU
104 104
105 105 IOMMU is buggy for some reason (we don't know why yet), when you plug in IOMMU is buggy for some reason (we don't know why yet), when you plug in
106 106 a graphics card. The graphics card simply won't work. On some of them, a graphics card. The graphics card simply won't work. On some of them,
107 you can use the console but as soon as you start xorg, it will just b0rk.
107 you can use the console but as soon as you start xorg/wayland, it will just b0rk.
108 108
109 109 Current Libreboot revisions *disable IOMMU by default*, on this board. The Current Libreboot revisions *disable IOMMU by default*, on this board. The
110 110 coreboot code for initialising IOMMU was modified by the Libreboot project, to coreboot code for initialising IOMMU was modified by the Libreboot project, to
111 111 make it a toggle. IOMMU works fine if you use only Intel graphics. make it a toggle. IOMMU works fine if you use only Intel graphics.
112 112
113 If you want to use IOMMU *with a graphics card*, you also can. Use this Linux
114 kernel option at boot:
115
116 intel_iommu=enable,igfx_off
117
118 With the above option, IOMMU is enabled *except* for the Intel GPU. However,
119 Libreboot also *disables the Intel GPU* in coreboot, entirely, when a graphics
120 card is used. With the above option, it's possible that something like Qubes
121 may work, which requires an IOMMU to be turned on.
122
123 If you are using Intel graphics, and not a graphics card, you can ignore the
124 above, and instead fully turn on the IOMMU, without any special kernel options.
125
113 126 The way coreboot works is this: if vt-d is present on the CPU, it enables an The way coreboot works is this: if vt-d is present on the CPU, it enables an
114 127 IOMMU, and only if vt-d is present. This is still the behaviour in Libreboot, IOMMU, and only if vt-d is present. This is still the behaviour in Libreboot,
115 128 but Libreboot adds an additional check: if `iommu` is not set in nvram, it but Libreboot adds an additional check: if `iommu` is not set in nvram, it
116 129 defaults to on, but if it's set to disabled, then IOMMU is not initialised. defaults to on, but if it's set to disabled, then IOMMU is not initialised.
117 130
131 Enable IOMMU
132 ------------
133
134 IOMMU is *disabled by default*, universally, on this board. You can turn it on,
135 by modifying the ROM image prior to flashing, or modifying it prior to
136 re-flashing.
137
118 138 On all other Haswell boards, LIbreboot enables IOMMU by default. To enable On all other Haswell boards, LIbreboot enables IOMMU by default. To enable
119 139 it on the 9020, do this on your ROM: it on the 9020, do this on your ROM:
120 140
121 141 nvramtool -C libreboot.rom -w iommu=Enable nvramtool -C libreboot.rom -w iommu=Enable
122 142
123 Then flash the ROM image. You can find nvram
143 If you're using a graphics card, please make sure to read the above notes
144 about how to use IOMMU; specifically, the part that talks about Linux kernel
145 option `intel_iommu=enable,igfx_off`
146
147 Then flash the ROM image. You can find nvramtool
124 148 under `src/coreboot/default/util/nvramtool`. Do this in lbmk if you don't under `src/coreboot/default/util/nvramtool`. Do this in lbmk if you don't
125 149 already havse `src/coreboot/default/`: already havse `src/coreboot/default/`:
126 150
 
... ... in [Libreboot flashing instructions](../install/)
137 161 and [Libreboot external flashing instructions](../install/spi.md). and [Libreboot external flashing instructions](../install/spi.md).
138 162
139 163 NOTE: If IOMMU is enabled, you can still use a graphics card, but you must NOTE: If IOMMU is enabled, you can still use a graphics card, but you must
140 pass this on the Linux cmdline paramaters: `iommu=off`
164 pass this on the Linux cmdline paramaters: `iommu=off` - or if you need
165 IOMMU (e.g. for Qubes), use `intel_iommu=enable,igfx_off` instead.
141 166
142 167 NOTE2: Libreboot uses a *static option table* on all boards that have nvram, NOTE2: Libreboot uses a *static option table* on all boards that have nvram,
143 168 which is why you must use the `-C` option on your ROM, to change the static which is why you must use the `-C` option on your ROM, to change the static
 
... ... If you're already running Libreboot, and you don't have flash protection
201 226 turned on, [internal flashing](../install/) is possible. turned on, [internal flashing](../install/) is possible.
202 227
203 228 Internal flashing can also be done with the original Dell BIOS, if the Internal flashing can also be done with the original Dell BIOS, if the
204 SERVICE_MODE jumper near the PCIe slots is installed. Before flashing,
229 SERVICE\_MODE jumper near the PCIe slots is installed. Before flashing,
205 230
206 231 rmmod spi-intel-platform rmmod spi-intel-platform
207 232
208 233 needs to be run to prevent errors. Once Libreboot is installed, the needs to be run to prevent errors. Once Libreboot is installed, the
209 SERVICE_MODE jumper can be removed.
234 SERVICE\_MODE jumper can be removed.
210 235
211 236 **Note: The Dell BIOS can write EFI variables to flash when shutting **Note: The Dell BIOS can write EFI variables to flash when shutting
212 237 down, which could corrupt the newly flashed Libreboot ROM and render down, which could corrupt the newly flashed Libreboot ROM and render
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/libreboot/lbwww

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww

Clone this repository using git:
git clone git://git.rocketgit.com/user/libreboot/lbwww

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main