LibreOffice/5.2.3.3$Linux_X86_64 LibreOffice_project/20m0$Build-3 0 2342 17861 7788 true false view2 3041 3464 2342 0 20202 7786 1 1 false 228 false false true true true 0 true true false false true false true false true true true true true false true true false false true false true true false false false true false true true false true false false 803236 false false true false true true false false 0 false true high-resolution false false false false true true true false false false true false false false true true 720138 true 1 true false false 0 false false false ACPI Specification for Status Override Table Specification: LINARO-0002 Authors: Al Stone <al.stone@linaro.org>, Graeme Gregory <graeme.gregory@linaro.org>, Parth Dixit<parth.dixit@linaro.org> Revision History: Version Date Comments 0.1 28 March 2014 Initial draft. 0.2 4 December 2014 First revision 0.3 6 January 2015 Second revision Title: Define a list of ACPI namespace names that are to be ignored by the OSPM License: This work is licensed under the Creative Commons Attribution 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/ or send a letter to Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA. Problem Statement: Hypervisors control which devices are allocated to which virtual machines. If ACPI tables created by platform firmware are passed directly from a hypervisor to a new virtual machine, the virtual machine can see all of the devices available to the hypervisor. This would be an incorrect view for the new virtual machine. By the same token, embedding the ability to create ACPI tables on the fly within a hypervisor adds more complexity and increases the resources needed by the hypervisor to run. To be clear, this is not a problem for the straightforward tables – such as the FADT, MADT, SRAT, or others – but is a problem for the DSDT and SSDT that contain AML byte codes. Generating AML byte codes on the fly would require the use of an ASL compiler, the most complex part of the tools needed to create ACPI tables. Hence, what we would like to be able to do is modify the ACPI tables used by virtual machines without having to use an ASL compiler to do so. The Status Override Table: This specification lays out the structure and content of a new ACPI table – the Status Override Table (STAO). This table, while not currently part of the ACPI specification, may or may not become part of the specification at a later date. The purpose of the STAO is to list devices in the ACPI namespace that are to be ignored by the OSPM. For example, if the STAO contains the name “\_SB.BUS0.DEV3”, the OSPM must operate as if that device does not exist – searches for the name must fail, and any use of methods provided by that device must fail as if the device does not exist. The structure of the STAO is defined in Table 1. Table 1. Status Override Table Field Byte Length Byte Offset Description Signature 4 0 STAO’ to indicate that this is the Status Override Table. Length 4 4 Length in bytes of the entire STAO Revision 1 8 1 – current revision level of the STAO Checksum 1 9 Standard ACPI table checksum; i.e., the entire table must sum to zero OEMID 6 10 OEM ID OEM Table ID 8 16 OEM model ID OEM Revision 4 24 OEM Revision of the STAO for the OEM Table ID Creator ID 4 28 Vendor ID of the utility that created the table Creator Revision 4 32 Revision of the utility that created the table UART 1 36 Flag to indicate that OSPM should ignore UART defined in SPCR table. Name List [n] - 37 A list of ACPI strings, where each string is the full path name in the ACPI namespace of the device that the OSPM is to ignore. The STAO structure is very simple: a standard ACPI table header, followed by a list of ACPI namespace names. Example: Since the STAO is not a standardized ACPI table, creating one with the ACPICA tool iasl looks a little different than it would for other tables. Below, we define a simple table with a few names to be ignored by the OSPM: /* * Template for [STAO] ACPI Table * Format: [ByteLength] FieldName : HexFieldValue */ [0004] Signature : “STAO” // Status Override Table [0004] Table Length : 00000000 [0001] Revision : 01 [0001] Checksum : 00 [0006] Oem ID : "LINARO" [0008] Oem Table ID : "TEMPLATE" [0004] Oem Revision : 00000000 [0004] Asl Compiler ID : "INTL" [0004] Asl Compiler Revision : 20140214 [0001]UART :1 Label : BeginStao String : "\_SB0.BUS0.DEV1" String : "\_SB0.BUS0.DEV2 String : "\_SB0.BUS1.DEV1.DEV2" String : "\_SB0.BUS1.DEV2.DEV2"