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 A4CD8D80C7F for ; Wed, 3 Apr 2024 08:38:39 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=Y4MRFzoUwZXcaKJofQ3MDMHWKeiHPGlU9m/D2Y/JO7E=; 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=1712133518; v=1; b=A4Evc8cXGWahREmBI8BJjh4VFjFN+leqUKSRnDUnIyBlBssn4RaF30mvol9wbtO8MH2BdVc2 l36n15RmIApkVXyC10gEgFjnou8E37IanDZMW2Pkt8GxzSF/ZIqSRatGSma8Jy8W/KXPLzFxhf8 PopjLJvxXLG0OIHpyksmPVC5dgL8BuTSOHZm0G9uU+kxhu6Wuoq5gBlmGKW3RWLKm+tSJheav/n 5PN4nqejSddMk1wllv2Kky8XeukrBWMhQk3gZNxiFmtc0vZDdeZR4rsV2olbLLFp1LWzWLwC/GJ mD2aV8DK3H+oHyGvNgBhFMIo0QUotKRYrZY/rRtd2JDKw== X-Received: by 127.0.0.2 with SMTP id f3RlYY7687511xhUAF9jIjA4; Wed, 03 Apr 2024 01:38:38 -0700 X-Received: from NAM12-DM6-obe.outbound.protection.outlook.com (NAM12-DM6-obe.outbound.protection.outlook.com [40.107.243.76]) by mx.groups.io with SMTP id smtpd.web10.6532.1712133517670495816 for ; Wed, 03 Apr 2024 01:38:37 -0700 X-Received: from MW4PR04CA0304.namprd04.prod.outlook.com (2603:10b6:303:82::9) by CH3PR12MB8970.namprd12.prod.outlook.com (2603:10b6:610:176::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7409.46; Wed, 3 Apr 2024 08:38:35 +0000 X-Received: from CO1PEPF000044FD.namprd21.prod.outlook.com (2603:10b6:303:82:cafe::f7) by MW4PR04CA0304.outlook.office365.com (2603:10b6:303:82::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7409.46 via Frontend Transport; Wed, 3 Apr 2024 08:38:34 +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 CO1PEPF000044FD.mail.protection.outlook.com (10.167.241.203) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.7472.0 via Frontend Transport; Wed, 3 Apr 2024 08:38:34 +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; Wed, 3 Apr 2024 03:38:27 -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 V4 1/6] MdePkg/Include: Update definitions of SPI related header files Date: Wed, 3 Apr 2024 16:38:01 +0800 Message-ID: <20240403083806.952-2-abner.chang@amd.com> In-Reply-To: <20240403083806.952-1-abner.chang@amd.com> References: <20240403083806.952-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: CO1PEPF000044FD:EE_|CH3PR12MB8970:EE_ X-MS-Office365-Filtering-Correlation-Id: 4c506348-0219-4fe4-5c44-08dc53b97346 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Message-Info: HydkZ6zXXSHcgikBsnw739hnrKAs1/BUR6FOfh7txvvDqwvXj5OE0LBv/KLAfnlZELwKBW0qUfxPf6wJNnAz1jci5XMwDqIHWUoy99V2utFGiJiZGmI0UMeshacNsQ1KguRTIreRXesWgI1HmaPotkhvNdGhacrL1szWw0DcxklR/+G78KutBNhxOal41oTHk1Oh3uIKwkQCw9BTHGHCy/2O1qFJSxxqiJU66vApZGZVzgy7tStAiQSrAtLkBQ5GF+YV6xU9dtnFHvd2/8DlW75HBfYXIjnJQ7545QCWlAle9rx4A/iOwxY56GVoimXy0ZVdu1WqWRfb3S0YinhKwRCGGQM9tYZGPe0MiSXwrXNUj788Mb9YEHBAc/H+LkHR+1iNqV+bpDMJaQChbtJwyHSX6mNy1mBixnizksHnN/Z+/qRbk9uF0BBYQewxmNwSut/m8glM+QW4tErAVbEN4hG+XisH2N6XrIwZCnSWovmNAV6iyieNT1IS6g/g+FZr69DlpIgIuXOzhy06ttsFsQI4LiDV9NvpHJAPW0JhNBDoKqtgvEKflB29udtNw1RtDEkpLZZjpVgTij67ucyAa/U1ENhBnV7JRpbZzSZ87CTj1dBiM8HNKWgMVvuzt891wk1yuCLg9nImp0pYdS3rT9ainSM0YOOREVWhiNgEzyfWmuTLN4zHlTZ3U/NV2zru8ckh/GytAfGomLvO89ikf6d5APUYaesZaVnUeYv52bFw0CQ7wVcOHHtAqt+L9Z1A X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Apr 2024 08:38:34.4688 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 4c506348-0219-4fe4-5c44-08dc53b97346 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: CO1PEPF000044FD.namprd21.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH3PR12MB8970 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: Wed, 03 Apr 2024 01:38:37 -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: xZwQdYxTRuSVgKee8NwV5vZyx7686176AA= 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=A4Evc8cX; spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io; dmarc=pass (policy=none) header.from=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..7a5da9f9692 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 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..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 (#117359): https://edk2.groups.io/g/devel/message/117359 Mute This Topic: https://groups.io/mt/105304854/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-