From patchwork Wed Sep 3 13:36:08 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 197 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1756906636; bh=yyBg7XZGXVvJMixIDRVUCHY84dfQtO5+jHI3yhVjcVI=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=YPaKKjdKtWwqMJLV6V7RlmpnlXjVJDmiWzlYN/dZVg3sR7q03kARxKEi/04Y5e1ZU mW3exq7+Gy8vO0OuCcGbY1UpWZUzD/aOHhLABZ5MFg88kDR73Ym1GKVpwmPxw7j7JR UNM6+R/WDhvc5hbgh454Mty7HP0OWQEYXK0AqjuUJ8Bu4vTYVLeAWtb/+/qqggXVFG TvniEyvfy+KcT5nDnIPBohfIfgX02tk4ta+7O/9qKafoz8blIjRAWHJz3bsX2UW1jj /94/AAwhsIni0m+ze4d3G+0MB85r8BuRaprodEJgNY3fkf0PNQrZJYWTxGbwRecl9V jaK0LwohN0F9Q== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id ABDCF678B5 for ; Wed, 3 Sep 2025 07:37:16 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id cN_4IHqi4F5t for ; Wed, 3 Sep 2025 07:37:16 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1756906636; bh=yyBg7XZGXVvJMixIDRVUCHY84dfQtO5+jHI3yhVjcVI=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=YPaKKjdKtWwqMJLV6V7RlmpnlXjVJDmiWzlYN/dZVg3sR7q03kARxKEi/04Y5e1ZU mW3exq7+Gy8vO0OuCcGbY1UpWZUzD/aOHhLABZ5MFg88kDR73Ym1GKVpwmPxw7j7JR UNM6+R/WDhvc5hbgh454Mty7HP0OWQEYXK0AqjuUJ8Bu4vTYVLeAWtb/+/qqggXVFG TvniEyvfy+KcT5nDnIPBohfIfgX02tk4ta+7O/9qKafoz8blIjRAWHJz3bsX2UW1jj /94/AAwhsIni0m+ze4d3G+0MB85r8BuRaprodEJgNY3fkf0PNQrZJYWTxGbwRecl9V jaK0LwohN0F9Q== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 999486789D for ; Wed, 3 Sep 2025 07:37:16 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1756906633; bh=j1dkL1ZUIEVAODav3QWM+S3wJKyrJbgpovZZO0GQ4X0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=XQ1/Jx0oaX0kkbsMai513SCW0rAlLmVOYHt4mx4KnM6Ib0Tdg+h4XQBM3l+jkpIed huTAcMo38LhAU3WU57LQCf3Qo8ey8U5AsmQoW/QC5uCxEsMwL9y5tu8lfjnqTbZfQZ BImjqmIerm1e03/KpK7+JEmPa6pyCCj5kyvR41SP25JHvH5BuiT0jG+ZLjfpBrHNQ7 u3XoIueJbxrlXVt+/k2rw2olG0fvshZJLXUC0ewL4vzYvr7foDPrUW5xB1bekk8JRV +RHvAkuQNry4zuPjqN9Yzz4VrE+Z4sWZrB1rlGZZ1r18jBCkIv5B9Y8e9/X/Pwav6O ifTpoBMRzsuHQ== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id F37A6678B5; Wed, 3 Sep 2025 07:37:13 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id 0lIVpPDfP0SX; Wed, 3 Sep 2025 07:37:13 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1756906630; bh=KcoCO2JKktrenrgoxosWZocnScqBy1fejEfStBeAd0M=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=rGuXcyjFnqfeUSeWrkMGY10u1YSxr1PRBh2LfYJ2AcwpqPdHujfV1o+SiKMtEJ9rR xBMGmnJ1ubA12WIgoZmJUa79pszs+ETdXL6e/MwyXSgGkkVVg1pXYw6adYSbEibzTG zQOHXyqC8yJFRPXKw6fklKUaXlthwJInLrbc/vXJYz0oPBskl0vcLZPYHwarRN5Ng+ 3F+pVMSOXQNezh9bMBt5jAjce8kB7xTVWxT+n+tlq+qGUf/uef/lu8Rv0Zs69bMwp/ /mDCtxz8IGbNDQWBfl3h/4DF5y3/zXxz6labipTPeAivRN1JPTiGi7pTzG5lmwOizS 0W4JDoupGAwYA== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id BB84D5FCF5; Wed, 3 Sep 2025 07:37:09 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Wed, 3 Sep 2025 07:36:08 -0600 Message-ID: <20250903133639.3235920-9-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250903133639.3235920-1-sjg@u-boot.org> References: <20250903133639.3235920-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: WOYNIPSR3IUN4DBRKZ7UET2TE7OXJIIX X-Message-ID-Hash: WOYNIPSR3IUN4DBRKZ7UET2TE7OXJIIX X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Simon Glass , Claude X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 08/25] smbios: Add comments for smbios_type1 (System Information) List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass Document the SMBIOS Type 1 structure so it is clear what each field means. Update struct smbios_header also. Co-developed-by: Claude --- include/smbios.h | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/include/smbios.h b/include/smbios.h index 8073364cb04..86a1a1b76f9 100644 --- a/include/smbios.h +++ b/include/smbios.h @@ -130,6 +130,16 @@ struct __packed smbios3_entry { u64 struct_table_address; }; +/** + * struct smbios_header - Common header for all SMBIOS structures + * + * This header appears at the beginning of every SMBIOS structure and + * provides basic identification and size information for the structure. + * + * @type: SMBIOS structure type (0-127 for standard types) + * @length: Length of the formatted portion of the structure in bytes + * @handle: Unique 16-bit identifier for this structure instance + */ struct __packed smbios_header { u8 type; u8 length; @@ -158,6 +168,24 @@ struct __packed smbios_type0 { #define SMBIOS_TYPE1_LENGTH_V21 0x19 #define SMBIOS_TYPE1_LENGTH_V24 0x1b +/** + * struct smbios_type1 - SMBIOS Type 1 (System Information) structure + * + * This structure contains information that identifies the system as a + * whole. It includes manufacturer, model, version, serial number, UUID, + * and other system-level identification information. + * + * @hdr: Common SMBIOS structure header + * @manufacturer: String number for manufacturer name + * @product_name: String number for product name + * @version: String number for version + * @serial_number: String number for serial number + * @uuid: Universal unique identifier for the system (16 bytes) + * @wakeup_type: Identifies the event that caused the system to power up + * @sku_number: String number for the system SKU + * @family: String number for the family of systems + * @eos: End-of-structure marker (double null bytes) + */ struct __packed smbios_type1 { struct smbios_header hdr; u8 manufacturer;