From 9e0b5cc206632ff3bee337822780d79d70b4233d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Piotr=20Kr=C3=B3l?= Date: Wed, 12 Oct 2022 23:56:13 +0200 Subject: [PATCH 1/2] dasharo certification program: initial commit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Piotr Król --- docs/certification/overview.md | 86 ++++++++++++++++++++++++++++++++++ mkdocs.yml | 30 +++++++----- 2 files changed, 103 insertions(+), 13 deletions(-) create mode 100644 docs/certification/overview.md diff --git a/docs/certification/overview.md b/docs/certification/overview.md new file mode 100644 index 00000000000..ac599fc5555 --- /dev/null +++ b/docs/certification/overview.md @@ -0,0 +1,86 @@ +# Dasharo Certification Program + +Our commitment to long-term maintenance and transparent validation lead us to +creation of Dasharo Certification Program. We would like to recognize that +without strict project management, hardware integration and validation +procedures maintaining significant number of hardware targets would be +impossible. + +More to that to maintain open-source firmware for multiple hardware targets we +have expect certain quality from code + +Dasharo Certification Program consist of three main parts: + +* Dasharo Onboarding with Silicon Vendor +* Project Infrastructure Setup for Dasharo Certification Program +* Lab Setup for Dasharo Certification Program + +Dasharo Certificate consists of test procedures, test results report, and test +logs confirming compliance with Program scope. All results of public Dasharo +Certification Program will be accessible publicly. + +* [Dasharo Universe](https://docs.dasharo.com) +* [Dasharo Github](https://github.com/Dasharo) + +Obviously not all our customers wish to publish Dasharo Certification results. +We respect will of our customers to not make Dasharo Certificaiton public. + +## Goals + +We hope that Dasharo Certification Program will lead to: + +* establishing certain standard for quality of open-source firmware distributions +* better understand of real cost of open-source firmware maintenance +* increase number of certified hardware platforms by bringing already + platforms which are already ported to open-source firmware, but there are no + quality control during the release process + +## Dasharo Onboarding with Silicon Vendor + +Critical part of creating any open-source firmware port since without +documentation any development have to rely on gaining adversarial +interoperability, what may be resource-intensive or in some cases even +impossible. Over the years we realize how to correctly onboard project and +build mutual relation between customers, Silicon Vendor and us. As a result we +included Dasharo Onboarding with Silicon Vendor in Dasharo Certification +Program and make it mendatory part. + +There are rare exceptions from onboarding, but it always have to be decided +individually with customer. + +## Project Infrastructure Setup for Dasharo Certification Program + +Project Infrastructure Setup is first step of Dasharo Certification Program, it +consist of structural approach to following activities: + +* formal Software Provider's resource allocation including legal, logistics and + financial fees, +* program kick-off, +* program execution plan monitoring, coordination and communication, +* Dasharo Certification release quality control. + +## Lab Setup for Dasharo Certification Program + +Every Dasharo Certification candidate have to be integrated in Dasharo +Certification Laboratory. Correct integration means: +* detailed analysis of Client's Infrastructure schematics and documentation, +* setup of remote and automated environment for development, debugging and testing, +* Client's Infrastructure preparation for manual testing procedures, if not all + tests can be automated, +* provisioning and configuration of Dasharo Transparent Validation system that + will execute test required for Dasharo Certification Program, + + + +## Naming conventions + +Dasharo programs are called after microarchitectures supported as part of given +program e.g. Dasharo Intel Alder Lake P Certification Program for MSI PRO +Z790-A DDR5. diff --git a/mkdocs.yml b/mkdocs.yml index fe703d3c4a1..96aafd1a157 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -24,8 +24,8 @@ markdown_extensions: nav: - 'Intro': index.md - 'Supported hardware': - # - 'Hardware Compatibility List': variants/hardware-compatibility-list.md - - 'Dell OptiPlex': + # - 'Hardware Compatibility List': variants/hardware-compatibility-list.md + - 'Dell OptiPlex 9010': - 'Overview': variants/dell_optiplex/overview.md - 'Releases': variants/dell_optiplex/releases.md - 'Building manual': variants/dell_optiplex/building-manual.md @@ -58,7 +58,7 @@ nav: - 'Hardware configuration matrix': variants/talos_2/hardware-matrix.md - 'Test matrix': variants/talos_2/test-matrix.md - 'Conference materials': variants/talos_2/conferences.md - # - 'NovaCustom NV4x 11th gen': + # - 'NovaCustom NV4x 11th gen': - 'NovaCustom NV4x': - 'Overview': variants/novacustom_nv4x/overview.md - 'Releases': variants/novacustom_nv4x/releases.md @@ -181,15 +181,13 @@ nav: - 'Trusted Computing': osf-trolling-list/trusted_computing.md - 'Jira Service Management': osf-trolling-list/jsm_documentation.md - 'Intel ME/CSME': osf-trivia-list/me.md - - 'Ecosystem': - - 'Overview': ecosystem/overview.md - # - 'Customer Infrastructure': ecosystem/customer-infrastructure.md - - 'Transparent Validation': - # - 'Overview': ecosystem/transparent-validation.md - # - 'Testing Infrastructure': ecosystem/testing-infrastructure.md - # - 'Hardware Laboratory': ecosystem/hardware-infrastructure.md - - 'MSI Z690': - - 'Assembly and Validation': transparent-validation/msi-z690/assembly-and-validation.md + - 'Dasharo Certification Program': + - 'Overview': certification/overview.md + - 'Lab Assembly Guides': + - 'Overview': certification/lab-overview.md + - 'Dell OptiPlex 9010': transparent-validation/dell_optiplex/assembly-and-validation.md + - 'MSI PRO Z690-A WIFI DDR4': transparent-validation/msi-z690/assembly-and-validation.md + - 'Hardware tools': - 'muxPi': - 'Theory of Operations': transparent-validation/muxpi/theory-of-operations.md - 'Basic validation': transparent-validation/muxpi/basic-validation.md @@ -197,13 +195,19 @@ nav: - 'Introduction': transparent-validation/rte/introduction.md - 'Specification': transparent-validation/rte/v1.1.0/specification.md - 'Getting Started': transparent-validation/rte/v1.1.0/getting-started.md - # - 'RTE and PC Engines': transparent-validation/rte/pcengines.md + - 'RTE and PC Engines': transparent-validation/rte/pcengines.md - 'RTE Reference OS': transparent-validation/rte/v1.1.0/reference-os.md - 'Revision History': transparent-validation/rte/revision-history.md - 'SD Wire': - 'Getting started': transparent-validation/sd-wire/getting-started.md - 'Specification': transparent-validation/sd-wire/specification.md - 'Usage': transparent-validation/sd-wire/usage-validation.md + - 'Ecosystem': + - 'Overview': ecosystem/overview.md + # - 'Customer Infrastructure': ecosystem/customer-infrastructure.md + # - 'Overview': ecosystem/transparent-validation.md + # - 'Testing Infrastructure': ecosystem/testing-infrastructure.md + # - 'Hardware Laboratory': ecosystem/hardware-infrastructure.md # - 'Secure Storage': ecosystem/secure-storage.md # - 'Signing Server': ecosystem/signing-server.md # - 'Attestation Server': ecosystem/attestation-server.md From 444581ce46c40294b7901de9708567afbd6c8a54 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Piotr=20Kr=C3=B3l?= Date: Wed, 12 Oct 2022 23:59:23 +0200 Subject: [PATCH 2/2] dtp: clean up and docs structure improvement MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Piotr Król --- docs/transparent-validation/rte/pcengines.md | 1 - mkdocs.yml | 9 ++++----- 2 files changed, 4 insertions(+), 6 deletions(-) delete mode 100644 docs/transparent-validation/rte/pcengines.md diff --git a/docs/transparent-validation/rte/pcengines.md b/docs/transparent-validation/rte/pcengines.md deleted file mode 100644 index 49412e0080b..00000000000 --- a/docs/transparent-validation/rte/pcengines.md +++ /dev/null @@ -1 +0,0 @@ -# How to connect RTE to PC Engines? diff --git a/mkdocs.yml b/mkdocs.yml index 96aafd1a157..43982f6af54 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -183,10 +183,6 @@ nav: - 'Intel ME/CSME': osf-trivia-list/me.md - 'Dasharo Certification Program': - 'Overview': certification/overview.md - - 'Lab Assembly Guides': - - 'Overview': certification/lab-overview.md - - 'Dell OptiPlex 9010': transparent-validation/dell_optiplex/assembly-and-validation.md - - 'MSI PRO Z690-A WIFI DDR4': transparent-validation/msi-z690/assembly-and-validation.md - 'Hardware tools': - 'muxPi': - 'Theory of Operations': transparent-validation/muxpi/theory-of-operations.md @@ -195,13 +191,16 @@ nav: - 'Introduction': transparent-validation/rte/introduction.md - 'Specification': transparent-validation/rte/v1.1.0/specification.md - 'Getting Started': transparent-validation/rte/v1.1.0/getting-started.md - - 'RTE and PC Engines': transparent-validation/rte/pcengines.md - 'RTE Reference OS': transparent-validation/rte/v1.1.0/reference-os.md - 'Revision History': transparent-validation/rte/revision-history.md - 'SD Wire': - 'Getting started': transparent-validation/sd-wire/getting-started.md - 'Specification': transparent-validation/sd-wire/specification.md - 'Usage': transparent-validation/sd-wire/usage-validation.md + - 'Lab Assembly Guides': + - 'Overview': certification/lab-overview.md + # - 'Dell OptiPlex 9010': transparent-validation/dell_optiplex/assembly-and-validation.md + - 'MSI PRO Z690-A WIFI DDR4': transparent-validation/msi-z690/assembly-and-validation.md - 'Ecosystem': - 'Overview': ecosystem/overview.md # - 'Customer Infrastructure': ecosystem/customer-infrastructure.md