From nobody Mon Feb 9 14:33:30 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+91076+1787277+3901457@groups.io; helo=mail02.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+91076+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1657078728; cv=none; d=zohomail.com; s=zohoarc; b=N8zIeGSg7rUgtsB2UbS260LpVznBLyHq3CzFDOnmHC0EaZT5lLWVDfMIzqb5rtP74e9DDzw+xyXF6ch+hDJyqAHAFA3xSKhBzuf6Er6uFXN1PcQNF0KVrqFLj0EVpuLRNsxtc33pfPW9ehD10Imt1VT6gI3+7V+E4lQLLDFtwqM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1657078728; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=GgfG9jnEmtzMHr592YLT/4DVh6/fZ5558AEKQMRXnzs=; b=XQ7LNgC1+Ra/Fs550piEPCE8EXJC+uoIE0rocBSyCLUZ63lbDmYhmjZ4ydl543mvqGH45XddsBpnhVIdOkYf0LLrBcEiCrgjVPBgLhMz72MITaqG9NaywXIZT6iSB+BbSH6oLjQYSo4p1pbI5JOAa6H8LywaPcRgAEBySXyISoI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+91076+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1657078728017138.19596493437462; Tue, 5 Jul 2022 20:38:48 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id tc5WYY1788612xzQBQIEO0zh; Tue, 05 Jul 2022 20:38:47 -0700 X-Received: from mail-pg1-f171.google.com (mail-pg1-f171.google.com [209.85.215.171]) by mx.groups.io with SMTP id smtpd.web12.2157.1657078726858443186 for ; Tue, 05 Jul 2022 20:38:47 -0700 X-Received: by mail-pg1-f171.google.com with SMTP id z14so13065721pgh.0 for ; Tue, 05 Jul 2022 20:38:46 -0700 (PDT) X-Gm-Message-State: fO9bOReCWd8ZcgCrZ9qQTDqvx1787277AA= X-Google-Smtp-Source: AGRyM1tmwsPJ1D2WkNuBJ17ML4y5r3x+UkleQeuXmmym2/Kyvp18mS9ycNyqJmH4TPXKsUCnnqy51w== X-Received: by 2002:a63:e05:0:b0:412:91db:a653 with SMTP id d5-20020a630e05000000b0041291dba653mr2178656pgl.446.1657078726241; Tue, 05 Jul 2022 20:38:46 -0700 (PDT) X-Received: from localhost.localdomain ([192.182.149.255]) by smtp.gmail.com with ESMTPSA id a140-20020a621a92000000b005289fbef7c4sm864251pfa.140.2022.07.05.20.38.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Jul 2022 20:38:45 -0700 (PDT) From: "Kun Qin" To: devel@edk2.groups.io Cc: Andrew Fish , Leif Lindholm , Michael D Kinney , Liming Gao , Zhiguang Liu Subject: [edk2-devel] [edk2-staging][PATCH v1 1/7] EDK2 Code First: PI Specification: New peripheral subclass for TPM Date: Tue, 5 Jul 2022 20:38:12 -0700 Message-Id: <20220706033818.1493-2-kuqin12@gmail.com> In-Reply-To: <20220706033818.1493-1-kuqin12@gmail.com> References: <20220706033818.1493-1-kuqin12@gmail.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,kuqin12@gmail.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1657078727; bh=TGrXERdxj/wZ+HAbi2vvYP1LtDfCjz4pq9GlmBBYT20=; h=Cc:Content-Type:Date:From:Reply-To:Subject:To; b=qT089Dmy6zjXOkwQMaUs1EEfH+tSh68G5AwU//cjyyx1brrGxNAwWqupW6IknN7Cjqk Olt6v3xKFUIZN1UHydUWC+igpPPdkO9cCqryaIkLjW/5Pd6KdihFPbUyQx4V7Ey9L7142 adfQWbZ+N3fVq6wcbUR1V7Mrdj1hjzjbEs4= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1657078728400100004 REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D3966 This change includes specification update markdown file that describes the proposed PI Specification v1.7 Errata A in detail and potential impact to the existing codebase. Cc: Andrew Fish Cc: Leif Lindholm Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Signed-off-by: Kun Qin --- CodeFirst/BZ3966-SpecChange.md | 60 ++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/CodeFirst/BZ3966-SpecChange.md b/CodeFirst/BZ3966-SpecChange.md new file mode 100644 index 000000000000..8a1541bdd577 --- /dev/null +++ b/CodeFirst/BZ3966-SpecChange.md @@ -0,0 +1,60 @@ +# Title: Introduction of `EFI_PERIPHERAL_TPM` Peripheral Subclass Definiti= on + +## Status: Draft + +## Document: UEFI Platform Initialization Specification Version 1.7 Errata= A + +## License + +SPDX-License-Identifier: CC-BY-4.0 + +## Submitter: [TianoCore Community](https://www.tianocore.org) + +## Summary of the change + +Add `EFI_PERIPHERAL_TPM` into Peripheral Subclass definition. + +## Benefits of the change + +Current status code covered various [peripheral subclass definitions](http= s://github.com/tianocore/edk2/blob/master/MdePkg/Include/Pi/PiStatusCode.h). + +As Trusted Platform Module (TPM) becomes more available on the modern syst= ems, status reports from such peripheral are playing more important roles i= n anaylzing the secruity state and healthiness of a system. However, periph= eral subclass definitions do not cover TPM as of today. + +Standardizing the TPM peripheral subclass definition could facilitate the = parsing of peripheral reported errors and avoid potential definition collis= ions from implementation based subclass usages. + +The request of this change intends to expand definitions of `EFI_PERIPHERA= L_**` under Periperhal Subclass definitions to cover the TPM subclass. + +## Impact of the change + +Occupy a new macro definitions of subclass under `Defined Subclasses: User= -Accessible Peripheral Class`. + +## Detailed description of the change [normative updates] + +### Specification Changes + +1. In PI Specification v1.7 Errata A: Vol. 3, Table 3-30: Defined Subclass= es: User-Accessible Peripheral Class, add one new rows below `EFI_PERIPHERA= L_DOCKING` definition and adjust the rest of reserved definitions according= ly: + + | Subclass | Code Name | Description | + | --- | --- | --- | + | Trusted Platform Module | EFI_PERIPHERAL_TPM | The peripheral referr= ed to is a Trusted Platform Module | + | 0x0F=E2=80=930x7F | Reserved for future use by this specification | = | + +1. In PI Specification v1.7 Errata A: Vol. 3, Table 3-84: Defined Subclass= es: User-Accessible Peripheral Class, add one new rows below `EFI_PERIPHERA= L_DOCKING` definition and adjust the rest of reserved definitions according= ly: + + | Subclass | Code Name | + | --- | --- | + | Trusted Platform Module | EFI_PERIPHERAL_TPM | + | 0x0F=E2=80=930x7F | Reserved for future use by this specification. | + +1. In PI Specification v1.7 Errata A: Vol. 3, Section 6.7.2.1 Subclass Def= initions: Prototype, add one new definitions below `EFI_PERIPHERAL_DOCKING`= definition: + + ```c + #define EFI_PERIPHERAL_TPM \ + (EFI_PERIPHERAL | 0x000E0000) + ``` + +### Code Changes + +1. Add macro definitions in `MdePkg/Include/Pi/PiStatusCode.h` to match ne= w specification. +1. Replace existing references of `gEfiSecurityPkgTokenSpaceGuid.PcdStatus= CodeSubClassTpmDevice` from SecurityPkg with new definition. +1. Updated the default value of `gEfiSecurityPkgTokenSpaceGuid.PcdStatusCo= deSubClassTpmDevice` to `(EFI_PERIPHERAL | 0x000E0000)` for consistency and= backwards compatibility outside of SecurityPkg. --=20 2.35.1.windows.2 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#91076): https://edk2.groups.io/g/devel/message/91076 Mute This Topic: https://groups.io/mt/92200212/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-