Jump to content

ACPICA iASL & Intel ACPI Tools 20150930


1 Screenshot

About This File

acpica.png

 

The NEW version of MaciASL 1.3 b265 / Новая версия MaciASL 1.3 b265

 

Intel ACPI tools. The NEW version 20150930 compiled by me from original sources. Use iasl compiler with your MaciASL, DSDTSE or another editor (or Terminal).

 

To update your DSDTSE, simply right click on DSDTSE --> Show contents, drag'n'drop iasl into --> Contents --> Resources. Another editors have mostly the same way.

For MaciASL simply drag iasl to Contents --> MacOS and rename it to iasl5 (or iasl51 for MaciASL 1.3 b262+ builds)

 

Intel ACPI тулзы. Новая версия 20150930 их скомпилирована мною из оригинальных сырцов. Для использования с ДСДТ редактором MaciASL, DSDTSE или другим (или Терминалом).

 

Инсталим сюда: Открываем правой кнопкой по "любимому" редактору --> показать содержимое пакета --> Contents --> Resources --> перетаскиваем драг-н-дропом на эту папку файл iasl, на замену соглашаемся. Имеем свежий компайлер.

Для MaciASL перетаскиваем в подпапку Contents --> MacOS и даем ему имя iasl5 (или iasl51 для современных билдов MaciASL 1.3 b262+ )

 

Major tools and utilities:

  • iASL - ACPI Source Language Compiler, ACPI Table Compiler, and AML Disassembler
  • AcpiExec - Load ACPI tables and execute control methods from user space
  • AcpiDump - Obtain system ACPI tables and save in ASCII hex format
  • AcpiXtract - Extract binary ACPI tables from an ASCII acpidump
  • AcpiHelp - Help utility for ASL operators, AML opcodes, and ACPI Predefined Names

Miscellaneous utilities:

  • AcpiNames - Example utility that loads and displays the ACPI namespace
  • AcpiSrc - Convert ACPICA code to Linux format
  • AcpiBin - Miscellaneous manipulation of binary ACPI tables

iASL HELP:

Supports ACPI Specification Revision 6.0

 

Usage: iasl [Options] [Files]

Options:

 

General:

-@ <file> Specify command file

-I <dir> Specify additional include directory

-T <sig>|ALL|* Create table template file for ACPI <Sig>

-p <prefix> Specify path/filename prefix for all output files

-v Display compiler version

-vo Enable optimization comments

-vs Disable signon

 

Help:

-h This message

-hc Display operators allowed in constant expressions

-hf Display help for output filename generation

-hr Display ACPI reserved method names

-ht Display currently supported ACPI table names

 

Preprocessor:

-D <symbol> Define symbol for preprocessor use

-li Create preprocessed output file (*.i)

-P Preprocess only and create preprocessor output file (*.i)

-Pn Disable preprocessor

 

Errors, Warnings, and Remarks:

-va Disable all errors/warnings/remarks

-ve Report only errors (ignore warnings and remarks)

-vi Less verbose errors and warnings for use with IDEs

-vr Disable remarks

-vw <messageid> Disable specific warning or remark

-w1 -w2 -w3 Set warning reporting level

-we Report warnings as errors

 

AML Code Generation (*.aml):

-oa Disable all optimizations (compatibility mode)

-of Disable constant folding

-oi Disable integer optimization to Zero/One/Ones

-on Disable named reference string optimization

-ot Disable typechecking

-cr Disable Resource Descriptor error checking

-in Ignore NoOp operators

-r <revision> Override table header Revision (1-255)

 

Optional Source Code Output Files:

-sc -sa Create source file in C or assembler (*.c or *.asm)

-ic -ia Create include file in C or assembler (*.h or *.inc)

-tc -ta -ts Create hex AML table in C, assembler, or ASL (*.hex)

-so Create offset table in C (*.offset.h)

 

Optional Listing Files:

-l Create mixed listing file (ASL source and AML) (*.lst)

-lm Create hardware summary map file (*.map)

-ln Create namespace file (*.nsp)

-ls Create combined source file (expanded includes) (*.src)

 

Data Table Compiler:

-G Compile custom table that contains generic operators

-vt Create verbose template files (full disassembly)

 

AML Disassembler:

-d <f1 f2 ...> Disassemble or decode binary ACPI tables to file (*.dsl)

(Optional, file type is automatically detected)

-da <f1 f2 ...> Disassemble multiple tables from single namespace

-db Do not translate Buffers to Resource Templates

-dc <f1 f2 ...> Disassemble AML and immediately compile it

(Obtain DSDT from current system if no input file)

-df Force disassembler to assume table contains valid AML

-dl Emit legacy ASL code only (no C-style operators)

-e <f1 f2 ...> Include ACPI table(s) for external symbol resolution

-fe <file> Specify external symbol declaration file

-in Ignore NoOp opcodes

-l Disassemble to mixed ASL and AML code

-vt Dump binary table data in hex format within output file

 

Debug Options:

-bf Create debug file (full output) (*.txt)

-bs Create debug file (parse tree only) (*.txt)

-bp <depth> Prune ASL parse tree

-bt <type> Object type to be pruned from the parse tree

-f Ignore errors, force creation of AML output file(s)

-m <size> Set internal line buffer size (in Kbytes)

-n Parse only, no output generation

-oc Display compile times and statistics

-x <level> Set debug level for trace output

-z Do not insert new compiler ID for DataTables

ACPISpec ver. 6.0 / ACPI Спецификации 6.0

 

ACPI Spec ver. 5.1 / ACPI спецификации версии 5.1

ACPISPec ver. 5.1 Errata A / ACPI спецификации 5.1 Исправления А

 

Attension / Внимание ::

===========================

Simple replacement of iasl compiler (iasl --> iasl5) in MacIASL leads to an empty Summary window, the bottom line shows correctly number of the errors / warnings / remarks, but the screen remains blank and errors addresses hard to find. This is the MacIASL's bug, not the compiler's.

 

