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 0D6BAAC0DC6 for ; Thu, 4 Apr 2024 09:25:22 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=u/zJat2OQ1g46kXwn3sZeno4pewZ1T9+nqfjZi5GXf8=; c=relaxed/simple; d=groups.io; h=Received-SPF:From:To:CC:Subject:Date:Message-ID:In-Reply-To:References:MIME-Version:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Resent-Date:Resent-From:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:Content-Transfer-Encoding:Content-Type; s=20240206; t=1712222721; v=1; b=tNimzJF8zp7SogCUnj+tI208kadZh+m9pWYaMLvpK9BdYpluEBBw/QOhs43GmKeOLrgWTEWC jFv5AK8KkQuC4DY/DQLZN/Q5KQkGPwSfFvyzON92hCCqukKMhkMSLUbLvSy61wtJ7iJUjjjICpC 7iQyuDFrmBgeMJiICIY/c7+trJClAT1+E4zZeIstc9YVFnv98Dze63fYOpXhpARCZ/GApkDsAiN GmugGonHDAR/mUB6C2/EMBbgzZ1BHa8dUJVF0uo1yhwOeIS1l32wgi1q9vrzrTGKWPlhIV3qQSW mBh4ASZAoTVWCfAUsYtAUhkvTrknimlGUd/t92+jrX7RQ== X-Received: by 127.0.0.2 with SMTP id IczoYY7687511xL2wj27zhPt; Thu, 04 Apr 2024 02:25:21 -0700 X-Received: from NAM02-BN1-obe.outbound.protection.outlook.com (NAM02-BN1-obe.outbound.protection.outlook.com [40.107.212.52]) by mx.groups.io with SMTP id smtpd.web11.33835.1712222720929116235 for ; Thu, 04 Apr 2024 02:25:21 -0700 X-Received: from DM6PR08CA0065.namprd08.prod.outlook.com (2603:10b6:5:1e0::39) by MN2PR12MB4173.namprd12.prod.outlook.com (2603:10b6:208:1d8::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7409.32; Thu, 4 Apr 2024 09:25:17 +0000 X-Received: from DS1PEPF0001709B.namprd05.prod.outlook.com (2603:10b6:5:1e0:cafe::ec) by DM6PR08CA0065.outlook.office365.com (2603:10b6:5:1e0::39) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7409.46 via Frontend Transport; Thu, 4 Apr 2024 09:25:17 +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 DS1PEPF0001709B.mail.protection.outlook.com (10.167.18.105) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.7452.22 via Frontend Transport; Thu, 4 Apr 2024 09:25:17 +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.35; Thu, 4 Apr 2024 04:25:15 -0500 From: "Chang, Abner via groups.io" To: CC: Michael D Kinney , Liming Gao , Zhiguang Liu , "Abdul Lateef Attar" , Brit Chesley Subject: [edk2-devel] [PATCH V5 1/6] MdePkg/Include: Update definitions of SPI related header files Date: Thu, 4 Apr 2024 17:24:49 +0800 Message-ID: <20240404092455.1903-2-abner.chang@amd.com> In-Reply-To: <20240404092455.1903-1-abner.chang@amd.com> References: <20240404092455.1903-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: DS1PEPF0001709B:EE_|MN2PR12MB4173:EE_ X-MS-Office365-Filtering-Correlation-Id: 7328f78a-7fd3-4264-19de-08dc54892478 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Message-Info: CQDPHiWs5z2yqvOD5WdeGaqH+m8XDel4UuyxQnTSY9PP/jjhnWn56SqJRfW15+Y540oqB5dSLCEPI56FgFUg9bVofg4BaJJddNkQwR+7/dejBaBmIS4gIHYk769GdnFQY7ujSP/gdqzFB38EKMFFwRLuo5LVEsg5383r8yFTVMa9YgszIeblUE582ml7IcNN30F1ceWQVHKwfsXUfV0gwl1uQF+2RDas3w8aW2aJW6ZPAKp0akTQVYxk3tRQQVdZaW2AyQudxxK5yiPzfW1bBie5fUQ0e0C0UnscqxBeEqfnKZtf12mcg9xOp6G3wX3hfvI7gf1BliMPoDeCTjhSSl6wf7oBB24GMG7LCluC0K9qmQ9FRgGYaHjCJNjl/3LuPAzdirPoaWXBDvSLtC9Hqb7f2dQTv2eRhjJXWwxWaKm8g8zyHyh32Tl63PE7Tlm1KRSJ7TZYvI9Le3ax4xnwun6pfToz69Fv8hv5iUC617GOEm+A/QfFdApib3HIGpFv6InzljXqs8X6iZuL5gouIEC8WPwtlwrvZ5uxlCNUYriH5fITM9ekDiisZlwJ2KCWUiQ/nnMmyabh/U1wpNrnE2Y6j+6IfOLw4Pq8amQvoF5Bnqq4JvQQZhY/wxUkQPC5ao9dlw5aUa50hD0FI84+LrWLJ+v1qW71i386u8VchRnDL8WYGzHCkF6jG7kteNNbyej3F1I72BOFPYk7ub6JoFZiX2UxDJ4IJTAjb7F/GOq5qpn7uz4WNDBMr+ziz2Vm X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 Apr 2024 09:25:17.6215 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 7328f78a-7fd3-4264-19de-08dc54892478 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: DS1PEPF0001709B.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR12MB4173 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 Resent-Date: Thu, 04 Apr 2024 02:25:21 -0700 Resent-From: abner.chang@amd.com Reply-To: devel@edk2.groups.io,abner.chang@amd.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: kPLK0eG8JwfWBxwys2GKU1xdx7686176AA= 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=20240206 header.b=tNimzJF8; dmarc=pass (policy=none) header.from=groups.io; spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io From: abnchang BZ#: 4471 Update definitions according to PI spec 1.8 errata A Signed-off-by: Abner Chang Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Abdul Lateef Attar Cc: Brit Chesley --- MdePkg/Include/Protocol/SpiConfiguration.h | 10 +++++++++- MdePkg/Include/Protocol/SpiHc.h | 16 +++++++++++++++- MdePkg/Include/Protocol/SpiIo.h | 12 +++++++++++- 3 files changed, 35 insertions(+), 3 deletions(-) diff --git a/MdePkg/Include/Protocol/SpiConfiguration.h b/MdePkg/Include/Pr= otocol/SpiConfiguration.h index 3f8fb9ff62c..120b54bbad8 100644 --- a/MdePkg/Include/Protocol/SpiConfiguration.h +++ b/MdePkg/Include/Protocol/SpiConfiguration.h @@ -2,10 +2,11 @@ This file defines the SPI Configuration Protocol. =20 Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Revision Reference: - This Protocol was introduced in UEFI PI Specification 1.6. + This Protocol was introduced in UEFI PI Specification 1.8 A. =20 **/ =20 @@ -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 SPI_PART_SUPPORTS_4_B1T_DATA_BUS_WIDTH BIT1 +#define SPI_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..354de721606 100644 --- a/MdePkg/Include/Protocol/SpiHc.h +++ b/MdePkg/Include/Protocol/SpiHc.h @@ -2,10 +2,11 @@ This file defines the SPI Host Controller Protocol. =20 Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Revision Reference: - This Protocol was introduced in UEFI PI Specification 1.6. + This Protocol was introduced in UEFI PI Specification 1.8 A. =20 **/ =20 @@ -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..2c95a375a20 100644 --- a/MdePkg/Include/Protocol/SpiIo.h +++ b/MdePkg/Include/Protocol/SpiIo.h @@ -2,10 +2,11 @@ This file defines the SPI I/O Protocol. =20 Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (C) 2024 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: BSD-2-Clause-Patent =20 @par Revision Reference: - This Protocol was introduced in UEFI PI Specification 1.6. + This Protocol was introduced in UEFI PI Specification 1.8 A. =20 **/ =20 @@ -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 (#117414): https://edk2.groups.io/g/devel/message/117414 Mute This Topic: https://groups.io/mt/105325718/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-