From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wr0-x230.google.com (mail-wr0-x230.google.com [IPv6:2a00:1450:400c:c0c::230]) (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 B806621DFC89E for ; Thu, 14 Sep 2017 09:39:29 -0700 (PDT) Received: by mail-wr0-x230.google.com with SMTP id o42so6385329wrb.3 for ; Thu, 14 Sep 2017 09:42:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=Wk1y89qnrGub9Ot0Tm6a2XQXWhhC7HGVVh4n+T891b8=; b=ScoE6DrYo2j+pZeKgOWVBZU801RWjhiJrKi9aK676DsFxpAoIz8MYNmtcFh7CCYVX9 VVD/jNBpp6OiU1uNZ0BdWTg2Y07e3N1hRCQpe8jK2CekAzQyPB9CrRtdYCXAYk+i04s+ 2dQi1/ALXrryejWUgNn7QuMN91DQmkzGUcLr4= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=Wk1y89qnrGub9Ot0Tm6a2XQXWhhC7HGVVh4n+T891b8=; b=JSX3Gz6nN0+VY2hVv6ARDx3qs4+0n7G91hVufT1ORIS9Y2HcgiOPMPysQFqTGk+Fey gWQyBywHgRMLupKoH7VM+rbfHqcgYAe8teYgQZo2Tt0MZ73SBx2HfiZsGbkAmqYIE+JP xjcohgr4IIN/FG/IpzQZ7rDtWaarasqZMfM3I4dSq+AOftzJi2g8MBRogBCf6EmIQykG /uSEsSBu3wNcHz37lvvgR7znGTtM6GXqFRjaLAft4k8/DgNLWPgWS1T4t0haO6WOyMOU JfAo0+pZ6r1eJDyHZutcXCPz7YIIvCO8Ob1MDcXbsNcrsAKntHFjuow+lUPQvLJz5miK DH8Q== X-Gm-Message-State: AHPjjUhYO11JpTcUlYuL5FXDQa8mALcZ0uUDQA3JaR/IROr6JyO2vkeE /18rZHH7lxCsO+dqc9hATQ== X-Google-Smtp-Source: ADKCNb6TU7x/J0N59e43UCtErMVYh6XYBZjkp6eiSbngrQYqKfkYU1WDdHdlhg6aQe/i/3ubGHXg/g== X-Received: by 10.223.146.4 with SMTP id 4mr19564358wrj.16.1505407347498; Thu, 14 Sep 2017 09:42:27 -0700 (PDT) Received: from bivouac.eciton.net (bivouac.eciton.net. [2a00:1098:0:86:1000:23:0:2]) by smtp.gmail.com with ESMTPSA id b125sm387751wma.29.2017.09.14.09.42.25 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Thu, 14 Sep 2017 09:42:25 -0700 (PDT) Date: Thu, 14 Sep 2017 17:42:24 +0100 From: Leif Lindholm To: evan.lloyd@arm.com Cc: edk2-devel@lists.01.org, Ard Biesheuvel , Matteo Carlini , nd@arm.com Message-ID: <20170914164224.lqrqkq4ot3ozftyo@bivouac.eciton.net> References: <20170911152335.72672-1-evan.lloyd@arm.com> <20170911152335.72672-3-evan.lloyd@arm.com> MIME-Version: 1.0 In-Reply-To: <20170911152335.72672-3-evan.lloyd@arm.com> User-Agent: NeoMutt/20170113 (1.7.2) Subject: Re: [PATCH 2/5] EmbeddedPkg: Introduce HardwareInterrupt2 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: , X-List-Received-Date: Thu, 14 Sep 2017 16:39:30 -0000 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Mon, Sep 11, 2017 at 04:23:32PM +0100, evan.lloyd@arm.com wrote: > From: Ard Biesheuvel > > The existing HardwareInterrupt protocol lacks the means to configure > the level/edge and polarity properties of an interrupt. So introduce a > new protocol HardwareInterrupt2, and add some new members that allow > manipulation of those properties. > > Contributed-under: TianoCore Contribution Agreement 1.0 > Signed-off-by: Ard Biesheuvel > Signed-off-by: Girish Pathak > Signed-off-by: Evan Lloyd > Tested-by: Girish Pathak Reviewed-by: Leif Lindholm > --- > EmbeddedPkg/EmbeddedPkg.dec | 1 + > EmbeddedPkg/Include/Protocol/HardwareInterrupt2.h | 182 ++++++++++++++++++++ > 2 files changed, 183 insertions(+) > > diff --git a/EmbeddedPkg/EmbeddedPkg.dec b/EmbeddedPkg/EmbeddedPkg.dec > index 0be102ad9c767d81a004c757f40a65063aab1d7a..151b1d503dee463d529a173d2555b6c9208100e5 100644 > --- a/EmbeddedPkg/EmbeddedPkg.dec > +++ b/EmbeddedPkg/EmbeddedPkg.dec > @@ -69,6 +69,7 @@ [Guids.common] > > [Protocols.common] > gHardwareInterruptProtocolGuid = { 0x2890B3EA, 0x053D, 0x1643, { 0xAD, 0x0C, 0xD6, 0x48, 0x08, 0xDA, 0x3F, 0xF1 } } > + gHardwareInterrupt2ProtocolGuid = { 0x32898322, 0x2da1, 0x474a, { 0xba, 0xaa, 0xf3, 0xf7, 0xcf, 0x56, 0x94, 0x70 } } > gEfiDebugSupportPeriodicCallbackProtocolGuid = { 0x9546e07c, 0x2cbb, 0x4c88, { 0x98, 0x6c, 0xcd, 0x34, 0x10, 0x86, 0xf0, 0x44 } } > gEfiEblAddCommandProtocolGuid = { 0xaeda2428, 0x9a22, 0x4637, { 0x9b, 0x21, 0x54, 0x5e, 0x28, 0xfb, 0xb8, 0x29 } } > gEmbeddedDeviceGuid = { 0xbf4b9d10, 0x13ec, 0x43dd, { 0x88, 0x80, 0xe9, 0xb, 0x71, 0x8f, 0x27, 0xde } } > diff --git a/EmbeddedPkg/Include/Protocol/HardwareInterrupt2.h b/EmbeddedPkg/Include/Protocol/HardwareInterrupt2.h > new file mode 100644 > index 0000000000000000000000000000000000000000..505052bd81afe7432e3122a2722ceab348777c29 > --- /dev/null > +++ b/EmbeddedPkg/Include/Protocol/HardwareInterrupt2.h > @@ -0,0 +1,182 @@ > +/** @file > + > + Copyright (c) 2016-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 __HARDWARE_INTERRUPT2_H__ > +#define __HARDWARE_INTERRUPT2_H__ > + > +#include > + > +// 22838932-1a2d-4a47-aaba-f3f7cf569470 > + > +#define EFI_HARDWARE_INTERRUPT2_PROTOCOL_GUID \ > + { 0x32898322, 0x2d1a, 0x474a, \ > + { 0xba, 0xaa, 0xf3, 0xf7, 0xcf, 0x56, 0x94, 0x70 } } > + > +typedef enum { > + EFI_HARDWARE_INTERRUPT2_TRIGGER_LEVEL_LOW, > + EFI_HARDWARE_INTERRUPT2_TRIGGER_LEVEL_HIGH, > + EFI_HARDWARE_INTERRUPT2_TRIGGER_EDGE_FALLING, > + EFI_HARDWARE_INTERRUPT2_TRIGGER_EDGE_RISING, > +} EFI_HARDWARE_INTERRUPT2_TRIGGER_TYPE; > + > +typedef struct _EFI_HARDWARE_INTERRUPT2_PROTOCOL \ > + EFI_HARDWARE_INTERRUPT2_PROTOCOL; > + > +/** > + Register Handler for the specified interrupt source. > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + @param Handler Callback for interrupt. NULL to unregister > + > + @retval EFI_SUCCESS Source was updated to support Handler. > + @retval EFI_DEVICE_ERROR Hardware could not be programmed. > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_REGISTER) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source, > + IN HARDWARE_INTERRUPT_HANDLER Handler > + ); > + > + > +/** > + Enable interrupt source Source. > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + > + @retval EFI_SUCCESS Source interrupt enabled. > + @retval EFI_DEVICE_ERROR Hardware could not be programmed. > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_ENABLE) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source > + ); > + > + > +/** > + Disable interrupt source Source. > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + > + @retval EFI_SUCCESS Source interrupt disabled. > + @retval EFI_DEVICE_ERROR Hardware could not be programmed. > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_DISABLE) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source > + ); > + > + > +/** > + Return current state of interrupt source Source. > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + @param InterruptState TRUE: source enabled, FALSE: source disabled. > + > + @retval EFI_SUCCESS InterruptState is valid > + @retval EFI_DEVICE_ERROR InterruptState is not valid > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_INTERRUPT_STATE) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source, > + IN BOOLEAN *InterruptState > + ); > + > +/** > + Signal to the hardware that the End Of Intrrupt state > + has been reached. > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + > + @retval EFI_SUCCESS Source interrupt EOI'ed. > + @retval EFI_DEVICE_ERROR Hardware could not be programmed. > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_END_OF_INTERRUPT) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source > + ); > + > +/** > + Return the configured trigger type for an interrupt source > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + @param TriggerType The configured trigger type > + > + @retval EFI_SUCCESS Operation successful > + @retval EFI_DEVICE_ERROR Information could not be returned > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_GET_TRIGGER_TYPE) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source, > + OUT EFI_HARDWARE_INTERRUPT2_TRIGGER_TYPE *TriggerType > + ); > + > + > +/** > + Configure the trigger type for an interrupt source > + > + @param This Instance pointer for this protocol > + @param Source Hardware source of the interrupt > + @param TriggerType The trigger type to configure > + > + @retval EFI_SUCCESS Operation successful > + @retval EFI_DEVICE_ERROR Hardware could not be programmed. > + > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *HARDWARE_INTERRUPT2_SET_TRIGGER_TYPE) ( > + IN EFI_HARDWARE_INTERRUPT2_PROTOCOL *This, > + IN HARDWARE_INTERRUPT_SOURCE Source, > + IN EFI_HARDWARE_INTERRUPT2_TRIGGER_TYPE TriggerType > + ); > + > +struct _EFI_HARDWARE_INTERRUPT2_PROTOCOL { > + HARDWARE_INTERRUPT2_REGISTER RegisterInterruptSource; > + HARDWARE_INTERRUPT2_ENABLE EnableInterruptSource; > + HARDWARE_INTERRUPT2_DISABLE DisableInterruptSource; > + HARDWARE_INTERRUPT2_INTERRUPT_STATE GetInterruptSourceState; > + HARDWARE_INTERRUPT2_END_OF_INTERRUPT EndOfInterrupt; > + > + // v2 members > + HARDWARE_INTERRUPT2_GET_TRIGGER_TYPE GetTriggerType; > + HARDWARE_INTERRUPT2_SET_TRIGGER_TYPE SetTriggerType; > +}; > + > +extern EFI_GUID gHardwareInterrupt2ProtocolGuid; > + > +#endif > -- > Guid("CE165669-3EF3-493F-B85D-6190EE5B9759") >