dasharo/docs
0
0
Fork 0
mirror of https://github.com/Dasharo/docs.git synced 2026-06-13 10:16:57 -07:00
Code Issues Packages Projects Releases Wiki Activity

Dasharo/docs: Fixed changes and modified test-matrix

Browse Source 
Signed-off-by: maheshtammisetti <mahesh.tammisetti@3mdeb.com>
This commit is contained in:
maheshtammisetti
2023-03-15 14:07:38 +05:30
parent 629bc45f07
commit 0a2a4eecf9
6 changed files with 58 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/variants/qemu_q35/building-manual.md
+3 -8
View File
@@ -50,17 +50,12 @@ Following is an example of SMM feature enabled,
Check the following build command:
```bash
build -D DEBUG_ON_SERIAL_PORT -D BOOTLOADER=COREBOOT -a IA32 -a X64 -t GCC5 -b DEBUG -p OvmfPkg/OvmfPkgX64.dsc.
build -a IA32 -a X64 -t GCC5 -b DEBUG -p OvmfPkg/OvmfPkgX64.dsc.
```
- `DEBUG_ON_SERIAL_PORT` = The following flag must be given for the **DEBUG** build
as the output is redirected to the I/O port **0x402** to qemu monitor.
- Debug messages are visible on given I/O port.
**0x402** will be later utilized for qemu invocation further in this documentation.
- Once the build is completed, the OVMF firmware image can be found below given path:
```bash
edk2/Build/Ovmf/DEBUG_GCC5/Ovmf.fd
edk2/Build/Ovmf/DEBUG_GCC5/FV/OVMF_CODE.fd
edk2/Build/Ovmf/DEBUG_GCC5/FV/OVMF_VARS.fd
```
docs/variants/qemu_q35/development.md
+9 -9
View File
@@ -6,10 +6,10 @@
docker instance (host machine) using built OVMF firmware image.
+ QEMU Installation:
- [Install QEMU on your linux distro](<https://www.qemu.org/download/#linux>)
- [Install QEMU on your linux distro](https://www.qemu.org/download/#linux)
```bash
qemu-system-x86_64 -drive if=pflash,format=raw,file=Build/OvmfX64/DEBUG_GCC5/FV/OVMF.fd -debugcon file:debug.log -global isa-debugcon.iobase=0x402 -global ICH9-LPC.disable_s3=1 -net none -machine q35,smm=on
qemu-system-x86_64 -drive if=pflash,format=raw,file=Build/OvmfX64/RELEASE_GCC5/FV/OVMF.fd -debugcon file:debug.log -global ICH9-LPC.disable_s3=1 -net none -machine q35,smm=on
```
+ `-drive` indicate device is pflash with firmware image of built OVMF.fd image.
@@ -31,7 +31,7 @@ only Q35 machines are supported hence the machine type.
1. After executing the above qemu command,
qemu boots into UEFI built-in shell and to BIOS selection area.
1. The features which are enabled in `OvmfPkgX64.dsc` can be verified at `BIOS menu`.
1. The features which are enabled in `OvmfPkgX64.dsc` can be verified at `Setup menu`.
At `Device Manager section` Dasharo features can
be verified in `Dasharo System Features` section.
@@ -43,7 +43,7 @@ only Q35 machines are supported hence the machine type.
rebuild the OVMF image with the following command.
```bash
build -D DEBUG_ON_SERIAL_PORT -D BOOTLOADER=COREBOOT -a IA32 -a X64 -t GCC5 -b DEBUG -p OvmfPkg/OvmfPkgX64.dsc
build -a IA32 -a X64 -t GCC5 -b RELEASE -p OvmfPkg/OvmfPkgX64.dsc
```
1. By making some changes in the `OvmfPkgX64.dsc` file, one can add features like
@@ -74,7 +74,6 @@ DEFINE OPAL_PASSWORD_ENABLE = TRUE
TcgStorageCoreLib|SecurityPkg/Library/TcgStorageCoreLib/TcgStorageCoreLib.inf
TcgStorageOpalLib|SecurityPkg/Library/TcgStorageOpalLib/TcgStorageOpalLib.inf
!endif
S3BootScriptLib|MdePkg/Library/BaseS3BootScriptLibNull/BaseS3BootScriptLibNull.inf
#
#
```
@@ -95,9 +94,10 @@ SecurityPkg/HddPassword/HddPasswordPei.inf
## Dasharo System Features
1. The .FDF file tells about location of source file and options used for build process.
1. The `.fdf` describes about source file location and variables used during
build process.
2. Below code snippet shows about the location of `SATA_PASSWORD` .inf file.
2. Below code snippet shows about the location of `SATA disk password` `.inf` file.
```bash
!if $(SATA_PASSWORD_ENABLE) == TRUE
@@ -105,8 +105,8 @@ INF SecurityPkg/HddPassword/HddPasswordDxe.inf
!endif
```
+ Include all necessary source file locations
to point at source libraries in .FDF file.
+ Include all necessary source file locations to point at source libraries
in .FDF file.
+ Below is the snippet of the SATA_PASSWORD support in `Device Manager`.
docs/variants/qemu_q35/hardware-matrix.md
+29
View File
@@ -0,0 +1,29 @@
# Hardware configuration matrix
## Introduction
This document describes the devices emulated by the QEMU Q35.
## QEMU Q35 //TBD
| Component | Description |
|--------------------------------|---------------------------------------------|
| **CPU** | Intel Core i3-10110U |
| **RAM** | Slot 1: Empty |
| | Slot 2: SAMSUNG M471A4G43MB1-CTD |
| **Flash memory** | Macronix KH25L12835F |
| **SSD** | Samsung MZVLB256HBHQ-00000 |
| **MMC drive** | SAMSUNG KLM8G1GETF-B041 (on-board) |
| **USB pendrives** | 1. SanDisk Ultra Flair USB 3.0 16 GB |
| **USB Keyboard** | DELL KB216 |
| **USB Mouse** | DELL MS116p |
| **Wireless card** | Intel Wi-Fi 6 AX200 |
| **Display** | Display 1: HDMI 1920x1080p |
| | Display 2: DP 1920x1080p |
| **Ethernet controller** | 6x intel i225 (on-board) |
| **Internal devices** | Audio subsystem |
| **TPM** | Protectli TPM |
| **Network** | Local network wired connection |
| **Remote Testing Environment** | RTE v1.1.0 |
| **Power Control** | RTE v1.1.0 |
| **Power supply** | Channel Well Technology 12V, 3.33A 40W |
docs/variants/qemu_q35/overview.md
+12
View File
@@ -11,6 +11,18 @@
* [Development](development.md) - describes information for running
Dasharo OVMF in QEMU Q35 machine and for Dasharo Developers.
* [Initial deployment](initial-deployment.md) - QEMU is an emulation environment
and not real hardware thus firmware deployment is not applicable.
* [Firmware update](firmware-update.md) - QEMU is an emulation environment
and not real hardware thus firmware update is not applicable.
* [Recovery](recovery.md) - QEMU is an emulation environment and not a
real hardware thus firmware recovery is not applicable.
* [Hardware configuration matrix](hardware-matrix.md) - describes about the
devices emulated by QEMU.
## Useful documents
* [EDK2 OVMF Package Documentation](https://github.com/tianocore/edk2/blob/master/OvmfPkg/README)
docs/variants/qemu_q35/test-matrix.md
-4
View File
@@ -40,9 +40,5 @@ Certification Procedure for tested platform:
| No. | Supported test suite | Test suite ID | Supported test cases |
|:-----|:--------------------------------------------------|:-------------:|:-------------------------------------|
| 1. | [Secure Boot support][SBO] | SBO | All |
| 2. | [ME neuter support][MNE] | MNE | All |
| 3. | [BIOS lock support][BLS] | BLS | All |
[SBO]: ../../unified-test-documentation/dasharo-security/206-secure-boot.md
[MNE]: ../../unified-test-documentation/dasharo-security/20F-me-neuter.md
[BLS]: ../../unified-test-documentation/dasharo-security/20J-bios-lock-support.md
mkdocs.yml
+5 -1
View File
@@ -148,8 +148,12 @@ nav:
- 'Overview': variants/qemu_q35/overview.md
- 'Releases': variants/qemu_q35/releases.md
- 'Building manual': variants/qemu_q35/building-manual.md
- 'Development': variants/qemu_q35/development.md
- 'Test matrix': variants/qemu_q35/test-matrix.md
- 'Development': variants/qemu_q35/development.md
- 'Initial Deployment': variants/qemu_q35/initial-deployment.md
- 'Firmware update': variants/qemu_q35/firmware-update.md
- 'Recovery': variants/qemu_q35/recovery.md
- 'Hardware Configuration Matrix': variants/qemu_q35/hardware-matrix.md
- 'MSI PRO Z690-A':
- 'Overview': variants/msi_z690/overview.md
- 'Releases': variants/msi_z690/releases.md