libreboot / lbwww (public) (License: Unspecified) (since 2023-04-11) (hash sha1)
libreboot website (markdown files). https://libreboot.org/
Clone URLs: https://rocketgit.com/user/libreboot/lbwww ssh://rocketgit@ssh.rocketgit.com/user/libreboot/lbwww git://git.rocketgit.com/user/libreboot/lbwww
25.04 master
List of commits:
Subject Hash Author Date (UTC)
Random docs cleanup 2e2b6c7d52c0802c72e2805f0f924d5c447935f2 Leah Rowe 2024-12-27 01:33:55
update 3050micro notes f2dd78251c25dc748f68ca6190960512fd3c9f7e Leah Rowe 2024-12-26 18:01:17
Remove legacy "./build" command from the docs 71b502349ab488f0e91403049181102286eb35e2 Leah Rowe 2024-12-25 09:08:24
Remove legacy "./vendor" command from docs 2ac7deeefc4fdafecb4ba23a3dce271637f9a75a Leah Rowe 2024-12-25 08:59:53
Remove legacy "./update trees" command from docs 443078014dc15c9dd40b428fe245623277e23db2 Leah Rowe 2024-12-25 08:55:21
make libreboot.org text bigger 8e3508c31340feac8bb7d5afed83542dd482f518 Leah Rowe 2024-12-20 16:27:35
note about prepping t480 usb bios updater 4811a7683e1f111ca2d2611915b082bd1fe9f080 Leah Rowe 2024-12-18 06:16:24
correction 777ea30c5968796901f6993a64cb017d5928b970 Leah Rowe 2024-12-18 05:50:01
stragglers 71cc1104e0311d3869bf6182a34720aabb118b0d Leah Rowe 2024-12-18 05:45:29
t480 tb notes, plus notes about touchscreen 8576804b30485e1c1ca71b5562a366dd721f812e Leah Rowe 2024-12-18 05:40:30
context 3ed4b4f6b3523054c8a27a7b3d6208cc7b8a6d27 Leah Rowe 2024-12-17 20:02:21
clean up an errant reference ca4a6756e3e0961255814b948ef888648761d000 Leah Rowe 2024-12-17 20:00:19
move 20241206 rev notes to own page 2a4b7d594316706ccae39f2e52a4f3aa926b659e Leah Rowe 2024-12-17 19:39:05
remove one of the u-boot photos 4aea280c60a82cd95c9a822913110505d30354b3 Leah Rowe 2024-12-17 18:55:49
rev5/6 20241206 notes 52da2a4d01a3105c43b817d09290ea95f56e452e Leah Rowe 2024-12-17 18:40:57
t480 update notes (ec uart) 63db2df0febcca7bf4a2e8187cb9ee0673418253 Leah Rowe 2024-12-17 14:37:36
Revert "make it rainbow" 207c6414458b7baf2879b938bdd491b4ed66f5da Leah Rowe 2024-12-17 12:29:27
rainbow shoes 3da0fb028f583bde136da43c4f070f54ad0a34f5 Leah Rowe 2024-12-17 06:15:37
20241206rev4 notes 332d9fa8d339d3b8ce2a67aa2730a35f3a503f5b Leah Rowe 2024-12-17 05:34:11
add another t480 mf link db8b4b3fe653ea53d23051e949b0408858d134ec Leah Rowe 2024-12-15 08:35:14
Commit 2e2b6c7d52c0802c72e2805f0f924d5c447935f2 - Random docs cleanup
Signed-off-by: Leah Rowe <info@minifree.org>
Author: Leah Rowe
Author date (UTC): 2024-12-27 01:33
Committer name: Leah Rowe
Committer date (UTC): 2024-12-27 01:33
Parent(s): f2dd78251c25dc748f68ca6190960512fd3c9f7e
Signer:
Signing key:
Signing status: N
Tree: 3d64367ac760d52b59d5f897a56e8d1ee5ee6f27
File Lines added Lines deleted
site/contrib.md 0 2
site/docs/install/devmem.md 3 1
site/docs/install/ga-g41m-es2l.md 4 1
site/docs/install/hp8200sff.md 3 1
site/docs/install/hp8300usdt.md 3 1
site/docs/install/hp9470m.md 3 1
site/docs/install/kfsn4-dre.md 3 1
site/docs/install/macbook21.md 3 1
site/docs/install/nvmutil.md 3 1
site/docs/install/r400.md 6 2
site/docs/install/spi.md 3 1
site/docs/install/spi_generic.md 3 1
site/docs/install/t400.md 3 1
site/docs/install/t440p_external.md 3 1
site/docs/install/t500.md 3 1
site/docs/install/t60_unbrick.md 3 1
site/docs/install/w541_external.md 3 1
site/docs/install/x200.md 3 1
site/docs/install/x200.uk.md 3 1
site/docs/install/x230_external.md 3 1
site/docs/install/x60_unbrick.md 3 1
site/docs/install/x60tablet_unbrick.md 3 1
site/docs/linux/grub_hardening.md 28 1
site/docs/maintain/index.md 16 1
site/docs/maintain/porting.md 3 1
site/docs/maintain/porting.uk.md 3 1
site/faq.md 3 1
site/faq.uk.md 3 1
site/news/audit3.md 3 1
site/news/audit4.md 3 1
site/news/safety.md 3 1
site/tasks/index.md 24 96
File site/contrib.md changed (mode: 100644) (index 6416247..55d6a72)
... ... Helped write the [FAQ section about DMA](../faq.md#hddssd-firmware), and provide
286 286 general advice in the early days of the project. Peter was a coreboot developer general advice in the early days of the project. Peter was a coreboot developer
287 287 in those days, and a major developer in the *libusb* project (which flashrom in those days, and a major developer in the *libusb* project (which flashrom
288 288 makes heavy use of). makes heavy use of).
289 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
290 now, as of 27 January 2024.
291 289
292 290 Peter also wrote the *bucts* utility used to set Backup Control (BUC) Top Swap Peter also wrote the *bucts* utility used to set Backup Control (BUC) Top Swap
293 291 (TS) bit on i945 laptops such as ThinkPad X60/T60, which is useful for a (TS) bit on i945 laptops such as ThinkPad X60/T60, which is useful for a
File site/docs/install/devmem.md changed (mode: 100644) (index d4ded98..554dd3b)
... ... FLASH ERRORS (and workarounds)
26 26 ======================= =======================
27 27
28 28 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog) **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
29 now, as of 27 January 2024, which is a fork of flashrom.**
29 now, as of 27 January 2024, which is a fork of flashrom.
30 The reason why was explained, in
31 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
30 32
31 33 This section relates to installing libreboot on supported targets. This section relates to installing libreboot on supported targets.
32 34
File site/docs/install/ga-g41m-es2l.md changed (mode: 100644) (index a63301d..a1398cf)
... ... NOTE: If you don't flash both chips, the recovery program from the default
164 164 factory BIOS will kick in and your board will be soft bricked. Make sure that factory BIOS will kick in and your board will be soft bricked. Make sure that
165 165 you flash both chips! you flash both chips!
166 166
167 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
167 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
168 168 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
169 The reason why was explained, in
170 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
171
File site/docs/install/hp8200sff.md changed (mode: 100644) (index 6e5b7ed..7e00111)
... ... between the pins until you can see the normal BIOS boot screen.
146 146
147 147 ![](https://av.libreboot.org/hp8200sff/fdo\_screwdriver.jpg) ![](https://av.libreboot.org/hp8200sff/fdo\_screwdriver.jpg)
148 148
149 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
149 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
150 150 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
151 The reason why was explained, in
152 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
151 153
152 154 Now, run this command: Now, run this command:
153 155
File site/docs/install/hp8300usdt.md changed (mode: 100644) (index 0585c8b..6a3c378)
... ... crystal (small metal cylinder) and the power cable for the optical drive.
81 81
82 82 Boot into an OS of your choice (that has flashprog support). Boot into an OS of your choice (that has flashprog support).
83 83
84 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
84 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
85 85 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
86 The reason why was explained, in
87 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
86 88
87 89 The BIOS should no longer impose any write-protections. The BIOS should no longer impose any write-protections.
88 90 You can now use `flashprog -p internal` freely. You can now use `flashprog -p internal` freely.
File site/docs/install/hp9470m.md changed (mode: 100644) (index f26209b..9168f0d)
... ... Some part of the board might turn on when programming. If programming fails,
91 91 you might have to attach the laptop to a charger. Make sure the laptop you might have to attach the laptop to a charger. Make sure the laptop
92 92 powers off before running flashprog. No LEDs should be lit. powers off before running flashprog. No LEDs should be lit.
93 93
94 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
94 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
95 95 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
96 The reason why was explained, in
97 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
96 98
File site/docs/install/kfsn4-dre.md changed (mode: 100644) (index e11ea92..21c979d)
... ... for building a high-powered workstation. Powered by libreboot.
54 54 Flashing instructions can be found at Flashing instructions can be found at
55 55 [../install/\#flashprog](../install/) [../install/\#flashprog](../install/)
56 56
57 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
57 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
58 58 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
59 The reason why was explained, in
60 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
59 61
60 62 Form factor {#formfactor} Form factor {#formfactor}
61 63 =========== ===========
File site/docs/install/macbook21.md changed (mode: 100644) (index 5ebd843..3be1fb5)
... ... MacBook2,1 can always be flashed internally, even if running Apple firmware:
105 105
106 106 sudo flashprog -p internal:laptop=force_I_want_a_brick,boardmismatch=force -w your.rom sudo flashprog -p internal:laptop=force_I_want_a_brick,boardmismatch=force -w your.rom
107 107
108 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
108 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
109 109 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
110 The reason why was explained, in
111 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
110 112
111 113 The MacBook1,1 can't be flashed internally if running the Apple EFI firmware. The MacBook1,1 can't be flashed internally if running the Apple EFI firmware.
112 114 You must flash externally. You must flash externally.
File site/docs/install/nvmutil.md changed (mode: 100644) (index b15a8dd..3d1beee)
... ... entire next section to it:
114 114 Use flashprog Use flashprog
115 115 ------------ ------------
116 116
117 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
117 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
118 118 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
119 The reason why was explained, in
120 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
119 121
120 122 If you wish to operate on the GbE section that's already If you wish to operate on the GbE section that's already
121 123 flashed, you should *dump* the current full ROM image. flashed, you should *dump* the current full ROM image.
File site/docs/install/r400.md changed (mode: 100644) (index eac5e37..5c5fa71)
... ... modified descriptor: see [../install/ich9utils.md](../install/ich9utils.md)*
80 80 Flashing instructions can be found at Flashing instructions can be found at
81 81 [../install/\#flashprog](../install/#flashprog) [../install/\#flashprog](../install/#flashprog)
82 82
83 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
83 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
84 84 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
85 The reason why was explained, in
86 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
85 87
86 88 EC update {#ecupdate} EC update {#ecupdate}
87 89 ========= =========
 
... ... Use this to find out:
176 178
177 179 flashprog -p internal flashprog -p internal
178 180
179 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
181 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
180 182 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
183 The reason why was explained, in
184 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
181 185
182 186 MAC address {#macaddress} MAC address {#macaddress}
183 187 =========== ===========
File site/docs/install/spi.md changed (mode: 100644) (index ba93502..bee0573)
... ... operates Minifree Ltd; sales provide funding for the Libreboot project.
19 19 Introduction Introduction
20 20 ============ ============
21 21
22 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
22 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
23 23 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
24 The reason why was explained, in
25 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
24 26
25 27 **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md), **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
26 28 OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)** OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
File site/docs/install/spi_generic.md changed (mode: 100644) (index 5de2868..9bd3cd7)
... ... title: Generic SPI Flashing Guide
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md), **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
10 12 OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)** OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
File site/docs/install/t400.md changed (mode: 100644) (index 3596e0b..8af030d)
... ... modified descriptor: see [../install/ich9utils.md](../install/ich9utils.md)*
79 79 Flashing instructions can be found at Flashing instructions can be found at
80 80 [../install/\#flashprog](../install/#flashprog) [../install/\#flashprog](../install/#flashprog)
81 81
82 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
82 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
83 83 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
84 The reason why was explained, in
85 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
84 86
85 87 EC update {#ecupdate} EC update {#ecupdate}
86 88 ========= =========
File site/docs/install/t440p_external.md changed (mode: 100644) (index d10fdc9..b81b5ba)
... ... Buy Libreboot preinstalled
12 12 Introduction Introduction
13 13 ============ ============
14 14
15 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
15 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
16 16 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
17 The reason why was explained, in
18 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
17 19
18 20 **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md), **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
19 21 OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)** OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
File site/docs/install/t500.md changed (mode: 100644) (index fbd067d..78014f8)
... ... modified descriptor: see [../install/ich9utils.md](../install/ich9utils.md)*
81 81 Flashing instructions can be found at Flashing instructions can be found at
82 82 [../install/\#flashprog](../install/#flashprog) [../install/\#flashprog](../install/#flashprog)
83 83
84 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
84 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
85 85 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
86 The reason why was explained, in
87 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
86 88
87 89 EC update {#ecupdate} EC update {#ecupdate}
88 90 ========= =========
File site/docs/install/t60_unbrick.md changed (mode: 100644) (index f4200a4..e12010e)
... ... title: ThinkPad T60 Recovery guide
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 "Unbricking" means flashing a known-good (working) ROM. The problem: "Unbricking" means flashing a known-good (working) ROM. The problem:
10 12 you can't boot the system, making this difficult. In this situation, you can't boot the system, making this difficult. In this situation,
File site/docs/install/w541_external.md changed (mode: 100644) (index 4f49f46..83eed5a)
... ... Buy Libreboot preinstalled
15 15 Introduction Introduction
16 16 ============ ============
17 17
18 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
18 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
19 19 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
20 The reason why was explained, in
21 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
20 22
21 23 **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md), **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
22 24 OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)** OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
File site/docs/install/x200.md changed (mode: 100644) (index 109246c..e9ce29d)
... ... modified descriptor: see [../install/ich9utils.md](../install/ich9utils.md)*
79 79 Flashing instructions can be found at Flashing instructions can be found at
80 80 [../install/\#flashprog](../install/#flashprog) [../install/\#flashprog](../install/#flashprog)
81 81
82 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
82 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
83 83 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
84 The reason why was explained, in
85 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
84 86
85 87 EC update {#ecupdate} EC update {#ecupdate}
86 88 ========= =========
File site/docs/install/x200.uk.md changed (mode: 100644) (index 3ea6113..b1ce8af)
... ... X200S та X201S; знову ж таки, це неперевірено. *Шви
71 71 Інструкції з перепрошивки можна знайти за адресою Інструкції з перепрошивки можна знайти за адресою
72 72 [../install/\#flashprog](../install/#flashprog) [../install/\#flashprog](../install/#flashprog)
73 73
74 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
74 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
75 75 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
76 The reason why was explained, in
77 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
76 78
77 79 Оновлення EC {#ecupdate} Оновлення EC {#ecupdate}
78 80 ========= =========
File site/docs/install/x230_external.md changed (mode: 100644) (index 8bbc59e..67bec81)
... ... x-toc-enable: true
6 6 **Minifree now sells the Libreboot T480, instead of the Libreboot X230. See: **Minifree now sells the Libreboot T480, instead of the Libreboot X230. See:
7 7 <https://minifree.org/product/libreboot-t480/>** <https://minifree.org/product/libreboot-t480/>**
8 8
9 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
9 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
10 10 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
11 The reason why was explained, in
12 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
11 13
12 14 **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md), **[PLEASE READ THESE INSTRUCTIONS BEFORE INSTALLING](../../news/safety.md),
13 15 OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)** OR YOU MIGHT BRICK YOUR MACHINE: [SAFETY PRECAUTIONS](../../news/safety.md)**
File site/docs/install/x60_unbrick.md changed (mode: 100644) (index 2c0263a..74107d0)
... ... title: ThinkPad X60 Recovery guide
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 "Unbricking" means flashing a known-good (working) ROM. The problem: "Unbricking" means flashing a known-good (working) ROM. The problem:
10 12 you can't boot the system, making this difficult. In this situation, you can't boot the system, making this difficult. In this situation,
File site/docs/install/x60tablet_unbrick.md changed (mode: 100644) (index 110a912..f3ab37c)
... ... title: ThinkPad X60 Tablet Recovery guide
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 "Unbricking" means flashing a known-good (working) ROM. The problem: "Unbricking" means flashing a known-good (working) ROM. The problem:
10 12 you can't boot the system, making this difficult. In this situation, you can't boot the system, making this difficult. In this situation,
File site/docs/linux/grub_hardening.md changed (mode: 100644) (index efdf128..903ee9c)
... ... See: [build from source](../build/)
82 82 IFD-based flash protection IFD-based flash protection
83 83 -------------------------- --------------------------
84 84
85 **NOTE: This CAN cause bricks on a lot of machines. You should use this with
86 care. The FLILL and/or PRx based methods are more reliable - also SMM methods.
87 You can reconfigure coreboot and enable the chipset-based flash protection there
88 which accomplishes the same result, and the benefit is that it can't easily
89 be overridden by an evel maid attack e.g. can't simply set the service jumper
90 on desktops.**
91
85 92 The simplest way is to just do this: The simplest way is to just do this:
86 93
87 ifdtool -x libreboot.rom -O libreboot.rom
94 ifdtool --lock libreboot.rom -O libreboot.rom
88 95
89 96 If you did the step before, to compile `cbfstool`, you can find ifdtool in If you did the step before, to compile `cbfstool`, you can find ifdtool in
90 97 the `elf/` directory, e.g. `elf/ifdtool/default/ifdtool`. Use the ifdtool the `elf/` directory, e.g. `elf/ifdtool/default/ifdtool`. Use the ifdtool
 
... ... things like graphics cards. More information is available here:
219 226
220 227 If you're using a graphics card, you *need* VGA option ROMs at least. If you're using a graphics card, you *need* VGA option ROMs at least.
221 228
229 GRUBSEA
230 -------
231
232 Another option is to make it so that GRUB is the primary payload on your board.
233 In this setup, SeaBIOS and U-Boot are still available.
234
235 For your board's `target.cfg`, add this:
236
237 payload_grubsea="y"
238
239 E.g. `config/coreboot/x200_8mb/target.cfg`
240
241 You should only do this on setups that have native graphics initialisation
242 e.g. Intel graphics, or where no VGA/GOP ROM is required either on-card or
243 in the flash (e.g. Intel graphics on Alderlake machines).
244
245 If you can't use GRUB as a primary payload, then you can use SeaGRUB as above
246 and disable the SeaBIOS menu, making SeaBIOS load only GRUB; SeaGRUB is useful
247 because GRUB will piggyback off of the VGA setup done by SeaBIOS first.
248
222 249 GPG keys GPG keys
223 250 ======== ========
224 251
File site/docs/maintain/index.md changed (mode: 100644) (index 715c6d2..c5519dd)
... ... title: lbmk maintenance manual
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 In addition to this manual, you should also refer to [porting.md](porting.md) In addition to this manual, you should also refer to [porting.md](porting.md)
10 12 and [testing.md](testing.md). and [testing.md](testing.md).
 
... ... as:
709 711 * `rev="ad983eeec76ecdb2aff4fb47baeee95ade012225"` (example entry) * `rev="ad983eeec76ecdb2aff4fb47baeee95ade012225"` (example entry)
710 712 * `xarch="i386-elf"` (example entry) * `xarch="i386-elf"` (example entry)
711 713 * `payload_grub="y"` (example entry) * `payload_grub="y"` (example entry)
714 * `payload_grubsea="y"`
712 715 * `payload_seabios="y"` (example entry) * `payload_seabios="y"` (example entry)
713 716 * `payload_memtest="y"` (example entry) * `payload_memtest="y"` (example entry)
714 717 * `payload_uboot="y"` (example entry) * `payload_uboot="y"` (example entry)
 
... ... hence `xarch`.
757 760 The `payload_grub` entry specifies whether or not GRUB is to be included in The `payload_grub` entry specifies whether or not GRUB is to be included in
758 761 ROM images. ROM images.
759 762
763 The `payload_grubsea` entry specifies that GRUB shall be the primary payload,
764 instead of SeaBIOS; SeaGRUB is disabled in this setup. You should only use this
765 where an Intel graphics device is present, or otherwise where native graphics
766 initialisation is present; it is also feasible on Intel Alderlake platforms,
767 but only where an Intel GPU is present; where a given system can use other
768 graphics devices, they must be unplugged or otherwise disabled. For example, you
769 must remove the graphics card on your desktop machine and only use the Intel
770 graphics, where it is available. Because of this, `payload_grubsea` is not
771 currently enabled by default (and SeaBIOS is more stable so it's a nice fallback
772 in case a bug in GRUB would otherwise brick your machine, because you can
773 bypass it and use SeaBIOS).
774
760 775 The `payload_seabios` entry specifies whether or not SeaBIOS is to be included The `payload_seabios` entry specifies whether or not SeaBIOS is to be included
761 776 in ROM images. If GRUB is also enabled, standalone SeaBIOS images will be in ROM images. If GRUB is also enabled, standalone SeaBIOS images will be
762 777 created alongside SeaGRUB images. SeaGRUB is where SeaBIOS automatically created alongside SeaGRUB images. SeaGRUB is where SeaBIOS automatically
File site/docs/maintain/porting.md changed (mode: 100644) (index 294757b..e464e9b)
2 2 title: Porting guide for new mainboards title: Porting guide for new mainboards
3 3 ... ...
4 4
5 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
5 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 6 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
7 The reason why was explained, in
8 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
7 9
8 10 NOTE: This page is largely Intel-centric, at present. It should be revised to NOTE: This page is largely Intel-centric, at present. It should be revised to
9 11 cover more vendors. [Patches welcome!](../../git.md) cover more vendors. [Patches welcome!](../../git.md)
File site/docs/maintain/porting.uk.md changed (mode: 100644) (index 3d216f5..faaaa73)
2 2 title: Керівництво перенесення title: Керівництво перенесення
3 3 ... ...
4 4
5 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
5 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 6 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
7 The reason why was explained, in
8 the [Libreboot 20240225 release](../../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
7 9
8 10 Це керівнитво передбачається для тих, хто має дуже низький рівень знань про прошивку Це керівнитво передбачається для тих, хто має дуже низький рівень знань про прошивку
9 11 загалом та coreboot окремо. загалом та coreboot окремо.
File site/faq.md changed (mode: 100644) (index 800476d..bc6c583)
... ... title: Frequently Asked Questions
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 AKA Frequently Questioned Answers AKA Frequently Questioned Answers
10 12
File site/faq.uk.md changed (mode: 100644) (index 83a36ac..fb79bdf)
... ... title: Часті питання
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
8 10
9 11 Також відомо як Відповіді на часті питання Також відомо як Відповіді на часті питання
10 12
File site/news/audit3.md changed (mode: 100644) (index 865c1b0..74553ea)
2 2 % Leah Rowe % Leah Rowe
3 3 % 20 October 2023 % 20 October 2023
4 4
5 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
5 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 6 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
7 The reason why was explained, in
8 the [Libreboot 20240225 release](libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
7 9
8 10 Introduction Introduction
9 11 ============ ============
File site/news/audit4.md changed (mode: 100644) (index bb205a8..7ab72d6)
2 2 % Leah Rowe % Leah Rowe
3 3 % 31 December 2023 % 31 December 2023
4 4
5 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
5 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 6 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
7 The reason why was explained, in
8 the [Libreboot 20240225 release](libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
7 9
8 10 Introduction Introduction
9 11 ============ ============
File site/news/safety.md changed (mode: 100644) (index c748973..193213d)
... ... does not need vendor files, the resulting ROM images will be identical and
9 9 therefore nothing will have happened. The inject script is designed to insert therefore nothing will have happened. The inject script is designed to insert
10 10 certain files, only if required on a given mainboard.** certain files, only if required on a given mainboard.**
11 11
12 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
12 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
13 13 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
14 The reason why was explained, in
15 the [Libreboot 20240225 release](libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
14 16
15 17 Introduction Introduction
16 18 ============ ============
File site/tasks/index.md changed (mode: 100644) (index 383a767..c86f27d)
... ... title: Jobs that need doing
3 3 x-toc-enable: true x-toc-enable: true
4 4 ... ...
5 5
6 NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
6 **NOTE: Libreboot standardises on [flashprog](https://flashprog.org/wiki/Flashprog)
7 7 now, as of 27 January 2024, which is a fork of flashrom. now, as of 27 January 2024, which is a fork of flashrom.
8
9 This page contains a curated list of tasks that are to be worked on, or tasks
10 that are being worked on. This is intended to complement
11 the [issue pages](https://codeberg.org/libreboot/lbmk/issues/).
12
13 Many of these entries will pertain to *lbmk*, which is Libreboot's build
14 system, but some entries may relate to documentation, or organisational
15 changes.
8 The reason why was explained, in
9 the [Libreboot 20240225 release](../news/libreboot20240225.md#flashprog-now-used-instead-of-flashrom)**
16 10
17 11 If you want to work on some of these yourself, patches are always welcome! If you want to work on some of these yourself, patches are always welcome!
18 12 Please read the [code review page](../git.md), which provides guidance on Please read the [code review page](../git.md), which provides guidance on
 
... ... audits are done in Libreboot, see:
62 56 * [Libreboot build system audit 1](../news/audit.md) * [Libreboot build system audit 1](../news/audit.md)
63 57 * [Libreboot build system audit 2](../news/audit2.md) * [Libreboot build system audit 2](../news/audit2.md)
64 58 * [Libreboot build system audit 3](../news/audit3.md) * [Libreboot build system audit 3](../news/audit3.md)
59 * [Libreboot build system audit 4](../news/audit4.md)
60 * [Libreboot build system audit 5](../news/audit5.md)
61 * [Libreboot build system audit 6](../news/audit6.md)
65 62
66 63 Auditing can often be pedantic, and seem petty. You might commit a patch that Auditing can often be pedantic, and seem petty. You might commit a patch that
67 reduces the sloccount by only 1 line, maybe 3, but they all add up. Audit 3
68 contained hundreds of changes, small changes, that together accounted for
69 about 1000 lines of code removed, while not affecting functionality in any way.
70
71 This will always remain on the TODO list, because there will always be a need
72 for auditing, as is true of any codebase. It is always possible to fix more
73 bugs or improve a piece of code. As they say: the code is never finished.
74
75 Port vendor scripts to Heads
76 ============================
77
78 Ironically, one of the first entries on this page pertains to a competing
79 project.
80
81 I promised the Heads project that I'd port Libreboot's vendorfile download and
82 inject scripts to the Heads build system. Libreboot provides these scripts for
83 automatically downloading certain firmwares at build time, as and when
84 required for a given mainboard. These are provided by the vendor, e.g. SMSC
85 SCH5545 Environment Control (EC) firmware used for fan control on Dell
86 Precision T1650.
64 reduces the sloccount by only 1 line, maybe 3, but they all add up.
87 65
88 Heads has such logic, but it's not as developed as the logic in Libreboot,
89 which was originally inspired by the Heads logic and then greatly expanded upon.
66 I say again:
90 67
91 I'm putting this here on the Libreboot TODO page, so that I always see it. And
92 I'm keeping it at the top of the page. This TODO entry is still relevant to
93 Libreboot, because it concerns work that I will do in my official capacity,
94 representing Libreboot while helping the (friendly) competition.
95
96 See: <https://osresearch.net/>
97
98 Heads is a really cool project, offering Linux-based kexec payloads on
99 supported hardware. It's another coreboot distro, and their build system design
100 even works similarly to Libreboot's (though they heavily use Makefiles whereas
101 Libreboot exclusively uses shell scripts and uses a much simpler design). Heads
102 provides many advanced security features like measured boot, even things like
103 TOTP-based authentication using secrets stored in the TPM.
104
105 Very, very, very^2 cool project, and Libreboot has plans to integrate some
106 of the same functionalitiys within it (see other notes on this page).
68 Code equals bugs, so fewer lines of code will cause fewer bugs.
107 69
108 70 Interesting board ports Interesting board ports
109 71 ======================= =======================
110 72
73 **Any board port is interesting. These are just a few that happened to be
74 noticed at a given time. The list below is by no means complete!**
75
111 76 Libreboot can support any board from coreboot, in principle. It would also be Libreboot can support any board from coreboot, in principle. It would also be
112 77 feasible to integrate other (libre) boot firmware, if desirable. The list below feasible to integrate other (libre) boot firmware, if desirable. The list below
113 78 is not exhaustive, it just lists boards that are interesting to us at this time: is not exhaustive, it just lists boards that are interesting to us at this time:
 
... ... oreboot is still a good project.
375 340 (though, whenever possible, lbmk should stick to coreboot, to keep things (though, whenever possible, lbmk should stick to coreboot, to keep things
376 341 simpler - are there efforts to implement oreboot ports in coreboot/C?) simpler - are there efforts to implement oreboot ports in coreboot/C?)
377 342
378 UEFI payload
379 ============
380
381 A UEFI payload in Libreboot is highly desirable, because it would basically
382 enable any distro or BSD to Just Work.
383
384 MrChromebox distribution
385 ------------------------
386
387 MrChromebox is another coreboot distro, similar in spirit to Libreboot.
388
389 Of interest: Mrchromebox provides Tianocore-based UEFI setups on chromebooks,
390 and we could probably integrate some of that in Libreboot. Tianocore is
391 essentially bloatware, and really a liability for the Libreboot project due
392 to its complexity, though MrChromebox targets a very different audience.
393
394 Chromebooks (x86)
343 LoongArch support
395 344 ----------------- -----------------
396 345
397 Start supporting x86 chromebooks in Libreboot. We don't support any.
398 There is already MrChromebox, we could just track that, but use our own
399 payloads instead of Tianocore.
400
401 Specifically: lbmk could have a feature added to it where it re-uses configs
402 from MrChromebox, with logic to automatically disable the payload. In lbmk,
403 coreboot configs do not enable payloads at all, because payloads are
404 compiled by lbmk and added after the fact - this is why we have `elf/`
405 containing coreboot images without payloads, and `bin/` which contains the
406 full ROMs, with payloads inside. This design is much more flexible, and permits
407 builds to be re-used more efficiently so as to reduce overall build time, when
408 compiling for multiple mainboards.
409
410 U-Boot SPL and UEFI on x86
411 --------------------------
412
413 Simon Glass has been working extensively on x86 support for U-Boot, to be used
414 as a coreboot payload. This work is of interest to the Libreboot project,
415 because we provide UEFI on ARM but not on x86.
416
417 U-Boot also provides SPL which can be used to execute other software in the
418 flash, and it's often used to boot a Linux kernel; since U-Boot provides a
419 UEFI implementation, it's perfect.
420
421 U-Boot is the preferred choice of UEFI implementation on x86, for Libreboot
422 purposes, because U-Boot uses a coding style similar to Linux and can more
423 easily import Linux drivers which are high quality, and Linux functionality
424 in general, for anything that we need.
425
426 Since we already provide U-Boot on ARM (thanks to the continued work done by
427 Alper Nebi Yasak), U-Boot on x86 would then create a situation whereby Libreboot
428 is consistent across platforms, at least for UEFI-based setups.
346 Ariadne Conill has been working on bringup for coreboot. Work also being done
347 with edk2; U-Boot also desirable here.
429 348
430 349 RockPro64 RockPro64
431 350 --------- ---------
 
... ... For UEFI purposes, U-Boot seems more mature, and it offers other features
445 364 like SPL. As already stated, this is the preferred UEFI implementation for like SPL. As already stated, this is the preferred UEFI implementation for
446 365 Libreboot, but uefistub is listed too because it's interesting. Libreboot, but uefistub is listed too because it's interesting.
447 366
367 Probably useless, since U-Boot is more complete. We may aswell use U-Boot, but
368 uefistub will remain mentioned here for the time being. The context for
369 uefistub is linuxboot-only setups; this is where uefistub can truly shine,
370 specifically on ARM64 devices.
371
448 372 Videos (plus RISCV) Videos (plus RISCV)
449 373 ------ ------
450 374
 
... ... The talks go all the way back to 2018. They're all worth watching.
466 390 Linuxboot Linuxboot
467 391 ========= =========
468 392
393 **NOTE: Stali Linux is a useful base, on top of which any Linux-based setup
394 could be built. With a stripped down kernel, it already provides a sensible
395 build system for ARM64 and AMD64.**
396
469 397 See for inspiration: [Heads project](https://osresearch.net/) See for inspiration: [Heads project](https://osresearch.net/)
470 398 and [Ownerboot project](https://sr.ht/~amjoseph/ownerboot/), these are other and [Ownerboot project](https://sr.ht/~amjoseph/ownerboot/), these are other
471 399 coreboot distros similar to Libreboot, but they provide Linux-based payloads. coreboot distros similar to Libreboot, but they provide Linux-based payloads.
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