From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=2a00:1450:4864:20::441; helo=mail-wr1-x441.google.com; envelope-from=leif.lindholm@linaro.org; receiver=edk2-devel@lists.01.org Received: from mail-wr1-x441.google.com (mail-wr1-x441.google.com [IPv6:2a00:1450:4864:20::441]) (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 EB02E21959CB2 for ; Fri, 9 Nov 2018 06:10:27 -0800 (PST) Received: by mail-wr1-x441.google.com with SMTP id b13so2016791wrx.6 for ; Fri, 09 Nov 2018 06:10:27 -0800 (PST) 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=QFe2XqJdPO3+yG3LfzoWFqbdeCQdDv866OBaeAG9C+c=; b=YFcVtnLv0YDNt7cncPkEQ7zwrC3zHUcYMk49XXiQp3YPaUrbFgyFJDiLvV2vyFWJnL R36P1VO9yjjLR3sW1x7dM/by2dB6k26GbKTWz/REdsEBLHYwSZk4w+/OA4B84YvaixeV JkSTePNP9zGUmTNxFkLaT8JEGMIWfM2Oa1hjg= 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=QFe2XqJdPO3+yG3LfzoWFqbdeCQdDv866OBaeAG9C+c=; b=cqunJVF2dJ2ZuB5lUj5BMxFPOFPOJgBTO40SysAvl09Z1JmGd7Jh0IFiyx/tkSeNeY +JEgd5mKFCWhKt1uXRKg0SaK0R1rA512ZMDWfup1254+eV0S93xHoKFSTbZqrFwqsYbn kZKY+0ITU5AgYOzSynCSttGTgCpWMQWPEGl0m/BpB/XzDAF9simuDygCKTCS1/GAlssA o8WGHt2326SEInxTt586dclGHTdNNkySOllzWsCxq6FmUXolZcPxMEVGqXG7tI0RpmQP nAOA7xs69aP/U9gOl3QG7wrG62MzVuXzICrYZ260pMM05hY7CXFDTNkyOXGKuh7kZfwk GI4w== X-Gm-Message-State: AGRZ1gIXeXjuUo8jZrMgdDMrf3LL2Xz3CGGTBdm6DU+bJhvYzKV7pYsd L5GpsfzpKdQ1FHUrF/TC9Bgg/w== X-Google-Smtp-Source: AJdET5cvsUoncNqx8740nOieYh70vgx7Xcc6rSEjlluJtCVzqhzj4V4AOTA951yL2e6yZAAGZUuJJw== X-Received: by 2002:adf:e388:: with SMTP id e8-v6mr8280623wrm.321.1541772626180; Fri, 09 Nov 2018 06:10:26 -0800 (PST) Received: from bivouac.eciton.net (bivouac.eciton.net. [2a00:1098:0:86:1000:23:0:2]) by smtp.gmail.com with ESMTPSA id h5-v6sm12226795wrs.51.2018.11.09.06.09.53 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Fri, 09 Nov 2018 06:10:09 -0800 (PST) Date: Fri, 9 Nov 2018 14:09:51 +0000 From: Leif Lindholm To: Jeff Brasen Cc: edk2-devel@lists.01.org, Ard Biesheuvel , Grish Pathak , Sami Mujawar Message-ID: <20181109140951.jcworswoffwot2q4@bivouac.eciton.net> References: <6dbe50db1293266db7588630fc97328276e82843.1541699412.git.jbrasen@nvidia.com> MIME-Version: 1.0 In-Reply-To: <6dbe50db1293266db7588630fc97328276e82843.1541699412.git.jbrasen@nvidia.com> User-Agent: NeoMutt/20170113 (1.7.2) Subject: Re: [PATCH] ArmPkg/ArmScmiDxe: Add clock enable function X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 09 Nov 2018 14:10:28 -0000 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi Jeff, On Thu, Nov 08, 2018 at 10:50:44AM -0700, Jeff Brasen wrote: > Add function to allow enabling and disabling of the clock using the SCMI > interface. Update the protocol GUID as the protocol interface has > changed. Changing a protocol GUID for an interface update feels a bit un-idiomatic for tianocore. (Generally, a new version of the protocol is added.) My main concern is that I can't see how removing the ability to discover the protocol by the old GUID could ever have a desirable outcome. Girish, Sami, what's your take? > Contributed-under: TianoCore Contribution Agreement 1.1 > Signed-off-by: Jeff Brasen > Cc: Ard Biesheuvel > Cc: Leif Lindholm > Cc: Grish Pathak > --- > ArmPkg/ArmPkg.dec | 2 +- > .../ArmScmiDxe/ArmScmiClockProtocolPrivate.h | 7 +++ > ArmPkg/Drivers/ArmScmiDxe/ScmiClockProtocol.c | 50 +++++++++++++++++++++- > ArmPkg/Include/Protocol/ArmScmiClockProtocol.h | 21 ++++++++- > 4 files changed, 77 insertions(+), 3 deletions(-) Could you make sure you follow https://github.com/tianocore/tianocore.github.io/wiki/Laszlo's-unkempt-git-guide-for-edk2-contributors-and-maintainers#contrib-23 when generating patches (or let os know if you are, and we have more git breakage)? / Leif > diff --git a/ArmPkg/ArmPkg.dec b/ArmPkg/ArmPkg.dec > index 84e57a0..a7b55a1 100644 > --- a/ArmPkg/ArmPkg.dec > +++ b/ArmPkg/ArmPkg.dec > @@ -57,7 +57,7 @@ > > ## Arm System Control and Management Interface(SCMI) Clock management protocol > ## ArmPkg/Include/Protocol/ArmScmiClockProtocol.h > - gArmScmiClockProtocolGuid = { 0x91ce67a8, 0xe0aa, 0x4012, { 0xb9, 0x9f, 0xb6, 0xfc, 0xf3, 0x4, 0x8e, 0xaa } } > + gArmScmiClockProtocolGuid = { 0xb8d8caf2, 0x9e94, 0x462c, { 0xa8, 0x34, 0x6c, 0x99, 0xfc, 0x05, 0xef, 0xcf } } > > ## Arm System Control and Management Interface(SCMI) Clock management protocol > ## ArmPkg/Include/Protocol/ArmScmiPerformanceProtocol.h > diff --git a/ArmPkg/Drivers/ArmScmiDxe/ArmScmiClockProtocolPrivate.h b/ArmPkg/Drivers/ArmScmiDxe/ArmScmiClockProtocolPrivate.h > index 0d1ec6f..c135bac 100644 > --- a/ArmPkg/Drivers/ArmScmiDxe/ArmScmiClockProtocolPrivate.h > +++ b/ArmPkg/Drivers/ArmScmiDxe/ArmScmiClockProtocolPrivate.h > @@ -59,6 +59,13 @@ typedef struct { > CLOCK_RATE_DWORD Rate; > } CLOCK_RATE_SET_ATTRIBUTES; > > + > +// Message parameters for CLOCK_CONFIG_SET command. > +typedef struct { > + UINT32 ClockId; > + UINT32 Attributes; > +} CLOCK_CONFIG_SET_ATTRIBUTES; > + > // if ClockAttr Bit[0] is set then clock device is enabled. > #define CLOCK_ENABLE_MASK 0x1 > #define CLOCK_ENABLED(ClockAttr) ((ClockAttr & CLOCK_ENABLE_MASK) == 1) > diff --git a/ArmPkg/Drivers/ArmScmiDxe/ScmiClockProtocol.c b/ArmPkg/Drivers/ArmScmiDxe/ScmiClockProtocol.c > index 64d2afa..493eb45 100644 > --- a/ArmPkg/Drivers/ArmScmiDxe/ScmiClockProtocol.c > +++ b/ArmPkg/Drivers/ArmScmiDxe/ScmiClockProtocol.c > @@ -388,6 +388,53 @@ ClockRateSet ( > return Status; > } > > +/** Enable/Disable specified clock. > + > + @param[in] This A Pointer to SCMI_CLOCK_PROTOCOL Instance. > + @param[in] ClockId Identifier for the clock device. > + @param[in] Enable TRUE to enable, FALSE to disable. > + > + @retval EFI_SUCCESS Clock enable/disable successful. > + @retval EFI_DEVICE_ERROR SCP returns an SCMI error. > + @retval !(EFI_SUCCESS) Other errors. > +**/ > +STATIC > +EFI_STATUS > +ClockEnable ( > + IN SCMI_CLOCK_PROTOCOL *This, > + IN UINT32 ClockId, > + IN BOOLEAN Enable > + ) > +{ > + EFI_STATUS Status; > + CLOCK_CONFIG_SET_ATTRIBUTES *ClockConfigSetAttributes; > + SCMI_COMMAND Cmd; > + UINT32 PayloadLength; > + > + Status = ScmiCommandGetPayload ((UINT32**)&ClockConfigSetAttributes); > + if (EFI_ERROR (Status)) { > + return Status; > + } > + > + // Fill arguments for clock protocol command. > + ClockConfigSetAttributes->ClockId = ClockId; > + ClockConfigSetAttributes->Attributes = Enable ? BIT0 : 0; > + > + Cmd.ProtocolId = SCMI_PROTOCOL_ID_CLOCK; > + Cmd.MessageId = SCMI_MESSAGE_ID_CLOCK_CONFIG_SET; > + > + PayloadLength = sizeof (CLOCK_CONFIG_SET_ATTRIBUTES); > + > + // Execute and wait for response on a SCMI channel. > + Status = ScmiCommandExecute ( > + &Cmd, > + &PayloadLength, > + NULL > + ); > + > + return Status; > +} > + > // Instance of the SCMI clock management protocol. > STATIC CONST SCMI_CLOCK_PROTOCOL ScmiClockProtocol = { > ClockGetVersion, > @@ -395,7 +442,8 @@ STATIC CONST SCMI_CLOCK_PROTOCOL ScmiClockProtocol = { > ClockGetClockAttributes, > ClockDescribeRates, > ClockRateGet, > - ClockRateSet > + ClockRateSet, > + ClockEnable > }; > > /** Initialize clock management protocol and install protocol on a given handle. > diff --git a/ArmPkg/Include/Protocol/ArmScmiClockProtocol.h b/ArmPkg/Include/Protocol/ArmScmiClockProtocol.h > index 3db26cb..d367f37 100644 > --- a/ArmPkg/Include/Protocol/ArmScmiClockProtocol.h > +++ b/ArmPkg/Include/Protocol/ArmScmiClockProtocol.h > @@ -21,7 +21,7 @@ > #include > > #define ARM_SCMI_CLOCK_PROTOCOL_GUID { \ > - 0x91ce67a8, 0xe0aa, 0x4012, {0xb9, 0x9f, 0xb6, 0xfc, 0xf3, 0x4, 0x8e, 0xaa} \ > + 0xb8d8caf2, 0x9e94, 0x462c, { 0xa8, 0x34, 0x6c, 0x99, 0xfc, 0x05, 0xef, 0xcf } \ > } > > extern EFI_GUID gArmScmiClockProtocolGuid; > @@ -205,6 +205,24 @@ EFI_STATUS > IN UINT64 Rate > ); > > +/** Enable/Disable specified clock. > + > + @param[in] This A Pointer to SCMI_CLOCK_PROTOCOL Instance. > + @param[in] ClockId Identifier for the clock device. > + @param[in] Enable TRUE to enable, FALSE to disable. > + > + @retval EFI_SUCCESS Clock enable/disable successful. > + @retval EFI_DEVICE_ERROR SCP returns an SCMI error. > + @retval !(EFI_SUCCESS) Other errors. > +**/ > +typedef > +EFI_STATUS > +(EFIAPI *SCMI_CLOCK_ENABLE) ( > + IN SCMI_CLOCK_PROTOCOL *This, > + IN UINT32 ClockId, > + IN BOOLEAN Enable > + ); > + > typedef struct _SCMI_CLOCK_PROTOCOL { > SCMI_CLOCK_GET_VERSION GetVersion; > SCMI_CLOCK_GET_TOTAL_CLOCKS GetTotalClocks; > @@ -212,6 +230,7 @@ typedef struct _SCMI_CLOCK_PROTOCOL { > SCMI_CLOCK_DESCRIBE_RATES DescribeRates; > SCMI_CLOCK_RATE_GET RateGet; > SCMI_CLOCK_RATE_SET RateSet; > + SCMI_CLOCK_ENABLE Enable; > } SCMI_CLOCK_PROTOCOL; > > #endif /* ARM_SCMI_CLOCK_PROTOCOL_H_ */ > -- > 2.7.4 >