From nobody Tue Feb 10 12:57:39 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce+27952+81733+1787277+3901457@groups.io; arc=fail (BodyHash is different from the expected one); dmarc=fail(p=none dis=none) header.from=arm.com Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1633891295037713.9192593231857; Sun, 10 Oct 2021 11:41:35 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id BYqeYY1788612xIaeQar7P29; Sun, 10 Oct 2021 11:41:34 -0700 X-Received: from EUR05-DB8-obe.outbound.protection.outlook.com (EUR05-DB8-obe.outbound.protection.outlook.com [40.107.20.66]) by mx.groups.io with SMTP id smtpd.web10.1811.1633891293757026070 for ; Sun, 10 Oct 2021 11:41:34 -0700 X-Received: from AS9PR06CA0095.eurprd06.prod.outlook.com (2603:10a6:20b:465::28) by DB7PR08MB2970.eurprd08.prod.outlook.com (2603:10a6:5:17::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.24; Sun, 10 Oct 2021 18:41:29 +0000 X-Received: from AM5EUR03FT040.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:465:cafe::b4) by AS9PR06CA0095.outlook.office365.com (2603:10a6:20b:465::28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.18 via Frontend Transport; Sun, 10 Oct 2021 18:41:29 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; edk2.groups.io; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;edk2.groups.io; dmarc=pass action=none header.from=arm.com; Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.108 as permitted sender) client-ip=66.175.222.108; envelope-from=bounce+27952+81733+1787277+3901457@groups.io; helo=mail02.groups.io; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; X-Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by AM5EUR03FT040.mail.protection.outlook.com (10.152.17.148) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.18 via Frontend Transport; Sun, 10 Oct 2021 18:41:28 +0000 X-Received: ("Tessian outbound a8bfe25d7364:v103"); Sun, 10 Oct 2021 18:41:27 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 66259a118ab3a05e X-CR-MTA-TID: 64aa7808 X-Received: from c4c3e889fbeb.2 by 64aa7808-outbound-1.mta.getcheckrecipient.com id B5D76E7D-5F5E-46BA-B094-972A1361B11E.1; Sun, 10 Oct 2021 18:30:23 +0000 X-Received: from EUR04-DB3-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id c4c3e889fbeb.2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Sun, 10 Oct 2021 18:30:23 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=WTUbLNErGxRUw0YtIHSB5SVAeVBbG0THoKedI6DGkXZJgTIEmbf3FED6ko4ict6b0UbV3WQh++SWgUnPX2mzu1zbhIguS26bU3g/DBicPeAoHIMisny1K77wpQLdmu0khQCLRuQVnQDHhh0bAJkkP4NWZD2OnCgtZqFobbYsOTHHXsxaxevn64A+ubHADa9b1yCQO3TsH9aVvegtr2yqSuQ4Fz8Ra4h/1Dgiwz16TA4+z/It2qTRzL9XbTuqPuC8HTn2ID/HCPOOw3fBMW10YVNgkD+imJCvGRJaNVRs9GNoDYcar2ypGnLwklGzoX8iYEBX91UUKwUXwHDN0i9nqQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=XZeOKSdYT5f3z5VOvXMDMbKwnbr+amutDkVFZcx70Jo=; b=Q+ZlJAu6Gx3GnFvYwYdwx0stMa/WVoq8pJgK61Kg0nsHRf9lwx4O4vDMdUm/igMyWAn2UpXpBJKda3bgxorhw0vgwcL5CXOw7NqDT9sB/fFNDY+Av5RW0vG+kwfUMZzbfDp4pV7HZVAii3rmBSen1G7tFQT8kGxivpgxVUhiyBO2vY4OAfSfKyLaiAMlDahcVZQXQAKvyYix+9JxX17t8rNG1qc0zeJdJe1+DEmA5BxUVndHVewVWEjhpxpupgb3Dc3DzwpUZni+ByKT7c5MZSfIf9LObsXmNKaRCT+pvnb4ifs8ar8RLQwgh0deAUo0K/LW5txDVI8C3X0lo1NcOQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none Authentication-Results-Original: edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=none action=none header.from=arm.com; X-Received: from PA4PR08MB5902.eurprd08.prod.outlook.com (2603:10a6:102:e0::10) by PAXPR08MB6542.eurprd08.prod.outlook.com (2603:10a6:102:158::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.19; Sun, 10 Oct 2021 18:30:22 +0000 X-Received: from PA4PR08MB5902.eurprd08.prod.outlook.com ([fe80::e5a7:9474:4463:d258]) by PA4PR08MB5902.eurprd08.prod.outlook.com ([fe80::e5a7:9474:4463:d258%2]) with mapi id 15.20.4587.025; Sun, 10 Oct 2021 18:30:22 +0000 From: "Khasim Mohammed" To: devel@edk2.groups.io Cc: nd@arm.com, Khasim Syed Mohammed Subject: [edk2-devel] [PATCH v2 1/7] Silicon/ARM/NeoverseN1Soc: Fix missing function documentation Date: Sun, 10 Oct 2021 23:59:50 +0530 Message-Id: <20211010182956.13526-2-khasim.mohammed@arm.com> In-Reply-To: <20211010182956.13526-1-khasim.mohammed@arm.com> References: <20211010182956.13526-1-khasim.mohammed@arm.com> X-ClientProxiedBy: LO4P123CA0392.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:18f::19) To PA4PR08MB5902.eurprd08.prod.outlook.com (2603:10a6:102:e0::10) MIME-Version: 1.0 X-Received: from e116623.arm.com (217.140.99.251) by LO4P123CA0392.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:18f::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4587.20 via Frontend Transport; Sun, 10 Oct 2021 18:30:21 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 0d251080-2a82-4699-11a4-08d98c1d924c X-MS-TrafficTypeDiagnostic: PAXPR08MB6542:|DB7PR08MB2970: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true NoDisclaimer: true X-MS-Oob-TLC-OOBClassifiers: OLM:8882;OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: Hrpkxfc/Are+iQ9HpBj7l9csIDh7fCK9AYZJlx8ks2e/YdA3NGmyokYaz//8t1waH5AgJSeEGtBfUV3HqLYXQ1DJ38FtcxZNmb6mxoAET/D8M4e+ECnyFUZzQQbqkJLC9WmUzpRgh1mxhi2r19JNrumMCslGuBy0Pa78cGoUIGhPA/6Lpd08UmDlTfSKJ9foKI+g88MulYxBnr75k0S0y/AaychwDCGoL7wLX81GZKb1OchlE+nGAtN23sUs2I2AP+Js0CTK/Vc773xqrQM7LzuDD+BxPjjjLPfFSYc213z6mc5BOmiRjT60oktdzv/quKkQFCHqPloRWv2jxwTTKTjsWBF0fLSpYZGp3NpZx6AydLdPvMHykPkLLvdaI0tsnIQprcuUJo6DP4GB4Qq+EUWThsledxGS3SEu3sfZpT5VcGZDh16pD9oE8efLt6Xuax1XWs8zenGEs+BMGk1fAccAE8Vr3LnQ8UwGo2kr1k1b0Qhr+56R31yhfdHJZxZI+8I7X7f2HXL6BTHXdhJbp/H+Eu5LJUNUNcPbLmVJ0pRsXEgPQlMLKk+OYVIiFJDhy1Mi5Qx4H7CjrBRzU13QvnuOeHWWdu0CR1A62I31rR2lszf0BuRgYiLIxTNJl9YXZdkerW1DIVu7q/Rmz7huj7GZH4atr0H+YxKLrGNLMe7AI9lwswUFdv7bjd7uefBWy50W5lgF1EAC7mvGPox+NQ== X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PA4PR08MB5902.eurprd08.prod.outlook.com;PTR:;CAT:NONE;SFS:(4636009)(366004)(1076003)(83380400001)(6666004)(8676002)(8936002)(956004)(2616005)(6486002)(5660300002)(26005)(38100700002)(38350700002)(66946007)(316002)(36756003)(7696005)(186003)(52116002)(66556008)(66476007)(86362001)(2906002)(6916009)(508600001)(4326008);DIR:OUT;SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAXPR08MB6542 Original-Authentication-Results: edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=none action=none header.from=arm.com; X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM5EUR03FT040.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 19c298e1-a90f-4eb6-8c1a-08d98c1c050c X-Microsoft-Antispam-Message-Info: OtiQRaoZ8yyqGp7q8FnMJBvpIqPHat8eUQqj5xUIHt+zRzhRM31/eJS2IM2MZnEjQR+8OemGYS8Qj1XpxCmj75SsPWbgRzw7ygSguNmiKCwvrN2pL6ZwDk2vb5PeQ/zF/roFN2Jg4bh9J6bKKwVv3B0TmD2lWj/rtuCWoWBv6Z8zDgneF+aJ1Ja5rb8Y3QCooHQlDQL9zEcO5xG6taC8+1QtFVymDkOTXHSG69Tm9Y1U9iVn/JPhOgoduQNRRPdKdXjoNSbdw/fFqtSqZg1zOWIductkPrUrfWgJ63scLnu3JvAGnTtGzCb5PlEgBsxE1SOxfOsbLrG8q7gg8u/llSjDbU3uDd22w24FpvQLHBKsXKJovgW7fV+pOLGz8JoEI+SAoF7SECDxIDQE+aXM2PTB0+T3rR0Qr5fGgJzDXDij3DIFofw3/CB6EGJnMA/HxG3OwX2w80olaxxzOECXRADC98R1gobuWLs6EYVvOYvWhuNqOPM/W/mSpFuI+AkMzfuaMYArH/MJueT0pioi3cQitOa0HeHySxJvMCQBoH3yBA26iBb0iZ8jl5XwaNF1qkGUeMIMfrw4BE1cJCNSvMdpA6iKIRS/JmsqarRmF5/95iE1A6Q8KZANYc2D7+dfK/tXcve+mmW+s0G5YTykGdktnEsWdjSem8+szNPFeYYNZEzHysYdyZADlP6CheNYncyhnjTN97sBIfX9SCew9A== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Oct 2021 18:41:28.5515 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0d251080-2a82-4699-11a4-08d98c1d924c X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: AM5EUR03FT040.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB2970 Precedence: Bulk List-Unsubscribe: List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,khasim.mohammed@arm.com X-Gm-Message-State: 81nppvbleWWnUnsX5hEBxsPJx1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1633891294; bh=8afpwTlc64cs3vK1i2baBO5gu8/jXOZBG9C53l/ptSk=; h=Cc:Content-Type:Date:From:Reply-To:Subject:To; b=tLVS6WZDOVxAShk0fPdHeVVm0IcO6qJ/KGRGXOfH2cpdXkSLiT3RBcjU6ZaiIfBiHwF UE1iW/2EGRqNBpSQjHOERl7IBaW47iK/rH1Oa/wqCrN1I3M0fdPSrGk2lz6lYTLBPVQDE 9w7FeYE2QPcztWk7GLdbDElVFh8drLEZBA8= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1633891296819100001 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This patch adds missing documentation for few of the functions and fixes few formatting changes. Signed-off-by: Khasim Syed Mohammed --- .../PciHostBridgeLib/PciHostBridgeLib.c | 18 ++++---- .../Library/PlatformLib/PlatformLib.c | 43 ++++++++++++++++--- 2 files changed, 47 insertions(+), 14 deletions(-) diff --git a/Silicon/ARM/NeoverseN1Soc/Library/PciHostBridgeLib/PciHostBrid= geLib.c b/Silicon/ARM/NeoverseN1Soc/Library/PciHostBridgeLib/PciHostBridgeL= ib.c index 9332939f63..ac88415fd2 100644 --- a/Silicon/ARM/NeoverseN1Soc/Library/PciHostBridgeLib/PciHostBridgeLib.c +++ b/Silicon/ARM/NeoverseN1Soc/Library/PciHostBridgeLib/PciHostBridgeLib.c @@ -1,10 +1,10 @@ /** @file -* PCI Host Bridge Library instance for ARM Neoverse N1 platform -* -* Copyright (c) 2019 - 2020, ARM Limited. All rights reserved. -* -* SPDX-License-Identifier: BSD-2-Clause-Patent -* + PCI Host Bridge Library instance for ARM Neoverse N1 platform + + Copyright (c) 2019 - 2021, ARM Limited. All rights reserved.
+ + SPDX-License-Identifier: BSD-2-Clause-Patent + **/ =20 #include @@ -96,7 +96,7 @@ STATIC PCI_ROOT_BRIDGE mPciRootBridge[] =3D { /** Return all the root bridge instances in an array. =20 - @param Count Return the count of root bridge instances. + @param Count Return the count of root bridge instances. =20 @return All the root bridge instances in an array. The array should be passed into PciHostBridgeFreeRootBridges() @@ -115,8 +115,8 @@ PciHostBridgeGetRootBridges ( /** Free the root bridge instances array returned from PciHostBridgeGetRootB= ridges(). =20 - @param Bridges The root bridge instances array. - @param Count The count of the array. + @param Bridges The root bridge instances array. + @param Count The count of the array. **/ VOID EFIAPI diff --git a/Silicon/ARM/NeoverseN1Soc/Library/PlatformLib/PlatformLib.c b/= Silicon/ARM/NeoverseN1Soc/Library/PlatformLib/PlatformLib.c index f722080e56..d5ec0ff30d 100644 --- a/Silicon/ARM/NeoverseN1Soc/Library/PlatformLib/PlatformLib.c +++ b/Silicon/ARM/NeoverseN1Soc/Library/PlatformLib/PlatformLib.c @@ -1,9 +1,9 @@ /** @file -* -* Copyright (c) 2018-2020, ARM Limited. All rights reserved. -* -* SPDX-License-Identifier: BSD-2-Clause-Patent -* + + Copyright (c) 2018-2021, ARM Limited. All rights reserved.
+ + SPDX-License-Identifier: BSD-2-Clause-Patent + **/ =20 #include @@ -17,6 +17,12 @@ STATIC ARM_CORE_INFO mCoreInfoTable[] =3D { { 0x1, 0x1 } // Cluster 1, Core 1 }; =20 +/** + Return the current Boot Mode. + + This function returns the boot reason on the platform. + +**/ EFI_BOOT_MODE ArmPlatformGetBootMode ( VOID @@ -25,6 +31,15 @@ ArmPlatformGetBootMode ( return BOOT_WITH_FULL_CONFIGURATION; } =20 +/** + Initialize controllers that must be setup in the normal world. + + This function is called by the ArmPlatformPkg/Pei or ArmPlatformPkg/Pei/= PlatformPeim + in the PEI phase. + + @param[in] MpId Processor ID + +**/ RETURN_STATUS ArmPlatformInitialize ( IN UINTN MpId @@ -33,6 +48,15 @@ ArmPlatformInitialize ( return RETURN_SUCCESS; } =20 +/** + Populate the Platform core information. + + This function populates the ARM_MP_CORE_INFO_PPI with information about = the cores. + + @param[out] CoreCount Number of cores + @param[out] ArmCoreTable Table containing information about the cores + +**/ EFI_STATUS PrePeiCoreGetMpCoreInfo ( OUT UINTN *CoreCount, @@ -56,6 +80,15 @@ EFI_PEI_PPI_DESCRIPTOR gPlatformPpiTable[] =3D { } }; =20 +/** + Return the Platform specific PPIs + + This function exposes the N1Sdp Specific PPIs. + + @param[out] PpiListSize Size in Bytes of the Platform PPI List + @param[out] PpiList Platform PPI List + +**/ VOID ArmPlatformGetPlatformPpiList ( OUT UINTN *PpiListSize, --=20 2.17.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 (#81733): https://edk2.groups.io/g/devel/message/81733 Mute This Topic: https://groups.io/mt/86220127/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-