[ACPICA]
[reactos.git] / reactos / drivers / bus / acpi / acpica / tables / tbxfload.c
1 /******************************************************************************
2 *
3 * Module Name: tbxfload - Table load/unload external interfaces
4 *
5 *****************************************************************************/
6
7 /*
8 * Copyright (C) 2000 - 2016, Intel Corp.
9 * All rights reserved.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
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.
25 *
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.
29 *
30 * NO WARRANTY
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.
42 */
43
44 #define EXPORT_ACPI_INTERFACES
45
46 #include "acpi.h"
47 #include "accommon.h"
48 #include "acnamesp.h"
49 #include "actables.h"
50 #include "acevents.h"
51
52 #define _COMPONENT ACPI_TABLES
53 ACPI_MODULE_NAME ("tbxfload")
54
55
56 /*******************************************************************************
57 *
58 * FUNCTION: AcpiLoadTables
59 *
60 * PARAMETERS: None
61 *
62 * RETURN: Status
63 *
64 * DESCRIPTION: Load the ACPI tables from the RSDT/XSDT
65 *
66 ******************************************************************************/
67
68 ACPI_STATUS ACPI_INIT_FUNCTION
69 AcpiLoadTables (
70 void)
71 {
72 ACPI_STATUS Status;
73
74
75 ACPI_FUNCTION_TRACE (AcpiLoadTables);
76
77
78 /*
79 * Install the default operation region handlers. These are the
80 * handlers that are defined by the ACPI specification to be
81 * "always accessible" -- namely, SystemMemory, SystemIO, and
82 * PCI_Config. This also means that no _REG methods need to be
83 * run for these address spaces. We need to have these handlers
84 * installed before any AML code can be executed, especially any
85 * module-level code (11/2015).
86 * Note that we allow OSPMs to install their own region handlers
87 * between AcpiInitializeSubsystem() and AcpiLoadTables() to use
88 * their customized default region handlers.
89 */
90 Status = AcpiEvInstallRegionHandlers ();
91 if (ACPI_FAILURE (Status))
92 {
93 ACPI_EXCEPTION ((AE_INFO, Status, "During Region initialization"));
94 return_ACPI_STATUS (Status);
95 }
96
97 /* Load the namespace from the tables */
98
99 Status = AcpiTbLoadNamespace ();
100
101 /* Don't let single failures abort the load */
102
103 if (Status == AE_CTRL_TERMINATE)
104 {
105 Status = AE_OK;
106 }
107
108 if (ACPI_FAILURE (Status))
109 {
110 ACPI_EXCEPTION ((AE_INFO, Status,
111 "While loading namespace from ACPI tables"));
112 }
113
114 if (AcpiGbl_ParseTableAsTermList || !AcpiGbl_GroupModuleLevelCode)
115 {
116 /*
117 * Initialize the objects that remain uninitialized. This
118 * runs the executable AML that may be part of the
119 * declaration of these objects:
120 * OperationRegions, BufferFields, Buffers, and Packages.
121 */
122 Status = AcpiNsInitializeObjects ();
123 if (ACPI_FAILURE (Status))
124 {
125 return_ACPI_STATUS (Status);
126 }
127 }
128
129 AcpiGbl_NamespaceInitialized = TRUE;
130 return_ACPI_STATUS (Status);
131 }
132
133 ACPI_EXPORT_SYMBOL_INIT (AcpiLoadTables)
134
135
136 /*******************************************************************************
137 *
138 * FUNCTION: AcpiTbLoadNamespace
139 *
140 * PARAMETERS: None
141 *
142 * RETURN: Status
143 *
144 * DESCRIPTION: Load the namespace from the DSDT and all SSDTs/PSDTs found in
145 * the RSDT/XSDT.
146 *
147 ******************************************************************************/
148
149 ACPI_STATUS
150 AcpiTbLoadNamespace (
151 void)
152 {
153 ACPI_STATUS Status;
154 UINT32 i;
155 ACPI_TABLE_HEADER *NewDsdt;
156 ACPI_TABLE_DESC *Table;
157 UINT32 TablesLoaded = 0;
158 UINT32 TablesFailed = 0;
159
160
161 ACPI_FUNCTION_TRACE (TbLoadNamespace);
162
163
164 (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
165
166 /*
167 * Load the namespace. The DSDT is required, but any SSDT and
168 * PSDT tables are optional. Verify the DSDT.
169 */
170 Table = &AcpiGbl_RootTableList.Tables[AcpiGbl_DsdtIndex];
171
172 if (!AcpiGbl_RootTableList.CurrentTableCount ||
173 !ACPI_COMPARE_NAME (Table->Signature.Ascii, ACPI_SIG_DSDT) ||
174 ACPI_FAILURE (AcpiTbValidateTable (Table)))
175 {
176 Status = AE_NO_ACPI_TABLES;
177 goto UnlockAndExit;
178 }
179
180 /*
181 * Save the DSDT pointer for simple access. This is the mapped memory
182 * address. We must take care here because the address of the .Tables
183 * array can change dynamically as tables are loaded at run-time. Note:
184 * .Pointer field is not validated until after call to AcpiTbValidateTable.
185 */
186 AcpiGbl_DSDT = Table->Pointer;
187
188 /*
189 * Optionally copy the entire DSDT to local memory (instead of simply
190 * mapping it.) There are some BIOSs that corrupt or replace the original
191 * DSDT, creating the need for this option. Default is FALSE, do not copy
192 * the DSDT.
193 */
194 if (AcpiGbl_CopyDsdtLocally)
195 {
196 NewDsdt = AcpiTbCopyDsdt (AcpiGbl_DsdtIndex);
197 if (NewDsdt)
198 {
199 AcpiGbl_DSDT = NewDsdt;
200 }
201 }
202
203 /*
204 * Save the original DSDT header for detection of table corruption
205 * and/or replacement of the DSDT from outside the OS.
206 */
207 memcpy (&AcpiGbl_OriginalDsdtHeader, AcpiGbl_DSDT,
208 sizeof (ACPI_TABLE_HEADER));
209
210 /* Load and parse tables */
211
212 (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
213 Status = AcpiNsLoadTable (AcpiGbl_DsdtIndex, AcpiGbl_RootNode);
214 (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
215 if (ACPI_FAILURE (Status))
216 {
217 ACPI_EXCEPTION ((AE_INFO, Status, "[DSDT] table load failed"));
218 TablesFailed++;
219 }
220 else
221 {
222 TablesLoaded++;
223 }
224
225 /* Load any SSDT or PSDT tables. Note: Loop leaves tables locked */
226
227 for (i = 0; i < AcpiGbl_RootTableList.CurrentTableCount; ++i)
228 {
229 Table = &AcpiGbl_RootTableList.Tables[i];
230
231 if (!AcpiGbl_RootTableList.Tables[i].Address ||
232 (!ACPI_COMPARE_NAME (Table->Signature.Ascii, ACPI_SIG_SSDT) &&
233 !ACPI_COMPARE_NAME (Table->Signature.Ascii, ACPI_SIG_PSDT) &&
234 !ACPI_COMPARE_NAME (Table->Signature.Ascii, ACPI_SIG_OSDT)) ||
235 ACPI_FAILURE (AcpiTbValidateTable (Table)))
236 {
237 continue;
238 }
239
240 /* Ignore errors while loading tables, get as many as possible */
241
242 (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
243 Status = AcpiNsLoadTable (i, AcpiGbl_RootNode);
244 (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
245 if (ACPI_FAILURE (Status))
246 {
247 ACPI_EXCEPTION ((AE_INFO, Status, "(%4.4s:%8.8s) while loading table",
248 Table->Signature.Ascii, Table->Pointer->OemTableId));
249
250 TablesFailed++;
251
252 ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT,
253 "Table [%4.4s:%8.8s] (id FF) - Table namespace load failed\n\n",
254 Table->Signature.Ascii, Table->Pointer->OemTableId));
255 }
256 else
257 {
258 TablesLoaded++;
259 }
260 }
261
262 if (!TablesFailed)
263 {
264 ACPI_INFO ((
265 "%u ACPI AML tables successfully acquired and loaded",
266 TablesLoaded));
267 }
268 else
269 {
270 ACPI_ERROR ((AE_INFO,
271 "%u table load failures, %u successful",
272 TablesFailed, TablesLoaded));
273
274 /* Indicate at least one failure */
275
276 Status = AE_CTRL_TERMINATE;
277 }
278
279 #ifdef ACPI_APPLICATION
280 ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INIT, "\n"));
281 #endif
282
283
284 UnlockAndExit:
285 (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
286 return_ACPI_STATUS (Status);
287 }
288
289
290 /*******************************************************************************
291 *
292 * FUNCTION: AcpiInstallTable
293 *
294 * PARAMETERS: Address - Address of the ACPI table to be installed.
295 * Physical - Whether the address is a physical table
296 * address or not
297 *
298 * RETURN: Status
299 *
300 * DESCRIPTION: Dynamically install an ACPI table.
301 * Note: This function should only be invoked after
302 * AcpiInitializeTables() and before AcpiLoadTables().
303 *
304 ******************************************************************************/
305
306 ACPI_STATUS ACPI_INIT_FUNCTION
307 AcpiInstallTable (
308 ACPI_PHYSICAL_ADDRESS Address,
309 BOOLEAN Physical)
310 {
311 ACPI_STATUS Status;
312 UINT8 Flags;
313 UINT32 TableIndex;
314
315
316 ACPI_FUNCTION_TRACE (AcpiInstallTable);
317
318
319 if (Physical)
320 {
321 Flags = ACPI_TABLE_ORIGIN_INTERNAL_PHYSICAL;
322 }
323 else
324 {
325 Flags = ACPI_TABLE_ORIGIN_EXTERNAL_VIRTUAL;
326 }
327
328 Status = AcpiTbInstallStandardTable (Address, Flags,
329 FALSE, FALSE, &TableIndex);
330
331 return_ACPI_STATUS (Status);
332 }
333
334 ACPI_EXPORT_SYMBOL_INIT (AcpiInstallTable)
335
336
337 /*******************************************************************************
338 *
339 * FUNCTION: AcpiLoadTable
340 *
341 * PARAMETERS: Table - Pointer to a buffer containing the ACPI
342 * table to be loaded.
343 *
344 * RETURN: Status
345 *
346 * DESCRIPTION: Dynamically load an ACPI table from the caller's buffer. Must
347 * be a valid ACPI table with a valid ACPI table header.
348 * Note1: Mainly intended to support hotplug addition of SSDTs.
349 * Note2: Does not copy the incoming table. User is responsible
350 * to ensure that the table is not deleted or unmapped.
351 *
352 ******************************************************************************/
353
354 ACPI_STATUS
355 AcpiLoadTable (
356 ACPI_TABLE_HEADER *Table)
357 {
358 ACPI_STATUS Status;
359 UINT32 TableIndex;
360
361
362 ACPI_FUNCTION_TRACE (AcpiLoadTable);
363
364
365 /* Parameter validation */
366
367 if (!Table)
368 {
369 return_ACPI_STATUS (AE_BAD_PARAMETER);
370 }
371
372 /* Install the table and load it into the namespace */
373
374 ACPI_INFO (("Host-directed Dynamic ACPI Table Load:"));
375 Status = AcpiTbInstallAndLoadTable (ACPI_PTR_TO_PHYSADDR (Table),
376 ACPI_TABLE_ORIGIN_EXTERNAL_VIRTUAL, FALSE, &TableIndex);
377 return_ACPI_STATUS (Status);
378 }
379
380 ACPI_EXPORT_SYMBOL (AcpiLoadTable)
381
382
383 /*******************************************************************************
384 *
385 * FUNCTION: AcpiUnloadParentTable
386 *
387 * PARAMETERS: Object - Handle to any namespace object owned by
388 * the table to be unloaded
389 *
390 * RETURN: Status
391 *
392 * DESCRIPTION: Via any namespace object within an SSDT or OEMx table, unloads
393 * the table and deletes all namespace objects associated with
394 * that table. Unloading of the DSDT is not allowed.
395 * Note: Mainly intended to support hotplug removal of SSDTs.
396 *
397 ******************************************************************************/
398
399 ACPI_STATUS
400 AcpiUnloadParentTable (
401 ACPI_HANDLE Object)
402 {
403 ACPI_NAMESPACE_NODE *Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Object);
404 ACPI_STATUS Status = AE_NOT_EXIST;
405 ACPI_OWNER_ID OwnerId;
406 UINT32 i;
407
408
409 ACPI_FUNCTION_TRACE (AcpiUnloadParentTable);
410
411
412 /* Parameter validation */
413
414 if (!Object)
415 {
416 return_ACPI_STATUS (AE_BAD_PARAMETER);
417 }
418
419 /*
420 * The node OwnerId is currently the same as the parent table ID.
421 * However, this could change in the future.
422 */
423 OwnerId = Node->OwnerId;
424 if (!OwnerId)
425 {
426 /* OwnerId==0 means DSDT is the owner. DSDT cannot be unloaded */
427
428 return_ACPI_STATUS (AE_TYPE);
429 }
430
431 /* Must acquire the table lock during this operation */
432
433 Status = AcpiUtAcquireMutex (ACPI_MTX_TABLES);
434 if (ACPI_FAILURE (Status))
435 {
436 return_ACPI_STATUS (Status);
437 }
438
439 /* Find the table in the global table list */
440
441 for (i = 0; i < AcpiGbl_RootTableList.CurrentTableCount; i++)
442 {
443 if (OwnerId != AcpiGbl_RootTableList.Tables[i].OwnerId)
444 {
445 continue;
446 }
447
448 /*
449 * Allow unload of SSDT and OEMx tables only. Do not allow unload
450 * of the DSDT. No other types of tables should get here, since
451 * only these types can contain AML and thus are the only types
452 * that can create namespace objects.
453 */
454 if (ACPI_COMPARE_NAME (
455 AcpiGbl_RootTableList.Tables[i].Signature.Ascii,
456 ACPI_SIG_DSDT))
457 {
458 Status = AE_TYPE;
459 break;
460 }
461
462 (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
463 Status = AcpiTbUnloadTable (i);
464 (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
465 break;
466 }
467
468 (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
469 return_ACPI_STATUS (Status);
470 }
471
472 ACPI_EXPORT_SYMBOL (AcpiUnloadParentTable)