From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by spool.mail.gandi.net (Postfix) with ESMTPS id E007974003E for ; Tue, 1 Aug 2023 07:57:46 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=v4012EOe2JVfx9iaF/s5fQIVduI0/IolFAe2o66jTOI=; c=relaxed/simple; d=groups.io; h=X-Received:X-Received:ARC-Seal:ARC-Message-Signature:ARC-Authentication-Results:X-Received:X-Received:X-MS-Exchange-Authentication-Results:Received-SPF:X-Received:X-Received:From:To:CC:Subject:Date:Message-ID:In-Reply-To:References:MIME-Version:X-Originating-IP:X-ClientProxiedBy:X-EOPAttributedMessage:X-MS-PublicTrafficType:X-MS-TrafficTypeDiagnostic:X-MS-Office365-Filtering-Correlation-Id:X-MS-Exchange-SenderADCheck:X-MS-Exchange-AntiSpam-Relay:X-Microsoft-Antispam-Message-Info:X-OriginatorOrg:X-MS-Exchange-CrossTenant-OriginalArrivalTime:X-MS-Exchange-CrossTenant-Network-Message-Id:X-MS-Exchange-CrossTenant-Id:X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp:X-MS-Exchange-CrossTenant-AuthSource:X-MS-Exchange-CrossTenant-AuthAs:X-MS-Exchange-CrossTenant-FromEntityHeader:X-MS-Exchange-Transport-CrossTenantHeadersStamped:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:X-Gm-Message-State:Conte nt-Transfer-Encoding:Content-Type; s=20140610; t=1690876665; v=1; b=Vy2O/RPGEkjs65URg31AJzXyzBgycNx4YzI07iO/z72UgeCn9v2T7GdJElbHaV/Xard0q43g tJZxRQBLM1B2Smjb1M6uu9wGX60mIZ/h2gWaIAgsR1JrWMpvqbRxZTkzPbM7A3xYBPmGAnYpe58 UR6gO74+LqtMlQ2ZE1gQSvQE= X-Received: by 127.0.0.2 with SMTP id rsgtYY7687511x3Jcyeolgj3; Tue, 01 Aug 2023 00:57:45 -0700 X-Received: from NAM04-DM6-obe.outbound.protection.outlook.com (NAM04-DM6-obe.outbound.protection.outlook.com [40.107.102.51]) by mx.groups.io with SMTP id smtpd.web10.7841.1690876664980215056 for ; Tue, 01 Aug 2023 00:57:45 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=BvDfxM2mU2Xx2GWM5tkBKAxwBUwr96Qf3TmmNp+1raJ5idSo03MIFJqfg/gvNekRUFJsvqUosUa2/LvvoPsOGLi5l4a6ETrXV2dNIO/neQV8+ynUaqVOVOZ8PMPlOtGDt/RQqXodsqX/QWSnpFrhh1KycgJdMyL+E6CfjmrGKWPTtPSu36jtwyq56eJyb8v6wBUVREqDu9lI67qzVdt9Se2ykR54YAmAiAXuvvyS5hKoNcvg6xMzzSbxb+uR7UOEmlGTPw10P+/x4couMOClZ+1US04kVuZ/6I8d20foOZzLktNe1g69AZWJF4YoRtDv/k7Bx/6Ut/sdMOxrboF74w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=xx+lZ5TUJyKzkpZTwj6Oo3FOx1RedYkhlY3VmvzbjPw=; b=B9U4njaQK/gAgF/aObIRLfSVyl1hh112otgGnT5Rf6WzMDFiUw5p0N3tjnu3ZCjVOerjpR3fArAwGa8BeqZ9UNylTXxauOrqoYbMnrE9xjjXr2N0dcqcG/L8RA8keDhX+adSOhBIEfZ8BoevHkSKM85bvEcod0pb6KRr8RH7MSXwd09k7Pw8IVdlh4N0ZlZ4LwZDz81T2d1mZXs29HZs+RNnolrOqL/5DeENULvzTK8BQHnqbQ96QMosGENVK/jPAOFEVjeV0wa8bH7JlP/YJKjlgVHR/inPDuc//z/rgc6We8clBM65M85voNEU5WSU1yQZI19hYd8AIUUoZ+WsEQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=edk2.groups.io smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none X-Received: from CY5PR15CA0123.namprd15.prod.outlook.com (2603:10b6:930:68::14) by DM6PR12MB4976.namprd12.prod.outlook.com (2603:10b6:5:1ba::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6631.44; Tue, 1 Aug 2023 07:57:42 +0000 X-Received: from CY4PEPF0000EE31.namprd05.prod.outlook.com (2603:10b6:930:68:cafe::79) by CY5PR15CA0123.outlook.office365.com (2603:10b6:930:68::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6631.44 via Frontend Transport; Tue, 1 Aug 2023 07:57:42 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C X-Received: from SATLEXMB04.amd.com (165.204.84.17) by CY4PEPF0000EE31.mail.protection.outlook.com (10.167.242.37) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6631.29 via Frontend Transport; Tue, 1 Aug 2023 07:57:42 +0000 X-Received: from TPE-L1-ABNCHANG.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Tue, 1 Aug 2023 02:57:39 -0500 From: "Chang, Abner via groups.io" To: CC: Michael D Kinney , Liming Gao , Zhiguang Liu , "Abdul Lateef Attar" Subject: [edk2-devel] [PATCH V2 1/6] MdePkg/Include: Update definitions of SPI related header files Date: Tue, 1 Aug 2023 15:57:20 +0800 Message-ID: <20230801075725.1102-2-abner.chang@amd.com> In-Reply-To: <20230801075725.1102-1-abner.chang@amd.com> References: <20230801075725.1102-1-abner.chang@amd.com> MIME-Version: 1.0 X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB04.amd.com (10.181.40.145) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY4PEPF0000EE31:EE_|DM6PR12MB4976:EE_ X-MS-Office365-Filtering-Correlation-Id: 94bc9f9c-4212-46ab-f0de-08db9264fc17 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Message-Info: rrRfvGsNIoTDDd6YyaQ40HJyfqQvjEwHzwtuj9zQEbdPS3c5YT/N7pTAQMGO0x8uH187jsq3nuOpPsMMjGXBIW0QFp8PWLLRDo+KIFqaZWW53ciCvp2ZdLpffhbLYdpGVOOOL8/o4+a7r8Guta7kXIjIoK/Ve4833XG1rBYnhyMQxxPHMR7eJ7jxciU8OSmwT5iKKmWWG5+V+hhdLPoljmIbCp4kvlZEPaevxlqw0iERecntPkx1yCii2x1686vpGk2MQzp0ydXLLyRQD64bM8h9L39hq7y27t1ZWtcsIW4eVuNLqJPKoXMu7SAUXlMiOsBUgIh9c1/HypxlA2+xbrPsN2Vt2GoRzqZ7qvC4sPiAQAUPaJXjXW+GSSSi62Y+F0Waq7VHjmnAYXWGf0F22hhSB4mt85CPg6sxg7GuoDatPnSLyDu5ZTL9AMfd0SWJW3fnP7p99ClzZI/U/KP0ARgN5pkwBsPSMb44VwgPC6UkOB5Db6M2S+oQehEml4CTMCVWju98UveJFHqKnpqID1eH4wRdAfBoc855jqcXlez3kEM6kr5o9MLTLneqp+bpa0mwHoxw9pnB1wBfNnuRzwpWX46hBsxcU5M5JYfId/0Dps/RXPt50IRmgXGQm1hTWwti1Bvg4xHh4KeZWJ86qIfL7gdWb5adFE5ZGHNK82EdACQWwqFNVlsbI3bkV9he11D/tNc51zaz3LxT0uXIzCc6uY2syfZefbstkp90FTpwYzH3XqMhRTFGfydpeHgzWs8OlYrw6JPWd0LR5RLJAw== X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Aug 2023 07:57:42.5619 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 94bc9f9c-4212-46ab-f0de-08db9264fc17 X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d;Ip=[165.204.84.17];Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: CY4PEPF0000EE31.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR12MB4976 Precedence: Bulk 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,abner.chang@amd.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: cuVjSnpcdC8pcmLlWHuDGuwGx7686176AA= Content-Transfer-Encoding: quoted-printable Content-Type: text/plain X-GND-Status: LEGIT Authentication-Results: spool.mail.gandi.net; dkim=pass header.d=groups.io header.s=20140610 header.b="Vy2O/RPG"; dmarc=none; spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io; arc=reject ("signature check failed: fail, {[1] = sig:microsoft.com:reject}") From: Abner Chang BZ#: 4471 Update definitions according to PI spec v1.8 Errata as it is approved in PIWG (Ticket #2394). Signed-off-by: Abner Chang Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Abdul Lateef Attar --- MdePkg/Include/Protocol/SpiConfiguration.h | 8 ++++++++ MdePkg/Include/Protocol/SpiHc.h | 14 ++++++++++++++ MdePkg/Include/Protocol/SpiIo.h | 10 ++++++++++ 3 files changed, 32 insertions(+) diff --git a/MdePkg/Include/Protocol/SpiConfiguration.h b/MdePkg/Include/Pr= otocol/SpiConfiguration.h index 3f8fb9ff62c..cffdc8e232d 100644 --- a/MdePkg/Include/Protocol/SpiConfiguration.h +++ b/MdePkg/Include/Protocol/SpiConfiguration.h @@ -2,6 +2,7 @@ This file defines the SPI Configuration Protocol. =20 Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Revision Reference: @@ -168,6 +169,13 @@ typedef struct _EFI_SPI_BUS { VOID *ClockParameter; } EFI_SPI_BUS; =20 +/// +/// Definitions of SPI Part Attributes. +/// +#define SPI_PART_SUPPORTS_2_BIT_DATA_BUS_WIDTH BIT0 +#define SPl_PART_SUPPORTS_4_B1T_DATA_BUS_WIDTH BIT1 +#define SPl_PART_SUPPORTS_8_B1T_DATA_BUS_WIDTH BIT2 + /// /// The EFI_SPI_PERIPHERAL data structure describes how a specific block o= f /// logic which is connected to the SPI bus. This data structure also sele= cts diff --git a/MdePkg/Include/Protocol/SpiHc.h b/MdePkg/Include/Protocol/SpiH= c.h index 30128dd5c4d..645bfdefe9b 100644 --- a/MdePkg/Include/Protocol/SpiHc.h +++ b/MdePkg/Include/Protocol/SpiHc.h @@ -2,6 +2,7 @@ This file defines the SPI Host Controller Protocol. =20 Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Revision Reference: @@ -121,6 +122,19 @@ typedef EFI_STATUS IN EFI_SPI_BUS_TRANSACTION *BusTransaction ); =20 +/// +/// Definitions of SPI Host Controller Attributes. +/// +#define HC_SUPPORTS_WRITE_ONLY_OPERATIONS BIT0 +#define HC_SUPPORTS_READ_ONLY_OPERATIONS BIT1 +#define HC_SUPPORTS_WRITE_THEN_READ_OPERATIONS BIT2 +#define HC_TX_FRAME_IN_MOST_SIGNIFICANT_BITS BIT3 +#define HC_RX_FRAME_IN_MOST_SIGNIFICANT_BITS BIT4 +#define HC_SUPPORTS_2_BIT_DATA_BUS_WIDTH BIT5 +#define HC_SUPPORTS_4_BIT_DATA_BUS_WIDTH BIT6 +#define HC_SUPPORTS_8_BIT_DATA_BUS_WIDTH BIT7 +#define HC_TRANSFER_SIZE_INCLUDES_OPCODE BIT8 +#define HC_TRANSFER_SIZE_INCLUDES_ADDRESS BIT9 /// /// Support a SPI data transaction between the SPI controller and a SPI ch= ip. /// diff --git a/MdePkg/Include/Protocol/SpiIo.h b/MdePkg/Include/Protocol/SpiI= o.h index b4fc5e03b88..0ea881fd115 100644 --- a/MdePkg/Include/Protocol/SpiIo.h +++ b/MdePkg/Include/Protocol/SpiIo.h @@ -2,6 +2,7 @@ This file defines the SPI I/O Protocol. =20 Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (C) 2023 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Revision Reference: @@ -223,6 +224,15 @@ typedef struct _EFI_SPI_BUS_TRANSACTION { UINT8 *ReadBuffer; } EFI_SPI_BUS_TRANSACTION; =20 +/// +/// Definitions of SPI I/O Attributes. +/// +#define SPI_IO_SUPPORTS_2_BIT_DATA_BUS_WIDTH BIT0 +#define SPI_IO_SUPPORTS_4_BIT_DATA_BUS_WIDTH BIT1 +#define SPI_IO_SUPPORTS_8_BIT_DATA_BUS_WIDTH BIT2 +#define SPI_IO_TRANSFER_SIZE_INCLUDES_OPCODE BIT3 +#define SPI_IO_TRANSFER_SIZE_INCLUDES_ADDRESS BIT4 + /// /// Support managed SPI data transactions between the SPI controller and a= SPI /// chip. --=20 2.37.1.windows.1 -=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 (#107419): https://edk2.groups.io/g/devel/message/107419 Mute This Topic: https://groups.io/mt/100478918/7686176 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-