Простая замена компайлера iasl (iasl --> iasl5) в MacIASL ведет к пустому выхлопу окна Summary, то есть количество ошибок / предупреждений / ремарок в нижней строке показывает корректно, но окно остается пустым и адреса ошибок найти сложно. Это баг самого MacIASL, а не компилятора.

===========================

 

IMPORTANT / ВАЖНО :

===========================

To have a correctly disassembled DSL file w/o unexpected errors, you need to use the Terminal to decompile AML binaries. If you have a modern platform and more than 1 SSDT in your ACPI, you need to decompile all of them correctly. To decompile only DSDT.aml use -e key (to decompile in legacy ASL code mode you have to add -dl key instead of -d ) :

 

Чтобы получить корректно дизассемблированный DSL файл без непредвиденных ошибок декомпиляции, нужно использовать терминал для декомпиляции бинарников. Если вы владеете современной платформой и среди ACPI таблиц присутствует более 1 SSDT, необходимо их корректно декомпилировать. Чтобы декомпилировать только DSDT, используйте ключ -e: (для распаковки в легаси код ASL вместо ключа -d надо использовать новый ключ -dl ) :

 

New ASL+ decompile: / Декомпайл ASL+:

iasl -e SSDT*.aml -d DSDT.aml

iasl -e /@full_path@/SSDT*.aml -d /@full_path@/DSDT.aml

iasl -da /@full_path@/SSDT*.aml /@full_path@/DSDT.aml

Legacy ASL decompile / Декомпайл ASL легаси:

iasl -e SSDT*.aml -dl DSDT.aml

iasl -e /@full_path@/SSDT*.aml -dl /@full_path@/DSDT.aml

iasl -da -dl /@full_path@/SSDT*.aml /@full_path@/DSDT.aml

===============================

To decompile all DSDT & SSDTs use -da key / Чтобы декомпилировать все DSDT и SSDT таблицы, используйте ключ -da:

iasl -da DSDT.aml SSDT*.aml

iasl -da /@full_path@/DSDT.aml /@full_path@/SSDT*.aml

Also add reference file ref.txt with unresolved External Methods and Argument count for each. Use -fe key:

 

Также можно добавить дополнительный реф.файл ref.txt c перечислением все еще нераспознанных методов и количество Аргументов для каждого. Используйте ключ -fe:

===============================

External (MDBG, MethodObj, 1) // <<<--- Unresolved Method with allocated Arguments count (text file ref.txt)

iasl -fe /@full_path@/ref.txt -e /@full_path@/SSDT*.aml -d /@full_path@/DSDT.aml

iasl -fe /@full_path@/ref.txt -e /@full_path@/SSDT*.aml -dl /@full_path@/DSDT.aml

iasl -fe /@full_path@/ref.txt -da -dl /@full_path@/SSDT*.aml /@full_path@/DSDT.aml

===============================

 

The command in the Terminal should be like this (with full paths of the files):

Команда в Терминале будет выглядеть так (с полными путями к файлам):

0:~ steve$ /Volumes/2\ UNIT\ 2T/MAC\ OS\ X\ \&\ HACK/ACPI/iASL_MAC/acpica-unix-20150619/iasl_20150619_64/iasl -fe /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/ref.txt -e /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT*.aml -dl /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/DSDT.aml

After pressing the Return key you should see something like this. It means that all of SSDTs were attached correctly to parsing (but in this example there were not all Externals resolved).

После нажатия клавиши Return вы увидите что-то наподобие этого. Это означает, что все ССДТ таблицы были прикреплены к парсингу (но в этом примере не были распознаны все External методы).

 

