patch-2.4.6 linux/drivers/acpi/ospm/busmgr/bmdriver.c

Next file: linux/drivers/acpi/ospm/busmgr/bmnotify.c
Previous file: linux/drivers/acpi/ospm/busmgr/bm_osl.c
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.4.5/linux/drivers/acpi/ospm/busmgr/bmdriver.c linux/drivers/acpi/ospm/busmgr/bmdriver.c
@@ -0,0 +1,469 @@
+/*****************************************************************************
+ *
+ * Module Name: bmdriver.c
+ *   $Revision: 17 $
+ *
+ *****************************************************************************/
+
+/*
+ *  Copyright (C) 2000, 2001 Andrew Grover
+ *
+ *  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 "bm.h"
+
+#define _COMPONENT		ACPI_BUS
+	MODULE_NAME		("bmdriver")
+
+
+/****************************************************************************
+ *                            External Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_get_device_power_state
+ *
+ * PARAMETERS:  
+ *
+ * RETURN:      
+ *
+ * DESCRIPTION: 
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_get_device_power_state (
+	BM_HANDLE               device_handle,
+	BM_POWER_STATE		*state)
+{
+	ACPI_STATUS             status = AE_OK;
+	BM_NODE			*node = NULL;
+
+	FUNCTION_TRACE("bm_get_device_power_state");
+
+	if (!state) {
+		return_ACPI_STATUS(AE_BAD_PARAMETER);
+	}
+
+	*state = ACPI_STATE_UNKNOWN;
+
+	/*
+	 * Resolve device handle to node.
+	 */
+	status = bm_get_node(device_handle, 0, &node);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	/*
+	 * Get the current power state.
+	 */
+	status = bm_get_power_state(node);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	*state = node->device.power.state;
+
+	return_ACPI_STATUS(status);
+}
+
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_set_device_power_state
+ *
+ * PARAMETERS:  
+ *
+ * RETURN:      
+ *
+ * DESCRIPTION: 
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_set_device_power_state (
+	BM_HANDLE               device_handle,
+	BM_POWER_STATE		state)
+{
+	ACPI_STATUS             status = AE_OK;
+	BM_NODE			*node = NULL;
+
+	FUNCTION_TRACE("bm_set_device_power_state");
+
+	/*
+	 * Resolve device handle to node.
+	 */
+	status = bm_get_node(device_handle, 0, &node);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	/*
+	 * Set the current power state.
+	 */
+	status = bm_set_power_state(node, state);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	return_ACPI_STATUS(status);
+}
+
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_get_device_status
+ *
+ * PARAMETERS:  
+ *    device_handle is really an index number into the array of BM_DEVICE
+ *                  structures in info_list.  This data item is passed to
+ *                  the registered program's "notify" callback.  It is used
+ *                  to retrieve the specific BM_DEVICE structure instance
+ *                  associated with the callback.  
+ *    device_status is a pointer that receives the result of processing
+ *                  the device's associated ACPI _STA.
+ *
+ * RETURN:
+ *    The ACPI_STATUS value indicates success AE_OK or failure of the function
+ *
+ * DESCRIPTION: Evaluates the device's ACPI _STA, if it is present.
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_get_device_status (
+	BM_HANDLE               device_handle,
+	BM_DEVICE_STATUS        *device_status)
+{
+	ACPI_STATUS             status = AE_OK;
+	BM_NODE			*node = NULL;
+
+	FUNCTION_TRACE("bm_get_device_status");
+
+	if (!device_status) {
+		return_ACPI_STATUS(AE_BAD_PARAMETER);
+	}
+
+	*device_status = BM_STATUS_UNKNOWN;
+
+	/*
+	 * Resolve device handle to node.
+	 */
+	status = bm_get_node(device_handle, 0, &node);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	/*
+	 * Parent Present?
+	 * ---------------
+	 * If the parent isn't present we can't evalute _STA on the child.
+	 * Return an unknown status.
+	 */
+	if (!BM_NODE_PRESENT(node->parent)) {
+		return_ACPI_STATUS(AE_OK);
+	}
+	
+	/*
+	 * Dynamic Status?
+	 * ---------------
+	 * If _STA isn't present we just return the default status.
+	 */
+	if (!(node->device.flags & BM_FLAGS_DYNAMIC_STATUS)) {
+		*device_status = BM_STATUS_DEFAULT;
+		return_ACPI_STATUS(AE_OK);
+	}
+
+	/*
+	 * Evaluate _STA:
+	 * --------------
+	 */
+	status = bm_evaluate_simple_integer(node->device.acpi_handle, "_STA", 
+		&(node->device.status));
+	if (ACPI_SUCCESS(status)) {
+		*device_status = node->device.status;
+	}
+
+	return_ACPI_STATUS(status);
+}
+
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_get_device_info
+ *
+ * PARAMETERS:
+ *    device_handle An index used to retrieve the associated BM_DEVICE info.
+ *    device        A pointer to a BM_DEVICE structure instance pointer.
+ *                  This pointed to BM_DEVICE structure will contain the
+ *                  this device's information.
+ *
+ * RETURN:
+ *    The ACPI_STATUS value indicates success AE_OK or failure of the function
+ *
+ * DESCRIPTION:
+ *    Using the device_handle this function retrieves this device's
+ *    BM_DEVICE structure instance and save's it in device.
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_get_device_info (
+	BM_HANDLE               device_handle,
+	BM_DEVICE               **device)
+{
+	ACPI_STATUS             status = AE_OK;
+	BM_NODE			*node = NULL;
+
+	FUNCTION_TRACE("bm_get_device_info");
+
+	if (!device) {
+		return_ACPI_STATUS(AE_BAD_PARAMETER);
+	}
+
+	/*
+	 * Resolve device handle to internal device.
+	 */
+	status = bm_get_node(device_handle, 0, &node);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	*device = &(node->device);
+
+	return_ACPI_STATUS(AE_OK);
+}
+
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_get_device_context
+ *
+ *    device_handle An index used to retrieve the associated BM_DEVICE info.
+ *    context       A pointer to a BM_DRIVER_CONTEXT structure instance.
+ *
+ * RETURN:
+ *    The ACPI_STATUS value indicates success AE_OK or failure of the function
+ *
+ * DESCRIPTION:
+ *    Using the device_handle this function retrieves this device's
+ *    BM_DRIVER_CONTEXT structure instance and save's it in context.
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_get_device_context (
+	BM_HANDLE               device_handle,
+	BM_DRIVER_CONTEXT	*context)
+{
+	ACPI_STATUS             status = AE_OK;
+	BM_NODE			*node = NULL;
+
+	FUNCTION_TRACE("bm_get_device_context");
+
+	if (!context) {
+		return_ACPI_STATUS(AE_BAD_PARAMETER);
+	}
+
+	*context = NULL;
+
+	/*
+	 * Resolve device handle to internal device.
+	 */
+	status = bm_get_node(device_handle, 0, &node);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	if (!node->driver.context) {
+		return_ACPI_STATUS(AE_NULL_ENTRY);
+	}
+
+	*context = node->driver.context;
+
+	return_ACPI_STATUS(AE_OK);
+}
+
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_register_driver
+ *
+ * PARAMETERS:  
+ *
+ * RETURN:      
+ *
+ * DESCRIPTION: 
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_register_driver (
+	BM_DEVICE_ID		*criteria,
+	BM_DRIVER		*driver)
+{
+	ACPI_STATUS             status = AE_NOT_FOUND;
+	BM_HANDLE_LIST          device_list;
+	BM_NODE			*node = NULL;
+	BM_DEVICE		*device = NULL;
+	u32                     i = 0;
+
+	FUNCTION_TRACE("bm_register_driver");
+
+	if (!criteria || !driver || !driver->notify || !driver->request) {
+		return_ACPI_STATUS(AE_BAD_PARAMETER);
+	}
+
+	MEMSET(&device_list, 0, sizeof(BM_HANDLE_LIST));
+
+	/*
+	 * Find Matches:
+	 * -------------
+	 * Search through the entire device hierarchy for matches against
+	 * the given device criteria.
+	 */
+	status = bm_search(BM_HANDLE_ROOT, criteria, &device_list);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	/*
+	 * Install driver:
+	 * ----------------
+	 * For each match, record the driver information and execute the 
+	 * driver's Notify() funciton (if present) to notify the driver
+	 * of the device's presence.
+	 */
+	for (i = 0; i < device_list.count; i++) {
+
+		/* Resolve the device handle. */
+		status = bm_get_node(device_list.handles[i], 0, &node);
+		if (ACPI_FAILURE(status)) {
+			continue;
+		}
+
+		device = &(node->device);
+
+		/* 
+		 * Make sure another driver hasn't already registered for 
+		 * this device. 
+		 */
+		if (BM_IS_DRIVER_CONTROL(device)) {
+			DEBUG_PRINT(ACPI_INFO, ("Another driver has already registered for device [%02x].\n", device->handle));
+			continue;
+		}
+
+		DEBUG_PRINT(ACPI_INFO, ("Registering driver for device [%02x].\n", device->handle));
+
+		/* Notify driver of new device. */
+		status = driver->notify(BM_NOTIFY_DEVICE_ADDED, 
+			node->device.handle, &(node->driver.context));
+		if (ACPI_SUCCESS(status)) {
+			node->driver.notify = driver->notify;
+			node->driver.request = driver->request;
+			node->device.flags |= BM_FLAGS_DRIVER_CONTROL;
+		}
+	}
+
+	return_ACPI_STATUS(AE_OK);
+}
+
+
+/****************************************************************************
+ *
+ * FUNCTION:    bm_unregister_driver
+ *
+ * PARAMETERS:  
+ *
+ * RETURN:      
+ *
+ * DESCRIPTION: 
+ *
+ ****************************************************************************/
+
+ACPI_STATUS
+bm_unregister_driver (
+	BM_DEVICE_ID		*criteria,
+	BM_DRIVER		*driver)
+{
+	ACPI_STATUS             status = AE_NOT_FOUND;
+	BM_HANDLE_LIST          device_list;
+	BM_NODE			*node = NULL;
+	BM_DEVICE		*device = NULL;
+	u32                     i = 0;
+
+	FUNCTION_TRACE("bm_unregister_driver");
+
+	if (!criteria || !driver || !driver->notify || !driver->request) {
+		return_ACPI_STATUS(AE_BAD_PARAMETER);
+	}
+
+	MEMSET(&device_list, 0, sizeof(BM_HANDLE_LIST));
+
+	/*
+	 * Find Matches:
+	 * -------------
+	 * Search through the entire device hierarchy for matches against
+	 * the given device criteria.
+	 */
+	status = bm_search(BM_HANDLE_ROOT, criteria, &device_list);
+	if (ACPI_FAILURE(status)) {
+		return_ACPI_STATUS(status);
+	}
+
+	/*
+	 * Remove driver:
+	 * ---------------
+	 * For each match, execute the driver's Notify() function to allow
+	 * the driver to cleanup each device instance.
+	 */
+	for (i = 0; i < device_list.count; i++) {
+
+		/* Resolve the device handle. */
+		status = bm_get_node(device_list.handles[i], 0, &node);
+		if (ACPI_FAILURE(status)) {
+			continue;
+		}
+
+		device = &(node->device);
+
+		/* 
+		 * Make sure driver has really registered for this device. 
+		 */
+		if (!BM_IS_DRIVER_CONTROL(device)) {
+			DEBUG_PRINT(ACPI_INFO, ("Driver hasn't registered for device [%02x].\n", device->handle));
+			continue;
+		}
+
+		DEBUG_PRINT(ACPI_INFO, ("Unregistering driver for device [%02x].\n", device->handle));
+
+		/* Notify driver of device removal. */
+		status = node->driver.notify(BM_NOTIFY_DEVICE_REMOVED, 
+			node->device.handle, &(node->driver.context));
+		if (ACPI_SUCCESS(status)) {
+			node->driver.notify = NULL;
+			node->driver.request = NULL;
+			node->driver.context = NULL;
+			node->device.flags &= ~BM_FLAGS_DRIVER_CONTROL;
+		}
+	}
+
+	return_ACPI_STATUS(AE_OK);
+}

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)