From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from NAM10-BN7-obe.outbound.protection.outlook.com (NAM10-BN7-obe.outbound.protection.outlook.com [40.107.92.83]) by mx.groups.io with SMTP id smtpd.web10.8932.1662563731270131010 for ; Wed, 07 Sep 2022 08:15:31 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@nvidia.com header.s=selector2 header.b=lw9mRSbn; spf=permerror, err=parse error for token &{10 18 %{i}._ip.%{h}._ehlo.%{d}._spf.vali.email}: invalid domain name (domain: nvidia.com, ip: 40.107.92.83, mailfrom: jbrasen@nvidia.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=RjDYWS3yVTPczdEX0vBOwvGeXmI5eVsCt7lkebGF9u0LyKgUyhxyLwjEROr3ms//KnOW7SNSpFX+BGKbjI6u4ZR4CuufhvSZebjCUZ2Uz+vNnSkYJWrEnk1GvWWIzptN1rx5c+z9nuqNpZyiXhzzKMTpuP6WWzh5NMvsxqo2H1MUBcuW3Gducsr5z7RQdfLt8buGL2sHBT8xUmTPyVb4ZRda4O2T1PX3IVc+KrgX3dbop6HU/1QvHkgBFpg0/UZhYmdpemauGHzrJ4f95apFq0vul9hXKmt9MKO+XovZjIsL0u1GuaFr/8t2hvaHfuxThOhE2kOJGowpr8j7VcM8jQ== 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=pEFR6w+2xz8qyz1TpIiYk92g6tJhecy9IKOFw/Bv6uw=; b=oKgumQ+h2sP0VFLG4vjOQaxMmjgJ8BfHstOLOnn5U0dWTbAeHi7wJdTf3yAssx0S8UTT/Q2y/eU9puSeQJaisknwBxHlzyA3b7oAdNy1Sc3wKtotziWaSN3gbw0k+TJE5Jn6QF11gIqOtsh0jT+jrtrEZgNsTyKRlkEsY+eFTzat+Gh7oNLV6fouckleDY3WCAHoaidwGOVZQixx77+z2BrCzlxTZ5nJNSAa/9ubaglvwIInA3l0zYw1Bp11X07E8+AlVHuW2Vjua9o5rTfQxGTT4oHfLZ8gYeqG2vdq7zhtSwvkiKP9xe1lCAVmHjTKCWtiIutLEIxzvZTLozTESQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.236) smtp.rcpttodomain=arm.com smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=pEFR6w+2xz8qyz1TpIiYk92g6tJhecy9IKOFw/Bv6uw=; b=lw9mRSbn7YABLYX1HTyjkS4OGkFrAdFQFDdOJpUheEDbcsRs3ZlygxQIywNKY+MNCNgimFmbzOT0zxlhvNIbub0V88ZDraSpkCoMy8MsDZeGqMs/CBBV7nclw/PsOjNvJDft2CpoxIoN5iRo5XP24AscJdfc47jSQXbzV0ymxM0jkt1/AKaCqhFX6CAIP/1itUtI7YFk/tEW6/7xpRAf6LwZxCDuZBWha8UEOtcBA9j08C7j/hyL0pn951lisI1Jbx09od4evWsfOEb6aUPRX+hYjIN6jF+n4DIplJTwcSZesSuKJwUIV0jVEDr4CsCmZqb4OKaYYf+cRBLHdHATpQ== Received: from DS7PR03CA0067.namprd03.prod.outlook.com (2603:10b6:5:3bb::12) by SJ1PR12MB6170.namprd12.prod.outlook.com (2603:10b6:a03:45b::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5588.18; Wed, 7 Sep 2022 15:15:27 +0000 Received: from DM6NAM11FT036.eop-nam11.prod.protection.outlook.com (2603:10b6:5:3bb:cafe::a9) by DS7PR03CA0067.outlook.office365.com (2603:10b6:5:3bb::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5612.14 via Frontend Transport; Wed, 7 Sep 2022 15:15:27 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.236) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.236 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.236; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.236) by DM6NAM11FT036.mail.protection.outlook.com (10.13.172.64) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5612.13 via Frontend Transport; Wed, 7 Sep 2022 15:15:27 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by DRHQMAIL109.nvidia.com (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.38; Wed, 7 Sep 2022 15:15:26 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.29; Wed, 7 Sep 2022 08:15:26 -0700 Received: from localhost.localdomain (10.127.8.10) by mail.nvidia.com (10.126.190.181) with Microsoft SMTP Server id 15.2.986.29 via Frontend Transport; Wed, 7 Sep 2022 08:15:26 -0700 From: "Jeff Brasen" To: CC: , , , Jeff Brasen Subject: [PATCH 2/3] DynamicTablesPkg: AML Code generation to add _CPC entries Date: Wed, 7 Sep 2022 09:15:18 -0600 Message-ID: X-Mailer: git-send-email 2.25.1 In-Reply-To: References: MIME-Version: 1.0 X-NVConfidentiality: public Return-Path: jbrasen@nvidia.com X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT036:EE_|SJ1PR12MB6170:EE_ X-MS-Office365-Filtering-Correlation-Id: cc220bbf-49a0-4f43-7254-08da90e3cb86 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: niyo1ljKvMQZyewaI1ZMyeX3E7HxVTxmpxan+mP3SVms1vDVaKUgJCYkg3OuRfznlR+4Wi7wWrLLZxN0HhaoY0ARpb/B5oHI8FDk2O2BvTZrlQcu7VH4+VDMXzSCvv/FJMklVd8566JZb2I1E+dx74GoT1r5s61HwhfYvc53ix/tLCFFZL5ujspxSt6rHRVexN2l8p37fpzA+f2E71s14+LiZc/oRVTIBDWYKfDTgNOmvLhtSqlynBfesACUOQrKxus/KlfJmrHgs/gKD50QyF5vdOGXiJxxBuVot6H691qN0++y/vctEB6umxSz59pk/YVncV5GKkI28e8LoGqoW7PvOq4lyuK+D2JZ3CuKVcmZsmr0T/9KNyQsu36E2TlMaUUqsMnamTB6y032I0/+CptZXS3lTHXcsV+RUVywMZ4okeNF7SP2OUjhEjkbjUIrEDGpFop6g6VJ/FY++VewMqE2IOi/5Hp1RO2x6g1QuVALV36X8I0juHXl9MaKuwweOntLqssW9jqYpGKkghVTHweU4n0qDWytjPe9FDJaQDrGOJKxYO9pRRBofwgXjOnp7IBxmOYd8VHiw6jEJDArwlnED5e7zmitkGq801r/u9chQHKU/KZgdEaV7MDDC65qrVc/C8pRXlKG7mV0QgmtgMdO1WQorYLgOrBOo4LIiDaW3MrpdH4sB/Vtq4QVMynuX72BpA3hyETrYL6+FgjCERT1cfvqxv9k30esethyzMIaohAKxw1QGHn/6E4N7Jjv9aolhXZA58gQ99m4OP5SfnsGKekbEcsd9+DmuhERu86Rlcg5vq+s93My36MutS4X X-Forefront-Antispam-Report: CIP:12.22.5.236;CTRY:US;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:mail.nvidia.com;PTR:InfoNoRecords;CAT:NONE;SFS:(13230016)(4636009)(39860400002)(396003)(346002)(136003)(376002)(40470700004)(46966006)(36840700001)(316002)(6916009)(478600001)(83380400001)(54906003)(6666004)(40460700003)(26005)(8936002)(40480700001)(5660300002)(36756003)(2906002)(30864003)(82310400005)(19627235002)(107886003)(86362001)(81166007)(4326008)(356005)(82740400003)(70206006)(70586007)(2616005)(36860700001)(8676002)(47076005)(426003)(336012)(41300700001)(186003)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Sep 2022 15:15:27.1189 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: cc220bbf-49a0-4f43-7254-08da90e3cb86 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a;Ip=[12.22.5.236];Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT036.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ1PR12MB6170 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain _CPC entries can describe CPU performance information.=0D The object is described in ACPI 6.4 s8.4.7.1.=0D "_CPC (Continuous Performance Control)".=0D =0D Add AmlCreateCpcNode() helper function to add _CPC entries to an=0D existing CPU object.=0D =0D Signed-off-by: Jeff Brasen =0D ---=0D .../Include/Library/AmlLib/AmlLib.h | 155 +++++=0D .../Common/AmlLib/CodeGen/AmlCodeGen.c | 549 ++++++++++++++++++=0D 2 files changed, 704 insertions(+)=0D =0D diff --git a/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h b/DynamicTabl= esPkg/Include/Library/AmlLib/AmlLib.h=0D index 39968660f2..65f6cd7583 100644=0D --- a/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h=0D +++ b/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h=0D @@ -1336,6 +1336,161 @@ AmlAddNameIntegerPackage (=0D IN AML_OBJECT_NODE_HANDLE PackageNode=0D );=0D =0D +/** Create a _CPC node.=0D +=0D + Creates and optionally adds the following node=0D + Name(_CPC, Package()=0D + {=0D + NumEntries, // Integer=0D + Revision, // Integer=0D + HighestPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + NominalPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + LowestNonlinearPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + LowestPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + GuaranteedPerformanceRegister, // Buffer (Resource Descripto= r)=0D + DesiredPerformanceRegister , // Buffer (Resource Descripto= r)=0D + MinimumPerformanceRegister , // Buffer (Resource Descripto= r)=0D + MaximumPerformanceRegister , // Buffer (Resource Descripto= r)=0D + PerformanceReductionToleranceRegister, // Buffer (Resource Descripto= r)=0D + TimeWindowRegister, // Buffer (Resource Descripto= r)=0D + CounterWraparoundTime, // Integer or Buffer (Resourc= e Descriptor)=0D + ReferencePerformanceCounterRegister, // Buffer (Resource Descripto= r)=0D + DeliveredPerformanceCounterRegister, // Buffer (Resource Descripto= r)=0D + PerformanceLimitedRegister, // Buffer (Resource Descripto= r)=0D + CPPCEnableRegister // Buffer (Resource Descripto= r)=0D + AutonomousSelectionEnable, // Integer or Buffer (Resourc= e Descriptor)=0D + AutonomousActivityWindowRegister, // Buffer (Resource Descripto= r)=0D + EnergyPerformancePreferenceRegister, // Buffer (Resource Descripto= r)=0D + ReferencePerformance // Integer or Buffer (Resourc= e Descriptor)=0D + LowestFrequency, // Integer or Buffer (Resourc= e Descriptor)=0D + NominalFrequency // Integer or Buffer (Resourc= e Descriptor)=0D + })=0D +=0D + If resource buffer is NULL then integer will be used.=0D +=0D + Cf. ACPI 6.4, s8.4.7.1 _CPC (Continuous Performance Control)=0D +=0D + @ingroup CodeGenApis=0D +=0D + @param [in] HighestPerformanceBuffer If provided, buffer = that indicates the highest level=0D + of performance the p= rocessor.=0D + @param [in] HighestPerformanceInteger Indicates the highes= t level of performance the processor,=0D + used if buffer is NU= LL.=0D + @param [in] NominalPerformanceBuffer If provided buffer t= hat indicates the highest sustained=0D + performance level of= the processor.=0D + @param [in] NominalPerformanceInteger Indicates the highes= t sustained performance level=0D + of the processor, us= ed if buffer is NULL.=0D + @param [in] LowestNonlinearPerformanceBuffer If provided, buffer = that indicates the lowest performance level=0D + of the processor wit= h non-linear power savings.=0D + @param [in] LowestNonlinearPerformanceInteger Indicates the lowest= performance level of the processor with=0D + non-linear power sav= ings, used if buffer is NULL.=0D + @param [in] LowestPerformanceBuffer If provided, buffer = that indicates the=0D + lowest performance l= evel of the processor.=0D + @param [in] LowestPerformanceInteger Indicates the lowest= performance level of the processor,=0D + used if buffer is NU= LL.=0D + @param [in] GuaranteedPerformanceRegister If provided, Guarant= eed Performance Register Buffer.=0D + @param [in] DesiredPerformanceRegister If provided, Desired= Performance Register Buffer.=0D + @param [in] MinimumPerformanceRegister If provided, Minimum= Performance Register Buffer.=0D + @param [in] MaximumPerformanceRegister If provided, Maximum= Performance Register Buffer.=0D + @param [in] PerformanceReductionToleranceRegister If provided, Perform= ance Reduction Tolerance Register.=0D + @param [in] TimeWindowRegister If provided, Time Wi= ndow Register.=0D + @param [in] CounterWraparoundTimeBuffer If provided, Counter= Wraparound Time buffer.=0D + @param [in] CounterWraparoundTimeInteger Counter Wraparound T= ime, used if buffer is NULL.=0D + @param [in] ReferencePerformanceCounterRegister Reference Performanc= e Counter Register.=0D + @param [in] DeliveredPerformanceCounterRegister Delivered Performanc= e Counter Register.=0D + @param [in] PerformanceLimitedRegister Performance Limited = Register.=0D + @param [in] CPPCEnableRegister If provided, CPPC En= ableRegister.=0D + @param [in] AutonomousSelectionEnableBuffer If provided, Autonom= ous Selection Enable buffer.=0D + @param [in] AutonomousSelectionEnableInteger Autonomous Selection= Enable, used if buffer is NULL.=0D + @param [in] AutonomousActivityWindowRegister If provided, Autonom= ousActivity-WindowRegister.=0D + @param [in] EnergyPerformancePreferenceRegister If provided, EnergyP= erformance-PreferenceRegister.=0D + @param [in] ReferencePerformanceBuffer If provided, Referen= ce Performance buffer.=0D + @param [in] ReferencePerformanceInteger Reference Performanc= e, used if buffer is NULL.=0D + @param [in] LowestFrequencyBuffer If provided, Lowest = Frequency buffer.=0D + @param [in] LowestFrequencyInteger Lowest Frequency, us= ed if buffer is NULL.=0D + @param [in] NominalFrequencyBuffer If provided, Nominal= FrequencyBuffer buffer.=0D + @param [in] NominalFrequencyInteger NominalFrequencyBuff= er, used if buffer is NULL.=0D + @param [in] ParentNode If provided, set Par= entNode as the parent=0D + of the node created.= =0D + @param [out] NewCpcNode If success and provi= ded, contains the created node.=0D +=0D + @retval EFI_SUCCESS The function completed successfully.=0D + @retval EFI_INVALID_PARAMETER Invalid parameter.=0D + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory.=0D +**/=0D +EFI_STATUS=0D +EFIAPI=0D +AmlCreateCpcNode (=0D + /// Indicates the highest level of performance the processor=0D + /// is theoretically capable of achieving.=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *HighestPerformanceBuffer OPT= IONAL,=0D + IN UINT32 HighestPerformanceInteger,=0D + /// Indicates the highest sustained performance level of the processor.= =0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *NominalPerformanceBuffer OPT= IONAL,=0D + IN UINT32 NominalPerformanceInteger,=0D + /// Indicates the lowest performance level of the processor with non-lin= ear power savings.=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *LowestNonlinearPerformanceBu= ffer OPTIONAL,=0D + IN UINT32 LowestNonlinearPerformanceInt= eger,=0D + /// Indicates the lowest performance level of the processor..=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *LowestPerformanceBuffer OPTI= ONAL,=0D + IN UINT32 LowestPerformanceInteger,=0D + /// Guaranteed Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *GuaranteedPerformanceRegiste= r OPTIONAL,=0D + /// Desired Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *DesiredPerformanceRegister O= PTIONAL,=0D + /// Minimum Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *MinimumPerformanceRegister O= PTIONAL,=0D + /// Maximum Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *MaximumPerformanceRegister O= PTIONAL,=0D + /// Performance Reduction Tolerance Register.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *PerformanceReductionToleranc= eRegister OPTIONAL,=0D + /// Time Window Register.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *TimeWindowRegister OPTIONAL,= =0D + /// Counter Wraparound Time=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *CounterWraparoundTimeBuffer = OPTIONAL,=0D + IN UINT32 CounterWraparoundTimeInteger,= =0D + /// Reference Performance Counter Register=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *ReferencePerformanceCounterR= egister,=0D + /// Delivered Performance Counter Register=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *DeliveredPerformanceCounterR= egister,=0D + /// Performance Limited Register=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *PerformanceLimitedRegister,= =0D + /// CPPC EnableRegister=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *CPPCEnableRegister OPTIONAL,= =0D + /// Autonomous Selection Enable=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *AutonomousSelectionEnableBuf= fer OPTIONAL,=0D + IN UINT32 AutonomousSelectionEnableInte= ger,=0D + /// AutonomousActivity-WindowRegister=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *AutonomousActivityWindowRegi= ster OPTIONAL,=0D + /// EnergyPerformance-PreferenceRegister=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *EnergyPerformancePreferenceR= egister OPTIONAL,=0D + /// Reference Performance=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *ReferencePerformanceBuffer O= PTIONAL,=0D + IN UINT32 ReferencePerformanceInteger,= =0D + /// Lowest Frequency=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *LowestFrequencyBuffer OPTION= AL,=0D + IN UINT32 LowestFrequencyInteger,=0D + /// Nominal Frequency=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *NominalFrequencyBuffer OPTIO= NAL,=0D + IN UINT32 NominalFrequencyInteger,=0D + IN AML_NODE_HANDLE ParentNode OPTIONAL,=0D + OUT AML_OBJECT_NODE_HANDLE *NewCpcNode OPTIONAL=0D + );=0D +=0D // DEPRECATED APIS=0D #ifndef DISABLE_NEW_DEPRECATED_INTERFACES=0D =0D diff --git a/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c b/= DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c=0D index 5fb39d077b..dfc3015baf 100644=0D --- a/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c=0D +++ b/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c=0D @@ -2850,3 +2850,552 @@ error_handler:=0D =0D return Status;=0D }=0D +=0D +/** Adds a register to the package=0D +=0D + @ingroup CodeGenApis=0D +=0D + @param [in] Register If provided, register that will be added to pa= ckage.=0D + otherwise NULL register will be added=0D + @param [in] PackageNode Package to add value to=0D +=0D + @retval EFI_SUCCESS The function completed successfully.=0D + @retval EFI_INVALID_PARAMETER Invalid parameter.=0D + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory.=0D +**/=0D +STATIC=0D +EFI_STATUS=0D +EFIAPI=0D +AmlAddRegisterToPackage (=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *Register OPTIONAL,=0D + IN AML_OBJECT_NODE_HANDLE PackageNode=0D + )=0D +{=0D + EFI_STATUS Status;=0D + AML_DATA_NODE_HANDLE RdNode;=0D + AML_OBJECT_NODE_HANDLE ResourceTemplateNode;=0D +=0D + RdNode =3D NULL;=0D + ResourceTemplateNode =3D NULL;=0D +=0D + Status =3D AmlCodeGenResourceTemplate (&ResourceTemplateNode);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + if (Register !=3D NULL) {=0D + Status =3D AmlCodeGenRdRegister (=0D + Register->AddressSpaceId,=0D + Register->RegisterBitWidth,=0D + Register->RegisterBitOffset,=0D + Register->Address,=0D + Register->AccessSize,=0D + NULL,=0D + &RdNode=0D + );=0D + } else {=0D + Status =3D AmlCodeGenRdRegister (=0D + EFI_ACPI_6_4_SYSTEM_MEMORY,=0D + 0,=0D + 0,=0D + 0,=0D + 0,=0D + NULL,=0D + &RdNode=0D + );=0D + }=0D +=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAppendRdNode (ResourceTemplateNode, RdNode);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + RdNode =3D NULL;=0D +=0D + Status =3D AmlVarListAddTail (=0D + (AML_NODE_HANDLE)PackageNode,=0D + (AML_NODE_HANDLE)ResourceTemplateNode=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + ResourceTemplateNode =3D NULL;=0D +=0D + return Status;=0D +=0D +error_handler:=0D + if (RdNode !=3D NULL) {=0D + AmlDeleteTree ((AML_NODE_HANDLE)RdNode);=0D + }=0D +=0D + if (ResourceTemplateNode !=3D NULL) {=0D + AmlDeleteTree ((AML_NODE_HANDLE)ResourceTemplateNode);=0D + }=0D +=0D + return Status;=0D +}=0D +=0D +/** Adds an integer or register to the package=0D +=0D + @ingroup CodeGenApis=0D +=0D + @param [in] Register If provided, register that will be added to pa= ckage=0D + @param [in] Integer If Register is NULL, integer that will be adde= d to the package=0D + @param [in] PackageNode Package to add value to=0D +=0D + @retval EFI_SUCCESS The function completed successfully.=0D + @retval EFI_INVALID_PARAMETER Invalid parameter.=0D + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory.=0D +**/=0D +STATIC=0D +EFI_STATUS=0D +EFIAPI=0D +AmlAddRegisterOrIntegerToPackage (=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *Register OPTIONAL,=0D + IN UINT32 Integer,=0D + IN AML_OBJECT_NODE_HANDLE PackageNode=0D + )=0D +{=0D + EFI_STATUS Status;=0D + AML_OBJECT_NODE_HANDLE IntegerNode;=0D +=0D + IntegerNode =3D NULL;=0D +=0D + if (Register !=3D NULL) {=0D + Status =3D AmlAddRegisterToPackage (Register, PackageNode);=0D + } else {=0D + Status =3D AmlCodeGenInteger (Integer, &IntegerNode);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlVarListAddTail (=0D + (AML_NODE_HANDLE)PackageNode,=0D + (AML_NODE_HANDLE)IntegerNode=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + IntegerNode =3D NULL;=0D + }=0D +=0D + return Status;=0D +=0D +error_handler:=0D + if (IntegerNode !=3D NULL) {=0D + AmlDeleteTree ((AML_NODE_HANDLE)IntegerNode);=0D + }=0D +=0D + return Status;=0D +}=0D +=0D +/** Create a _CPC node.=0D +=0D + Creates and optionally adds the following node=0D + Name(_CPC, Package()=0D + {=0D + NumEntries, // Integer=0D + Revision, // Integer=0D + HighestPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + NominalPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + LowestNonlinearPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + LowestPerformance, // Integer or Buffer (Resourc= e Descriptor)=0D + GuaranteedPerformanceRegister, // Buffer (Resource Descripto= r)=0D + DesiredPerformanceRegister , // Buffer (Resource Descripto= r)=0D + MinimumPerformanceRegister , // Buffer (Resource Descripto= r)=0D + MaximumPerformanceRegister , // Buffer (Resource Descripto= r)=0D + PerformanceReductionToleranceRegister, // Buffer (Resource Descripto= r)=0D + TimeWindowRegister, // Buffer (Resource Descripto= r)=0D + CounterWraparoundTime, // Integer or Buffer (Resourc= e Descriptor)=0D + ReferencePerformanceCounterRegister, // Buffer (Resource Descripto= r)=0D + DeliveredPerformanceCounterRegister, // Buffer (Resource Descripto= r)=0D + PerformanceLimitedRegister, // Buffer (Resource Descripto= r)=0D + CPPCEnableRegister // Buffer (Resource Descripto= r)=0D + AutonomousSelectionEnable, // Integer or Buffer (Resourc= e Descriptor)=0D + AutonomousActivityWindowRegister, // Buffer (Resource Descripto= r)=0D + EnergyPerformancePreferenceRegister, // Buffer (Resource Descripto= r)=0D + ReferencePerformance // Integer or Buffer (Resourc= e Descriptor)=0D + LowestFrequency, // Integer or Buffer (Resourc= e Descriptor)=0D + NominalFrequency // Integer or Buffer (Resourc= e Descriptor)=0D + })=0D +=0D + If resource buffer is NULL then integer will be used.=0D +=0D + Cf. ACPI 6.4, s8.4.7.1 _CPC (Continuous Performance Control)=0D +=0D + @ingroup CodeGenApis=0D +=0D + @param [in] HighestPerformanceBuffer If provided, buffer = that indicates the highest level=0D + of performance the p= rocessor.=0D + @param [in] HighestPerformanceInteger Indicates the highes= t level of performance the processor,=0D + used if buffer is NU= LL.=0D + @param [in] NominalPerformanceBuffer If provided buffer t= hat indicates the highest sustained=0D + performance level of= the processor.=0D + @param [in] NominalPerformanceInteger Indicates the highes= t sustained performance level=0D + of the processor, us= ed if buffer is NULL.=0D + @param [in] LowestNonlinearPerformanceBuffer If provided, buffer = that indicates the lowest performance level=0D + of the processor wit= h non-linear power savings.=0D + @param [in] LowestNonlinearPerformanceInteger Indicates the lowest= performance level of the processor with=0D + non-linear power sav= ings, used if buffer is NULL.=0D + @param [in] LowestPerformanceBuffer If provided, buffer = that indicates the=0D + lowest performance l= evel of the processor.=0D + @param [in] LowestPerformanceInteger Indicates the lowest= performance level of the processor,=0D + used if buffer is NU= LL.=0D + @param [in] GuaranteedPerformanceRegister If provided, Guarant= eed Performance Register Buffer.=0D + @param [in] DesiredPerformanceRegister If provided, Desired= Performance Register Buffer.=0D + @param [in] MinimumPerformanceRegister If provided, Minimum= Performance Register Buffer.=0D + @param [in] MaximumPerformanceRegister If provided, Maximum= Performance Register Buffer.=0D + @param [in] PerformanceReductionToleranceRegister If provided, Perform= ance Reduction Tolerance Register.=0D + @param [in] TimeWindowRegister If provided, Time Wi= ndow Register.=0D + @param [in] CounterWraparoundTimeBuffer If provided, Counter= Wraparound Time buffer.=0D + @param [in] CounterWraparoundTimeInteger Counter Wraparound T= ime, used if buffer is NULL.=0D + @param [in] ReferencePerformanceCounterRegister Reference Performanc= e Counter Register.=0D + @param [in] DeliveredPerformanceCounterRegister Delivered Performanc= e Counter Register.=0D + @param [in] PerformanceLimitedRegister Performance Limited = Register.=0D + @param [in] CPPCEnableRegister If provided, CPPC En= ableRegister.=0D + @param [in] AutonomousSelectionEnableBuffer If provided, Autonom= ous Selection Enable buffer.=0D + @param [in] AutonomousSelectionEnableInteger Autonomous Selection= Enable, used if buffer is NULL.=0D + @param [in] AutonomousActivityWindowRegister If provided, Autonom= ousActivity-WindowRegister.=0D + @param [in] EnergyPerformancePreferenceRegister If provided, EnergyP= erformance-PreferenceRegister.=0D + @param [in] ReferencePerformanceBuffer If provided, Referen= ce Performance buffer.=0D + @param [in] ReferencePerformanceInteger Reference Performanc= e, used if buffer is NULL.=0D + @param [in] LowestFrequencyBuffer If provided, Lowest = Frequency buffer.=0D + @param [in] LowestFrequencyInteger Lowest Frequency, us= ed if buffer is NULL.=0D + @param [in] NominalFrequencyBuffer If provided, Nominal= FrequencyBuffer buffer.=0D + @param [in] NominalFrequencyInteger NominalFrequencyBuff= er, used if buffer is NULL.=0D + @param [in] ParentNode If provided, set Par= entNode as the parent=0D + of the node created.= =0D + @param [out] NewCpcNode If success and provi= ded, contains the created node.=0D +=0D + @retval EFI_SUCCESS The function completed successfully.=0D + @retval EFI_INVALID_PARAMETER Invalid parameter.=0D + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory.=0D +**/=0D +EFI_STATUS=0D +EFIAPI=0D +AmlCreateCpcNode (=0D + /// Indicates the highest level of performance the processor=0D + /// is theoretically capable of achieving.=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *HighestPerformanceBuffer OPT= IONAL,=0D + IN UINT32 HighestPerformanceInteger,=0D + /// Indicates the highest sustained performance level of the processor.= =0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *NominalPerformanceBuffer OPT= IONAL,=0D + IN UINT32 NominalPerformanceInteger,=0D + /// Indicates the lowest performance level of the processor with non-lin= ear power savings.=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *LowestNonlinearPerformanceBu= ffer OPTIONAL,=0D + IN UINT32 LowestNonlinearPerformanceInt= eger,=0D + /// Indicates the lowest performance level of the processor..=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *LowestPerformanceBuffer OPTI= ONAL,=0D + IN UINT32 LowestPerformanceInteger,=0D + /// Guaranteed Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *GuaranteedPerformanceRegiste= r OPTIONAL,=0D + /// Desired Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *DesiredPerformanceRegister O= PTIONAL,=0D + /// Minimum Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *MinimumPerformanceRegister O= PTIONAL,=0D + /// Maximum Performance Register Buffer.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *MaximumPerformanceRegister O= PTIONAL,=0D + /// Performance Reduction Tolerance Register.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *PerformanceReductionToleranc= eRegister OPTIONAL,=0D + /// Time Window Register.=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *TimeWindowRegister OPTIONAL,= =0D + /// Counter Wraparound Time=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *CounterWraparoundTimeBuffer = OPTIONAL,=0D + IN UINT32 CounterWraparoundTimeInteger,= =0D + /// Reference Performance Counter Register=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *ReferencePerformanceCounterR= egister,=0D + /// Delivered Performance Counter Register=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *DeliveredPerformanceCounterR= egister,=0D + /// Performance Limited Register=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *PerformanceLimitedRegister,= =0D + /// CPPC EnableRegister=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *CPPCEnableRegister OPTIONAL,= =0D + /// Autonomous Selection Enable=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *AutonomousSelectionEnableBuf= fer OPTIONAL,=0D + IN UINT32 AutonomousSelectionEnableInte= ger,=0D + /// AutonomousActivity-WindowRegister=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *AutonomousActivityWindowRegi= ster OPTIONAL,=0D + /// EnergyPerformance-PreferenceRegister=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *EnergyPerformancePreferenceR= egister OPTIONAL,=0D + /// Reference Performance=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *ReferencePerformanceBuffer O= PTIONAL,=0D + IN UINT32 ReferencePerformanceInteger,= =0D + /// Lowest Frequency=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *LowestFrequencyBuffer OPTION= AL,=0D + IN UINT32 LowestFrequencyInteger,=0D + /// Nominal Frequency=0D + /// Optional=0D + IN EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE *NominalFrequencyBuffer OPTIO= NAL,=0D + IN UINT32 NominalFrequencyInteger,=0D + IN AML_NODE_HANDLE ParentNode OPTIONAL,=0D + OUT AML_OBJECT_NODE_HANDLE *NewCpcNode OPTIONAL=0D + )=0D +{=0D + EFI_STATUS Status;=0D + AML_OBJECT_NODE_HANDLE CpcNode;=0D + AML_OBJECT_NODE_HANDLE CpcPackage;=0D +=0D + if ((ReferencePerformanceCounterRegister =3D=3D NULL) ||=0D + (PerformanceLimitedRegister =3D=3D NULL) ||=0D + ((ParentNode =3D=3D NULL) && (NewCpcNode =3D=3D NULL)))=0D + {=0D + ASSERT (0);=0D + return EFI_INVALID_PARAMETER;=0D + }=0D +=0D + CpcNode =3D NULL;=0D + CpcPackage =3D NULL;=0D +=0D + Status =3D AmlCodeGenNamePackage ("_CPC", NULL, &CpcNode);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + // Get the Package object node of the _CPC node,=0D + // which is the 2nd fixed argument (i.e. index 1).=0D + CpcPackage =3D (AML_OBJECT_NODE_HANDLE)AmlGetFixedArgument (=0D + CpcNode,=0D + EAmlParseIndexTerm1=0D + );=0D + if ((CpcPackage =3D=3D NULL) = ||=0D + (AmlGetNodeType ((AML_NODE_HANDLE)CpcPackage) !=3D EAmlNodeObject) = ||=0D + (!AmlNodeHasOpCode (CpcPackage, AML_PACKAGE_OP, 0)))=0D + {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + // NumEntries 23 per ACPI 6.4 specification=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + NULL,=0D + 23,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + // Revision 3 per ACPI 6.4 specification=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + NULL,=0D + 3,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + HighestPerformanceBuffer,=0D + HighestPerformanceInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + NominalPerformanceBuffer,=0D + NominalPerformanceInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + LowestNonlinearPerformanceBuffer,=0D + LowestNonlinearPerformanceInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + LowestPerformanceBuffer,=0D + LowestPerformanceInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (GuaranteedPerformanceRegister, CpcPa= ckage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (DesiredPerformanceRegister, CpcPacka= ge);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (MinimumPerformanceRegister, CpcPacka= ge);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (MaximumPerformanceRegister, CpcPacka= ge);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (PerformanceReductionToleranceRegiste= r, CpcPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (TimeWindowRegister, CpcPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + CounterWraparoundTimeBuffer,=0D + CounterWraparoundTimeInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (ReferencePerformanceCounterRegister,= CpcPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (DeliveredPerformanceCounterRegister,= CpcPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (PerformanceLimitedRegister, CpcPacka= ge);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (CPPCEnableRegister, CpcPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + AutonomousSelectionEnableBuffer,=0D + AutonomousSelectionEnableInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (AutonomousActivityWindowRegister, Cp= cPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterToPackage (EnergyPerformancePreferenceRegister,= CpcPackage);=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + ReferencePerformanceBuffer,=0D + ReferencePerformanceInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + LowestFrequencyBuffer,=0D + LowestFrequencyInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + Status =3D AmlAddRegisterOrIntegerToPackage (=0D + NominalFrequencyBuffer,=0D + NominalFrequencyInteger,=0D + CpcPackage=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D +=0D + if (ParentNode !=3D NULL) {=0D + Status =3D AmlVarListAddTail (=0D + (AML_NODE_HANDLE)ParentNode,=0D + (AML_NODE_HANDLE)CpcNode=0D + );=0D + if (EFI_ERROR (Status)) {=0D + ASSERT (0);=0D + goto error_handler;=0D + }=0D + }=0D +=0D + if (NewCpcNode !=3D NULL) {=0D + *NewCpcNode =3D CpcNode;=0D + }=0D +=0D + return Status;=0D +=0D +error_handler:=0D + if (CpcNode !=3D NULL) {=0D + AmlDeleteTree ((AML_NODE_HANDLE)CpcNode);=0D + }=0D +=0D + return Status;=0D +}=0D -- =0D 2.25.1=0D =0D