Intel ACPI Component ArchitectureASL+ Optimizing Compiler version 20150619-64Copyright (c) 2000 - 2015 Intel CorporationReading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/DSDT.aml - Length 00081138 (0x013CF2)ACPI: DSDT 0x0000000000000000 013CF2 (v02 _ASUS_ Notebook 00000012 INTL 20120711)Acpi table [DSDT] successfully installed and loadedReading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-9.aml - Length 00006602 (0x0019CA)ACPI: SSDT 0x0000000000000000 0019CA (v01 OptRef OptTabl  00001000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-8.aml - Length 00006531 (0x001983)ACPI: SSDT 0x0000000000000000 001983 (v01 SgRef  SgPeg    00001000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-7.aml - Length 00017729 (0x004541)ACPI: SSDT 0x0000000000000000 004541 (v01 SaSsdt SaSsdt   00003000 INTL 20091112)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-6.aml - Length 00000664 (0x000298)ACPI: SSDT 0x0000000000000000 000298 (v01 SataRe SataTabl 00001000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-5x.aml - Length 00000281 (0x000119)ACPI: SSDT 0x0000000000000000 000119 (v01 PmRef  ApCst    00003000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-4x.aml - Length 00000979 (0x0003D3)ACPI: SSDT 0x0000000000000000 0003D3 (v01 PmRef  Cpu0Cst  00003001 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-3x.aml - Length 00001450 (0x0005AA)ACPI: SSDT 0x0000000000000000 0005AA (v01 PmRef  ApIst    00003000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-2.aml - Length 00002776 (0x000AD8)ACPI: SSDT 0x0000000000000000 000AD8 (v01 PmRef  CpuPm    00003000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-1.aml - Length 00001337 (0x000539)ACPI: SSDT 0x0000000000000000 000539 (v01 PmRef  Cpu0Ist  00003000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]Reading ACPI table from file /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/SSDT-0.aml - Length 00000413 (0x00019D)ACPI: SSDT 0x0000000000000000 00019D (v01 Intel  zpodd    00001000 INTL 20120711)Acpi table [SSDT] successfully installed and loadedPass 1 parse of [SSDT]Pass 2 parse of [SSDT]/Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/ref.txt: Importing method external (1 arguments) MDBG/Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/ref.txt: Importing method external (4 arguments) _SB_.PCI0.GFX0._DSM/Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/ref.txt: Imported 2 external method definitionsPass 1 parse of [DSDT]Pass 2 parse of [DSDT]Parsing Deferred Opcodes (Methods/Buffers/Packages/Regions)Parsing completedFound 31 external control methods, reparsing with new informationPass 1 parse of [DSDT]Pass 2 parse of [DSDT]Parsing Deferred Opcodes (Methods/Buffers/Packages/Regions)Parsing completedDisassembly completedASL Output:    /Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/DSDT.dsl - 748426 bytesiASL Warning: There were 31 external control methods found duringdisassembly, but only 25 were resolved (6 unresolved). AdditionalACPI tables may be required to properly disassemble the code. Theresulting disassembler output file may not compile because thedisassembler did not know how many arguments to assign to theunresolved methods. Note: SSDTs can be dynamically loaded atruntime and may or may not be available via the host OS.If necessary, the -fe option can be used to specify a file containingcontrol method external declarations with the associated methodargument counts. Each line of the file must be of the form:    External (<method pathname>, MethodObj, <argument count>)Invocation:    iasl -fe refs.txt -d dsdt.aml

 

 

Here is an example how disassembler parses the Externals. / Вот пример, как дизассемблер парсит External методы.

 

    External (_SB_.PCI0.PAUD.PUAM, MethodObj)    // Warning: Unresolved method, guessing 0 arguments    External (_SB_.PCI0.RP05.PEGP.EPON, MethodObj)    // Warning: Unresolved method, guessing 0 arguments    External (_SB_.PCI0.XHC_.DUAM, MethodObj)    // Warning: Unresolved method, guessing 0 arguments    External (_SB_.TPM_.PTS_, MethodObj)    // Warning: Unresolved method, guessing 1 arguments    External (PS0X, MethodObj)    // Warning: Unresolved method, guessing 0 arguments    External (PS3X, MethodObj)    // Warning: Unresolved method, guessing 0 arguments    /*     * External declarations that were imported from     * the reference file [/Volumes/Y/Users/stevebondaryan/Desktop/N551JM/origin/ref.txt]     */    External (_SB_.PCI0.GFX0._DSM, MethodObj)    // 4 Arguments    External (MDBG, MethodObj)    // 1 Arguments    External (_PR_.CPU0._PPC, IntObj)    External (_PR_.CPU0._PSS, PkgObj)    External (_SB_.IAOE.ECTM, UnknownObj)    External (_SB_.IAOE.FFSE, UnknownObj)    External (_SB_.IAOE.IBT1, UnknownObj)    External (_SB_.IAOE.ITMR, UnknownObj)    External (_SB_.IAOE.PTSL, UnknownObj)    External (_SB_.IAOE.RCTM, UnknownObj)    External (_SB_.IAOE.WKRS, UnknownObj)    External (_SB_.IFFS.FFSS, UnknownObj)    External (_SB_.PCCD, UnknownObj)    External (_SB_.PCCD.PENB, UnknownObj)    External (_SB_.PCI0.B0D3.ABAR, FieldUnitObj)    External (_SB_.PCI0.B0D3.BARA, IntObj)    External (_SB_.PCI0.GFX0.ADVD, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.AINT, MethodObj)    // 2 Arguments    External (_SB_.PCI0.GFX0.CBLV, FieldUnitObj)    External (_SB_.PCI0.GFX0.CLID, FieldUnitObj)    External (_SB_.PCI0.GFX0.DWBL, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.GCBL, MethodObj)    // 1 Arguments    External (_SB_.PCI0.GFX0.GCDS, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.GLID, MethodObj)    // 1 Arguments    External (_SB_.PCI0.GFX0.GSCI, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.GSSE, FieldUnitObj)    External (_SB_.PCI0.GFX0.LCDD._DCS, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.NATK, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.OPTS, MethodObj)    // 1 Arguments    External (_SB_.PCI0.GFX0.OWAK, MethodObj)    // 1 Arguments    External (_SB_.PCI0.GFX0.PRST, MethodObj)    // 0 Arguments    External (_SB_.PCI0.GFX0.STAT, FieldUnitObj)    External (_SB_.PCI0.GFX0.SWHD, MethodObj)    // 1 Arguments    External (_SB_.PCI0.GFX0.TCHE, FieldUnitObj)    External (_SB_.PCI0.GFX0.UPBL, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0, UnknownObj)    External (_SB_.PCI0.PEG0.HPME, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0.PEGP, UnknownObj)    External (_SB_.PCI0.PEG0.PEGP.DWBL, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0.PEGP.EPON, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0.PEGP.LCDD._DCS, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0.PEGP.NATK, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0.PEGP.PRST, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG0.PEGP.UPBL, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG1, UnknownObj)    External (_SB_.PCI0.PEG1.HPME, MethodObj)    // 0 Arguments    External (_SB_.PCI0.PEG2, UnknownObj)    External (_SB_.PCI0.PEG2.HPME, MethodObj)    // 0 Arguments    External (GSMI, FieldUnitObj)    External (LIDS, FieldUnitObj)    External (PCCD, UnknownObj)    External (PDC0, IntObj)    External (PDC1, IntObj)    External (PDC2, IntObj)    External (PDC3, IntObj)    External (PDC4, IntObj)    External (PDC5, IntObj)    External (PDC6, IntObj)    External (PDC7, IntObj)    External (SGMD, FieldUnitObj)

 

 

And here you are a correctly disassembled Method ADBG, which refering to External Method MDBG with 1 Arg count

Вот пример корректно дизассемблированного метода ADBG, который ссылается на External метод MDBG c 1 Аргументом.

 

    Method (ADBG, 1, Serialized)    {        If (CondRefOf (MDBG))        {            MNIO (Arg0)            MNIO ("\n")            Return (MDBG (Arg0))  // MDBG is and External reference Method, but there is no such method in ACPI tables.        }        Return (Zero)    }

 

 

But without ref.txt parsing will be incorrect and compiler will return an error, like this:

Но без подключенного ref.txt файла парсинг кода пройдет неправильно и компилятор вернет ошибку компиляции:

 

    External (MDBG, IntObj) // Here is an ERROR// ...    Method (ADBG, 1, Serialized)    {        If (CondRefOf (MDBG))        {            MNIO (Arg0)            MNIO ("\n")            Return (MDBG) // Here is an ERROR            Arg0          // Here is an ERROR        }        Return (Zero)    }

 

 

Here is an original SSDT with MDBG method, which was lost. / Вот SSDT таблица с методом MDBG, которая была утеряна:

 

DefinitionBlock ("MDBG.aml", "SSDT", 1, "Intel_", "ADebTabl", 0x00001000){    Scope (\)    {        Name (DPTR, 0x80000000)        Name (EPTR, 0x80000000)        Name (CPTR, 0x80000000)        Mutex (MMUT, 0x00)        Method (MDBG, 1, Serialized)        {            Store (Acquire (MMUT, 0x03E8), Local0)            If (LEqual (Local0, Zero))            {                OperationRegion (ABLK, SystemMemory, CPTR, 0x10)                Field (ABLK, ByteAcc, NoLock, Preserve)                {                    AAAA,   128                }                Store (Arg0, AAAA) /* \MDBG.AAAA */                Add (CPTR, 0x10, CPTR) /* \CPTR */                If (LGreaterEqual (CPTR, EPTR))                {                    Add (DPTR, 0x10, CPTR) /* \CPTR */                }                Release (MMUT)            }            Return (Local0)        }    }}

 

 

===================

And more: if you need to decompile your custom DSDT with your patches and if it still has many External Methods, you need to use all of the SSDTs this time too. If you deleted all of the Externals and those dependencies in the code, then no need to decompile with SSDTs and refs.

 

В дополнение: если вы решили декомпилировать свою кастомную DSDT с примененными патчами и в таблице все еще имеются в большом количестве External методы, в этом случае также требуется использовать терминал и включить в декомпиляцию все SSDT таблицы. Если вы удалили все External методы со всеми зависимостями в коде, тогда не требуется использовать при декомпиляции SSDT таблицы и реф.файлы.

===================

 

Changelog 20150930:

 

 

30 September 2015. Summary of changes for version 20150930:

 

1) ACPICA kernel-resident subsystem:

  • Debugger: Implemented several changes and bug fixes to assist support for the in-kernel version of the AML debugger. Lv Zheng.
  • - Fix the "predefined" command for in-kernel debugger.
  • - Do not enter debug command loop for the help and version commands.
  • - Disallow "execute" command during execution/single-step of a method.

  • Interpreter: Updated runtime typechecking for all operators that have target operands. The operand is resolved and validated that it is legal. For example, the target cannot be a non-data object such as a Device, Mutex, ThermalZone, etc., as per the ACPI specification.
  • Debugger: Fixed the double-mutex user I/O handshake to work when local deadlock detection is enabled.
  • Debugger: limited display of method locals and arguments (LocalX and ArgX) to only those that have actually been initialized. This prevents lines of extraneous output.
  • Updated the definition of the NFIT table to correct the bit polarity of one flag: ACPI_NFIT_MEM_ARMED --> ACPI_NFIT_MEM_NOT_ARMED
  • Example Code and Data Size: These are the sizes for the OS-independent acpica.lib produced by the Microsoft Visual C++ 9.0 32-bit compiler. The debug version of the code includes the debug output trace mechanism and has a much larger code and data size.

Current Release:

  • Non-Debug Version: 101.7K Code, 27.9K Data, 129.6K Total
  • Debug Version: 199.3K Code, 81.4K Data, 280.7K Total

Previous Release:

  • Non-Debug Version: 101.3K Code, 27.7K Data, 129.0K Total
  • Debug Version: 198.6K Code, 80.9K Data, 279.5K Total

2) iASL Compiler/Disassembler and Tools:

  • iASL: Improved the compile-time typechecking for operands of many of the ASL operators:

  • -- Added an option to disable compiler operand/operator typechecking (-ot).
  • -- For the following operators, the TermArg operands are now validated when possible to be Integer data objects: BankField, OperationRegion, DataTableRegion, Buffer, and Package.
  • -- Store (Source, Target): Both the source and target operands are resolved and checked that the operands are both legal. For example, neither operand can be a non-data object such as a Device, Mutex, ThermalZone, etc. Note, as per the ACPI specification, the CopyObject operator can be used to store an object to any type of target object.
  • -- Store (Source, Target): If the source is a Package object, the target must be a Package object, LocalX, ArgX, or Debug. Likewise, if the target is a Package, the source must also be a Package.
  • -- Store (Source, Target): A warning is issued if the source and target resolve to the identical named object.
  • -- Store (Source, <method invocation>): An error is generated for the target method invocation, as this construct is not supported by the AML interpreter.
  • -- For all ASL math and logic operators, the target operand must be a data object (Integer, String, Buffer, LocalX, ArgX, or Debug). This includes the function return value also.
  • -- External declarations are also included in the typechecking where possible. External objects defined using the UnknownObj keyword cannot be typechecked, however.

  • iASL and Disassembler: Added symbolic (ASL+) support for the ASL Index operator:
  • - Legacy code: Index (PKG1, 3)
  • - New ASL+ code: PKG1 [3]
  • This completes the ACPI 6.0 ASL+ support as it was the only operator not supported.

  • iASL: Fixed the file suffix for the preprocessor output file (.i). Two spaces were inadvertently appended to the filename, causing file access and deletion problems on some systems.
  • ASL Test Suite (ASLTS): Updated the master makefile to generate all possible compiler output files when building the test suite -- thus exercising these features of the compiler. These files are automatically deleted when the test suite exits.

----------------------------------------

18 August 2015. Summary of changes for version 20150818:

 

1) ACPICA kernel-resident subsystem:

  • Fix a regression for AcpiGetTableByIndex interface causing it to fail. Lv Zheng. ACPICA BZ 1186.
  • Completed development to ensure that the ACPICA Disassembler and Debugger are fully standalone components of ACPICA. Removed cross-component dependences. Lv Zheng.
  • The max-number-of-AML-loops is now runtime configurable (previously was compile-time only). This is essentially a loop timeout to force-abort infinite AML loops. ACPCIA BZ 1192.
  • Debugger: Cleanup output to dump ACPI names and namepaths without any trailing underscores. Lv Zheng. ACPICA BZ 1135.
  • Removed unnecessary conditional compilations across the Debugger and Disassembler components where entire modules could be left uncompiled.
  • The aapits test is deprecated and has been removed from the ACPICA git tree. The test has never been completed and has not been maintained, thus becoming rather useless. ACPICA BZ 1015, 794.

  • A batch of small changes to close bugzilla and other reports:
  • - Remove duplicate code for _PLD processing. ACPICA BZ 1176.
  • - Correctly cleanup after a ACPI table load failure. ACPICA BZ 1185.
  • - iASL: Support POSIX yacc again in makefile. Jung-uk Kim.
  • - ACPI table support: general cleanup and simplification. Lv Zheng, Bob Moore.
  • - ACPI table support: fix for a buffer read overrun in AcpiTbFindTable. ACPICA BZ 1184.
  • - Enhance parameter validation for DataTableRegion and LoadTable ASL/AML operators.
  • - Debugger: Split debugger initialization/termination interfaces. Lv Zheng.
  • - AcpiExec: Emit OemTableId for SSDTs during the load phase for table identification.
  • - AcpiExec: Add debug message during _REG method phase during table load/init.
  • - AcpiNames: Fix a regression where some output was missing and no longer emitted.
  • - Debugger: General cleanup and simplification. Lv Zheng.
  • - Disassembler: Cleanup use of several global option variables. Lv Zheng.

  • Example Code and Data Size: These are the sizes for the OS-independent acpica.lib produced by the Microsoft Visual C++ 9.0 32-bit compiler. The debug version of the code includes the debug output trace mechanism and has a much larger code and data size.

Current Release:

  • Non-Debug Version: 101.3K Code, 27.7K Data, 129.0K Total
  • Debug Version: 198.6K Code, 80.9K Data, 279.5K Total

Previous Release:

  • Non-Debug Version: 100.9K Code, 24.5K Data, 125.4K Total
  • Debug Version: 197.8K Code, 81.5K Data, 279.3K Total

2) iASL Compiler/Disassembler and Tools:

  • AcpiExec: Fixed a problem where any more than 32 ACPI tables in the XSDT were not handled properly and caused load errors. Now, properly invoke and use the ACPICA auto-reallocate mechanism for ACPI table data structures. ACPICA BZ 1188
  • AcpiNames: Add command-line wildcard support for ACPI table files. ACPICA BZ 1190.
  • AcpiExec and AcpiNames: Add -l option to load ACPI tables only. For AcpiExec, this means that no control methods (like _REG/_INI/_STA) are executed during initialization. ACPICA BZ 1187, 1189.
  • iASL/Disassembler: Implemented a prototype "listing" mode that emits AML that corresponds to each disassembled ASL statement, to simplify debugging. ACPICA BZ 1191.
  • Debugger: Add option to the "objects" command to display a summary of the current namespace objects (Object type and count). This is displayed if the command is entered with no arguments.
  • AcpiNames: Add -x option to specify debug level, similar to AcpiExec.

----------------------------------------

17 July 2015. Summary of changes for version 20150717:

 

1) ACPICA kernel-resident subsystem:

  • Improved the partitioning between the Debugger and Disassembler components. This allows the Debugger to be used standalone within kernel code without the Disassembler (which is used for single stepping also). This renames and moves one file, dmobject.c to dbobject.c. Lv Zheng.
  • Debugger: Implemented a new command to trace the execution of control methods (Trace). This is especially useful for the in-kernel version of the debugger when file I/O may not be available for method trace output. See the ACPICA reference for more information. Lv Zheng.
  • Moved all C library prototypes (used for the local versions of these functions when requested) to a new header, acclib.hCleaned up the use of non-ANSI C library functions. These functions are implemented locally in ACPICA. Moved all such functions to a common source file, utnonansi.c
  • Debugger: Fixed a problem with the "!!" command (get last command executed) where the debugger could enter an infinite loop and eventually crash.
  • Removed the use of local macros that were used for some of the standard C library functions to automatically cast input parameters. This mostly affected the is* functions where the input parameter is defined to be an int. This required a few modifications to the main ACPICA source code to provide casting for these functions and eliminate possible compiler warnings for these parameters.
  • Across the source code, added additional status/error checking to resolve issues discovered by static source code analysis tools such as Coverity.
  • Example Code and Data Size: These are the sizes for the OS-independent acpica.lib produced by the Microsoft Visual C++ 9.0 32-bit compiler. The debug version of the code includes the debug output trace mechanism and has a much larger code and data size.

Current Release:

  • Non-Debug Version: 100.9K Code, 24.5K Data, 125.4K Total
  • Debug Version: 197.8K Code, 81.5K Data, 279.3K Total

Previous Release:

  • Non-Debug Version: 100.6K Code, 27.6K Data, 128.2K Total
  • Debug Version: 196.2K Code, 81.0K Data, 277.2K Total

2) iASL Compiler/Disassembler and Tools:

  • iASL: Fixed a regression where the device map file feature no longer worked properly when used in conjunction with the disassembler. It only worked properly with the compiler itself.
  • iASL: Implemented a new warning for method LocalX variables that are set but never used (similar to a C compiler such as gcc). This also applies to ArgX variables that are not defined by the parent method, and are instead (legally) used as local variables.
  • iASL/Preprocessor: Finished the pass-through of line numbers from the preprocessor to the compiler. This ensures that compiler errors/warnings have the correct original line numbers and filenames, regardless of any #include files.
  • iASL/Preprocessor: Fixed a couple of issues with comment handling and the pass-through of comments to the preprocessor output file (which becomes the compiler input file). Also fixed a problem with // comments that appear after a math expression.
  • iASL: Added support for the TCPA server table to the table compiler and template generator. (The client table was already previously supported)

  • iASL/Preprocessor: Added a permanent #define of the symbol "__IASL__" to identify the iASL compiler.

  • Cleaned up the use of the macros NEGATIVE and POSITIVE which were defined multiple times. The new names are ACPI_SIGN_NEGATIVE and ACPI_SIGN_POSITIVE.
  • AcpiHelp: Update to expand help messages for the iASL preprocessor directives.

----------------------------------------

 

19 June 2015. Summary of changes for version 20150619:

 

Two regressions in version 20150616 have been addressed:

  • Fixes some problems/issues with the C library macro removal (ACPI_STRLEN, etc.) This update changes ACPICA to only use the standard headers for functions, or the prototypes for the local versions of the C library functions. Across the source code, this required some additional casts for some Clib invocations for portability. Moved all local prototypes to a new file, acclib.h
  • Fixes several problems with recent changes to the handling of the FACS table that could cause some systems not to boot.

----------------------------------------

16 June 2015. Summary of changes for version 20150616:

 

 

1) ACPICA kernel-resident subsystem:

  • Across the entire ACPICA source code base, the various macros for the C library functions (such as ACPI_STRLEN, etc.) have been removed and replaced by the standard C library names (strlen, etc.) The original purpose for these macros is no longer applicable. This simplification reduces the number of macros used in the ACPICA source code significantly, improving readability and maintainability.
  • Implemented support for a new ACPI table, the OSDT. This table, the "override" SDT, can be loaded directly by the host OS at boot time. It enables the replacement of existing namespace objects that were installed via the DSDT and/or SSDTs. The primary purpose for this is to replace buggy or incorrect ASL/AML code obtained via the BIOS. The OSDT is slated for inclusion in a future version of the ACPI Specification. Lv Zheng/Bob Moore.
  • Added support for systems with (improperly) two FACS tables -- a "32-bit" table (via FADT 32-bit legacy field) and a "64-bit" table (via the 64-bit X field). This change will support both automatically. There continues to be systems found with this issue. This support requires a change to the AcpiSetFirmwareWakingVector interface. Also, a public global variable has been added to allow the host to select which FACS is desired (AcpiGbl_Use32BitFacsAddresses). See the ACPICA reference for more details Lv Zheng.
  • Added a new feature to allow for systems that do not contain an FACS. Although this is already supported on hardware-reduced platforms, the feature has been extended for all platforms. The reasoning is that we do not want to abort the entire ACPICA initialization just because the system is seriously buggy and has no FACS.
  • Fixed a problem where the GUID strings for NFIT tables (in acuuid.h) were not correctly transcribed from the ACPI specification in ACPICA version 20150515.
  • Implemented support for the _CLS object in the AcpiGetObjectInfo external interface.
  • Updated the definitions of the TCPA and TPM2 ACPI tables to the more recent TCG ACPI Specification, December 14, 2014. Table disassembler and compiler also updated. Note: The TCPA "server" table is not supported by the disassembler/table-compiler at this time.
  • ACPI 6.0: Added definitions for the new GIC version field in the MADT.
  • Example Code and Data Size: These are the sizes for the OS-independent acpica.lib produced by the Microsoft Visual C++ 9.0 32-bit compiler. The debug version of the code includes the debug output trace mechanism and has a much larger code and data size.

Current Release:

  • Non-Debug Version: 100.6K Code, 27.6K Data, 128.2K Total
  • Debug Version: 196.2K Code, 81.0K Data, 277.2K Total

Previous Release:

  • Non-Debug Version: 99.9K Code, 27.5K Data, 127.4K Total
  • Debug Version: 195.2K Code, 80.8K Data, 276.0K Total

2) iASL Compiler/Disassembler and Tools:

  • Disassembler: Fixed a problem with the new symbolic operator disassembler where incorrect ASL code could be emitted in some cases for the "non-commutative" operators -- Subtract, Divide, Modulo, ShiftLeft, and ShiftRight. The actual problem cases seem to be rather unusual in common ASL code, however. David Box.
  • Modified the linux version of acpidump to obtain ACPI tables from not just /dev/mem (which may not exist) and /sys/firmware/acpi/tables. Lv Zheng.
  • iASL: Fixed a problem where the user preprocessor output file (.i) contained extra data that was not expected. The compiler was using this file as a temporary file and passed through #line directives in order to keep compiler error messages in sync with the input file and line number across multiple include files. The (.i) is no longer a temporary file as the compiler uses a new, different file for the original purpose.
  • iASL: Fixed a problem where comments within the original ASL source code file were not passed through to the preprocessor output file, nor any listing files.
  • iASL: Fixed some issues for the handling of the "#include" preprocessor directive and the similar (but not the same) "Include" ASL operator.
  • iASL: Add support for the new OSDT in both the disassembler and compiler.
  • iASL: Fixed a problem with the constant folding support where a Buffer object could be incorrectly generated (incorrectly formed) during a conversion to a Store() operator.
  • AcpiHelp: Updated for new NFIT GUIDs, "External" AML opcode, and new description text for the _REV predefined name. _REV now permanently returns 2, as per the ACPI 6.0 specification.
  • Debugger: Enhanced the output of the Debug ASL object for references produced by the Index operator. For Buffers and strings, only output the actual byte pointed to by the index. For packages, only print the single package element decoded by the index. Previously, the entire buffer/string/package was emitted.
  • iASL/Table-compiler: Fixed a regression where the "generic" data types were no longer recognized, causing errors.

---------------------------------------------

08 April 2015. Summary of changes for version 20150515:

 

This release implements most of ACPI 6.0 as described below.

 

1) ACPICA kernel-resident subsystem:

  • Implemented runtime argument checking and return value checking for all new ACPI 6.0 predefined names. This includes: _BTH, _CR3, _DSD, _LPI, _MTL, _PRR, _RDI, _RST, _TFP, _TSN.
  • Example Code and Data Size: These are the sizes for the OS-independent acpica.lib produced by the Microsoft Visual C++ 9.0 32-bit compiler. The debug version of the code includes the debug output trace mechanism and has a much larger code and data size.

