Skip to content

Commit 6cedf2d

Browse files
gaspar-ilomgaspar-ilom
committed
add github actions add Binary-Blobs and Maintainers-and-Testers pages
taken from OP of linuxboot/heads#692 - split into two pages - add section on maintainers - remove out-of-date section on MRC blobs (not used anymore) - include BOARDS_AND_TESTERS.md from main repo - force inclusion in [local]_config.yml - allow triggering wiki deployment from heads repo Signed-off-by: gaspar-ilom <gasparilom@riseup.net>
1 parent 62abc69 commit 6cedf2d

5 files changed

Lines changed: 163 additions & 0 deletions

File tree

‎.github/workflows/jekyll-gh-pages.yml‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# orkflow for building and deploying a Jekyll site to GitHub Pages
2+
name: Deploy Heads Wiki Jekyll with GitHub Pages
3+
4+
on:
5+
# Runs on pushes targeting the default branch or triggered from main repo in case md files are pushed there
6+
push:
7+
branches: ["master", "problem-resolution"]
8+
9+
# Allows manual runs
10+
workflow_dispatch:
11+
12+
repository_dispatch:
13+
types: [redeploy-wiki]
14+
15+
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
16+
permissions:
17+
contents: read
18+
pages: write
19+
id-token: write
20+
21+
# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
22+
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
23+
concurrency:
24+
group: "pages"
25+
cancel-in-progress: false
26+
27+
jobs:
28+
# Build job
29+
build:
30+
runs-on: ubuntu-latest
31+
steps:
32+
- name: Checkout
33+
uses: actions/checkout@v4
34+
with:
35+
ref: ${{ github.event.client_payload.ref }}
36+
# Fetch markdown files maintained in the main repo for rendering as part of the Wiki
37+
- name: Fetch sources from main repo
38+
working-directory: ./Development
39+
run: |
40+
curl -H 'Accept: application/vnd.github+raw' -O -L https://raw.githubusercontent.com/gaspar-ilom/heads/heads-wiki-actions/BOARDS_AND_TESTERS.md
41+
- name: Setup Pages
42+
uses: actions/configure-pages@v5
43+
- name: Build with Jekyll
44+
uses: actions/jekyll-build-pages@v1
45+
with:
46+
source: ./
47+
destination: ./_site
48+
- name: Upload artifact
49+
uses: actions/upload-pages-artifact@v3
50+
51+
# Deployment job
52+
deploy:
53+
environment:
54+
name: github-pages
55+
url: ${{ steps.deployment.outputs.page_url }}
56+
runs-on: ubuntu-latest
57+
needs: build
58+
steps:
59+
- name: Deploy to GitHub Pages
60+
id: deployment
61+
uses: actions/deploy-pages@v4

