From 05203fc5cd4d3c979b0e16fb83b80f3593186d1c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vincent=20Stehl=C3=A9?= <vincent.stehle@arm.com>
Date: Fri, 8 Sep 2023 11:09:43 +0200
Subject: [PATCH] chapter2: smbios requirements
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Require SMBIOS and some structures.
- Add a reference to the SMBIOS specification v3.7.0.

Suggested-by: Peter Robinson <pbrobinson@redhat.com>
Signed-off-by: Vincent Stehlé <vincent.stehle@arm.com>
---
 source/chapter2-uefi.rst | 29 +++++++++++++++++++++++++++++
 source/references.rst    |  4 ++++
 2 files changed, 33 insertions(+)

diff --git a/source/chapter2-uefi.rst b/source/chapter2-uefi.rst
index f8bfae0..25e7ae6 100644
--- a/source/chapter2-uefi.rst
+++ b/source/chapter2-uefi.rst
@@ -362,6 +362,35 @@ The DTB must be contained in memory of type `EfiACPIReclaimMemory`.
 .. [#ACPIMemNote] `EfiACPIReclaimMemory` was chosen to match the recommendation
    for ACPI tables which fulfill the same task as the DTB.
 
+SMBIOS
+------
+
+Firmware shall provide SMBIOS tables and structures as described in
+[SMBIOS]_ § 5 & 6. [#SMBNote]_
+All of the following SMBIOS structures are required for EBBR compliance.
+
+.. list-table:: Required SMBIOS structures
+   :widths: 50 50
+   :header-rows: 1
+
+   * - Structure
+     - Description
+   * - BIOS Information (Type 0)
+     - Provides BIOS informations, such as vendor and version.
+   * - System Information (Type 1)
+     - Provides system informations, such as product name, manufacturer and
+       serial number.
+   * - System Enclosure or Chassis (Type 3)
+     - Provides chassis informations, such as the asset tag.
+   * - Processor Information (Type 4)
+     - Provides CPU informations, such as the type, count and frequency.
+   * - System Boot Information (Type 32)
+     - Provides the boot status.
+
+.. [#SMBNote] Support tools such as sosreport use SMBIOS to provide information
+   to users and collect information for support cases.
+   https://github.com/sosreport/sos
+
 UEFI Boot Services
 ==================
 
diff --git a/source/references.rst b/source/references.rst
index 727d5e3..ed25e80 100644
--- a/source/references.rst
+++ b/source/references.rst
@@ -51,3 +51,7 @@ Bibliography
    Version 20211203
 
 .. [RVUEFI] `RISC-V UEFI Protocol Specification <https://github.com/riscv-non-isa/riscv-uefi/releases/download/1.0.0/RISCV_UEFI_PROTOCOL-spec.pdf>`_
+
+.. [SMBIOS] `System Management BIOS (SMBIOS) Reference Specification v3.7.0
+   <https://www.dmtf.org/sites/default/files/standards/documents/DSP0134_3.7.0.pdf>`_,
+   July 2023, `DMTF <https://www.dmtf.org>`_