Current Release:

  • Non-Debug Version: 99.9K Code, 27.5K Data, 127.4K Total
  • Debug Version: 195.2K Code, 80.8K Data, 276.0K Total

Previous Release:

  • Non-Debug Version: 99.1K Code, 27.3K Data, 126.4K Total
  • Debug Version: 192.8K Code, 79.9K Data, 272.7K Total

2) iASL Compiler/Disassembler and Tools:

  • iASL compiler: Added compile-time support for all new ACPI 6.0 predefined names (argument count validation and return value typechecking.)
  • iASL disassembler and table compiler: implemented support for all new ACPI 6.0 tables. This includes: DRTM, IORT, LPIT, NFIT, STAO, WPBT, XENV.
  • iASL disassembler and table compiler: Added ACPI 6.0 changes to existing tables: FADT, MADT.
  • iASL preprocessor: Added a new directive to enable inclusion of binary blobs into ASL code. The new directive is #includebinary. It takes a binary file as input and emits a named ascii buffer object into the ASL code.
  • AcpiHelp: Added support for all new ACPI 6.0 predefined names.
  • AcpiHelp: Added a new option, -d, to display all iASL preprocessor directives.
  • AcpiHelp: Added a new option, -t, to display all known/supported ACPI tables.

----------------------------------------

