1 /******************************************************************************
3 * Module Name: oswintbl - Windows OSL for obtaining ACPI tables
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2016, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
50 #pragma warning(disable:4115) /* warning C4115: (caused by rpcasync.h) */
57 #define _COMPONENT ACPI_OS_SERVICES
58 ACPI_MODULE_NAME ("oswintbl")
60 /* Local prototypes */
63 WindowsFormatException (
68 #define LOCAL_BUFFER_SIZE 64
70 static char KeyBuffer[LOCAL_BUFFER_SIZE];
71 static char ErrorBuffer[LOCAL_BUFFER_SIZE];
74 * Tables supported in the Windows registry. Zero or more SSDTs are assumed to
75 * follow these tables.
77 static char *SupportedTables[] =
85 /* Number of table names for the table above. */
87 #define ACPI_OS_NUM_TABLE_ENTRIES 4
90 /******************************************************************************
92 * FUNCTION: WindowsFormatException
94 * PARAMETERS: WinStatus - Status from a Windows system call
96 * RETURN: Formatted (ascii) exception code. Front-end to Windows
97 * FormatMessage interface.
99 * DESCRIPTION: Decode a windows exception
101 *****************************************************************************/
104 WindowsFormatException (
109 FormatMessage (FORMAT_MESSAGE_FROM_SYSTEM, NULL, WinStatus, 0,
110 ErrorBuffer, LOCAL_BUFFER_SIZE, NULL);
112 return (ErrorBuffer);
116 /******************************************************************************
118 * FUNCTION: AcpiOsGetTableByAddress
120 * PARAMETERS: Address - Physical address of the ACPI table
121 * Table - Where a pointer to the table is returned
123 * RETURN: Status; Table buffer is returned if AE_OK.
124 * AE_NOT_FOUND: A valid table was not found at the address
126 * DESCRIPTION: Get an ACPI table via a physical memory address.
128 * NOTE: Cannot be implemented without a Windows device driver.
130 *****************************************************************************/
133 AcpiOsGetTableByAddress (
134 ACPI_PHYSICAL_ADDRESS Address,
135 ACPI_TABLE_HEADER **Table)
138 fprintf (stderr, "Get table by address is not supported on Windows\n");
143 /******************************************************************************
145 * FUNCTION: AcpiOsGetTableByIndex
147 * PARAMETERS: Index - Which table to get
148 * Table - Where a pointer to the table is returned
149 * Instance - Where a pointer to the table instance no. is
151 * Address - Where the table physical address is returned
153 * RETURN: Status; Table buffer and physical address returned if AE_OK.
154 * AE_LIMIT: Index is beyond valid limit
156 * DESCRIPTION: Get an ACPI table via an index value (0 through n). Returns
157 * AE_LIMIT when an invalid index is reached. Index is not
158 * necessarily an index into the RSDT/XSDT.
159 * Table is obtained from the Windows registry.
161 * NOTE: Cannot get the physical address from the windows registry;
162 * zero is returned instead.
164 *****************************************************************************/
167 AcpiOsGetTableByIndex (
169 ACPI_TABLE_HEADER **Table,
171 ACPI_PHYSICAL_ADDRESS *Address)
177 if (Index < ACPI_OS_NUM_TABLE_ENTRIES)
179 Signature = SupportedTables[Index];
184 Signature = ACPI_SIG_SSDT;
185 Index -= ACPI_OS_NUM_TABLE_ENTRIES;
188 Status = AcpiOsGetTableByName (Signature, Index, Table, Address);
190 if (ACPI_SUCCESS (Status))
194 else if (Status == AE_NOT_FOUND && ACPI_COMPARE_NAME (Signature, ACPI_SIG_SSDT))
196 /* Treat SSDTs that are not found as invalid index. */
204 /******************************************************************************
206 * FUNCTION: AcpiOsGetTableByName
208 * PARAMETERS: Signature - ACPI Signature for desired table. Must be
209 * a null terminated 4-character string.
210 * Instance - For SSDTs (0...n). Use 0 otherwise.
211 * Table - Where a pointer to the table is returned
212 * Address - Where the table physical address is returned
214 * RETURN: Status; Table buffer and physical address returned if AE_OK.
215 * AE_LIMIT: Instance is beyond valid limit
216 * AE_NOT_FOUND: A table with the signature was not found
218 * DESCRIPTION: Get an ACPI table via a table signature (4 ASCII characters).
219 * Returns AE_LIMIT when an invalid instance is reached.
220 * Table is obtained from the Windows registry.
222 * NOTE: Assumes the input signature is uppercase.
223 * Cannot get the physical address from the windows registry;
224 * zero is returned instead.
226 *****************************************************************************/
229 AcpiOsGetTableByName (
232 ACPI_TABLE_HEADER **Table,
233 ACPI_PHYSICAL_ADDRESS *Address)
242 ACPI_TABLE_HEADER *ReturnTable;
243 ACPI_STATUS Status = AE_OK;
246 /* Multiple instances are only supported for SSDT tables. */
248 if (Instance > 0 && !ACPI_COMPARE_NAME (Signature, ACPI_SIG_SSDT))
253 /* Get a handle to the table key */
257 strcpy (KeyBuffer, "HARDWARE\\ACPI\\");
258 if (AcpiUtSafeStrcat (KeyBuffer, sizeof (KeyBuffer), Signature))
260 return (AE_BUFFER_OVERFLOW);
264 * Windows stores SSDT at SSDT, SSD1, ..., SSD9, SSDA, ..., SSDS, SSDT,
265 * SSDU, ..., SSDY. If the first (0th) and the 29th tables have the same
266 * OEM ID, Table ID and Revision, then the 29th entry will overwrite the
267 * first entry... Let's hope that we do not have that many entries.
269 if (Instance > 0 && ACPI_COMPARE_NAME (Signature, ACPI_SIG_SSDT))
273 KeyBuffer[strlen (KeyBuffer) - 1] = '0' + (char) Instance;
275 else if (Instance < 29)
277 KeyBuffer[strlen (KeyBuffer) - 1] = 'A' + (char) (Instance - 10);
285 WinStatus = RegOpenKeyEx (HKEY_LOCAL_MACHINE, KeyBuffer,
286 0L, KEY_READ, &Handle);
288 if (WinStatus != ERROR_SUCCESS)
291 * Somewhere along the way, MS changed the registry entry for
293 * HARDWARE/ACPI/FACP to
294 * HARDWARE/ACPI/FADT.
296 * This code allows for both.
298 if (ACPI_COMPARE_NAME (Signature, "FACP"))
302 else if (ACPI_COMPARE_NAME (Signature, "XSDT"))
306 else if (ACPI_COMPARE_NAME (Signature, ACPI_SIG_SSDT))
308 /* SSDT may not be present on older Windows versions, but it is
309 * also possible that the index is not found. */
310 return (AE_NOT_FOUND);
315 "Could not find %s in registry at %s: %s (WinStatus=0x%X)\n",
316 Signature, KeyBuffer, WindowsFormatException (WinStatus), WinStatus);
317 return (AE_NOT_FOUND);
326 /* Actual data for the table is down a couple levels */
330 WinStatus = RegEnumKey (Handle, i, KeyBuffer, sizeof (KeyBuffer));
332 if (WinStatus == ERROR_NO_MORE_ITEMS)
337 WinStatus = RegOpenKey (Handle, KeyBuffer, &SubKey);
338 if (WinStatus != ERROR_SUCCESS)
340 fprintf (stderr, "Could not open %s entry: %s\n",
341 Signature, WindowsFormatException (WinStatus));
346 RegCloseKey (Handle);
351 /* Find the (binary) table entry */
355 NameSize = sizeof (KeyBuffer);
356 WinStatus = RegEnumValue (Handle, i, KeyBuffer, &NameSize, NULL,
358 if (WinStatus != ERROR_SUCCESS)
360 fprintf (stderr, "Could not get %s registry entry: %s\n",
361 Signature, WindowsFormatException (WinStatus));
366 if (Type == REG_BINARY)
372 /* Get the size of the table */
374 WinStatus = RegQueryValueEx (Handle, KeyBuffer, NULL, NULL,
376 if (WinStatus != ERROR_SUCCESS)
378 fprintf (stderr, "Could not read the %s table size: %s\n",
379 Signature, WindowsFormatException (WinStatus));
384 /* Allocate a new buffer for the table */
386 ReturnTable = malloc (DataSize);
389 Status = AE_NO_MEMORY;
393 /* Get the actual table from the registry */
395 WinStatus = RegQueryValueEx (Handle, KeyBuffer, NULL, NULL,
396 (UCHAR *) ReturnTable, &DataSize);
397 if (WinStatus != ERROR_SUCCESS)
399 fprintf (stderr, "Could not read %s data: %s\n",
400 Signature, WindowsFormatException (WinStatus));
406 *Table = ReturnTable;
410 RegCloseKey (Handle);
415 /* These are here for acpidump only, so we don't need to link oswinxf */
418 /******************************************************************************
420 * FUNCTION: AcpiOsMapMemory
422 * PARAMETERS: Where - Physical address of memory to be mapped
423 * Length - How much memory to map
425 * RETURN: Pointer to mapped memory. Null on error.
427 * DESCRIPTION: Map physical memory into caller's address space
429 *****************************************************************************/
433 ACPI_PHYSICAL_ADDRESS Where,
437 return (ACPI_TO_POINTER ((ACPI_SIZE) Where));
441 /******************************************************************************
443 * FUNCTION: AcpiOsUnmapMemory
445 * PARAMETERS: Where - Logical address of memory to be unmapped
446 * Length - How much memory to unmap
450 * DESCRIPTION: Delete a previously created mapping. Where and Length must
451 * correspond to a previous mapping exactly.
453 *****************************************************************************/