From nobody Mon Feb 9 23:03:57 2026 Delivered-To: importer@patchew.org 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+81595+1787277+3901457@groups.io; helo=mail02.groups.io; 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+81595+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=arm.com ARC-Seal: i=1; a=rsa-sha256; t=1633620779; cv=none; d=zohomail.com; s=zohoarc; b=nhM7uPISrsq54svRio4bAG7HWNF7TdwaQ5v1BmHpzPZnTcq0i/EyRzQHfXekwqocYo7/xDFKthGZ2ZHhF6G4FMOxTQbnTUfotq4QhsgtTFafVEXoNYUtexeI32OZIylnP1owm8tP5liyKIikYW6zUt1U40QrLwP6/h1IHmgjsfo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1633620779; h=Date:From:In-Reply-To:List-Subscribe:List-Id:List-Help:List-Unsubscribe:Message-ID:Reply-To:References:Sender:Subject:To; bh=2XiSjF7uxJ56zJglOdWSwzbJXaiVrkt6QImvU+8cITc=; b=bKBkyXxqo0SPBufvX2bJM3gsvXqReMhdc0RgycErdfZlSdwGtyEyd26EzlAO0C7BfdrkVObDdgkKHC7XnxGMUk6wKL6Pwzc2JeDzbF0da0UwzDRXy+HGKYzUt3Pa4ja/6tPLLUbtK0+LAbrqee9ATBUm7KZDoXzKg3kWBTtZLE4= ARC-Authentication-Results: i=1; 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+81595+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by mx.zohomail.com with SMTPS id 1633620779295355.97333856106127; Thu, 7 Oct 2021 08:32:59 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id nbDpYY1788612xEsybc1qTU5; Thu, 07 Oct 2021 08:32:59 -0700 X-Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web10.13675.1633620777160551863 for ; Thu, 07 Oct 2021 08:32:57 -0700 X-Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id D8146ED1; Thu, 7 Oct 2021 08:32:56 -0700 (PDT) X-Received: from e120189.arm.com (unknown [10.57.72.88]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id D82EC3F66F; Thu, 7 Oct 2021 08:32:55 -0700 (PDT) From: "PierreGondois" To: devel@edk2.groups.io, Sami Mujawar , Alexei.Fedorov@arm.com Subject: [edk2-devel] [PATCH v2 14/21] DynamicTablesPkg: AML code generation for a ResourceTemplate Date: Thu, 7 Oct 2021 16:32:03 +0100 Message-Id: <20211007153210.26608-15-Pierre.Gondois@arm.com> In-Reply-To: <20211007153210.26608-1-Pierre.Gondois@arm.com> References: <20211007153210.26608-1-Pierre.Gondois@arm.com> 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,pierre.gondois@arm.com X-Gm-Message-State: zduglptTIEbCsuMez573b9bRx1787277AA= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1633620779; bh=eKC4MBVowF1MDDJQovMIsUoSSdR/rRJ/DcYyFBNjqmw=; h=Date:From:Reply-To:Subject:To; b=pmFq6bl5CRiK4gOPISkGQoFZnJNoX37avRp6ogPHeopPnvbCTEQWX81BHaK99f1+NSY P7fk5CndYJkhHguc+yj/QF9wCj9vhJAOMGUWmkIu9ZcPC81iyFLwJJ5vRNUMlO17XlaB5 fEpTO7PzNfXEY4ZmNjfco3Cyu+wvznX7Bwc= X-ZohoMail-DKIM: pass (identity @groups.io) X-ZM-MESSAGEID: 1633620781639100031 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: Pierre Gondois ASL provides a ResourceTemplate macro that creates a Buffer in which resource descriptor macros can be listed. The ResourceTemplate macro automatically generates an End descriptor and calculates the checksum for the resource template. Therefore, add AmlCodeGenResourceTemplate() to generate AML code for the ResourceTemplate() macro. This function generates a Buffer node with an EndTag resource data descriptor, which is similar to the ASL ResourceTemplate() macro. Signed-off-by: Pierre Gondois Reviewed-by: Sami Mujawar --- .../Common/AmlLib/CodeGen/AmlCodeGen.c | 190 ++++++++++++++++++ 1 file changed, 190 insertions(+) diff --git a/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c b/= DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c index a4cd2502dc56..da80e9d77cc2 100644 --- a/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c +++ b/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c @@ -12,6 +12,7 @@ =20 #include #include +#include #include #include #include @@ -316,6 +317,195 @@ error_handler: return Status; } =20 +/** AML code generation for a Buffer object node. + + To create a Buffer object node with an empty buffer, + call the function with (Buffer=3DNULL, BufferSize=3D0). + + @param [in] Buffer Buffer to set for the created Buffer + object node. The Buffer's content is copied. + NULL if there is no buffer to set for + the Buffer node. + @param [in] BufferSize Size of the Buffer. + 0 if there is no buffer to set for + the Buffer node. + @param [out] NewObjectNode If success, contains the created + Buffer object node. + + @retval EFI_SUCCESS Success. + @retval EFI_INVALID_PARAMETER Invalid parameter. + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory. +**/ +STATIC +EFI_STATUS +EFIAPI +AmlCodeGenBuffer ( + IN CONST UINT8 * Buffer, OPTIONAL + IN UINT32 BufferSize, OPTIONAL + OUT AML_OBJECT_NODE ** NewObjectNode + ) +{ + EFI_STATUS Status; + AML_OBJECT_NODE * BufferNode; + AML_OBJECT_NODE * BufferSizeNode; + UINT32 BufferSizeNodeSize; + AML_DATA_NODE * DataNode; + UINT32 PkgLen; + + // Buffer and BufferSize must be either both set, or both clear. + if ((NewObjectNode =3D=3D NULL) || + ((Buffer =3D=3D NULL) !=3D (BufferSize =3D=3D 0))) { + ASSERT (0); + return EFI_INVALID_PARAMETER; + } + + BufferNode =3D NULL; + DataNode =3D NULL; + + // Cf ACPI 6.3 specification, s20.2.5.4 "Type 2 Opcodes Encoding" + // DefBuffer :=3D BufferOp PkgLength BufferSize ByteList + // BufferOp :=3D 0x11 + // BufferSize :=3D TermArg =3D> Integer + + Status =3D AmlCodeGenInteger (BufferSize, &BufferSizeNode); + if (EFI_ERROR (Status)) { + ASSERT (0); + return Status; + } + + // Get the number of bytes required to encode the BufferSizeNode. + Status =3D AmlComputeSize ( + (AML_NODE_HEADER*)BufferSizeNode, + &BufferSizeNodeSize + ); + if (EFI_ERROR (Status)) { + ASSERT (0); + goto error_handler; + } + + // Compute the size to write in the PkgLen. + Status =3D AmlComputePkgLength (BufferSizeNodeSize + BufferSize, &PkgLen= ); + if (EFI_ERROR (Status)) { + ASSERT (0); + goto error_handler; + } + + // Create an object node for the buffer. + Status =3D AmlCreateObjectNode ( + AmlGetByteEncodingByOpCode (AML_BUFFER_OP, 0), + PkgLen, + &BufferNode + ); + if (EFI_ERROR (Status)) { + ASSERT (0); + goto error_handler; + } + + // Set the BufferSizeNode as a fixed argument of the BufferNode. + Status =3D AmlSetFixedArgument ( + BufferNode, + EAmlParseIndexTerm0, + (AML_NODE_HEADER*)BufferSizeNode + ); + if (EFI_ERROR (Status)) { + ASSERT (0); + goto error_handler; + } + + // BufferSizeNode is now attached. + BufferSizeNode =3D NULL; + + // If there is a buffer, create a DataNode and attach it to the BufferNo= de. + if (Buffer !=3D NULL) { + Status =3D AmlCreateDataNode ( + EAmlNodeDataTypeRaw, + Buffer, + BufferSize, + &DataNode + ); + if (EFI_ERROR (Status)) { + ASSERT (0); + goto error_handler; + } + + Status =3D AmlVarListAddTail ( + (AML_NODE_HEADER*)BufferNode, + (AML_NODE_HEADER*)DataNode + ); + if (EFI_ERROR (Status)) { + ASSERT (0); + goto error_handler; + } + } + + *NewObjectNode =3D BufferNode; + return Status; + +error_handler: + if (BufferSizeNode !=3D NULL) { + AmlDeleteTree ((AML_NODE_HEADER*)BufferSizeNode); + } + if (BufferNode !=3D NULL) { + AmlDeleteTree ((AML_NODE_HEADER*)BufferNode); + } + if (DataNode !=3D NULL) { + AmlDeleteTree ((AML_NODE_HEADER*)DataNode); + } + return Status; +} + +/** AML code generation for a ResourceTemplate. + + "ResourceTemplate" is a macro defined in ACPI 6.3, s19.3.3 + "ASL Resource Templates". It allows to store resource data elements. + + In AML, a ResourceTemplate is implemented as a Buffer storing resource + data elements. An EndTag resource data descriptor must be at the end + of the list of resource data elements. + This function generates a Buffer node with an EndTag resource data + descriptor. It can be seen as an empty list of resource data elements. + + @param [out] NewObjectNode If success, contains the created + ResourceTemplate object node. + + @retval EFI_SUCCESS Success. + @retval EFI_INVALID_PARAMETER Invalid parameter. + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory. +**/ +STATIC +EFI_STATUS +EFIAPI +AmlCodeGenResourceTemplate ( + OUT AML_OBJECT_NODE ** NewObjectNode + ) +{ + EFI_STATUS Status; + AML_OBJECT_NODE * BufferNode; + + if (NewObjectNode =3D=3D NULL) { + ASSERT (0); + return EFI_INVALID_PARAMETER; + } + + // Create a BufferNode with an empty buffer. + Status =3D AmlCodeGenBuffer (NULL, 0, &BufferNode); + if (EFI_ERROR (Status)) { + ASSERT (0); + return Status; + } + + // Create an EndTag resource data element and attach it to the Buffer. + Status =3D AmlCodeGenEndTag (0, BufferNode, NULL); + if (EFI_ERROR (Status)) { + ASSERT (0); + AmlDeleteTree ((AML_NODE_HEADER*)BufferNode); + return Status; + } + + *NewObjectNode =3D BufferNode; + return Status; +} + /** AML code generation for a Name object node. =20 @param [in] NameString The new variable name. --=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 (#81595): https://edk2.groups.io/g/devel/message/81595 Mute This Topic: https://groups.io/mt/86148207/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-