10 April 2015. Summary of changes for version 20150410:

  • Reverted a change introduced in version 20150408 that caused a regression in the disassembler where incorrect operator symbols could be emitted.

----------------------------------------

08 April 2015. Summary of changes for version 20150408:

 

 

1) ACPICA kernel-resident subsystem:

  • Permanently set the return value for the _REV predefined name. It now returns 2 (was 5). This matches other ACPI implementations. _REV will be deprecated in the future, and is now defined to be 1 for ACPI 1.0, and 2 for ACPI 2.0 and later. It should never be used to differentiate or identify operating systems.
  • Added the "Windows 2015" string to the _OSI support. ACPICA will now return TRUE to a query with this string.
  • Fixed several issues with the local version of the printf function.
  • Added the C99 compiler option (-std=c99) to the Unix makefiles.

Current Release:

  • Non-Debug Version: 99.9K Code, 27.4K Data, 127.3K Total
  • Debug Version: 195.2K Code, 80.7K Data, 275.9K Total

Previous Release:

  • Non-Debug Version: 98.8K Code, 27.3K Data, 126.1K Total
  • Debug Version: 192.1K Code, 79.8K Data, 271.9K Total

2) iASL Compiler/Disassembler and Tools:

  • iASL: Implemented an enhancement to the constant folding feature to transform the parse tree to a simple Store operation whenever possible:

Add (2, 3, X) ==> is converted to: Store (5, X)X = 2 + 3 ==> is converted to: Store (5, X)

  • Updated support for the SLIC table (Software Licensing Description Table) in both the Data Table compiler and the disassembler. The SLIC table support now conforms to "Microsoft Software Licensing Tables (SLIC and MSDM). November 29, 2011. Copyright 2011 Microsoft". Note: Any SLIC data following the ACPI header is now defined to be "Proprietary Data", and as such, can only be entered or displayed as a hex data block.
  • Implemented full support for the MSDM table as described in the document above. Note: The format of MSDM is similar to SLIC. Any MSDM data following the ACPI header is defined to be "Proprietary Data", and can only be entered or displayed as a hex data block.
  • Implemented the -Pn option for the iASL Table Compiler (was only implemented for the ASL compiler). This option disables the iASL preprocessor.
  • Disassembler: For disassembly of Data Tables, added a comment field around the Ascii equivalent data that is emitted as part of the "Raw Table Data" block. This prevents the iASL Preprocessor from possible confusion if/when the table is compiled.
  • Disassembler: Added an option (-df) to force the disassembler to assume that the table being disassembled contains valid AML. This feature is useful for disassembling AML files that contain ACPI signatures other than DSDT or SSDT (such as OEMx or other signatures).
  • Changes for the EFI version of the tools:

