/******************************************************************************
*
* Module Name: utxface - External interfaces for "global" ACPI functions
* $Revision: 82 $
*
*****************************************************************************/
/*
* Copyright (C) 2000, 2001 R. Byron Moore
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
#include "acpi.h"
#include "acevents.h"
#include "achware.h"
#include "acnamesp.h"
#include "acinterp.h"
#include "amlcode.h"
#include "acdebug.h"
#include "acexcep.h"
#define _COMPONENT ACPI_UTILITIES
MODULE_NAME ("utxface")
/*******************************************************************************
*
* FUNCTION: Acpi_initialize_subsystem
*
* PARAMETERS: None
*
* RETURN: Status
*
* DESCRIPTION: Initializes all global variables. This is the first function
* called, so any early initialization belongs here.
*
******************************************************************************/
acpi_status
acpi_initialize_subsystem (
void)
{
acpi_status status;
FUNCTION_TRACE ("Acpi_initialize_subsystem");
DEBUG_EXEC(acpi_ut_init_stack_ptr_trace ());
/* Initialize all globals used by the subsystem */
acpi_ut_init_globals ();
/* Initialize the OS-Dependent layer */
status = acpi_os_initialize ();
if (ACPI_FAILURE (status)) {
REPORT_ERROR (("OSD failed to initialize, %s\n",
acpi_format_exception (status)));
return_ACPI_STATUS (status);
}
/* Create the default mutex objects */
status = acpi_ut_mutex_initialize ();
if (ACPI_FAILURE (status)) {
REPORT_ERROR (("Global mutex creation failure, %s\n",
acpi_format_exception (status)));
return_ACPI_STATUS (status);
}
/*
* Initialize the namespace manager and
* the root of the namespace tree
*/
status = acpi_ns_root_initialize ();
if (ACPI_FAILURE (status)) {
REPORT_ERROR (("Namespace initialization failure, %s\n",
acpi_format_exception (status)));
return_ACPI_STATUS (status);
}
/* If configured, initialize the AML debugger */
DEBUGGER_EXEC (acpi_db_initialize ());
return_ACPI_STATUS (status);
}
/*******************************************************************************
*
* FUNCTION: Acpi_enable_subsystem
*
* PARAMETERS: Flags - Init/enable Options
*
* RETURN: Status
*
* DESCRIPTION: Completes the subsystem initialization including hardware.
* Puts system into ACPI mode if it isn't already.
*
******************************************************************************/
acpi_status
acpi_enable_subsystem (
u32 flags)
{
acpi_status status = AE_OK;
FUNCTION_TRACE ("Acpi_enable_subsystem");
/* Sanity check the FADT for valid values */
status = acpi_ut_validate_fadt ();
if (ACPI_FAILURE (status)) {
return_ACPI_STATUS (status);
}
/*
* Install the default Op_region handlers. These are
* installed unless other handlers have already been
* installed via the Install_address_space_handler interface
*/
if (!(flags & ACPI_NO_ADDRESS_SPACE_INIT)) {
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Installing default address space handlers\n"));
status = acpi_ev_install_default_address_space_handlers ();
if (ACPI_FAILURE (status)) {
return_ACPI_STATUS (status);
}
}
/*
* We must initialize the hardware before we can enable ACPI.
*/
if (!(flags & ACPI_NO_HARDWARE_INIT)) {
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI hardware\n"));
status = acpi_hw_initialize ();
if (ACPI_FAILURE (status)) {
return_ACPI_STATUS (status);
}
}
/*
* Enable ACPI on this platform
*/
if (!(flags & ACPI_NO_ACPI_ENABLE)) {
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Going into ACPI mode\n"));
status = acpi_enable ();
if (ACPI_FAILURE (status)) {
ACPI_DEBUG_PRINT ((ACPI_DB_WARN, "Acpi_enable failed.\n"));
return_ACPI_STATUS (status);
}
}
/*
* Note:
* We must have the hardware AND events initialized before we can execute
* ANY control methods SAFELY. Any control method can require ACPI hardware
* support, so the hardware MUST be initialized before execution!
*/
if (!(flags & ACPI_NO_EVENT_INIT)) {
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI events\n"));
status = acpi_ev_initialize ();
if (ACPI_FAILURE (status)) {
return_ACPI_STATUS (status);
}
}
/*
* Initialize all device objects in the namespace
* This runs the _STA and _INI methods.
*/
if (!(flags & ACPI_NO_DEVICE_INIT)) {
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI Devices\n"));
status = acpi_ns_initialize_devices ();
if (ACPI_FAILURE (status)) {
return_ACPI_STATUS (status);
}
}
/*
* Initialize the objects that remain uninitialized. This
* runs the executable AML that is part of the declaration of Op_regions
* and Fields.
*/
if (!(flags & ACPI_NO_OBJECT_INIT)) {
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Init] Initializing ACPI Objects\n"));
status = acpi_ns_initialize_objects ();
if (ACPI_FAILURE (status)) {
return_ACPI_STATUS (status);
}
}
acpi_gbl_startup_flags |= ACPI_INITIALIZED_OK;
return_ACPI_STATUS (status);
}
/*******************************************************************************
*
* FUNCTION: Acpi_terminate
*
* PARAMETERS: None
*
* RETURN: Status
*
* DESCRIPTION: Shutdown the ACPI subsystem. Release all resources.
*
******************************************************************************/
acpi_status
acpi_terminate (void)
{
FUNCTION_TRACE ("Acpi_terminate");
/* Terminate the AML Debugger if present */
DEBUGGER_EXEC(acpi_gbl_db_terminate_threads = TRUE);
/* TBD: [Investigate] This is no longer needed?*/
/* Acpi_ut_release_mutex (ACPI_MTX_DEBUG_CMD_READY); */
/* Shutdown and free all resources */
acpi_ut_subsystem_shutdown ();
/* Free the mutex objects */
acpi_ut_mutex_terminate ();
#ifdef ENABLE_DEBUGGER
/* Shut down the debugger */
acpi_db_terminate ();
#endif
/* Now we can shutdown the OS-dependent layer */
acpi_os_terminate ();
return_ACPI_STATUS (AE_OK);
}
/*****************************************************************************
*
* FUNCTION: Acpi_subsystem_status
*
* PARAMETERS: None
*
* RETURN: Status of the ACPI subsystem
*
* DESCRIPTION: Other drivers that use the ACPI subsystem should call this
* before making any other calls, to ensure the subsystem initial-
* ized successfully.
*
****************************************************************************/
acpi_status
acpi_subsystem_status (void)
{
if (acpi_gbl_startup_flags & ACPI_INITIALIZED_OK) {
return (AE_OK);
}
else {
return (AE_ERROR);
}
}
/******************************************************************************
*
* FUNCTION: Acpi_get_system_info
*
* PARAMETERS: Out_buffer - a pointer to a buffer to receive the
* resources for the device
* Buffer_length - the number of bytes available in the buffer
*
* RETURN: Status - the status of the call
*
* DESCRIPTION: This function is called to get information about the current
* state of the ACPI subsystem. It will return system information
* in the Out_buffer.
*
* If the function fails an appropriate status will be returned
* and the value of Out_buffer is undefined.
*
******************************************************************************/
acpi_status
acpi_get_system_info (
acpi_buffer *out_buffer)
{
acpi_system_info *info_ptr;
u32 i;
FUNCTION_TRACE ("Acpi_get_system_info");
/*
* Must have a valid buffer
*/
if ((!out_buffer) ||
(!out_buffer->pointer)) {
return_ACPI_STATUS (AE_BAD_PARAMETER);
}
if (out_buffer->length < sizeof (acpi_system_info)) {
/*
* Caller's buffer is too small
*/
out_buffer->length = sizeof (acpi_system_info);
return_ACPI_STATUS (AE_BUFFER_OVERFLOW);
}
/*
* Set return length and get data
*/
out_buffer->length = sizeof (acpi_system_info);
info_ptr = (acpi_system_info *) out_buffer->pointer;
info_ptr->acpi_ca_version = ACPI_CA_VERSION;
/* System flags (ACPI capabilities) */
info_ptr->flags = acpi_gbl_system_flags;
/* Timer resolution - 24 or 32 bits */
if (!acpi_gbl_FADT) {
info_ptr->timer_resolution = 0;
}
else if (acpi_gbl_FADT->tmr_val_ext == 0) {
info_ptr->timer_resolution = 24;
}
else {
info_ptr->timer_resolution = 32;
}
/* Clear the reserved fields */
info_ptr->reserved1 = 0;
info_ptr->reserved2 = 0;
/* Current debug levels */
info_ptr->debug_layer = acpi_dbg_layer;
info_ptr->debug_level = acpi_dbg_level;
/* Current status of the ACPI tables, per table type */
info_ptr->num_table_types = NUM_ACPI_TABLES;
for (i = 0; i < NUM_ACPI_TABLES; i++) {
info_ptr->table_info[i].count = acpi_gbl_acpi_tables[i].count;
}
return_ACPI_STATUS (AE_OK);
}