ACPICA: Remove ACPI_GET_OBJECT_TYPE macro
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / acpi / acpica / utglobal.c
CommitLineData
1da177e4
LT
1/******************************************************************************
2 *
3 * Module Name: utglobal - Global variables for the ACPI subsystem
4 *
5 *****************************************************************************/
6
7/*
75a44ce0 8 * Copyright (C) 2000 - 2008, Intel Corp.
1da177e4
LT
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 DEFINE_ACPI_GLOBALS
45
1da177e4 46#include <acpi/acpi.h>
e2f7a777
LB
47#include "accommon.h"
48#include "acnamesp.h"
1da177e4
LT
49
50#define _COMPONENT ACPI_UTILITIES
e97d6bf1 51ACPI_MODULE_NAME("utglobal")
1da177e4 52
44f6c012 53/*******************************************************************************
1da177e4
LT
54 *
55 * Static global variable initialization.
56 *
57 ******************************************************************************/
1da177e4
LT
58/*
59 * We want the debug switches statically initialized so they
60 * are already set when the debugger is entered.
61 */
1da177e4 62/* Debug switch - level and trace mask */
4be44fcd 63u32 acpi_dbg_level = ACPI_DEBUG_DEFAULT;
1da177e4
LT
64
65/* Debug switch - layer (component) mask */
66
e76f4276 67u32 acpi_dbg_layer = 0;
4be44fcd 68u32 acpi_gbl_nesting_level = 0;
1da177e4
LT
69
70/* Debugger globals */
71
4be44fcd
LB
72u8 acpi_gbl_db_terminate_threads = FALSE;
73u8 acpi_gbl_abort_method = FALSE;
74u8 acpi_gbl_method_executing = FALSE;
1da177e4
LT
75
76/* System flags */
77
4be44fcd 78u32 acpi_gbl_startup_flags = 0;
1da177e4
LT
79
80/* System starts uninitialized */
81
4be44fcd 82u8 acpi_gbl_shutdown = TRUE;
1da177e4 83
4be44fcd 84const char *acpi_gbl_sleep_state_names[ACPI_S_STATE_COUNT] = {
1da177e4
LT
85 "\\_S0_",
86 "\\_S1_",
87 "\\_S2_",
88 "\\_S3_",
89 "\\_S4_",
90 "\\_S5_"
91};
92
4be44fcd 93const char *acpi_gbl_highest_dstate_names[4] = {
1da177e4
LT
94 "_S1D",
95 "_S2D",
96 "_S3D",
97 "_S4D"
98};
99
44f6c012 100/*******************************************************************************
1da177e4 101 *
84fb2c97
BM
102 * FUNCTION: acpi_format_exception
103 *
104 * PARAMETERS: Status - The acpi_status code to be formatted
105 *
106 * RETURN: A string containing the exception text. A valid pointer is
107 * always returned.
108 *
109 * DESCRIPTION: This function translates an ACPI exception into an ASCII string
110 * It is here instead of utxface.c so it is always present.
1da177e4
LT
111 *
112 ******************************************************************************/
113
84fb2c97
BM
114const char *acpi_format_exception(acpi_status status)
115{
116 const char *exception = NULL;
117
118 ACPI_FUNCTION_ENTRY();
119
120 exception = acpi_ut_validate_exception(status);
121 if (!exception) {
122
123 /* Exception code was not recognized */
124
125 ACPI_ERROR((AE_INFO,
126 "Unknown exception code: 0x%8.8X", status));
127
128 exception = "UNKNOWN_STATUS_CODE";
3e0d69ec 129 dump_stack();
84fb2c97
BM
130 }
131
132 return (ACPI_CAST_PTR(const char, exception));
133}
134
135ACPI_EXPORT_SYMBOL(acpi_format_exception)
136
137/*******************************************************************************
138 *
139 * Namespace globals
140 *
141 ******************************************************************************/
1da177e4
LT
142/*
143 * Predefined ACPI Names (Built-in to the Interpreter)
144 *
145 * NOTES:
146 * 1) _SB_ is defined to be a device to allow \_SB_._INI to be run
147 * during the initialization sequence.
148 * 2) _TZ_ is defined to be a thermal zone in order to allow ASL code to
149 * perform a Notify() operation on it.
150 */
0897831b
BM
151const struct acpi_predefined_names acpi_gbl_pre_defined_names[] = {
152 {"_GPE", ACPI_TYPE_LOCAL_SCOPE, NULL},
153 {"_PR_", ACPI_TYPE_LOCAL_SCOPE, NULL},
154 {"_SB_", ACPI_TYPE_DEVICE, NULL},
155 {"_SI_", ACPI_TYPE_LOCAL_SCOPE, NULL},
156 {"_TZ_", ACPI_TYPE_THERMAL, NULL},
157 {"_REV", ACPI_TYPE_INTEGER, (char *)ACPI_CA_SUPPORT_LEVEL},
158 {"_OS_", ACPI_TYPE_STRING, ACPI_OS_NAME},
159 {"_GL_", ACPI_TYPE_MUTEX, (char *)1},
1da177e4
LT
160
161#if !defined (ACPI_NO_METHOD_EXECUTION) || defined (ACPI_CONSTANT_EVAL_ONLY)
0897831b 162 {"_OSI", ACPI_TYPE_METHOD, (char *)1},
1da177e4 163#endif
1da177e4 164
44f6c012
RM
165 /* Table terminator */
166
0897831b 167 {NULL, ACPI_TYPE_ANY, NULL}
44f6c012 168};
1da177e4
LT
169
170/*
171 * Properties of the ACPI Object Types, both internal and external.
172 * The table is indexed by values of acpi_object_type
173 */
4be44fcd
LB
174const u8 acpi_gbl_ns_properties[] = {
175 ACPI_NS_NORMAL, /* 00 Any */
176 ACPI_NS_NORMAL, /* 01 Number */
177 ACPI_NS_NORMAL, /* 02 String */
178 ACPI_NS_NORMAL, /* 03 Buffer */
179 ACPI_NS_NORMAL, /* 04 Package */
180 ACPI_NS_NORMAL, /* 05 field_unit */
181 ACPI_NS_NEWSCOPE, /* 06 Device */
182 ACPI_NS_NORMAL, /* 07 Event */
183 ACPI_NS_NEWSCOPE, /* 08 Method */
184 ACPI_NS_NORMAL, /* 09 Mutex */
185 ACPI_NS_NORMAL, /* 10 Region */
186 ACPI_NS_NEWSCOPE, /* 11 Power */
187 ACPI_NS_NEWSCOPE, /* 12 Processor */
188 ACPI_NS_NEWSCOPE, /* 13 Thermal */
189 ACPI_NS_NORMAL, /* 14 buffer_field */
190 ACPI_NS_NORMAL, /* 15 ddb_handle */
191 ACPI_NS_NORMAL, /* 16 Debug Object */
192 ACPI_NS_NORMAL, /* 17 def_field */
193 ACPI_NS_NORMAL, /* 18 bank_field */
194 ACPI_NS_NORMAL, /* 19 index_field */
195 ACPI_NS_NORMAL, /* 20 Reference */
196 ACPI_NS_NORMAL, /* 21 Alias */
197 ACPI_NS_NORMAL, /* 22 method_alias */
198 ACPI_NS_NORMAL, /* 23 Notify */
199 ACPI_NS_NORMAL, /* 24 Address Handler */
200 ACPI_NS_NEWSCOPE | ACPI_NS_LOCAL, /* 25 Resource Desc */
201 ACPI_NS_NEWSCOPE | ACPI_NS_LOCAL, /* 26 Resource Field */
202 ACPI_NS_NEWSCOPE, /* 27 Scope */
203 ACPI_NS_NORMAL, /* 28 Extra */
204 ACPI_NS_NORMAL, /* 29 Data */
205 ACPI_NS_NORMAL /* 30 Invalid */
1da177e4
LT
206};
207
1da177e4
LT
208/* Hex to ASCII conversion table */
209
4be44fcd
LB
210static const char acpi_gbl_hex_to_ascii[] = {
211 '0', '1', '2', '3', '4', '5', '6', '7',
212 '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'
44f6c012
RM
213};
214
44f6c012 215/*******************************************************************************
1da177e4
LT
216 *
217 * FUNCTION: acpi_ut_hex_to_ascii_char
218 *
219 * PARAMETERS: Integer - Contains the hex digit
220 * Position - bit position of the digit within the
44f6c012 221 * integer (multiple of 4)
1da177e4 222 *
44f6c012 223 * RETURN: The converted Ascii character
1da177e4 224 *
44f6c012 225 * DESCRIPTION: Convert a hex digit to an Ascii character
1da177e4 226 *
44f6c012 227 ******************************************************************************/
1da177e4 228
4be44fcd 229char acpi_ut_hex_to_ascii_char(acpi_integer integer, u32 position)
1da177e4
LT
230{
231
232 return (acpi_gbl_hex_to_ascii[(integer >> position) & 0xF]);
233}
234
1da177e4
LT
235/******************************************************************************
236 *
237 * Event and Hardware globals
238 *
239 ******************************************************************************/
240
4be44fcd 241struct acpi_bit_register_info acpi_gbl_bit_register_info[ACPI_NUM_BITREG] = {
1da177e4
LT
242 /* Name Parent Register Register Bit Position Register Bit Mask */
243
4be44fcd
LB
244 /* ACPI_BITREG_TIMER_STATUS */ {ACPI_REGISTER_PM1_STATUS,
245 ACPI_BITPOSITION_TIMER_STATUS,
246 ACPI_BITMASK_TIMER_STATUS},
247 /* ACPI_BITREG_BUS_MASTER_STATUS */ {ACPI_REGISTER_PM1_STATUS,
248 ACPI_BITPOSITION_BUS_MASTER_STATUS,
249 ACPI_BITMASK_BUS_MASTER_STATUS},
250 /* ACPI_BITREG_GLOBAL_LOCK_STATUS */ {ACPI_REGISTER_PM1_STATUS,
251 ACPI_BITPOSITION_GLOBAL_LOCK_STATUS,
252 ACPI_BITMASK_GLOBAL_LOCK_STATUS},
253 /* ACPI_BITREG_POWER_BUTTON_STATUS */ {ACPI_REGISTER_PM1_STATUS,
254 ACPI_BITPOSITION_POWER_BUTTON_STATUS,
255 ACPI_BITMASK_POWER_BUTTON_STATUS},
256 /* ACPI_BITREG_SLEEP_BUTTON_STATUS */ {ACPI_REGISTER_PM1_STATUS,
257 ACPI_BITPOSITION_SLEEP_BUTTON_STATUS,
258 ACPI_BITMASK_SLEEP_BUTTON_STATUS},
259 /* ACPI_BITREG_RT_CLOCK_STATUS */ {ACPI_REGISTER_PM1_STATUS,
260 ACPI_BITPOSITION_RT_CLOCK_STATUS,
261 ACPI_BITMASK_RT_CLOCK_STATUS},
262 /* ACPI_BITREG_WAKE_STATUS */ {ACPI_REGISTER_PM1_STATUS,
263 ACPI_BITPOSITION_WAKE_STATUS,
264 ACPI_BITMASK_WAKE_STATUS},
265 /* ACPI_BITREG_PCIEXP_WAKE_STATUS */ {ACPI_REGISTER_PM1_STATUS,
266 ACPI_BITPOSITION_PCIEXP_WAKE_STATUS,
267 ACPI_BITMASK_PCIEXP_WAKE_STATUS},
268
269 /* ACPI_BITREG_TIMER_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
270 ACPI_BITPOSITION_TIMER_ENABLE,
271 ACPI_BITMASK_TIMER_ENABLE},
272 /* ACPI_BITREG_GLOBAL_LOCK_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
273 ACPI_BITPOSITION_GLOBAL_LOCK_ENABLE,
274 ACPI_BITMASK_GLOBAL_LOCK_ENABLE},
275 /* ACPI_BITREG_POWER_BUTTON_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
276 ACPI_BITPOSITION_POWER_BUTTON_ENABLE,
277 ACPI_BITMASK_POWER_BUTTON_ENABLE},
278 /* ACPI_BITREG_SLEEP_BUTTON_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
279 ACPI_BITPOSITION_SLEEP_BUTTON_ENABLE,
280 ACPI_BITMASK_SLEEP_BUTTON_ENABLE},
281 /* ACPI_BITREG_RT_CLOCK_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
282 ACPI_BITPOSITION_RT_CLOCK_ENABLE,
283 ACPI_BITMASK_RT_CLOCK_ENABLE},
4be44fcd
LB
284 /* ACPI_BITREG_PCIEXP_WAKE_DISABLE */ {ACPI_REGISTER_PM1_ENABLE,
285 ACPI_BITPOSITION_PCIEXP_WAKE_DISABLE,
286 ACPI_BITMASK_PCIEXP_WAKE_DISABLE},
287
288 /* ACPI_BITREG_SCI_ENABLE */ {ACPI_REGISTER_PM1_CONTROL,
289 ACPI_BITPOSITION_SCI_ENABLE,
290 ACPI_BITMASK_SCI_ENABLE},
291 /* ACPI_BITREG_BUS_MASTER_RLD */ {ACPI_REGISTER_PM1_CONTROL,
292 ACPI_BITPOSITION_BUS_MASTER_RLD,
293 ACPI_BITMASK_BUS_MASTER_RLD},
294 /* ACPI_BITREG_GLOBAL_LOCK_RELEASE */ {ACPI_REGISTER_PM1_CONTROL,
295 ACPI_BITPOSITION_GLOBAL_LOCK_RELEASE,
296 ACPI_BITMASK_GLOBAL_LOCK_RELEASE},
82d79b86
BM
297 /* ACPI_BITREG_SLEEP_TYPE */ {ACPI_REGISTER_PM1_CONTROL,
298 ACPI_BITPOSITION_SLEEP_TYPE,
299 ACPI_BITMASK_SLEEP_TYPE},
4be44fcd
LB
300 /* ACPI_BITREG_SLEEP_ENABLE */ {ACPI_REGISTER_PM1_CONTROL,
301 ACPI_BITPOSITION_SLEEP_ENABLE,
302 ACPI_BITMASK_SLEEP_ENABLE},
303
304 /* ACPI_BITREG_ARB_DIS */ {ACPI_REGISTER_PM2_CONTROL,
305 ACPI_BITPOSITION_ARB_DISABLE,
306 ACPI_BITMASK_ARB_DISABLE}
1da177e4
LT
307};
308
4be44fcd
LB
309struct acpi_fixed_event_info acpi_gbl_fixed_event_info[ACPI_NUM_FIXED_EVENTS] = {
310 /* ACPI_EVENT_PMTIMER */ {ACPI_BITREG_TIMER_STATUS,
311 ACPI_BITREG_TIMER_ENABLE,
312 ACPI_BITMASK_TIMER_STATUS,
313 ACPI_BITMASK_TIMER_ENABLE},
314 /* ACPI_EVENT_GLOBAL */ {ACPI_BITREG_GLOBAL_LOCK_STATUS,
315 ACPI_BITREG_GLOBAL_LOCK_ENABLE,
316 ACPI_BITMASK_GLOBAL_LOCK_STATUS,
317 ACPI_BITMASK_GLOBAL_LOCK_ENABLE},
318 /* ACPI_EVENT_POWER_BUTTON */ {ACPI_BITREG_POWER_BUTTON_STATUS,
319 ACPI_BITREG_POWER_BUTTON_ENABLE,
320 ACPI_BITMASK_POWER_BUTTON_STATUS,
321 ACPI_BITMASK_POWER_BUTTON_ENABLE},
322 /* ACPI_EVENT_SLEEP_BUTTON */ {ACPI_BITREG_SLEEP_BUTTON_STATUS,
323 ACPI_BITREG_SLEEP_BUTTON_ENABLE,
324 ACPI_BITMASK_SLEEP_BUTTON_STATUS,
325 ACPI_BITMASK_SLEEP_BUTTON_ENABLE},
326 /* ACPI_EVENT_RTC */ {ACPI_BITREG_RT_CLOCK_STATUS,
327 ACPI_BITREG_RT_CLOCK_ENABLE,
328 ACPI_BITMASK_RT_CLOCK_STATUS,
329 ACPI_BITMASK_RT_CLOCK_ENABLE},
1da177e4
LT
330};
331
44f6c012 332/*******************************************************************************
1da177e4
LT
333 *
334 * FUNCTION: acpi_ut_get_region_name
335 *
336 * PARAMETERS: None.
337 *
338 * RETURN: Status
339 *
340 * DESCRIPTION: Translate a Space ID into a name string (Debug only)
341 *
44f6c012 342 ******************************************************************************/
1da177e4
LT
343
344/* Region type decoding */
345
4be44fcd 346const char *acpi_gbl_region_types[ACPI_NUM_PREDEFINED_REGIONS] = {
1da177e4
LT
347 "SystemMemory",
348 "SystemIO",
349 "PCI_Config",
350 "EmbeddedControl",
351 "SMBus",
34830726 352 "SystemCMOS",
1da177e4
LT
353 "PCIBARTarget",
354 "DataTable"
1da177e4
LT
355};
356
4be44fcd 357char *acpi_ut_get_region_name(u8 space_id)
1da177e4
LT
358{
359
4be44fcd 360 if (space_id >= ACPI_USER_REGION_BEGIN) {
b229cf92 361 return ("UserDefinedRegion");
4be44fcd 362 } else if (space_id >= ACPI_NUM_PREDEFINED_REGIONS) {
b229cf92 363 return ("InvalidSpaceId");
1da177e4
LT
364 }
365
defba1d8 366 return (ACPI_CAST_PTR(char, acpi_gbl_region_types[space_id]));
1da177e4
LT
367}
368
44f6c012 369/*******************************************************************************
1da177e4
LT
370 *
371 * FUNCTION: acpi_ut_get_event_name
372 *
373 * PARAMETERS: None.
374 *
375 * RETURN: Status
376 *
377 * DESCRIPTION: Translate a Event ID into a name string (Debug only)
378 *
44f6c012 379 ******************************************************************************/
1da177e4
LT
380
381/* Event type decoding */
382
4be44fcd 383static const char *acpi_gbl_event_types[ACPI_NUM_FIXED_EVENTS] = {
1da177e4 384 "PM_Timer",
0897831b
BM
385 "GlobalLock",
386 "PowerButton",
387 "SleepButton",
388 "RealTimeClock",
1da177e4
LT
389};
390
4be44fcd 391char *acpi_ut_get_event_name(u32 event_id)
1da177e4
LT
392{
393
4be44fcd 394 if (event_id > ACPI_EVENT_MAX) {
b229cf92 395 return ("InvalidEventID");
1da177e4
LT
396 }
397
4a90c7e8 398 return (ACPI_CAST_PTR(char, acpi_gbl_event_types[event_id]));
1da177e4
LT
399}
400
44f6c012 401/*******************************************************************************
1da177e4
LT
402 *
403 * FUNCTION: acpi_ut_get_type_name
404 *
405 * PARAMETERS: None.
406 *
407 * RETURN: Status
408 *
409 * DESCRIPTION: Translate a Type ID into a name string (Debug only)
410 *
44f6c012 411 ******************************************************************************/
1da177e4
LT
412
413/*
414 * Elements of acpi_gbl_ns_type_names below must match
415 * one-to-one with values of acpi_object_type
416 *
44f6c012
RM
417 * The type ACPI_TYPE_ANY (Untyped) is used as a "don't care" when searching;
418 * when stored in a table it really means that we have thus far seen no
419 * evidence to indicate what type is actually going to be stored for this entry.
1da177e4 420 */
4be44fcd 421static const char acpi_gbl_bad_type[] = "UNDEFINED";
1da177e4 422
44f6c012
RM
423/* Printable names of the ACPI object types */
424
4be44fcd 425static const char *acpi_gbl_ns_type_names[] = {
1da177e4
LT
426 /* 00 */ "Untyped",
427 /* 01 */ "Integer",
428 /* 02 */ "String",
429 /* 03 */ "Buffer",
430 /* 04 */ "Package",
0897831b 431 /* 05 */ "FieldUnit",
1da177e4
LT
432 /* 06 */ "Device",
433 /* 07 */ "Event",
434 /* 08 */ "Method",
435 /* 09 */ "Mutex",
436 /* 10 */ "Region",
437 /* 11 */ "Power",
438 /* 12 */ "Processor",
439 /* 13 */ "Thermal",
0897831b
BM
440 /* 14 */ "BufferField",
441 /* 15 */ "DdbHandle",
442 /* 16 */ "DebugObject",
443 /* 17 */ "RegionField",
444 /* 18 */ "BankField",
445 /* 19 */ "IndexField",
1da177e4
LT
446 /* 20 */ "Reference",
447 /* 21 */ "Alias",
0897831b 448 /* 22 */ "MethodAlias",
1da177e4 449 /* 23 */ "Notify",
0897831b
BM
450 /* 24 */ "AddrHandler",
451 /* 25 */ "ResourceDesc",
452 /* 26 */ "ResourceFld",
1da177e4
LT
453 /* 27 */ "Scope",
454 /* 28 */ "Extra",
455 /* 29 */ "Data",
456 /* 30 */ "Invalid"
457};
458
4be44fcd 459char *acpi_ut_get_type_name(acpi_object_type type)
1da177e4
LT
460{
461
4be44fcd 462 if (type > ACPI_TYPE_INVALID) {
4a90c7e8 463 return (ACPI_CAST_PTR(char, acpi_gbl_bad_type));
1da177e4
LT
464 }
465
4a90c7e8 466 return (ACPI_CAST_PTR(char, acpi_gbl_ns_type_names[type]));
1da177e4
LT
467}
468
4be44fcd 469char *acpi_ut_get_object_type_name(union acpi_operand_object *obj_desc)
1da177e4
LT
470{
471
4be44fcd 472 if (!obj_desc) {
1da177e4
LT
473 return ("[NULL Object Descriptor]");
474 }
475
3371c19c 476 return (acpi_ut_get_type_name(obj_desc->common.type));
1da177e4
LT
477}
478
44f6c012 479/*******************************************************************************
1da177e4
LT
480 *
481 * FUNCTION: acpi_ut_get_node_name
482 *
483 * PARAMETERS: Object - A namespace node
484 *
485 * RETURN: Pointer to a string
486 *
487 * DESCRIPTION: Validate the node and return the node's ACPI name.
488 *
44f6c012 489 ******************************************************************************/
1da177e4 490
4be44fcd 491char *acpi_ut_get_node_name(void *object)
1da177e4 492{
4be44fcd 493 struct acpi_namespace_node *node = (struct acpi_namespace_node *)object;
1da177e4
LT
494
495 /* Must return a string of exactly 4 characters == ACPI_NAME_SIZE */
496
4be44fcd 497 if (!object) {
1da177e4
LT
498 return ("NULL");
499 }
500
501 /* Check for Root node */
502
4be44fcd 503 if ((object == ACPI_ROOT_OBJECT) || (object == acpi_gbl_root_node)) {
1da177e4
LT
504 return ("\"\\\" ");
505 }
506
507 /* Descriptor must be a namespace node */
508
61686124 509 if (ACPI_GET_DESCRIPTOR_TYPE(node) != ACPI_DESC_TYPE_NAMED) {
1da177e4
LT
510 return ("####");
511 }
512
513 /* Name must be a valid ACPI name */
514
c51a4de8 515 if (!acpi_ut_valid_acpi_name(node->name.integer)) {
3d81b236 516 node->name.integer = acpi_ut_repair_name(node->name.ascii);
1da177e4
LT
517 }
518
519 /* Return the name */
520
521 return (node->name.ascii);
522}
523
44f6c012 524/*******************************************************************************
1da177e4
LT
525 *
526 * FUNCTION: acpi_ut_get_descriptor_name
527 *
528 * PARAMETERS: Object - An ACPI object
529 *
530 * RETURN: Pointer to a string
531 *
532 * DESCRIPTION: Validate object and return the descriptor type
533 *
44f6c012
RM
534 ******************************************************************************/
535
536/* Printable names of object descriptor types */
1da177e4 537
4be44fcd 538static const char *acpi_gbl_desc_type_names[] = {
1da177e4
LT
539 /* 00 */ "Invalid",
540 /* 01 */ "Cached",
541 /* 02 */ "State-Generic",
542 /* 03 */ "State-Update",
543 /* 04 */ "State-Package",
544 /* 05 */ "State-Control",
0897831b
BM
545 /* 06 */ "State-RootParseScope",
546 /* 07 */ "State-ParseScope",
547 /* 08 */ "State-WalkScope",
1da177e4
LT
548 /* 09 */ "State-Result",
549 /* 10 */ "State-Notify",
550 /* 11 */ "State-Thread",
551 /* 12 */ "Walk",
552 /* 13 */ "Parser",
553 /* 14 */ "Operand",
554 /* 15 */ "Node"
555};
556
4be44fcd 557char *acpi_ut_get_descriptor_name(void *object)
1da177e4
LT
558{
559
4be44fcd 560 if (!object) {
1da177e4
LT
561 return ("NULL OBJECT");
562 }
563
4be44fcd 564 if (ACPI_GET_DESCRIPTOR_TYPE(object) > ACPI_DESC_TYPE_MAX) {
defba1d8 565 return (ACPI_CAST_PTR(char, acpi_gbl_bad_type));
1da177e4
LT
566 }
567
defba1d8
BM
568 return (ACPI_CAST_PTR(char,
569 acpi_gbl_desc_type_names[ACPI_GET_DESCRIPTOR_TYPE
570 (object)]));
1da177e4
LT
571
572}
573
f02a99ac
BM
574/*******************************************************************************
575 *
576 * FUNCTION: acpi_ut_get_reference_name
577 *
578 * PARAMETERS: Object - An ACPI reference object
579 *
580 * RETURN: Pointer to a string
581 *
582 * DESCRIPTION: Decode a reference object sub-type to a string.
583 *
584 ******************************************************************************/
585
586/* Printable names of reference object sub-types */
587
1044f1f6
BM
588static const char *acpi_gbl_ref_class_names[] = {
589 /* 00 */ "Local",
590 /* 01 */ "Argument",
591 /* 02 */ "RefOf",
592 /* 03 */ "Index",
593 /* 04 */ "DdbHandle",
594 /* 05 */ "Named Object",
595 /* 06 */ "Debug"
596};
597
f02a99ac
BM
598const char *acpi_ut_get_reference_name(union acpi_operand_object *object)
599{
1044f1f6
BM
600 if (!object)
601 return "NULL Object";
f02a99ac 602
1044f1f6
BM
603 if (ACPI_GET_DESCRIPTOR_TYPE(object) != ACPI_DESC_TYPE_OPERAND)
604 return "Not an Operand object";
f02a99ac 605
1044f1f6
BM
606 if (object->common.type != ACPI_TYPE_LOCAL_REFERENCE)
607 return "Not a Reference object";
f02a99ac 608
1044f1f6
BM
609 if (object->reference.class > ACPI_REFCLASS_MAX)
610 return "Unknown Reference class";
f02a99ac 611
1044f1f6 612 return acpi_gbl_ref_class_names[object->reference.class];
f02a99ac
BM
613}
614
1da177e4
LT
615#if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
616/*
617 * Strings and procedures used for debug only
618 */
619
44f6c012 620/*******************************************************************************
1da177e4
LT
621 *
622 * FUNCTION: acpi_ut_get_mutex_name
623 *
44f6c012 624 * PARAMETERS: mutex_id - The predefined ID for this mutex.
1da177e4 625 *
44f6c012
RM
626 * RETURN: String containing the name of the mutex. Always returns a valid
627 * pointer.
1da177e4
LT
628 *
629 * DESCRIPTION: Translate a mutex ID into a name string (Debug only)
630 *
44f6c012 631 ******************************************************************************/
1da177e4 632
4be44fcd 633char *acpi_ut_get_mutex_name(u32 mutex_id)
1da177e4
LT
634{
635
4c90ece2 636 if (mutex_id > ACPI_MAX_MUTEX) {
1da177e4
LT
637 return ("Invalid Mutex ID");
638 }
639
640 return (acpi_gbl_mutex_names[mutex_id]);
641}
514d18d7
ZR
642
643/*******************************************************************************
644 *
645 * FUNCTION: acpi_ut_get_notify_name
646 *
647 * PARAMETERS: notify_value - Value from the Notify() request
648 *
649 * RETURN: String corresponding to the Notify Value.
650 *
651 * DESCRIPTION: Translate a Notify Value to a notify namestring.
652 *
653 ******************************************************************************/
654
655/* Names for Notify() values, used for debug output */
656
657static const char *acpi_gbl_notify_value_names[] = {
658 "Bus Check",
659 "Device Check",
660 "Device Wake",
661 "Eject Request",
662 "Device Check Light",
663 "Frequency Mismatch",
664 "Bus Mode Mismatch",
665 "Power Fault",
666 "Capabilities Check",
667 "Device PLD Check",
668 "Reserved",
669 "System Locality Update"
670};
671
672const char *acpi_ut_get_notify_name(u32 notify_value)
673{
674
675 if (notify_value <= ACPI_NOTIFY_MAX) {
676 return (acpi_gbl_notify_value_names[notify_value]);
677 } else if (notify_value <= ACPI_MAX_SYS_NOTIFY) {
678 return ("Reserved");
679 } else { /* Greater or equal to 0x80 */
680
681 return ("**Device Specific**");
682 }
683}
1da177e4
LT
684#endif
685
44f6c012 686/*******************************************************************************
1da177e4
LT
687 *
688 * FUNCTION: acpi_ut_valid_object_type
689 *
690 * PARAMETERS: Type - Object type to be validated
691 *
44f6c012 692 * RETURN: TRUE if valid object type, FALSE otherwise
1da177e4
LT
693 *
694 * DESCRIPTION: Validate an object type
695 *
44f6c012 696 ******************************************************************************/
1da177e4 697
4be44fcd 698u8 acpi_ut_valid_object_type(acpi_object_type type)
1da177e4
LT
699{
700
4be44fcd 701 if (type > ACPI_TYPE_LOCAL_MAX) {
52fc0b02 702
1da177e4
LT
703 /* Note: Assumes all TYPEs are contiguous (external/local) */
704
705 return (FALSE);
706 }
707
708 return (TRUE);
709}
710
44f6c012 711/*******************************************************************************
1da177e4
LT
712 *
713 * FUNCTION: acpi_ut_init_globals
714 *
44f6c012
RM
715 * PARAMETERS: None
716 *
b417d40b 717 * RETURN: Status
1da177e4
LT
718 *
719 * DESCRIPTION: Init library globals. All globals that require specific
720 * initialization should be initialized here!
721 *
44f6c012 722 ******************************************************************************/
1da177e4 723
b417d40b 724acpi_status acpi_ut_init_globals(void)
1da177e4 725{
4be44fcd
LB
726 acpi_status status;
727 u32 i;
1da177e4 728
b229cf92 729 ACPI_FUNCTION_TRACE(ut_init_globals);
1da177e4 730
73459f73
RM
731 /* Create all memory caches */
732
4be44fcd
LB
733 status = acpi_ut_create_caches();
734 if (ACPI_FAILURE(status)) {
b417d40b 735 return_ACPI_STATUS(status);
73459f73 736 }
1da177e4 737
1da177e4
LT
738 /* Mutex locked flags */
739
4c90ece2 740 for (i = 0; i < ACPI_NUM_MUTEX; i++) {
4be44fcd
LB
741 acpi_gbl_mutex_info[i].mutex = NULL;
742 acpi_gbl_mutex_info[i].thread_id = ACPI_MUTEX_NOT_ACQUIRED;
743 acpi_gbl_mutex_info[i].use_count = 0;
1da177e4
LT
744 }
745
28f55ebc
BM
746 for (i = 0; i < ACPI_NUM_OWNERID_MASKS; i++) {
747 acpi_gbl_owner_id_mask[i] = 0;
748 }
749 acpi_gbl_owner_id_mask[ACPI_NUM_OWNERID_MASKS - 1] = 0x80000000; /* Last ID is never valid */
750
1da177e4
LT
751 /* GPE support */
752
4be44fcd
LB
753 acpi_gbl_gpe_xrupt_list_head = NULL;
754 acpi_gbl_gpe_fadt_blocks[0] = NULL;
755 acpi_gbl_gpe_fadt_blocks[1] = NULL;
e97d6bf1 756 acpi_current_gpe_count = 0;
1da177e4 757
3e08e2d2 758 /* Global handlers */
1da177e4 759
4be44fcd
LB
760 acpi_gbl_system_notify.handler = NULL;
761 acpi_gbl_device_notify.handler = NULL;
762 acpi_gbl_exception_handler = NULL;
763 acpi_gbl_init_handler = NULL;
3e08e2d2 764 acpi_gbl_table_handler = NULL;
1da177e4 765
1da177e4
LT
766 /* Global Lock support */
767
967440e3 768 acpi_gbl_global_lock_semaphore = NULL;
c81da666 769 acpi_gbl_global_lock_mutex = NULL;
4be44fcd 770 acpi_gbl_global_lock_acquired = FALSE;
4be44fcd 771 acpi_gbl_global_lock_handle = 0;
009c4cbe 772 acpi_gbl_global_lock_present = FALSE;
1da177e4
LT
773
774 /* Miscellaneous variables */
775
4be44fcd
LB
776 acpi_gbl_cm_single_step = FALSE;
777 acpi_gbl_db_terminate_threads = FALSE;
778 acpi_gbl_shutdown = FALSE;
779 acpi_gbl_ns_lookup_count = 0;
780 acpi_gbl_ps_find_count = 0;
781 acpi_gbl_acpi_hardware_present = TRUE;
28f55ebc
BM
782 acpi_gbl_last_owner_id_index = 0;
783 acpi_gbl_next_owner_id_offset = 0;
50eca3eb
BM
784 acpi_gbl_trace_method_name = 0;
785 acpi_gbl_trace_dbg_level = 0;
786 acpi_gbl_trace_dbg_layer = 0;
4be44fcd
LB
787 acpi_gbl_debugger_configuration = DEBUGGER_THREADING;
788 acpi_gbl_db_output_flags = ACPI_DB_CONSOLE_OUTPUT;
1da177e4
LT
789
790 /* Hardware oriented */
791
4be44fcd
LB
792 acpi_gbl_events_initialized = FALSE;
793 acpi_gbl_system_awake_and_running = TRUE;
1da177e4
LT
794
795 /* Namespace */
796
4be44fcd 797 acpi_gbl_root_node = NULL;
1da177e4 798 acpi_gbl_root_node_struct.name.integer = ACPI_ROOT_NAME;
61686124 799 acpi_gbl_root_node_struct.descriptor_type = ACPI_DESC_TYPE_NAMED;
4be44fcd
LB
800 acpi_gbl_root_node_struct.type = ACPI_TYPE_DEVICE;
801 acpi_gbl_root_node_struct.child = NULL;
802 acpi_gbl_root_node_struct.peer = NULL;
803 acpi_gbl_root_node_struct.object = NULL;
804 acpi_gbl_root_node_struct.flags = ANOBJ_END_OF_PEER_LIST;
1da177e4
LT
805
806#ifdef ACPI_DEBUG_OUTPUT
1d18c058 807 acpi_gbl_lowest_stack_pointer = ACPI_CAST_PTR(acpi_size, ACPI_SIZE_MAX);
1da177e4
LT
808#endif
809
d41eb99b
BM
810#ifdef ACPI_DBG_TRACK_ALLOCATIONS
811 acpi_gbl_display_final_mem_stats = FALSE;
812#endif
813
b417d40b 814 return_ACPI_STATUS(AE_OK);
1da177e4 815}
8313524a 816
e97d6bf1 817ACPI_EXPORT_SYMBOL(acpi_gbl_FADT)
8313524a 818ACPI_EXPORT_SYMBOL(acpi_dbg_level)
1044f1f6 819ACPI_EXPORT_SYMBOL(acpi_dbg_layer)
e97d6bf1 820ACPI_EXPORT_SYMBOL(acpi_current_gpe_count)