From 9381092bb11f48ca9be986b5fca392a1b2e3fb46 Mon Sep 17 00:00:00 2001 From: WuXie Date: Sat, 14 Mar 2026 07:39:31 +0800 Subject: [PATCH 1/3] docs(dts): add generated supported-hardware matrix scaffold --- .../_generated-supported-hardware-matrix.md | 30 ++++++++++++++++ .../documentation/supported-hardware.md | 7 ++++ .../generate_dts_supported_hardware_matrix.py | 35 +++++++++++++++++++ 3 files changed, 72 insertions(+) create mode 100644 docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md create mode 100755 scripts/generate_dts_supported_hardware_matrix.py diff --git a/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md b/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md new file mode 100644 index 0000000000..ac73d3a9f3 --- /dev/null +++ b/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md @@ -0,0 +1,30 @@ + + +| Vendor/Model | Dasharo release id | +|---|---| +| `3mdeb test config / fum_cap_test` | `novacustom_v54x_mtl_igpu` | +| `asrock industrial / nuc box-125h` | `novacustom_nuc_box_mtl` | +| `hardkernel / odroid-h4` | `hardkernel_odroid_h4` | +| `micro-star international co., ltd. / ms-7d25 / pro z690-a (ms-7d25)` | `msi_ms7d25` | +| `micro-star international co., ltd. / ms-7d25 / pro z690-a ddr4(ms-7d25)` | `msi_ms7d25` | +| `micro-star international co., ltd. / ms-7d25 / pro z690-a wifi (ms-7d25)` | `msi_ms7d25` | +| `micro-star international co., ltd. / ms-7d25 / pro z690-a wifi ddr4(ms-7d25)` | `msi_ms7d25` | +| `micro-star international co., ltd. / ms-7e06 / pro z790-p (ms-7e06)` | `msi_ms7e06` | +| `micro-star international co., ltd. / ms-7e06 / pro z790-p ddr4 (ms-7e06)` | `msi_ms7e06` | +| `micro-star international co., ltd. / ms-7e06 / pro z790-p ddr4(ms-7e06)` | `msi_ms7e06` | +| `micro-star international co., ltd. / ms-7e06 / pro z790-p wifi (ms-7e06)` | `msi_ms7e06` | +| `micro-star international co., ltd. / ms-7e06 / pro z790-p wifi ddr4 (ms-7e06)` | `msi_ms7e06` | +| `micro-star international co., ltd. / ms-7e06 / pro z790-p wifi ddr4(ms-7e06)` | `msi_ms7e06` | +| `notebook / ns50_70mu` | `novacustom_ns5x_tgl` | +| `notebook / ns5x_ns7xpu` | `novacustom_ns5x_adl` | +| `notebook / nv4xmb,me,mz` | `novacustom_nv4x_tgl` | +| `notebook / nv4xpz` | `novacustom_nv4x_adl` | +| `notebook / v54x_6x_tu / v540tu` | `novacustom_v54x_mtl_igpu` | +| `notebook / v54x_6x_tu / v560tu` | `novacustom_v56x_mtl_igpu` | +| `notebook / v5xtnc_tnd_tne / v540tnx` | `novacustom_v54x_mtl_dgpu` | +| `notebook / v5xtnc_tnd_tne / v560tnx` | `novacustom_v56x_mtl_dgpu` | +| `novacustom / nuc_box` | `novacustom_nuc_box_mtl` | +| `pc engines / apu2` | `pcengines_apu2` | +| `pc engines / apu3` | `pcengines_apu3` | +| `pc engines / apu4` | `pcengines_apu4` | +| `pc engines / apu6` | `pcengines_apu6` | diff --git a/docs/dasharo-tools-suite/documentation/supported-hardware.md b/docs/dasharo-tools-suite/documentation/supported-hardware.md index 31660c4c36..a194c99fda 100644 --- a/docs/dasharo-tools-suite/documentation/supported-hardware.md +++ b/docs/dasharo-tools-suite/documentation/supported-hardware.md @@ -26,3 +26,10 @@ proprietary vendor EC firmware to the Dasharo EC firmware on this hardware: * [NovaCustom V540TNx](../../variants/novacustom_v540tnx/releases.md) * [NovaCustom V560TU](../../variants/novacustom_v560tu/releases.md) * [NovaCustom V560TNx](../../variants/novacustom_v560tnx/releases.md) + +## Generated mapping matrix (experimental) + +The table below is generated from DTS metadata mapping in `dts-configs` (see `Dasharo/dts-configs#39`) to reduce manual drift in this page. + +--8<-- "dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md" + diff --git a/scripts/generate_dts_supported_hardware_matrix.py b/scripts/generate_dts_supported_hardware_matrix.py new file mode 100755 index 0000000000..b7b6af94aa --- /dev/null +++ b/scripts/generate_dts_supported_hardware_matrix.py @@ -0,0 +1,35 @@ +#!/usr/bin/env python3 +import json +from pathlib import Path + +MAPPING = Path('/tmp/wuxie/dts-configs/configs/docs_supported_platforms.json') +OUT = Path('docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md') + + +def to_display(vendor, model, board): + v = vendor.replace('_', ' ') + if board: + return f"{v} / {model} / {board}" + return f"{v} / {model}" + + +def main(): + data = json.loads(MAPPING.read_text()) + entries = data.get('entries', []) + lines = [ + '', + '', + '| Vendor/Model | Dasharo release id |', + '|---|---|', + ] + for e in entries: + disp = to_display(e['system_vendor'], e['system_model'], e.get('board_model')) + rel = e.get('dasharo_rel_name', '') + lines.append(f"| `{disp}` | `{rel}` |") + + OUT.write_text('\n'.join(lines) + '\n') + print(f'Wrote {OUT} with {len(entries)} rows') + + +if __name__ == '__main__': + main() From fe9906621b05099c0e2b919cc15b4210a81a672a Mon Sep 17 00:00:00 2001 From: WuXie Date: Wed, 15 Apr 2026 21:49:46 +0800 Subject: [PATCH 2/3] docs(dts): fix markdownlint issues in generated matrix include --- .../documentation/_generated-supported-hardware-matrix.md | 2 ++ docs/dasharo-tools-suite/documentation/supported-hardware.md | 3 ++- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md b/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md index ac73d3a9f3..294de6dd3c 100644 --- a/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md +++ b/docs/dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md @@ -1,3 +1,5 @@ +# Supported hardware matrix (generated) + | Vendor/Model | Dasharo release id | diff --git a/docs/dasharo-tools-suite/documentation/supported-hardware.md b/docs/dasharo-tools-suite/documentation/supported-hardware.md index a194c99fda..90a839f73d 100644 --- a/docs/dasharo-tools-suite/documentation/supported-hardware.md +++ b/docs/dasharo-tools-suite/documentation/supported-hardware.md @@ -29,7 +29,8 @@ proprietary vendor EC firmware to the Dasharo EC firmware on this hardware: ## Generated mapping matrix (experimental) -The table below is generated from DTS metadata mapping in `dts-configs` (see `Dasharo/dts-configs#39`) to reduce manual drift in this page. +The table below is generated from DTS metadata mapping in `dts-configs` +(see `Dasharo/dts-configs#39`) to reduce manual drift in this page. --8<-- "dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md" From d0dad4a38ba1eb85e27273de572f79a5030ac2e6 Mon Sep 17 00:00:00 2001 From: WuXie Date: Wed, 15 Apr 2026 21:52:08 +0800 Subject: [PATCH 3/3] docs(dts): normalize EOF newline in supported-hardware page --- docs/dasharo-tools-suite/documentation/supported-hardware.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/dasharo-tools-suite/documentation/supported-hardware.md b/docs/dasharo-tools-suite/documentation/supported-hardware.md index 90a839f73d..083a0be983 100644 --- a/docs/dasharo-tools-suite/documentation/supported-hardware.md +++ b/docs/dasharo-tools-suite/documentation/supported-hardware.md @@ -33,4 +33,3 @@ The table below is generated from DTS metadata mapping in `dts-configs` (see `Dasharo/dts-configs#39`) to reduce manual drift in this page. --8<-- "dasharo-tools-suite/documentation/_generated-supported-hardware-matrix.md" -