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 25.06 master
List of commits:
Subject Hash Author Date (UTC)
Notes pertaining to T480/3050 FSP licensing 19fab472018d2f8315b0236f163b7c7725f575be Leah Rowe 2024-12-29 16:56:19
also mention that they are 0201 jumpers 6447f5d1831f0b431f7f8ff824b403b4c9c73c73 Leah Rowe 2024-12-29 15:33:54
jumpers, not jumpjumpers, not jumpss 58bab1695b02f1bc5045479330f262a3e8a3a957 Leah Rowe 2024-12-29 15:15:17
thoUART t480 007136a010c4d620d381532914e0d0b60eb79b72 Leah Rowe 2024-12-29 15:12:25
update t480/3050 errata (tpm and 8254 timer) aad0b223e054d0591274dc0fcfa29618fca8933b Leah Rowe 2024-12-29 14:52:45
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
Commit 19fab472018d2f8315b0236f163b7c7725f575be - Notes pertaining to T480/3050 FSP licensing
Signed-off-by: Leah Rowe <info@minifree.org>
Author: Leah Rowe
Author date (UTC): 2024-12-29 16:56
Committer name: Leah Rowe
Committer date (UTC): 2024-12-29 16:56
Parent(s): 6447f5d1831f0b431f7f8ff824b403b4c9c73c73
Signer:
Signing key:
Signing status: N
Tree: 8b08c1742398848b5868f4101049385f5a3250a8
File Lines added Lines deleted
site/docs/install/dell3050.md 65 1
site/docs/install/t480.md 73 2
File site/docs/install/dell3050.md changed (mode: 100644) (index e5f6e98..c41487e)
... ... Build ROM image from source
82 82
83 83 The build target, when building from source, is thus: The build target, when building from source, is thus:
84 84
85 ./mk -b coreboot dell3050micro_fsp_16mb
85 ./mk -b coreboot dell3050micro_vfsp_16mb
86 86
87 87 Mate Kukri's *deguard* utility disables the Intel Boot Guard on this Mate Kukri's *deguard* utility disables the Intel Boot Guard on this
88 88 machine. Libreboot uses this by default, along with `me_cleaner` to provide machine. Libreboot uses this by default, along with `me_cleaner` to provide
 
... ... SMT is rarely of benefit in practise, but can be useful in some circumstances.
215 215 For example, if you're compiling a large codebase from source that takes hours, For example, if you're compiling a large codebase from source that takes hours,
216 216 SMT increases the building speed by about 15 percent; for example, a 3 hour SMT increases the building speed by about 15 percent; for example, a 3 hour
217 217 build job might take about 2 hours and 40 minutes instead. build job might take about 2 hours and 40 minutes instead.
218
219 Intel FSP copyright
220 ===================
221
222 Abstract
223 --------
224
225 The initial Libreboot 20241206 release included Intel FSP directly inside the
226 ROM images. Intel provides the FSP under a license which states (and I
227 paraphrase): you must not modify it, but you can redistribute it freely, so
228 long as the license notice is retained.
229
230 The FSP is a concatenation of three modules: FSP-T, FSP-S and FSP-M. T basically
231 does CAR, S is essentially romstage components, and M is raminit. Due to how
232 coreboot works, these components must be split into single components. Coreboot
233 doesn't use T by default (it implements CAR itself), but has the option to
234 use it. It will use M and S, only.
235
236 Technically, the process of splitting FSP into these three files counts as
237 a modification. Furthermore, coreboot also rebases the M module by modifying
238 certain pointers, so that it can integrate with coreboot to provide raminit.
239
240 Intel *themselves* own the copyright to the tool for splitting FSP,
241 at `3rdparty/fsp/Tools/SplitFspBin.py`, and it seems that they do intend for
242 the FSP to be used this way. However, until now, those using the Intel FSP
243 have built coreboot images from source, so the issue of modified distributions
244 didn't come up.
245
246 By the strictest possible interpretation of Intel's licensing, Libreboot was
247 technically in violation. To mitigate this, Libreboot 20241206 *revision 8* and
248 newer, will no longer include the Intel FSP inside images. Instead, the vendor
249 inject script is used for inserting the FSP into release images, which is what
250 we already do for several other components.
251
252 `_fsp` vs `_vfsp` targets
253 -------------------------
254
255 The original 20241206 release images had `_fsp` in the file name. From rev8
256 onward, `_vfsp` is specified instead.
257
258 Libreboot's inject script verifies checksums on files, when inserting into the
259 images. Because of this, if we inject FSP after the fact, that means anyone
260 using the old images will find errors when they try.
261
262 To mitigate this, the build targets containing `_fsp` in the name have been
263 retained, but these targets are set `release="n"` so that no ROM images are
264 provided in releases. The `_vfsp` images are provided pre-compiled, instead.
265
266 With this re-design, modern lbmk (from Libreboot 20241206 rev8 onward) can still
267 reliably inject Intel ME into the old `_fsp` images, if you already downloaded
268 those before.
269
270 Therefore, you must be especially careful to get this right. If you're running
271 the inject script into a tarball, it will generally detect the right one, but
272 inserting manually into individual image files is also possible; if you do this,
273 you must remember to correctly specify `dell3050micro_vfsp_16mb`,
274 or to specify the `_fsp` targets if you're doing this on older images.
275
276 It is extremely unlikely that Intel would have ever cracked down on Libreboot
277 for its previous mistake, since many other projects exist that include FSP
278 directly in coreboot images, even commercially. However, Libreboot wishes to
279 respect Intel's license, in the
280 most [technically correct](https://www.youtube.com/watch?v=0ZEuWJ4muYc) way
281 possible.
File site/docs/install/t480.md changed (mode: 100644) (index c442125..33d1fad)
... ... Please refer to the standard [build instructions](../build/) first.
127 127
128 128 The build target, when building from source, is thus: The build target, when building from source, is thus:
129 129
130 ./mk -b coreboot t480_fsp_16mb
131 ./mk -b coreboot t480s_fsp_16mb
130 ./mk -b coreboot t480_vfsp_16mb
131 ./mk -b coreboot t480s_vfsp_16mb
132 132
133 133 **NOTE: The T480 and T480s may be similar, but they do have several critical **NOTE: The T480 and T480s may be similar, but they do have several critical
134 134 differences in their wiring, so you MUST flash the correct image. Please differences in their wiring, so you MUST flash the correct image. Please
 
... ... git add config/coreboot/t480s_fsp_16mb/
518 518 git commit -s -m "experimental/unstable t480 thunderbolt support" git commit -s -m "experimental/unstable t480 thunderbolt support"
519 519 ``` ```
520 520
521 **NOTE: With the above change, or if using the branch referenced below,
522 the build targets will be `t480_fsp_16mb` and `t480s_fsp_16mb`,
523 not `t480_vfsp_16mb` and `t480s_vfsp_16mb`; see notes regarding fsp/vfsp
524 elsewhere on this page. This branch also does not contain other fixes from
525 Libreboot 20231206 rev8/newer, since it's based on 20241206 rev2. A rebase will
526 not be conducted; instead, ThunderBolt PCI-E support will simply be added in
527 a subsequent release, and revision to the 20241206 release.**
528
521 529 You can now follow standard [build instructions](../build/). You can now follow standard [build instructions](../build/).
522 530
523 531 The branch named `20241206-t480-thunderbolt-unstable` already has the above The branch named `20241206-t480-thunderbolt-unstable` already has the above
 
... ... If you encounter this issue, check\
551 559 [this page](../../faq.md#thinkpad-acpi) [this page](../../faq.md#thinkpad-acpi)
552 560 for details as to how to fix this. for details as to how to fix this.
553 561
562 Intel FSP copyright
563 ===================
564
565 Abstract
566 --------
567
568 The initial Libreboot 20241206 release included Intel FSP directly inside the
569 ROM images. Intel provides the FSP under a license which states (and I
570 paraphrase): you must not modify it, but you can redistribute it freely, so
571 long as the license notice is retained.
572
573 The FSP is a concatenation of three modules: FSP-T, FSP-S and FSP-M. T basically
574 does CAR, S is essentially romstage components, and M is raminit. Due to how
575 coreboot works, these components must be split into single components. Coreboot
576 doesn't use T by default (it implements CAR itself), but has the option to
577 use it. It will use M and S, only.
578
579 Technically, the process of splitting FSP into these three files counts as
580 a modification. Furthermore, coreboot also rebases the M module by modifying
581 certain pointers, so that it can integrate with coreboot to provide raminit.
582
583 Intel *themselves* own the copyright to the tool for splitting FSP,
584 at `3rdparty/fsp/Tools/SplitFspBin.py`, and it seems that they do intend for
585 the FSP to be used this way. However, until now, those using the Intel FSP
586 have built coreboot images from source, so the issue of modified distributions
587 didn't come up.
588
589 By the strictest possible interpretation of Intel's licensing, Libreboot was
590 technically in violation. To mitigate this, Libreboot 20241206 *revision 8* and
591 newer, will no longer include the Intel FSP inside images. Instead, the vendor
592 inject script is used for inserting the FSP into release images, which is what
593 we already do for several other components.
594
595 `_fsp` vs `_vfsp` targets
596 -------------------------
597
598 The original 20241206 release images had `_fsp` in the file name. From rev8
599 onward, `_vfsp` is specified instead.
600
601 Libreboot's inject script verifies checksums on files, when inserting into the
602 images. Because of this, if we inject FSP after the fact, that means anyone
603 using the old images will find errors when they try.
604
605 To mitigate this, the build targets containing `_fsp` in the name have been
606 retained, but these targets are set `release="n"` so that no ROM images are
607 provided in releases. The `_vfsp` images are provided pre-compiled, instead.
608
609 With this re-design, modern lbmk (from Libreboot 20241206 rev8 onward) can still
610 reliably inject Intel ME into the old `_fsp` images, if you already downloaded
611 those before.
612
613 Therefore, you must be especially careful to get this right. If you're running
614 the inject script into a tarball, it will generally detect the right one, but
615 inserting manually into individual image files is also possible; if you do this,
616 you must remember to correctly specify `t480_vfsp_16mb` or `t480s_vfsp_16mb`,
617 or to specify the `_fsp` targets if you're doing this on older images.
618
619 It is extremely unlikely that Intel would have ever cracked down on Libreboot
620 for its previous mistake, since many other projects exist that include FSP
621 directly in coreboot images, even commercially. However, Libreboot wishes to
622 respect Intel's license, in the
623 most [technically correct](https://www.youtube.com/watch?v=0ZEuWJ4muYc) way
624 possible.
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