From: "PierreGondois" <pierre.gondois@arm.com>
To: Jeff Brasen <jbrasen@nvidia.com>, devel@edk2.groups.io
Cc: Sami.Mujawar@arm.com, Alexei.Fedorov@arm.com,
Swatisri Kantamsetti <swatisrik@nvidia.com>,
Ashish Singhal <ashishsingha@nvidia.com>
Subject: Re: [PATCH 4/4] DynamicTablesPkg: Add Aml NameUnicodeString API
Date: Mon, 3 Jul 2023 11:42:56 +0200 [thread overview]
Message-ID: <ab962fc3-af08-3109-8b61-2e9b0a98b5f5@arm.com> (raw)
In-Reply-To: <ef38fa95b4aecc382390127e60a8047322831964.1688079404.git.jbrasen@nvidia.com>
Hello Jeff,
Reviewed-by: Pierre Gondois <pierre.gondois@arm.com>
On 6/30/23 01:01, Jeff Brasen wrote:
> Add API to generate a Name that contains a Unicode string buffer.
>
> Change-Id: I0116b2921cbbbecc3420ff7a42a7ab6e01852534
> Reviewed-by: Swatisri Kantamsetti <swatisrik@nvidia.com>
> Reviewed-by: Ashish Singhal <ashishsingha@nvidia.com>
> ---
> .../Include/Library/AmlLib/AmlLib.h | 31 +++++++
> .../Common/AmlLib/CodeGen/AmlCodeGen.c | 86 +++++++++++++++++++
> 2 files changed, 117 insertions(+)
>
> diff --git a/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h b/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h
> index 043e7ee901..5150aa4870 100644
> --- a/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h
> +++ b/DynamicTablesPkg/Include/Library/AmlLib/AmlLib.h
> @@ -958,6 +958,37 @@ AmlCodeGenNameResourceTemplate (
> OUT AML_OBJECT_NODE_HANDLE *NewObjectNode OPTIONAL
> );
>
> +/** AML code generation for a Name object node, containing a String.
> +
> + AmlCodeGenNameUnicodeString ("_STR", L"String", ParentNode, NewObjectNode) is
> + equivalent of the following ASL code:
> + Name(_STR, Unicode ("String"))
> +
> + @ingroup CodeGenApis
> +
> + @param [in] NameString The new variable name.
> + Must be a NULL-terminated ASL NameString
> + e.g.: "DEV0", "DV15.DEV0", etc.
> + The input string is copied.
> + @param [in] String NULL terminated Unicode String to associate to the
> + NameString.
> + @param [in] ParentNode If provided, set ParentNode as the parent
> + of the node created.
> + @param [out] NewObjectNode If success, contains the created node.
> +
> + @retval EFI_SUCCESS Success.
> + @retval EFI_INVALID_PARAMETER Invalid parameter.
> + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory.
> +**/
> +EFI_STATUS
> +EFIAPI
> +AmlCodeGenNameUnicodeString (
> + IN CONST CHAR8 *NameString,
> + IN CHAR16 *String,
> + IN AML_NODE_HANDLE ParentNode OPTIONAL,
> + OUT AML_OBJECT_NODE_HANDLE *NewObjectNode OPTIONAL
> + );
> +
> /** Add a _PRT entry.
>
> AmlCodeGenPrtEntry (0x0FFFF, 0, "LNKA", 0, PrtNameNode) is
> diff --git a/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c b/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c
> index a0d01032d5..20ddad031d 100644
> --- a/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c
> +++ b/DynamicTablesPkg/Library/Common/AmlLib/CodeGen/AmlCodeGen.c
> @@ -869,6 +869,92 @@ AmlCodeGenNameResourceTemplate (
> return Status;
> }
>
> +/** AML code generation for a Name object node, containing a String.
> +
> + AmlCodeGenNameUnicodeString ("_STR", L"String", ParentNode, NewObjectNode) is
> + equivalent of the following ASL code:
> + Name(_STR, Unicode ("String"))
> +
> + @ingroup CodeGenApis
> +
> + @param [in] NameString The new variable name.
> + Must be a NULL-terminated ASL NameString
> + e.g.: "DEV0", "DV15.DEV0", etc.
> + The input string is copied.
> + @param [in] String NULL terminated Unicode String to associate to the
> + NameString.
> + @param [in] ParentNode If provided, set ParentNode as the parent
> + of the node created.
> + @param [out] NewObjectNode If success, contains the created node.
> +
> + @retval EFI_SUCCESS Success.
> + @retval EFI_INVALID_PARAMETER Invalid parameter.
> + @retval EFI_OUT_OF_RESOURCES Failed to allocate memory.
> +**/
> +EFI_STATUS
> +EFIAPI
> +AmlCodeGenNameUnicodeString (
> + IN CONST CHAR8 *NameString,
> + IN CHAR16 *String,
> + IN AML_NODE_HANDLE ParentNode OPTIONAL,
> + OUT AML_OBJECT_NODE_HANDLE *NewObjectNode OPTIONAL
> + )
> +{
> + EFI_STATUS Status;
> + AML_OBJECT_NODE *ObjectNode;
> + AML_DATA_NODE *DataNode;
> +
> + if ((NameString == NULL) ||
> + (String == NULL) ||
> + ((ParentNode == NULL) && (NewObjectNode == NULL)))
> + {
> + ASSERT (0);
> + return EFI_INVALID_PARAMETER;
> + }
> +
> + Status = AmlCodeGenBuffer (NULL, 0, &ObjectNode);
> + if (EFI_ERROR (Status)) {
> + ASSERT_EFI_ERROR (Status);
> + return Status;
> + }
> +
> + Status = AmlCreateDataNode (
> + EAmlNodeDataTypeRaw,
> + (CONST UINT8 *)String,
> + StrSize (String),
> + &DataNode
> + );
> + if (EFI_ERROR (Status)) {
> + ASSERT_EFI_ERROR (Status);
> + AmlDeleteTree ((AML_NODE_HEADER *)ObjectNode);
> + return Status;
> + }
> +
> + Status = AmlVarListAddTail (
> + (AML_NODE_HEADER *)ObjectNode,
> + (AML_NODE_HEADER *)DataNode
> + );
> + if (EFI_ERROR (Status)) {
> + ASSERT_EFI_ERROR (Status);
> + AmlDeleteTree ((AML_NODE_HEADER *)ObjectNode);
> + AmlDeleteTree ((AML_NODE_HANDLE)DataNode);
> + return Status;
> + }
> +
> + Status = AmlCodeGenName (
> + NameString,
> + ObjectNode,
> + ParentNode,
> + NewObjectNode
> + );
> + if (EFI_ERROR (Status)) {
> + ASSERT (0);
> + AmlDeleteTree ((AML_NODE_HEADER *)ObjectNode);
> + }
> +
> + return Status;
> +}
> +
> /** Add a _PRT entry.
>
> AmlCodeGenPrtEntry (0x0FFFF, 0, "LNKA", 0, PrtNameNode) is
next prev parent reply other threads:[~2023-07-03 9:43 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-06-29 23:01 [PATCH 0/4] Add support for generating ACPI ThermalZones Jeff Brasen
2023-06-29 23:01 ` [PATCH 1/4] DynamicTablesPkg: Add ThermalZone CodeGen function Jeff Brasen
2023-07-03 9:42 ` PierreGondois
2023-06-29 23:01 ` [PATCH 2/4] DynamicTablesPkg: Add support for simple method invocation Jeff Brasen
2023-07-03 9:42 ` PierreGondois
2023-06-29 23:01 ` [PATCH 3/4] DynamicTablesPkg: Add support to add Strings to package Jeff Brasen
2023-07-03 9:42 ` PierreGondois
2023-06-29 23:01 ` [PATCH 4/4] DynamicTablesPkg: Add Aml NameUnicodeString API Jeff Brasen
2023-07-03 9:42 ` PierreGondois [this message]
2023-07-03 12:27 ` PierreGondois
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-list from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=ab962fc3-af08-3109-8b61-2e9b0a98b5f5@arm.com \
--to=devel@edk2.groups.io \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox