From patchwork Thu Nov 30 10:11:31 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ard Biesheuvel X-Patchwork-Id: 120099 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp470719qgn; Thu, 30 Nov 2017 02:11:55 -0800 (PST) X-Google-Smtp-Source: AGs4zMab+zx24+PnoMiJ2OCXRQEu6rB0PVd/uF1F8Au0j9u3fVQSbivHj70Dci7Of8+6A5kyqxMj X-Received: by 10.84.232.200 with SMTP id x8mr2046144plm.101.1512036715591; Thu, 30 Nov 2017 02:11:55 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1512036715; cv=none; d=google.com; s=arc-20160816; b=bH+S+Md7xf6PmJZOpDrGQV0YMAooUGZZGhadgh2eCfSwme5Yir3zY3KBPM1QpT4Tl/ Z/XwNo0etw6vPh2x1TsYSrhlCCf7lqxTFYfBPOmVt5pnKSJ4Tie6QSUptAVWmWfMeY+S w+fCb+k9XOlyMm1hHgX4+eWhmq8qxQXcNitpx4kMKAJkVc7CFQW7WGCzFegVVqSXKgFX EevP9vVbbJvcscxK/oiDK4XRvE2+CsSZQWzVcpI60ywJ2rT+mRFnYg1EVJYW6hBVqlSx 0fOXu43tc30FT4d+zbI0LLMsAJ+7/2AQ7Cs7M5XdQGt9k6DKIvl/9Wo67okEbpsRkkiE ohRw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version:cc :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:references:in-reply-to:message-id:date :to:from:dkim-signature:delivered-to:arc-authentication-results; bh=e55WRy5HGgZm1TTIgzo484ZHcR/Wba3NEwUbyrT+qIU=; b=xQsiEcv1+g8ALW0Mlq6qcOOYDOzyUWgiRWHTER/xV4anLAHNMuHYVz0/hrPpFp/a1V VVj75PPaJgXreDtRno9goV/blfAcCLxlzohsojksgcRPA0ho+P8YGi/+dk+KB+NBuZMA QEFaV5TYFvxgWyHme2XSbwZJ4C1Rr4p8ekl+NMYtWWng5DtPP4yWxszA26AiSq5QdaCw niCbUu34Hlk0rAzGqBqhFXuzsHnOmRBb94LQ4SnFbw10gqnQu4eoMqqCO7FESdObAItb D7HOO9bJfHXFJTQ5s0uXOazxn2s1ddCr6OYx+EX9PU/07dDjeFg3Q31qw1MugwqSWa/b +drA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=RZgz6Jat; spf=pass (google.com: best guess record for domain of edk2-devel-bounces@lists.01.org designates 198.145.21.10 as permitted sender) smtp.mailfrom=edk2-devel-bounces@lists.01.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from ml01.01.org (ml01.01.org. [198.145.21.10]) by mx.google.com with ESMTPS id h132si2722605pgc.815.2017.11.30.02.11.55 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 30 Nov 2017 02:11:55 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of edk2-devel-bounces@lists.01.org designates 198.145.21.10 as permitted sender) client-ip=198.145.21.10; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=RZgz6Jat; spf=pass (google.com: best guess record for domain of edk2-devel-bounces@lists.01.org designates 198.145.21.10 as permitted sender) smtp.mailfrom=edk2-devel-bounces@lists.01.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id D5138220C1C36; Thu, 30 Nov 2017 02:07:29 -0800 (PST) X-Original-To: edk2-devel@lists.01.org Delivered-To: edk2-devel@lists.01.org Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=2a00:1450:400c:c0c::242; helo=mail-wr0-x242.google.com; envelope-from=ard.biesheuvel@linaro.org; receiver=edk2-devel@lists.01.org Received: from mail-wr0-x242.google.com (mail-wr0-x242.google.com [IPv6:2a00:1450:400c:c0c::242]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 0498E21A1099A for ; Thu, 30 Nov 2017 02:07:26 -0800 (PST) Received: by mail-wr0-x242.google.com with SMTP id h1so5965211wre.12 for ; Thu, 30 Nov 2017 02:11:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=K0TqdkvCFBgL/jUzeL+/3KMPIP70hYXfhdqdgS4oBWo=; b=RZgz6JatdrMPP46f8n0mElfhvKynV/yZ2NBLFK6UucJlBPM2e5V+J3gxAQeqDo3u9A 1OcW1ILmiW6ivfYqU3S+rwYu3FfYXVQIQ0iA4a6f2ZGmAes6tb+6Zz0sC1N5c4yLuny3 c1CBMT+qJ7wREhQh+ol3ctPtChg9emNtd2i24= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=K0TqdkvCFBgL/jUzeL+/3KMPIP70hYXfhdqdgS4oBWo=; b=FyyDdOIBLj/os63foe0xLOuQhekqQYPPKX0KaCxAFoU2fOjruW2ug/WTBryuWtmbDc djbFRe+mDrH+12Cy1iTNL2LLU6uW72m5wHkLSGylenV9VoA2dkEioY+mZmN6Q87eZEy6 YhTYVsiDxmj5Igy+Bzr8viXfTAuQj7y8VFK+riyM+lmouAkswdnjjQQHhqdDdrtEeKJ8 2PsdjSmEiUP1k7iu7+DfVUiCtqlaD2BFLGGNC4bUArkAMgKpowd1qCZbzDm3pdbxmEYQ HG1vPMSVh4pIm+rDouiI6GPFHrjW+OZ7cymP/sVPSUhtmqOBYWPUbrqoeZz3tWEs0sMi X06w== X-Gm-Message-State: AJaThX4WYYJzmGQBeE7NJXkZi2rcSP4160M+hdkcIiBrFMu1GN7L5zkT m87vCtcK7QncY8iMm+pfqr4AcW99sGo= X-Received: by 10.223.170.4 with SMTP id p4mr1426437wrd.109.1512036705443; Thu, 30 Nov 2017 02:11:45 -0800 (PST) Received: from localhost.localdomain ([105.150.171.234]) by smtp.gmail.com with ESMTPSA id z108sm6572353wrb.67.2017.11.30.02.11.40 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 30 Nov 2017 02:11:41 -0800 (PST) From: Ard Biesheuvel To: edk2-devel@lists.01.org Date: Thu, 30 Nov 2017 10:11:31 +0000 Message-Id: <20171130101132.18317-2-ard.biesheuvel@linaro.org> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20171130101132.18317-1-ard.biesheuvel@linaro.org> References: <20171130101132.18317-1-ard.biesheuvel@linaro.org> Subject: [edk2] [PATCH v2 1/2] MdeModulePkg: introduce SD/MMC override protocol X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: hao.a.wu@intel.com, feng.tian@intel.com, star.zeng@intel.com, leif.lindholm@linaro.org, Ard Biesheuvel MIME-Version: 1.0 Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" Many ARM based SoCs have integrated SDHCI controllers, and often, these implementations deviate in subtle ways from the pertinent specifications. On the one hand, these deviations are quite easy to work around, but on the other hand, having a collection of SoC specific workarounds in the generic driver stack is undesirable. So let's introduce an optional SD/MMC override protocol that we can invoke at the appropriate moments in the device initialization. That way, the workaround itself remains platform specific, but we can still use the generic driver stack on such platforms. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Ard Biesheuvel --- MdeModulePkg/Include/Protocol/SdMmcOverride.h | 103 ++++++++++++++++++++ MdeModulePkg/MdeModulePkg.dec | 3 + 2 files changed, 106 insertions(+) -- 2.11.0 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel diff --git a/MdeModulePkg/Include/Protocol/SdMmcOverride.h b/MdeModulePkg/Include/Protocol/SdMmcOverride.h new file mode 100644 index 000000000000..5a5c393896f4 --- /dev/null +++ b/MdeModulePkg/Include/Protocol/SdMmcOverride.h @@ -0,0 +1,103 @@ +/** @file + Protocol to describe overrides required to support non-standard SDHCI + implementations + + Copyright (c) 2017, Linaro, Ltd. All rights reserved.
+ + This program and the accompanying materials + are licensed and made available under the terms and conditions of the BSD License + which accompanies this distribution. The full text of the license may be found at + http://opensource.org/licenses/bsd-license.php + + THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, + WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + +**/ + +#ifndef __SD_MMC_OVERRIDE_H__ +#define __SD_MMC_OVERRIDE_H__ + +#include + +#define EDKII_SD_MMC_OVERRIDE_PROTOCOL_GUID \ + { 0xeaf9e3c1, 0xc9cd, 0x46db, { 0xa5, 0xe5, 0x5a, 0x12, 0x4c, 0x83, 0x23, 0x23 } } + +#define EDKII_SD_MMC_OVERRIDE_PROTOCOL_VERSION 0x1 + +typedef struct _SD_MMC_OVERRIDE SD_MMC_OVERRIDE; + +typedef enum { + SD_MMC_OVERRIDE_RESET_PRE_HOOK, + SD_MMC_OVERRIDE_RESET_POST_HOOK, + SD_MMC_OVERRIDE_INIT_HOST_PRE_HOOK, + SD_MMC_OVERRIDE_INIT_HOST_POST_HOOK, +} SD_MMC_OVERRIDE_HOOK; + +/** + + Override function for SDHCI capability bits + + @param[in] PassThru A pointer to the + EFI_SD_MMC_PASS_THRU_PROTOCOL instance. + @param[in] ControllerHandle The EFI_HANDLE of the controller. + @param[in] Slot The 0 based slot index. + @param[in,out] SdMmcHcSlotCapability The SDHCI capability structure. + + @retval EFI_SUCCESS The override function completed successfully. + @retval EFI_NOT_FOUND The specified controller or slot does not exist. + @retval EFI_INVALID_PARAMETER SdMmcHcSlotCapability is NULL + +**/ +typedef +EFI_STATUS +(EFIAPI * SD_MMC_OVERRIDE_CAPABILITY) ( + IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, + IN EFI_HANDLE ControllerHandle, + IN UINT8 Slot, + IN OUT UINT64 *SdMmcHcSlotCapability + ); + +/** + + Override function for SDHCI controller operations + + @param[in] PassThru A pointer to the + EFI_SD_MMC_PASS_THRU_PROTOCOL instance. + @param[in] ControllerHandle The EFI_HANDLE of the controller. + @param[in] Slot The 0 based slot index. + @param[in,out] HookType The type of operation and whether the + hook is invoked right before (pre) or + right after (post) + + @retval EFI_SUCCESS The override function completed successfully. + @retval EFI_NOT_FOUND The specified controller or slot does not exist. + @retval EFI_INVALID_PARAMETER HookType is invalid + +**/ +typedef +EFI_STATUS +(EFIAPI * SD_MMC_OVERRIDE_INVOKE_HOOK) ( + IN EFI_SD_MMC_PASS_THRU_PROTOCOL *PassThru, + IN EFI_HANDLE ControllerHandle, + IN UINT8 Slot, + IN SD_MMC_OVERRIDE_HOOK HookType + ); + +struct _SD_MMC_OVERRIDE { + // + // Protocol version of this implementation + // + UINTN Version; + // + // Callback to override SD/MMC host controller capability bits + // + SD_MMC_OVERRIDE_CAPABILITY OverrideCapability; + // + // Callback to invoke SD/MMC override hooks + // + SD_MMC_OVERRIDE_INVOKE_HOOK InvokeHook; +}; + +extern EFI_GUID gEdkiiSdMmcOverrideProtocolGuid; + +#endif diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec index 856d67aceb21..64ceea029f94 100644 --- a/MdeModulePkg/MdeModulePkg.dec +++ b/MdeModulePkg/MdeModulePkg.dec @@ -562,6 +562,9 @@ [Protocols] ## Include/Protocol/SmmMemoryAttribute.h gEdkiiSmmMemoryAttributeProtocolGuid = { 0x69b792ea, 0x39ce, 0x402d, { 0xa2, 0xa6, 0xf7, 0x21, 0xde, 0x35, 0x1d, 0xfe } } + ## Include/Protocol/SdMmcOverride.h + gEdkiiSdMmcOverrideProtocolGuid = { 0xeaf9e3c1, 0xc9cd, 0x46db, { 0xa5, 0xe5, 0x5a, 0x12, 0x4c, 0x83, 0x23, 0x23 } } + # # [Error.gEfiMdeModulePkgTokenSpaceGuid] # 0x80000001 | Invalid value provided.