From nobody Sat Feb 7 04:40:35 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+82710+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 1635269593658884.6694301722716; Tue, 26 Oct 2021 10:33:13 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id Jpd1YY1788612xhEirzPRd7E; Tue, 26 Oct 2021 10:33:13 -0700 X-Received: from EUR04-HE1-obe.outbound.protection.outlook.com (EUR04-HE1-obe.outbound.protection.outlook.com [40.107.7.53]) by mx.groups.io with SMTP id smtpd.web09.390.1635269591081201957 for ; Tue, 26 Oct 2021 10:33:12 -0700 X-Received: from AM6P195CA0058.EURP195.PROD.OUTLOOK.COM (2603:10a6:209:87::35) by AM4PR0802MB2163.eurprd08.prod.outlook.com (2603:10a6:200:5d::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4628.18; Tue, 26 Oct 2021 17:33:07 +0000 X-Received: from VE1EUR03FT049.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:87:cafe::e7) by AM6P195CA0058.outlook.office365.com (2603:10a6:209:87::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4628.18 via Frontend Transport; Tue, 26 Oct 2021 17:33:07 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;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+82710+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 VE1EUR03FT049.mail.protection.outlook.com (10.152.19.216) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4628.18 via Frontend Transport; Tue, 26 Oct 2021 17:33:06 +0000 X-Received: ("Tessian outbound e27daf245730:v103"); Tue, 26 Oct 2021 17:33:06 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 6a6823ca03e87453 X-CR-MTA-TID: 64aa7808 X-Received: from 924b78afff36.2 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 2999F6C6-F893-4268-B88A-80E3D9D0E3FC.1; Tue, 26 Oct 2021 17:33:01 +0000 X-Received: from EUR05-AM6-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 924b78afff36.2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Tue, 26 Oct 2021 17:33:01 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=FI0D/LepUhjnis08tc0ImvDGOsfvvIztK2EabThui7h3xMamEtgnJ98dAcX0gWJg2y2m640RPpc+/bIuNh6Xo4kznerb4xkMxyhX1S/DTfi51EyvvwqDcYXN+KROnsi9ReSPgbMzXAf7Tb4gUixWP/WVLvKNhW6h0fUf5RNmvrONgy5TIh+HdTYrLlFmNXbG51hp6JGvjXGuKlqt6K8VuXyjJRyGS3HdOe0qwumKQZ06LMkfPmBksifJiLdU9mMzwd+MgT8HClOlLbQ6QhTq3IeGJpqZftuUEsuwSYSmZH9qZmNaZW9x6GDqdsxPtAfthhAovmm/RBX90UrMDuzpeg== 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=dKBKsnz63k/Dwki1RTuk6ZbD6wgnEqhVp4jT6/Oqd7w=; b=j7O15FC4j6bq7her/AwKJlgHMyZjuHPevA0Lnkx7R2qv083Raz6EpIZX4EMRFI9ohFdaQEgDcJll1O6qXGsLZEh4LouqBWI0PvJZbaU9TRNeyRVhPfyI47wXgxLpzElEkav8iN622PZInxudMh8FXMtNgWAP4UaoOMxLl1w/tVqkeC58egNnWMeIM/4rZK5K4mk8Ll50oN9SpCsQHKzyKBq0LKH5BR5mzBp8H8UiVg5nprONHDDN18tucNwzZvt6whYBByd64E4aS8tE9YfMeg1nu0PoWim7+niKaH3p9bKvEVPdLVT9tNCDtABx4NkYBwU0ZiYLMQeGpJ3PVVLrTQ== 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: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com; X-Received: from PA4PR08MB5902.eurprd08.prod.outlook.com (2603:10a6:102:e0::10) by PR2PR08MB4698.eurprd08.prod.outlook.com (2603:10a6:101:19::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4628.18; Tue, 26 Oct 2021 17:32:59 +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.4628.020; Tue, 26 Oct 2021 17:32:58 +0000 From: "Khasim Mohammed" To: devel@edk2.groups.io Cc: nd@arm.com, Khasim Syed Mohammed Subject: [edk2-devel] [PATCH v3 1/7] Silicon/ARM/NeoverseN1Soc: Fix missing function documentation Date: Tue, 26 Oct 2021 23:02:28 +0530 Message-Id: <20211026173234.9053-2-khasim.mohammed@arm.com> In-Reply-To: <20211026173234.9053-1-khasim.mohammed@arm.com> References: <20211026173234.9053-1-khasim.mohammed@arm.com> X-ClientProxiedBy: LO4P123CA0218.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:1a6::7) 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 LO4P123CA0218.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:1a6::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4628.16 via Frontend Transport; Tue, 26 Oct 2021 17:32:57 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 1a3f7c20-605f-476d-537c-08d998a6ac2b X-MS-TrafficTypeDiagnostic: PR2PR08MB4698:|AM4PR0802MB2163: 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: 3psrDVqo1wpoz8jTJ7DRPUGrf3v752lnJNVe6n8sWmEB6dKZkA5053wt38+sZoldvLd8gjfrTBWxgWLBDWc+QJVLiBSdf1xgs4YyzJKcaOXac6cewdxVaPENYG4Pqy34f6uXjxeffLznm8N4BYl10wasu/VNjNq8dJ9POlyiCN6eQngBu1/of3hjHD6EocK2+WorTsbkQHhbyh6T7GM7s3R35ELFbKo2+3hHp0mOqeiojHTOiqns6+2x7ql8aKBrIH2Ky+Yn9RIjttTjxlxpH3KNdEeDm+BNeV9LNCpQPneFSwOqKjXITRhCWx5rMQ8emlw/waS8U1KEUTs4T076+VH8akbt8POmZW4wPlCCUKPauZtathVDjsrIKeNVOW1MtvNp1SpJqKxIAiG5woq2wPpBkOfrSGtlw8/2U6ASaFLEMIuE+WVl+HyTSodUND4blV8qF0/+rdLVuz8WE3w8HlgkJUIwPfmcQewCKqEVZ+0gOqInB5Fzutgkc0maDVt8w0CpR3Q/vMwXwLaGfZh/4HWM5bUyoEcNx1FW29LSpVOS8pLMSQ62wPRCVuc6IQlFNZit7NLmALNDltoUOHJ8Xwq0gun6n0ev1kqv7Les7w95mNg1Yl5PaadHp1+/EiPtDWficCO8xwJv/avHbxHATm4ewdXznwwK/PJRYsnx0xq+X2rKt5X+ydbtcPrRRodGKxYsqk4WhY6uEWVoQWSwcg== 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)(6916009)(6666004)(316002)(6486002)(4326008)(66476007)(86362001)(36756003)(52116002)(83380400001)(5660300002)(26005)(2616005)(956004)(66946007)(7696005)(38350700002)(8676002)(186003)(508600001)(1076003)(38100700002)(66556008)(2906002)(8936002);DIR:OUT;SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: PR2PR08MB4698 Original-Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com; X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: VE1EUR03FT049.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: a6fe438a-4c25-4388-be56-08d998a6a721 X-Microsoft-Antispam-Message-Info: 0aNmOVlD7aNvMalwP+FCpbmNXRZ55cY4iWoJYCj86h2DJUNjtGFoX8kZP+nzB6k/Q4eTGij6TNm+zVp9V44rOdeOsdGTqgblb9srr+Gr572bchylL4yYRMnWcJ+R9xfGwGkXowSQaFTuFlkWSqmrSxZkU8zv5uLbfpgp1p4bQPhyA1TVALo0T8eUdZmo/XI0Jmf6JDtvVE9wWhjV8WW8zcmSLvlxmotk1wPC2huoxrWdKchvzQzjaRULq2MUYdQzkH6u9sKp9UrLzpC/ypjsrspkBeFge2n9BONYxAZLTW1vD5QGOpUQJgKRro2vYMnNTTdJO7FnEi7IENrdNrExYdOPr3tLZ7W6JAAu2g+tTo7B6PL5i7UasoHsi9Cx4tDI0kAaKKOWD5H0trGVek9C3ABdSIt5wpn8qoFm0eHqicM853hpY7OGjtaRO9JvfHNkIWGauUJVPR7wkyCcc1G0PvMRxaf50SLCMWfXYLYFraqVW93d8TLYcdwszjFgSA/bz3w+XLvzkBpC15pi4N9jN8FN4RI4eF9uVqEV+vIZukTYAaV2wvVGXTJsmTNkEd2SwBTllvAZSOXlp5zayyxfrw+6NhjbZD3yNiN/niHwR2tBg59W2NNC7QXPb92CwR6k0TCecPktwcZQ0kNLNIu1zO+0hnN6WOIGFmo8iQaLJwGNBn7udiJEX88Zck0LnUrCyEncSz0OM5klC4vxpkRdCw== X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Oct 2021 17:33:06.9070 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1a3f7c20-605f-476d-537c-08d998a6ac2b 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: VE1EUR03FT049.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM4PR0802MB2163 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: 1CPwAHsFLcCo3ORCCKoPSrDLx1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1635269593; bh=vG/hROlPApC9pHdwoLJ/yNUEml43G3ybByCjTGrhoDc=; h=Cc:Content-Type:Date:From:Reply-To:Subject:To; b=bLTnplsdayBskuL32bLPtgHg8IfUnv7EIbyCvhwZxZXD+efmk2PTdm1FspY6SI7o1xU hf7uQfNctMUj382P9kk0TN5BayfJAmrF9AXsLXlbRLI/xvMNuSdzmiptNbBljyWYtgeaK k3RtIHECHeJXfPK1uVXE1WHzUPAc2S2oono= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1635269594696100001 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 --- .../Library/PlatformLib/PlatformLib.c | 46 +++++++++++++++++-- 1 file changed, 41 insertions(+), 5 deletions(-) diff --git a/Silicon/ARM/NeoverseN1Soc/Library/PlatformLib/PlatformLib.c b/= Silicon/ARM/NeoverseN1Soc/Library/PlatformLib/PlatformLib.c index f722080e56..c0effd37f3 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. + + @return The boot reason on the platform. + +**/ EFI_BOOT_MODE ArmPlatformGetBootMode ( VOID @@ -25,6 +31,16 @@ 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 + @retval RETURN_SUCCESS + +**/ RETURN_STATUS ArmPlatformInitialize ( IN UINTN MpId @@ -33,6 +49,17 @@ 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 + @retval EFI_SUCCESS + +**/ EFI_STATUS PrePeiCoreGetMpCoreInfo ( OUT UINTN *CoreCount, @@ -56,6 +83,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 (#82710): https://edk2.groups.io/g/devel/message/82710 Mute This Topic: https://groups.io/mt/86608847/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-