135
88
return (ACPI_CAST_PTR(const char, exception));
138
ACPI_EXPORT_SYMBOL(acpi_format_exception)
140
/*******************************************************************************
144
******************************************************************************/
146
* Predefined ACPI Names (Built-in to the Interpreter)
149
* 1) _SB_ is defined to be a device to allow \_SB_._INI to be run
150
* during the initialization sequence.
151
* 2) _TZ_ is defined to be a thermal zone in order to allow ASL code to
152
* perform a Notify() operation on it.
154
const struct acpi_predefined_names acpi_gbl_pre_defined_names[] = {
155
{"_GPE", ACPI_TYPE_LOCAL_SCOPE, NULL},
156
{"_PR_", ACPI_TYPE_LOCAL_SCOPE, NULL},
157
{"_SB_", ACPI_TYPE_DEVICE, NULL},
158
{"_SI_", ACPI_TYPE_LOCAL_SCOPE, NULL},
159
{"_TZ_", ACPI_TYPE_THERMAL, NULL},
160
{"_REV", ACPI_TYPE_INTEGER, (char *)ACPI_CA_SUPPORT_LEVEL},
161
{"_OS_", ACPI_TYPE_STRING, ACPI_OS_NAME},
162
{"_GL_", ACPI_TYPE_MUTEX, (char *)1},
164
#if !defined (ACPI_NO_METHOD_EXECUTION) || defined (ACPI_CONSTANT_EVAL_ONLY)
165
{"_OSI", ACPI_TYPE_METHOD, (char *)1},
168
/* Table terminator */
170
{NULL, ACPI_TYPE_ANY, NULL}
174
* Properties of the ACPI Object Types, both internal and external.
175
* The table is indexed by values of acpi_object_type
177
const u8 acpi_gbl_ns_properties[] = {
178
ACPI_NS_NORMAL, /* 00 Any */
179
ACPI_NS_NORMAL, /* 01 Number */
180
ACPI_NS_NORMAL, /* 02 String */
181
ACPI_NS_NORMAL, /* 03 Buffer */
182
ACPI_NS_NORMAL, /* 04 Package */
183
ACPI_NS_NORMAL, /* 05 field_unit */
184
ACPI_NS_NEWSCOPE, /* 06 Device */
185
ACPI_NS_NORMAL, /* 07 Event */
186
ACPI_NS_NEWSCOPE, /* 08 Method */
187
ACPI_NS_NORMAL, /* 09 Mutex */
188
ACPI_NS_NORMAL, /* 10 Region */
189
ACPI_NS_NEWSCOPE, /* 11 Power */
190
ACPI_NS_NEWSCOPE, /* 12 Processor */
191
ACPI_NS_NEWSCOPE, /* 13 Thermal */
192
ACPI_NS_NORMAL, /* 14 buffer_field */
193
ACPI_NS_NORMAL, /* 15 ddb_handle */
194
ACPI_NS_NORMAL, /* 16 Debug Object */
195
ACPI_NS_NORMAL, /* 17 def_field */
196
ACPI_NS_NORMAL, /* 18 bank_field */
197
ACPI_NS_NORMAL, /* 19 index_field */
198
ACPI_NS_NORMAL, /* 20 Reference */
199
ACPI_NS_NORMAL, /* 21 Alias */
200
ACPI_NS_NORMAL, /* 22 method_alias */
201
ACPI_NS_NORMAL, /* 23 Notify */
202
ACPI_NS_NORMAL, /* 24 Address Handler */
203
ACPI_NS_NEWSCOPE | ACPI_NS_LOCAL, /* 25 Resource Desc */
204
ACPI_NS_NEWSCOPE | ACPI_NS_LOCAL, /* 26 Resource Field */
205
ACPI_NS_NEWSCOPE, /* 27 Scope */
206
ACPI_NS_NORMAL, /* 28 Extra */
207
ACPI_NS_NORMAL, /* 29 Data */
208
ACPI_NS_NORMAL /* 30 Invalid */
211
/* Hex to ASCII conversion table */
213
static const char acpi_gbl_hex_to_ascii[] = {
214
'0', '1', '2', '3', '4', '5', '6', '7',
215
'8', '9', 'A', 'B', 'C', 'D', 'E', 'F'
218
/*******************************************************************************
220
* FUNCTION: acpi_ut_hex_to_ascii_char
222
* PARAMETERS: Integer - Contains the hex digit
223
* Position - bit position of the digit within the
224
* integer (multiple of 4)
226
* RETURN: The converted Ascii character
228
* DESCRIPTION: Convert a hex digit to an Ascii character
230
******************************************************************************/
232
char acpi_ut_hex_to_ascii_char(acpi_integer integer, u32 position)
235
return (acpi_gbl_hex_to_ascii[(integer >> position) & 0xF]);
238
91
/******************************************************************************
240
93
* Event and Hardware globals
313
166
ACPI_BITMASK_ARB_DISABLE}
316
struct acpi_fixed_event_info acpi_gbl_fixed_event_info[ACPI_NUM_FIXED_EVENTS] = {
317
/* ACPI_EVENT_PMTIMER */ {ACPI_BITREG_TIMER_STATUS,
318
ACPI_BITREG_TIMER_ENABLE,
319
ACPI_BITMASK_TIMER_STATUS,
320
ACPI_BITMASK_TIMER_ENABLE},
321
/* ACPI_EVENT_GLOBAL */ {ACPI_BITREG_GLOBAL_LOCK_STATUS,
322
ACPI_BITREG_GLOBAL_LOCK_ENABLE,
323
ACPI_BITMASK_GLOBAL_LOCK_STATUS,
324
ACPI_BITMASK_GLOBAL_LOCK_ENABLE},
325
/* ACPI_EVENT_POWER_BUTTON */ {ACPI_BITREG_POWER_BUTTON_STATUS,
326
ACPI_BITREG_POWER_BUTTON_ENABLE,
327
ACPI_BITMASK_POWER_BUTTON_STATUS,
328
ACPI_BITMASK_POWER_BUTTON_ENABLE},
329
/* ACPI_EVENT_SLEEP_BUTTON */ {ACPI_BITREG_SLEEP_BUTTON_STATUS,
330
ACPI_BITREG_SLEEP_BUTTON_ENABLE,
331
ACPI_BITMASK_SLEEP_BUTTON_STATUS,
332
ACPI_BITMASK_SLEEP_BUTTON_ENABLE},
333
/* ACPI_EVENT_RTC */ {ACPI_BITREG_RT_CLOCK_STATUS,
334
ACPI_BITREG_RT_CLOCK_ENABLE,
335
ACPI_BITMASK_RT_CLOCK_STATUS,
336
ACPI_BITMASK_RT_CLOCK_ENABLE},
169
#ifdef ACPI_DEBUG_OUTPUT
339
171
/*******************************************************************************
373
205
return (ACPI_CAST_PTR(char, acpi_gbl_region_types[space_id]));
376
/*******************************************************************************
378
* FUNCTION: acpi_ut_get_event_name
384
* DESCRIPTION: Translate a Event ID into a name string (Debug only)
386
******************************************************************************/
388
/* Event type decoding */
390
static const char *acpi_gbl_event_types[ACPI_NUM_FIXED_EVENTS] = {
398
char *acpi_ut_get_event_name(u32 event_id)
401
if (event_id > ACPI_EVENT_MAX) {
402
return ("InvalidEventID");
405
return (ACPI_CAST_PTR(char, acpi_gbl_event_types[event_id]));
408
/*******************************************************************************
410
* FUNCTION: acpi_ut_get_type_name
416
* DESCRIPTION: Translate a Type ID into a name string (Debug only)
418
******************************************************************************/
421
* Elements of acpi_gbl_ns_type_names below must match
422
* one-to-one with values of acpi_object_type
424
* The type ACPI_TYPE_ANY (Untyped) is used as a "don't care" when searching;
425
* when stored in a table it really means that we have thus far seen no
426
* evidence to indicate what type is actually going to be stored for this entry.
428
static const char acpi_gbl_bad_type[] = "UNDEFINED";
430
/* Printable names of the ACPI object types */
432
static const char *acpi_gbl_ns_type_names[] = {
438
/* 05 */ "FieldUnit",
445
/* 12 */ "Processor",
447
/* 14 */ "BufferField",
448
/* 15 */ "DdbHandle",
449
/* 16 */ "DebugObject",
450
/* 17 */ "RegionField",
451
/* 18 */ "BankField",
452
/* 19 */ "IndexField",
453
/* 20 */ "Reference",
455
/* 22 */ "MethodAlias",
457
/* 24 */ "AddrHandler",
458
/* 25 */ "ResourceDesc",
459
/* 26 */ "ResourceFld",
466
char *acpi_ut_get_type_name(acpi_object_type type)
469
if (type > ACPI_TYPE_INVALID) {
470
return (ACPI_CAST_PTR(char, acpi_gbl_bad_type));
473
return (ACPI_CAST_PTR(char, acpi_gbl_ns_type_names[type]));
476
char *acpi_ut_get_object_type_name(union acpi_operand_object *obj_desc)
480
return ("[NULL Object Descriptor]");
483
return (acpi_ut_get_type_name(ACPI_GET_OBJECT_TYPE(obj_desc)));
486
/*******************************************************************************
488
* FUNCTION: acpi_ut_get_descriptor_name
490
* PARAMETERS: Object - An ACPI object
492
* RETURN: Pointer to a string
494
* DESCRIPTION: Validate object and return the descriptor type
496
******************************************************************************/
498
/* Printable names of object descriptor types */
500
static const char *acpi_gbl_desc_type_names[] = {
503
/* 02 */ "State-Generic",
504
/* 03 */ "State-Update",
505
/* 04 */ "State-Package",
506
/* 05 */ "State-Control",
507
/* 06 */ "State-RootParseScope",
508
/* 07 */ "State-ParseScope",
509
/* 08 */ "State-WalkScope",
510
/* 09 */ "State-Result",
511
/* 10 */ "State-Notify",
512
/* 11 */ "State-Thread",
519
char *acpi_ut_get_descriptor_name(void *object)
523
return ("NULL OBJECT");
526
if (ACPI_GET_DESCRIPTOR_TYPE(object) > ACPI_DESC_TYPE_MAX) {
527
return (ACPI_CAST_PTR(char, acpi_gbl_bad_type));
530
return (ACPI_CAST_PTR(char,
531
acpi_gbl_desc_type_names[ACPI_GET_DESCRIPTOR_TYPE
536
#if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
538
* Strings and procedures used for debug only
541
/*******************************************************************************
543
* FUNCTION: acpi_ut_get_mutex_name
545
* PARAMETERS: mutex_id - The predefined ID for this mutex.
547
* RETURN: String containing the name of the mutex. Always returns a valid
550
* DESCRIPTION: Translate a mutex ID into a name string (Debug only)
552
******************************************************************************/
554
char *acpi_ut_get_mutex_name(u32 mutex_id)
557
if (mutex_id > ACPI_MAX_MUTEX) {
558
return ("Invalid Mutex ID");
561
return (acpi_gbl_mutex_names[mutex_id]);
564
/*******************************************************************************
566
* FUNCTION: acpi_ut_get_notify_name
568
* PARAMETERS: notify_value - Value from the Notify() request
570
* RETURN: String corresponding to the Notify Value.
572
* DESCRIPTION: Translate a Notify Value to a notify namestring.
574
******************************************************************************/
576
/* Names for Notify() values, used for debug output */
578
static const char *acpi_gbl_notify_value_names[] = {
583
"Device Check Light",
584
"Frequency Mismatch",
587
"Capabilities Check",
590
"System Locality Update"
593
const char *acpi_ut_get_notify_name(u32 notify_value)
596
if (notify_value <= ACPI_NOTIFY_MAX) {
597
return (acpi_gbl_notify_value_names[notify_value]);
598
} else if (notify_value <= ACPI_MAX_SYS_NOTIFY) {
600
} else { /* Greater or equal to 0x80 */
602
return ("**Device Specific**");
607
/*******************************************************************************
609
* FUNCTION: acpi_ut_valid_object_type
611
* PARAMETERS: Type - Object type to be validated
613
* RETURN: TRUE if valid object type, FALSE otherwise
615
* DESCRIPTION: Validate an object type
617
******************************************************************************/
619
u8 acpi_ut_valid_object_type(acpi_object_type type)
622
if (type > ACPI_TYPE_LOCAL_MAX) {
624
/* Note: Assumes all TYPEs are contiguous (external/local) */
632
/*******************************************************************************
634
* FUNCTION: acpi_ut_init_globals
640
* DESCRIPTION: Init library globals. All globals that require specific
641
* initialization should be initialized here!
643
******************************************************************************/
645
void acpi_ut_init_globals(void)
652
ACPI_FUNCTION_TRACE(ut_init_globals);
655
/* Create all memory caches */
657
status = acpi_ut_create_caches();
658
if (ACPI_FAILURE(status)) {
663
/* Mutex locked flags */
665
for (i = 0; i < ACPI_NUM_MUTEX; i++) {
666
acpi_gbl_mutex_info[i].mutex = NULL;
667
acpi_gbl_mutex_info[i].thread_id = ACPI_MUTEX_NOT_ACQUIRED;
668
acpi_gbl_mutex_info[i].use_count = 0;
671
for (i = 0; i < ACPI_NUM_OWNERID_MASKS; i++) {
672
acpi_gbl_owner_id_mask[i] = 0;
674
acpi_gbl_owner_id_mask[ACPI_NUM_OWNERID_MASKS - 1] = 0x80000000; /* Last ID is never valid */
678
acpi_gbl_gpe_xrupt_list_head = NULL;
679
acpi_gbl_gpe_fadt_blocks[0] = NULL;
680
acpi_gbl_gpe_fadt_blocks[1] = NULL;
682
/* Global handlers */
684
acpi_gbl_system_notify.handler = NULL;
685
acpi_gbl_device_notify.handler = NULL;
686
acpi_gbl_exception_handler = NULL;
687
acpi_gbl_init_handler = NULL;
688
/*acpi_gbl_table_handler = NULL;*/
690
/* Global Lock support */
692
acpi_gbl_global_lock_semaphore = NULL;
693
acpi_gbl_global_lock_mutex = NULL;
694
acpi_gbl_global_lock_acquired = FALSE;
695
acpi_gbl_global_lock_handle = 0;
697
/* Miscellaneous variables */
699
acpi_gbl_cm_single_step = FALSE;
700
acpi_gbl_db_terminate_threads = FALSE;
701
acpi_gbl_shutdown = FALSE;
702
acpi_gbl_ns_lookup_count = 0;
703
acpi_gbl_ps_find_count = 0;
704
acpi_gbl_acpi_hardware_present = TRUE;
705
acpi_gbl_last_owner_id_index = 0;
706
acpi_gbl_next_owner_id_offset = 0;
707
acpi_gbl_trace_method_name = 0;
708
acpi_gbl_trace_dbg_level = 0;
709
acpi_gbl_trace_dbg_layer = 0;
710
acpi_gbl_debugger_configuration = DEBUGGER_THREADING;
711
acpi_gbl_db_output_flags = ACPI_DB_CONSOLE_OUTPUT;
713
/* Hardware oriented */
715
acpi_gbl_events_initialized = FALSE;
716
acpi_gbl_system_awake_and_running = TRUE;
720
acpi_gbl_root_node = NULL;
721
acpi_gbl_root_node_struct.name.integer = ACPI_ROOT_NAME;
722
acpi_gbl_root_node_struct.descriptor_type = ACPI_DESC_TYPE_NAMED;
723
acpi_gbl_root_node_struct.type = ACPI_TYPE_DEVICE;
724
acpi_gbl_root_node_struct.child = NULL;
725
acpi_gbl_root_node_struct.peer = NULL;
726
acpi_gbl_root_node_struct.object = NULL;
727
acpi_gbl_root_node_struct.flags = ANOBJ_END_OF_PEER_LIST;
729
#ifdef ACPI_DEBUG_OUTPUT
730
acpi_gbl_lowest_stack_pointer = ACPI_CAST_PTR(acpi_size, ACPI_SIZE_MAX);
733
#ifdef ACPI_DBG_TRACK_ALLOCATIONS
734
acpi_gbl_display_final_mem_stats = FALSE;
740
ACPI_EXPORT_SYMBOL(acpi_dbg_level)
741
ACPI_EXPORT_SYMBOL(acpi_dbg_layer)