From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=217.140.96.140; helo=cam-smtp0.cambridge.arm.com; envelope-from=sami.mujawar@arm.com; receiver=edk2-devel@lists.01.org Received: from cam-smtp0.cambridge.arm.com (fw-tnat.cambridge.arm.com [217.140.96.140]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 037E720961853 for ; Fri, 18 May 2018 04:08:44 -0700 (PDT) Received: from E107187.Emea.Arm.com (e107187.emea.arm.com [10.1.206.129]) by cam-smtp0.cambridge.arm.com (8.13.8/8.13.8) with ESMTP id w4IB8b76012833; Fri, 18 May 2018 12:08:39 +0100 From: Sami Mujawar To: edk2-devel@lists.01.org Cc: ard.biesheuvel@linaro.org, leif.lindholm@linaro.org, Matteo.Carlini@arm.com, Stephanie.Hughes-Fitt@arm.com, nd@arm.com, evan.lloyd@arm.com Date: Fri, 18 May 2018 12:08:31 +0100 Message-Id: <20180518110831.29576-1-sami.mujawar@arm.com> X-Mailer: git-send-email 2.11.0.windows.3 MIME-Version: 1.0 Subject: [staging/dynamictables PATCH v2] Update Readme.md to reflect ACPICA compiler update X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 18 May 2018 11:08:45 -0000 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The ACPICA iASL compiler has been enhanced to support the generation of an AML hex file which is required by the Dynamic Tables Framework. The patch for this enhancement has been integrated in the ACPICA repository. Therefore the Prerequisites section in the Readme has been updated accordingly. Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Sami Mujawar --- The changes can be seen at https://github.com/samimujawar/edk2-staging/tree/258_reflect_acpica_compiler_enhancement_v2 Notes: v2: - Add patch commit date and info about presentation. [LEIF] - Updated Readme.md to add date for referencing ACPICA patch. Also annotated the UEFI presentation. [SAMI] v1: - Update ACPICA iAsl compiler usage guidelines. [SAMI] Readme.md | 25 +++++++++++++------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/Readme.md b/Readme.md index b72efca18e8ab5de17cab06f0a1a0725991256d4..6501623503d6ec8ef4840aebc70561d44cf1ca12 100644 --- a/Readme.md +++ b/Readme.md @@ -87,9 +87,9 @@ contains the Dynamic Tables Framework. ### ACPICA iASL compiler The RAW table generator, used to process the DSDT/SSDT files depends on the iASL compiler to convert the DSDT/SSDT ASL files to a C array containing -the hex AML code. The current implementation of the iASL compiler does not -support generation of a C header file suitable for including from a C source -file. +the hex AML code. The "-tc" option of the iASL compiler has been enhanced to +support generation of an AML hex file (C header) with a unique symbol name +so that it is suitable for inclusion from a C source file. Related Links -------------- @@ -135,16 +135,23 @@ or Prerequisites ------------- -ACPICA iASL compiler with support for generating a C header file. +ACPICA iASL compiler with the enhanced "-tc" option to support generation of +AML hex (C header) files with unique symbol names. -A patch ***'Modify hex AML C header file generation'***, to enable -this support has been submitted to the ACPICA source repository. - +A patch *'[iASL: Enhance the -tc option (create AML hex file in C)](https://github.com/acpica/acpica/commit/f9a88a4c1cd020b6a5475d63b29626852a0b5f37)'*, dated 16 March 2018 (2018-03-16), +to enable this support has been integrated to the ACPICA source repository. + +Ensure that the iASL compiler used for building *Dynamic Tables Framework* has this feature enabled. + +This feature was made available in the *ACPICA Compiler update +[Version 20180508](https://www.acpica.org/node/156)*, dated 8 May 2018 (2018-05-08). Documentation ------------- -A description document is in preparation, and should be available in the -near future. + +Refer to the following presentation from *UEFI Plugfest Seattle 2018*: + +[Dynamic Tables Framework: A Step Towards Automatic Generation of Advanced Configuration and Power Interface (ACPI) & System Management BIOS (SMBIOS) Tables – Sami Mujawar (Arm).](http://www.uefi.org/sites/default/files/resources/Arm_Dynamic%20Tables%20Framework%20A%20Step%20Towards%20Automatic%20Generation%20of%20Advanced%20Configuration%20and%20Power%20Interface%20%28ACPI%29%20%26%20System%20Management%20BIOS%20%28SMBIOS%29%20Tables%20_0.pdf) Miscellaneous ------------- -- 'Guid(CE165669-3EF3-493F-B85D-6190EE5B9759)'