1) Fixed a build error/issue

2) Fixed a cast warning
  • iASL: Fixed a path issue with the __FILE__ operator by making the directory prefix optional within the internal SplitInputFilename function.
  • Debugger: Removed some unused global variables.
  • Tests: Updated the makefile for proper generation of the AAPITS suite.

----------------------------------------

04 February 2015. Summary of changes for version 20150204:

 

This release is available at https://acpica.org/downloads

 

ACPICA kernel-resident subsystem:

  • Updated all ACPICA copyrights and signons to 2014. Added the 2014 copyright to all module headers and signons, including the standard Linux header. This affects virtually every file in the ACPICA core subsystem, iASL compiler, all ACPICA utilities, and the test suites.
  • Events: Introduce ACPI_GPE_DISPATCH_RAW_HANDLER to fix GPE storm issues. A raw gpe handling mechanism was created to allow better handling of GPE storms that aren't easily managed by the normal handler. The raw handler allows disabling/renabling of the the GPE so that interrupt storms can be avoided in cases where events cannot be timely serviced. In this scenario, handlers should use the AcpiSetGpe() API to disable/enable the GPE. This APIwill leave the reference counts undisturbed, thereby preventing unintentionalclearing of the GPE when the intent in only to temporarily disable it. Rawhandlers allow enabling and disabling of a GPE by removing GPE registerlocking. As such, raw handlers much provide their own locks while using GPE API's to protect access to GPE data structures. Lv Zheng
  • Events: Always modify GPE registers under the GPE lock. Applies GPE lock around AcpiFinishGpe() to protect access to GPE register values. Reported as bug by joe.liu@apple.com.
  • Unix makefiles: Separate option to disable optimizations and _FORTIFY_SOURCE. This change removes the _FORTIFY_SOURCE flag from the NOOPT disable option and creates a separate flag (NOFORTIFY) for this purpose. Some toolchains may define _FORTIFY_SOURCE which leads redefined errors when building ACPICA. This allows disabling the option without also having to disable optimazations. David Box