‎Development/Binary-Blobs.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
layout: default
3+
title: Binary Blobs
4+
permalink: /Binary-Blobs/
5+
nav_order: 3
6+
parent: Development
7+
---
8+
9+
<!-- markdownlint-disable MD033 -->
10+
<details open markdown="block">
11+
<summary>
12+
Table of contents
13+
</summary>
14+
{: .text-delta }
15+
1. TOC
16+
{:toc}
17+
</details>
18+
<!-- markdownlint-enable MD033 -->
19+
20+
Coreboot specs
21+
===
22+
23+
Intel
24+
====
25+
26+
- xxx0: [gm45 bridge, Montevina: no FSP, no ME: X200, T400, T500, R500, X300](https://doc.coreboot.org/mainboard/lenovo/montevina_series.html) : **no QubesOS support there** (no proper vt-d2)
27+
- [xx20](https://doc.coreboot.org/mainboard/lenovo/x2xx_series.html): [Sandy bridge, no FSP. ME<10: BUP module required only: X220/T420/T520](https://doc.coreboot.org/mainboard/lenovo/Sandy_Bridge_series.html)
28+
- xx30: [Ivy bridge, no FSP. ME<10: ROMP and BUP required: X230/T430/W530](https://doc.coreboot.org/mainboard/lenovo/Ivy_Bridge_series.html) Z220 CMT and others
29+
30+
Additional required Intel blobs:
31+
=====
32+
33+
- [FSP is present in all Broadwell+ platforms](https://doc.coreboot.org/soc/intel/fsp/index.html)
34+
35+
ME status on different boards models
36+
=====
37+
38+
- [Removed in ME <=6 (xxx0)](https://libreboot.org/faq.html#intelme)
39+
- [Deactivated+Neutered ME in ME 6 <= 10 (xx20 BUP/xx30 BUP+ROMP)](https://github.com/corna/me_cleaner/wiki/How-does-it-work%3F#me-versions-from-60-nehalem-to-10x-broadwell-1)
40+
- [Deactivate+Partially Neutered (BUP, RBE, Kernel and syslibs modules **REQUIRED** in ME > 11)](https://github.com/corna/me_cleaner/wiki/How-does-it-work%3F#me-versions-from-11x-skylake-1)
41+
- [Soft disable/HAP disable bit possible on ME 12+ (**PoC BE CAUTIOUS**)](https://github.com/corna/me_cleaner/pull/384)
42+
- [xx30, xx20](https://github.com/corna/me_cleaner/wiki/How-does-it-work%3F#me-versions-from-60-nehalem-to-10x-broadwell): ME 6 <= 10
43+
- [Skylake, Kabylake, Whiskeylake and newer](https://github.com/corna/me_cleaner/wiki/How-does-it-work%3F#me-versions-from-11x-skylake): ME >= 11
44+
- Intel ME then changed its name to Converged Security Management Engine (CSME), where HAP bit can be flipped, but modules cannot be removed anymore.
45+
46+
AMD
47+
====
48+
49+
- [AMD fam15h](https://doc.coreboot.org/soc/amd/family15h.html?highlight=amd) (**eg: kgpe-d16**)
50+
- [PSP in all models after fam15h](https://doc.coreboot.org/soc/amd/psp_integration.html)
51+
52+
Power9
53+
====
54+
55+
- Blobless.

‎Development/Maintainers-and-Testers.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
layout: default
3+
title: Maintainers and Testers
4+
permalink: /Maintainers-and-Testers/
5+
nav_order: 3
6+
parent: Development
7+
---
8+
9+
<!-- markdownlint-disable MD033 -->
10+
<details open markdown="block">
11+
<summary>
12+
Table of contents
13+
</summary>
14+
{: .text-delta }
15+
1. TOC
16+
{:toc}
17+
</details>
18+
<!-- markdownlint-enable MD033 -->
19+
20+
21+
Maintainers
22+
===
23+
24+
- [@tlaurion](https://github.com/tlaurion) (was Insurgo, not selling hardware anymore, project is currently under-funded)
25+
- [@JonathonHall-Purism](https://github.com/JonathonHall-Purism) (purism)
26+
- [@nestire](https://github.com/nestire) (nitrokey)
27+
- [@osresearch](https://github.com/osresearch) (founder of project, not active)
28+
29+
Board testers
30+
===
31+
32+
See [Board Testers](https://github.com/linuxboot/heads/blob/master/BOARD_TESTERS.md).
33+
34+
Integration/Test
35+
===
36+
37+
- Reproducibility expertise: [@osresearch](https://github.com/osresearch) [@flammit](https://github.com/flammit) [@JonathonHall-Purism](https://github.com/JonathonHall-Purism) [@tlaurion](https://github.com/tlaurion)
38+
- Integration expertise: [@tlaurion](https://github.com/tlaurion) [@JonathonHall-Purism](https://github.com/JonathonHall-Purism)
39+
- qemu: [@JonathonHall-Purism](https://github.com/JonathonHall-Purism) [@tlaurion](https://github.com/tlaurion)
40+
- Continuous Integration environments: [@SergiiDmytruk](https://github.com/SergiiDmytruk) [@tlaurion](https://github.com/tlaurion) [@Tonux599](https://github.com/Tonux599) ?
41+
42+
**Please add where you can help so that you are comfortable being tagged in issues.**
43+

‎_config.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ aux_links_new_tab: true
99

1010
title: Heads - Wiki
1111

12+
include: [Development/BOARDS_AND_TESTERS.md]
13+
1214
last_edit_timestamp: true # show or hide edit time - page must have `last_modified_date` defined in the frontmatter
1315
last_edit_time_format: "%b %e %Y at %I:%M %p" # uses ruby's time format: https://ruby-doc.org/stdlib-2.7.0/libdoc/time/rdoc/Time.html
1416

‎local_config.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ aux_links_new_tab: true
99

1010
title: Heads - Wiki
1111

12+
include: [Development/BOARDS_AND_TESTERS.md]
13+
1214
last_edit_timestamp: true # show or hide edit time - page must have `last_modified_date` defined in the frontmatter
1315
last_edit_time_format: "%b %e %Y at %I:%M %p" # uses ruby's time format: https://ruby-doc.org/stdlib-2.7.0/libdoc/time/rdoc/Time.html
1416

0 commit comments

Comments
 (0)