From 20d08fb292f40d866e4daca16b94adfd7ef973ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20=C5=BBygowski?= <michal.zygowski@3mdeb.com>
Date: Fri, 15 May 2026 17:25:30 +0200
Subject: [PATCH] docs/variants/gigabyte_mz33-ar1/building-manual.md: Add build
 procedure
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Michał Żygowski <michal.zygowski@3mdeb.com>
---
 .../gigabyte_mz33-ar1/building-manual.md      | 59 +++++++++++++++++--
 docs/variants/gigabyte_mz33-ar1/releases.md   |  6 --
 2 files changed, 54 insertions(+), 11 deletions(-)

diff --git a/docs/variants/gigabyte_mz33-ar1/building-manual.md b/docs/variants/gigabyte_mz33-ar1/building-manual.md
index 68c92da5..d6a340e2 100644
--- a/docs/variants/gigabyte_mz33-ar1/building-manual.md
+++ b/docs/variants/gigabyte_mz33-ar1/building-manual.md
@@ -15,9 +15,58 @@ MZ33-AR1.
 
 ## Building
 
-!!! Error "STOP"
+To build Dasharo (coreboot+UEFI) firmware image, first clone the coreboot
+repository:
 
-    Building the firmware from source is currently only available after
-    purchasing the product from [our
-    shop](https://shop.3mdeb.com/product/full-build-gigabyte-mz33-ar1-with-dasharo-corebootuefi-pro-package-for-servers/)
-    and agreeing to the terms of service.
+```bash
+git clone https://github.com/Dasharo/coreboot.git
+```
+
+then follow the steps below:
+
+1. To build a specific version checkout to the version's tag.
+    Skip this step otherwise.
+
+    ```bash
+    cd coreboot
+    git checkout gigabyte_mz33_ar1_<version>
+    ```
+
+    For example
+
+    ```bash
+    git checkout gigabyte_mz33_ar1_v0.9.0
+    ```
+
+2. Checkout submodules:
+
+    ```bash
+    git submodule update --init --checkout
+    ```
+
+3. Download the package with necessary blobs and put it in proper directory:
+
+{{ tos_checkbox("gigabyte-mz33-ar1-v090-blobs") }}
+
+<div id="gigabyte-mz33-ar1-v090-blobs"
+     class="tos-gate-content" markdown="1"
+     style="display: none">
+
+- Download the [blobs
+package](https://dl.3mdeb.com/open-source-firmware/Dasharo/gigabyte_mz33_ar1/uefi/v0.9.0/Turin.zip).
+- Then unzip it to the following directory:
+
+    ```bash
+    unzip Turin.zip -d 3rdparty/blobs/soc/amd/
+    ```
+
+</div>
+
+Now build the firmware:
+
+```bash
+./build.sh mz33_ar1
+```
+
+The resulting coreboot image will be placed in the coreboot directory as
+`asrock_spc741d8_<version>.rom` and
diff --git a/docs/variants/gigabyte_mz33-ar1/releases.md b/docs/variants/gigabyte_mz33-ar1/releases.md
index 3f8c7e6e..493e1689 100644
--- a/docs/variants/gigabyte_mz33-ar1/releases.md
+++ b/docs/variants/gigabyte_mz33-ar1/releases.md
@@ -73,10 +73,6 @@ Test results for this release can be found
 
 ### Binaries
 
-{{ tos_checkbox("gigabyte-mz33-ar1-v090-binaries") }}
-
-<div id="gigabyte-mz33-ar1-v090-binaries" class="tos-gate-content" markdown="1" style="display: none">
-
 #### Raw Dasharo image
 
 [sha256][gigabyte_mz33_ar1_v0.9.0.rom_hash]{.md-button}
@@ -95,8 +91,6 @@ Test results for this release can be found
 [sha256][gigabyte_mz33_ar1_v0.9.0.sbom.json_hash]{.md-button}
 [sha256.sig][gigabyte_mz33_ar1_v0.9.0.sbom.json_sig]{.md-button}
 
-</div>
-
 This is a Dasharo Pro Package release. For this platform, access to pre-built
 binaries is provided exclusively through the
 [Full Build for Gigabyte MZ33-AR1](https://shop.3mdeb.com/product/full-build-gigabyte-mz33-ar1-with-dasharo-corebootuefi-pro-package-for-servers/),