Current Release:

  • Non-Debug Version: 101.7K Code, 27.9K Data, 129.6K Total
  • Debug Version: 199.2K Code, 82.4K Data, 281.6K Total

-------------------------------------------------------------

 

 

07 November 2014. Summary of changes for version 20141107:

 

This release is available at https://acpica.org/downloads

  • This release introduces and implements language extensions to ASL that provide support for symbolic ("C-style") operators and expressions. These language extensions are known collectively as ASL+.

1) iASL Compiler/Disassembler and Tools:

  • Disassembler: Fixed a problem with disassembly of the UartSerialBus macro. Changed "StopBitsNone" to the correct "StopBitsZero". David E. Box.
  • Disassembler: Fixed the Unicode macro support to add escape sequences. All non-printable ASCII values are emitted as escape sequences, as well as the standard escapes for quote and backslash. Ensures that the disassembled macro can be correctly recompiled.
  • iASL: Added Printf/Fprintf macros for formatted output. These macros are translated to existing AML Concatenate and Store operations. Printf writes to the ASL Debug object. Fprintf allows the specification of an ASL name as the target. Only a single format specifier is required, %o, since the AML interpreter dynamically converts objects to the required type. David E. Box.

(old) Store (Concatenate (Concatenate (Concatenate (Concatenate(Concatenate (Concatenate (Concatenate ("", Arg0),": Unexpected value for "), Arg1), ", "), Arg2)," at line "), Arg3), Debug)(new) Printf ("%o: Unexpected value for %o, %o at line %o",Arg0, Arg1, Arg2, Arg3)(old) Store (Concatenate (Concatenate (Concatenate (Concatenate("", Arg1), ": "), Arg0), " Successful"), STR1)(new) Fprintf (STR1, "%o: %o Successful", Arg1, Arg0)

  • iASL: Added debug options (-bp, -bt) to dynamically prune levels of the ASL parse tree before the AML code is generated. This allows blocks of ASL code to be removed in order to help locate and identify problem devices and/or code. David E. Box.
  • AcpiExec: Added support (-fi) for an optional namespace object initialization file. This file specifies initial values for namespace objects as necessary for debugging and testing different ASL code paths that may be taken as a result of BIOS options.

2) Overview of symbolic operator support for ASL (ASL+)

-------------------------------------------------------

  • As an extension to the ASL language, iASL implements support for symbolic (C-style) operators for math and logical expressions. This can greatly simplify ASL code as well as improve both readability and maintainability. These language extensions can exist concurrently with all legacy ASL code and expressions.
  • The symbolic extensions are 100% compatible with existing AML interpreters, since no new AML opcodes are created. To implement the extensions, the iASL compiler transforms the symbolic expressions into the legacy ASL/AML equivalents at compile time.
  • Full symbolic expressions are supported, along with the standard C precedence and associativity rules.
  • Full disassembler support for the symbolic expressions is provided, and creates an automatic migration path for existing ASL code to ASL+ code via the disassembly process. By default, the disassembler now emits ASL+ code with symbolic expressions. An option (-dl) is provided to force the disassembler to emit legacy ASL code if desired.

Below is the complete list of the currently supported symbolic operators with examples. See the iASL User Guide for additional information.

ASL+ Syntax Legacy ASL Equivalent// Math operatorsZ = X + Y Add (X, Y, Z)Z = X - Y Subtract (X, Y, Z)Z = X * Y Multiply (X, Y, Z)Z = X / Y Divide (X, Y, , Z)Z = X % Y Mod (X, Y, Z)Z = X << Y ShiftLeft (X, Y, Z)Z = X >> Y ShiftRight (X, Y, Z)Z = X & Y And (X, Y, Z)Z = X | Y Or (X, Y, Z)Z = X ^ Y Xor (X, Y, Z)Z = ~X Not (X, Z)X++ Increment (X)X-- Decrement (X)// Logical operators(X == Y) LEqual (X, Y)(X != Y) LNotEqual (X, Y)(X < Y) LLess (X, Y)(X > Y) LGreater (X, Y)(X <= Y) LLessEqual (X, Y)(X >= Y) LGreaterEqual (X, Y)(X && Y) LAnd (X, Y)(X || Y) LOr (X, Y)(!X) LNot (X)// Assignment and compound assignment operationsX = Y Store (Y, X)X += Y Add (X, Y, X)X -= Y Subtract (X, Y, X)X *= Y Multiply (X, Y, X)X /= Y Divide (X, Y, , X)X %= Y Mod (X, Y, X)X <<= Y ShiftLeft (X, Y, X)X >>= Y ShiftRight (X, Y, X)X &= Y And (X, Y, X)X |= Y Or (X, Y, X)X ^= Y Xor (X, Y, X)

3) ASL+ Examples:

Legacy ASL:If (LOr (LOr (LEqual (And (R510, 0x03FB), 0x02E0), LEqual (And (R520,

What's New in Version 20150930

Released

  • https://github.com/acpica/acpica/blob/master/documents/changes.txt
 Share


User Feedback

Recommended Comments

There are no comments to display.

×
×
  • Create New...