diff --git a/docs/unified/novacustom/building-manual.md b/docs/unified/novacustom/building-manual.md index 66067152..80fb8097 100644 --- a/docs/unified/novacustom/building-manual.md +++ b/docs/unified/novacustom/building-manual.md @@ -22,56 +22,40 @@ Make sure that you have following packages installed: ## Build Dasharo BIOS firmware -1. Refer to the table below to set the `SDK`, `REVISION`, and `CONFIG` variables - based on your device and preference: - - using release branch will always result in the latest released version, - - using tag you can specify the exact version to build. - -| Device | SDK version | release branch | tag format | config | -|---------------|-------------------------|----------------|----------------------------|---------------------| -| NV4X TGL | coreboot-sdk:0ad5fbd48d | clevo/release | novacustom_nv4x_vX.Y.Z | novacustom_nv4x_tgl | -| NS5X/7X TGL | coreboot-sdk:0ad5fbd48d | clevo/release | novacustom_ns5x_vX.Y.Z | novacustom_ns5x_tgl | -| NS5X/NS7X ADL | coreboot-sdk:0ad5fbd48d | clevo/release | novacustom_ns5x_adl_vX.Y.Z | novacustom_nv4x_adl | -| NV4X ADL | coreboot-sdk:0ad5fbd48d | clevo/release | novacustom_nv4x_adl_vX.Y.Z | novacustom_ns4x_adl | - 1. Export variables: - ```bash - export SDK="" - export REVISION="" - export CONFIG="" - ``` - - For example, if you want to build `v1.3.0` firmware for the `NS5X ADL`, you - should set: - - ```bash - export SDK="coreboot-sdk:0ad5fbd48d" - ``` - - ```bash - export REVISION="novacustom_ns5x_adl_v1.3.0" - ``` - - ```bash - export CONFIG="config.novacustom_ns5x_adl.3.0" - ``` - 1. Clone the Dasharo coreboot repository: ```bash git clone https://github.com/Dasharo/coreboot.git - ``` - -1. Navigate to the source code directory and checkout to the desired revision: - - ```bash cd coreboot ``` - ```bash - git checkout $REVISION - ``` +1. Checkout to the latest version: + + === "NS5x ADL v1.3.0" + + ```bash + git checkout novacustom_ns5x_adl_v1.3.0 + ``` + + === "NV4x ADL v1.3.0" + + ```bash + git checkout novacustom_nv4x_adl_v1.3.0 + ``` + + === "NS5x TGL v1.3.0" + + ```bash + git checkout novacustom_ns5x_v1.3.0 + ``` + + === "NV4x TGL v1.3.0" + + ```bash + git checkout novacustom_nv4x_v1.3.0 + ``` ```bash git submodule update --init --recursive --checkout @@ -79,19 +63,41 @@ Make sure that you have following packages installed: 1. Start docker container: - ```bash docker run --rm -it -u $UID \ -v $PWD:/home/coreboot/coreboot \ -w /home/coreboot/coreboot \ - $SDK /bin/bash + coreboot-sdk:0ad5fbd48d /bin/bash ``` -1. Inside of the container, configure and start the build process: +1. Inside of the container, configure the build process: - ```bash - cp configs/config.$CONFIG .config - ``` + === "NS5x ADL v1.3.0" + + ```bash + cp configs/config.novacustom_ns5x_adl .config + ``` + + === "NV4x ADL v1.3.0" + + ```bash + cp configs/config.novacustom_nv4x_adl .config + ``` + + === "NS5x TGL v1.3.0" + + ```bash + cp configs/config.novacustom_ns5x_tgl .config + ``` + + === "NV4x TGL v1.3.0" + + ```bash + cp configs/config.novacustom_nv4x_tgl .config + ``` + + +1. Start the build process: ```bash make olddefconfig diff --git a/mkdocs.yml b/mkdocs.yml index dbeda3d8..3f3cce9e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -6,6 +6,8 @@ theme: custom_dir: overrides favicon: images/favicon.png logo: images/dasharo-logo.png + features: + - content.tabs.link extra_css: - stylesheets/extra.css google_analytics: @@ -21,10 +23,15 @@ markdown_extensions: toc_depth: 2 - pymdownx.tasklist: custom_checkbox: true + - pymdownx.superfences + - pymdownx.tabbed: + alternate_style: true nav: - 'Intro': index.md - 'Supported hardware': # - 'Hardware Compatibility List': variants/hardware-compatibility-list.md + - 'building [TEST]': + - 'Building': unified/novacustom/building-manual.md - 'Dell OptiPlex': - 'Overview': variants/dell_optiplex/overview.md - 'Releases': variants/dell_optiplex/releases.md