[linux-2.6-block.git] / include / acpi / acobject.h


/******************************************************************************
 *
 * Name: acobject.h - Definition of union acpi_operand_object  (Internal object only)
 *
 *****************************************************************************/

/*
 * Copyright (C) 2000 - 2007, R. Byron Moore
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions, and the following disclaimer,
 *    without modification.
 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
 *    substantially similar to the "NO WARRANTY" disclaimer below
 *    ("Disclaimer") and any redistribution must be conditioned upon
 *    including a substantially similar Disclaimer requirement for further
 *    binary redistribution.
 * 3. Neither the names of the above-listed copyright holders nor the names
 *    of any contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * Alternatively, this software may be distributed under the terms of the
 * GNU General Public License ("GPL") version 2 as published by the Free
 * Software Foundation.
 *
 * NO WARRANTY
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGES.
 */

#ifndef _ACOBJECT_H
#define _ACOBJECT_H

/* acpisrc:struct_defs -- for acpisrc conversion */

/*
 * The union acpi_operand_object is used to pass AML operands from the dispatcher
 * to the interpreter, and to keep track of the various handlers such as
 * address space handlers and notify handlers. The object is a constant
 * size in order to allow it to be cached and reused.
 *
 * Note: The object is optimized to be aligned and will not work if it is
 * byte-packed.
 */
#if ACPI_MACHINE_WIDTH == 64
#pragma pack(8)
#else
#pragma pack(4)
#endif

/*******************************************************************************
 *
 * Common Descriptors
 *
 ******************************************************************************/

/*
 * Common area for all objects.
 *
 * descriptor_type is used to differentiate between internal descriptors, and
 * must be in the same place across all descriptors
 *
 * Note: The descriptor_type and Type fields must appear in the identical
 * position in both the struct acpi_namespace_node and union acpi_operand_object
 * structures.
 */
#define ACPI_OBJECT_COMMON_HEADER \
	union acpi_operand_object       *next_object;       /* Objects linked to parent NS node */\
	u8                              descriptor_type;    /* To differentiate various internal objs */\
	u8                              type;               /* acpi_object_type */\
	u16                             reference_count;    /* For object deletion management */\
	u8                              flags;
	/*
	 * Note: There are 3 bytes available here before the
	 * next natural alignment boundary (for both 32/64 cases)
	 */

/* Values for Flag byte above */

#define AOPOBJ_AML_CONSTANT         0x01
#define AOPOBJ_STATIC_POINTER       0x02
#define AOPOBJ_DATA_VALID           0x04
#define AOPOBJ_OBJECT_INITIALIZED   0x08
#define AOPOBJ_SETUP_COMPLETE       0x10
#define AOPOBJ_SINGLE_DATUM         0x20
#define AOPOBJ_INVALID              0x40	/* Used if host OS won't allow an op_region address */

/******************************************************************************
 *
 * Basic data types
 *
 *****************************************************************************/

struct acpi_object_common {
ACPI_OBJECT_COMMON_HEADER};

struct acpi_object_integer {
	ACPI_OBJECT_COMMON_HEADER u8 fill[3];	/* Prevent warning on some compilers */
	acpi_integer value;
};

/*
 * Note: The String and Buffer object must be identical through the Pointer
 * and length elements.  There is code that depends on this.
 *
 * Fields common to both Strings and Buffers
 */
#define ACPI_COMMON_BUFFER_INFO(_type) \
	_type                           *pointer; \
	u32                             length;

struct acpi_object_string {	/* Null terminated, ASCII characters only */
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_BUFFER_INFO(char)	/* String in AML stream or allocated string */
};

struct acpi_object_buffer {
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_BUFFER_INFO(u8)	/* Buffer in AML stream or allocated buffer */
	u32 aml_length;
	u8 *aml_start;
	struct acpi_namespace_node *node;	/* Link back to parent node */
};

struct acpi_object_package {
	ACPI_OBJECT_COMMON_HEADER struct acpi_namespace_node *node;	/* Link back to parent node */
	union acpi_operand_object **elements;	/* Array of pointers to acpi_objects */
	u8 *aml_start;
	u32 aml_length;
	u32 count;		/* # of elements in package */
};

/******************************************************************************
 *
 * Complex data types
 *
 *****************************************************************************/

struct acpi_object_event {
	ACPI_OBJECT_COMMON_HEADER acpi_semaphore os_semaphore;	/* Actual OS synchronization object */
};

struct acpi_object_mutex {
	ACPI_OBJECT_COMMON_HEADER u8 sync_level;	/* 0-15, specified in Mutex() call */
	u16 acquisition_depth;	/* Allow multiple Acquires, same thread */
	struct acpi_thread_state *owner_thread;	/* Current owner of the mutex */
	acpi_mutex os_mutex;	/* Actual OS synchronization object */
	union acpi_operand_object *prev;	/* Link for list of acquired mutexes */
	union acpi_operand_object *next;	/* Link for list of acquired mutexes */
	struct acpi_namespace_node *node;	/* Containing namespace node */
	u8 original_sync_level;	/* Owner's original sync level (0-15) */
};

struct acpi_object_region {
	ACPI_OBJECT_COMMON_HEADER u8 space_id;
	struct acpi_namespace_node *node;	/* Containing namespace node */
	union acpi_operand_object *handler;	/* Handler for region access */
	union acpi_operand_object *next;
	acpi_physical_address address;
	u32 length;
};

struct acpi_object_method {
	ACPI_OBJECT_COMMON_HEADER u8 method_flags;
	u8 param_count;
	u8 sync_level;
	union acpi_operand_object *mutex;
	u8 *aml_start;
	ACPI_INTERNAL_METHOD implementation;
	u32 aml_length;
	u8 thread_count;
	acpi_owner_id owner_id;
};

/******************************************************************************
 *
 * Objects that can be notified.  All share a common notify_info area.
 *
 *****************************************************************************/

/*
 * Common fields for objects that support ASL notifications
 */
#define ACPI_COMMON_NOTIFY_INFO \
	union acpi_operand_object       *system_notify;     /* Handler for system notifies */\
	union acpi_operand_object       *device_notify;     /* Handler for driver notifies */\
	union acpi_operand_object       *handler;	/* Handler for Address space */

struct acpi_object_notify_common {	/* COMMON NOTIFY for POWER, PROCESSOR, DEVICE, and THERMAL */
ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_NOTIFY_INFO};

struct acpi_object_device {
	ACPI_OBJECT_COMMON_HEADER
	    ACPI_COMMON_NOTIFY_INFO struct acpi_gpe_block_info *gpe_block;
};

struct acpi_object_power_resource {
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_NOTIFY_INFO u32 system_level;
	u32 resource_order;
};

struct acpi_object_processor {
	ACPI_OBJECT_COMMON_HEADER
	    /* The next two fields take advantage of the 3-byte space before NOTIFY_INFO */
	u8 proc_id;
	u8 length;
	 ACPI_COMMON_NOTIFY_INFO acpi_io_address address;
};

struct acpi_object_thermal_zone {
ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_NOTIFY_INFO};

/******************************************************************************
 *
 * Fields.  All share a common header/info field.
 *
 *****************************************************************************/

/*
 * Common bitfield for the field objects
 * "Field Datum"  -- a datum from the actual field object
 * "Buffer Datum" -- a datum from a user buffer, read from or to be written to the field
 */
#define ACPI_COMMON_FIELD_INFO \
	u8                              field_flags;        /* Access, update, and lock bits */\
	u8                              attribute;          /* From access_as keyword */\
	u8                              access_byte_width;  /* Read/Write size in bytes */\
	struct acpi_namespace_node      *node;              /* Link back to parent node */\
	u32                             bit_length;         /* Length of field in bits */\
	u32                             base_byte_offset;   /* Byte offset within containing object */\
	u32                             value;              /* Value to store into the Bank or Index register */\
	u8                              start_field_bit_offset;/* Bit offset within first field datum (0-63) */\
	u8                              access_bit_width;	/* Read/Write size in bits (8-64) */

struct acpi_object_field_common {	/* COMMON FIELD (for BUFFER, REGION, BANK, and INDEX fields) */
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object *region_obj;	/* Parent Operation Region object (REGION/BANK fields only) */
};

struct acpi_object_region_field {
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object *region_obj;	/* Containing op_region object */
};

struct acpi_object_bank_field {
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object *region_obj;	/* Containing op_region object */
	union acpi_operand_object *bank_obj;	/* bank_select Register object */
};

struct acpi_object_index_field {
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO
	    /*
	     * No "RegionObj" pointer needed since the Index and Data registers
	     * are each field definitions unto themselves.
	     */
	union acpi_operand_object *index_obj;	/* Index register */
	union acpi_operand_object *data_obj;	/* Data register */
};

/* The buffer_field is different in that it is part of a Buffer, not an op_region */

struct acpi_object_buffer_field {
	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object *buffer_obj;	/* Containing Buffer object */
};

/******************************************************************************
 *
 * Objects for handlers
 *
 *****************************************************************************/

struct acpi_object_notify_handler {
	ACPI_OBJECT_COMMON_HEADER struct acpi_namespace_node *node;	/* Parent device */
	acpi_notify_handler handler;
	void *context;
};

struct acpi_object_addr_handler {
	ACPI_OBJECT_COMMON_HEADER u8 space_id;
	u8 handler_flags;
	acpi_adr_space_handler handler;
	struct acpi_namespace_node *node;	/* Parent device */
	void *context;
	acpi_adr_space_setup setup;
	union acpi_operand_object *region_list;	/* regions using this handler */
	union acpi_operand_object *next;
};

/* Flags for address handler (handler_flags) */

#define ACPI_ADDR_HANDLER_DEFAULT_INSTALLED  0x01

/******************************************************************************
 *
 * Special internal objects
 *
 *****************************************************************************/

/*
 * The Reference object type is used for these opcodes:
 * Arg[0-6], Local[0-7], index_op, name_op, zero_op, one_op, ones_op, debug_op
 */
struct acpi_object_reference {
	ACPI_OBJECT_COMMON_HEADER u8 target_type;	/* Used for index_op */
	u16 opcode;
	void *object;		/* name_op=>HANDLE to obj, index_op=>union acpi_operand_object */
	struct acpi_namespace_node *node;
	union acpi_operand_object **where;
	u32 offset;		/* Used for arg_op, local_op, and index_op */
};

/*
 * Extra object is used as additional storage for types that
 * have AML code in their declarations (term_args) that must be
 * evaluated at run time.
 *
 * Currently: Region and field_unit types
 */
struct acpi_object_extra {
	ACPI_OBJECT_COMMON_HEADER struct acpi_namespace_node *method_REG;	/* _REG method for this region (if any) */
	void *region_context;	/* Region-specific data */
	u8 *aml_start;
	u32 aml_length;
};

/* Additional data that can be attached to namespace nodes */

struct acpi_object_data {
	ACPI_OBJECT_COMMON_HEADER acpi_object_handler handler;
	void *pointer;
};

/* Structure used when objects are cached for reuse */

struct acpi_object_cache_list {
	ACPI_OBJECT_COMMON_HEADER union acpi_operand_object *next;	/* Link for object cache and internal lists */
};

/******************************************************************************
 *
 * union acpi_operand_object Descriptor - a giant union of all of the above
 *
 *****************************************************************************/

union acpi_operand_object {
	struct acpi_object_common common;
	struct acpi_object_integer integer;
	struct acpi_object_string string;
	struct acpi_object_buffer buffer;
	struct acpi_object_package package;
	struct acpi_object_event event;
	struct acpi_object_method method;
	struct acpi_object_mutex mutex;
	struct acpi_object_region region;
	struct acpi_object_notify_common common_notify;
	struct acpi_object_device device;
	struct acpi_object_power_resource power_resource;
	struct acpi_object_processor processor;
	struct acpi_object_thermal_zone thermal_zone;
	struct acpi_object_field_common common_field;
	struct acpi_object_region_field field;
	struct acpi_object_buffer_field buffer_field;
	struct acpi_object_bank_field bank_field;
	struct acpi_object_index_field index_field;
	struct acpi_object_notify_handler notify;
	struct acpi_object_addr_handler address_space;
	struct acpi_object_reference reference;
	struct acpi_object_extra extra;
	struct acpi_object_data data;
	struct acpi_object_cache_list cache;
};

/******************************************************************************
 *
 * union acpi_descriptor - objects that share a common descriptor identifier
 *
 *****************************************************************************/

/* Object descriptor types */

#define ACPI_DESC_TYPE_CACHED           0x01	/* Used only when object is cached */
#define ACPI_DESC_TYPE_STATE            0x02
#define ACPI_DESC_TYPE_STATE_UPDATE     0x03
#define ACPI_DESC_TYPE_STATE_PACKAGE    0x04
#define ACPI_DESC_TYPE_STATE_CONTROL    0x05
#define ACPI_DESC_TYPE_STATE_RPSCOPE    0x06
#define ACPI_DESC_TYPE_STATE_PSCOPE     0x07
#define ACPI_DESC_TYPE_STATE_WSCOPE     0x08
#define ACPI_DESC_TYPE_STATE_RESULT     0x09
#define ACPI_DESC_TYPE_STATE_NOTIFY     0x0A
#define ACPI_DESC_TYPE_STATE_THREAD     0x0B
#define ACPI_DESC_TYPE_WALK             0x0C
#define ACPI_DESC_TYPE_PARSER           0x0D
#define ACPI_DESC_TYPE_OPERAND          0x0E
#define ACPI_DESC_TYPE_NAMED            0x0F
#define ACPI_DESC_TYPE_MAX              0x0F

struct acpi_common_descriptor {
	void *common_pointer;
	u8 descriptor_type;	/* To differentiate various internal objs */
};

union acpi_descriptor {
	struct acpi_common_descriptor common;
	union acpi_operand_object object;
	struct acpi_namespace_node node;
	union acpi_parse_object op;
};

#pragma pack()

#endif				/* _ACOBJECT_H */
Commit	Line	Data
1da177e4 LT	1
	2	/******************************************************************************
	3	*
61686124	4	* Name: acobject.h - Definition of union acpi_operand_object (Internal object only)
1da177e4 LT	5	*
	6	*****************************************************************************/
	7
	8	/*
6c9deb72	9	* Copyright (C) 2000 - 2007, R. Byron Moore
1da177e4 LT	10	* All rights reserved.
	11	*
	12	* Redistribution and use in source and binary forms, with or without
	13	* modification, are permitted provided that the following conditions
	14	* are met:
	15	* 1. Redistributions of source code must retain the above copyright
	16	* notice, this list of conditions, and the following disclaimer,
	17	* without modification.
	18	* 2. Redistributions in binary form must reproduce at minimum a disclaimer
	19	* substantially similar to the "NO WARRANTY" disclaimer below
	20	* ("Disclaimer") and any redistribution must be conditioned upon
	21	* including a substantially similar Disclaimer requirement for further
	22	* binary redistribution.
	23	* 3. Neither the names of the above-listed copyright holders nor the names
	24	* of any contributors may be used to endorse or promote products derived
	25	* from this software without specific prior written permission.
	26	*
	27	* Alternatively, this software may be distributed under the terms of the
	28	* GNU General Public License ("GPL") version 2 as published by the Free
	29	* Software Foundation.
	30	*
	31	* NO WARRANTY
	32	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	33	* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	34	* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
	35	* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	36	* HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	37	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	38	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	39	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
	40	* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
	41	* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
	42	* POSSIBILITY OF SUCH DAMAGES.
	43	*/
	44
	45	#ifndef _ACOBJECT_H
	46	#define _ACOBJECT_H
	47
61686124 BM	48	/* acpisrc:struct_defs -- for acpisrc conversion */
61686124 BM	49
1da177e4	50	/*
61686124	51	* The union acpi_operand_object is used to pass AML operands from the dispatcher
1da177e4	52	* to the interpreter, and to keep track of the various handlers such as
61686124	53	* address space handlers and notify handlers. The object is a constant
1da177e4	54	* size in order to allow it to be cached and reused.
7c9626ba BM	55	*
	56	* Note: The object is optimized to be aligned and will not work if it is
	57	* byte-packed.
1da177e4	58	*/
7c9626ba BM	59	#if ACPI_MACHINE_WIDTH == 64
	60	#pragma pack(8)
	61	#else
	62	#pragma pack(4)
	63	#endif
1da177e4 LT	64
	65	/*******************************************************************************
	66	*
	67	* Common Descriptors
	68	*
	69	******************************************************************************/
	70
	71	/*
	72	* Common area for all objects.
	73	*
61686124 BM	74	* descriptor_type is used to differentiate between internal descriptors, and
61686124 BM	75	* must be in the same place across all descriptors
793c2388 BM	76	*
	77	* Note: The descriptor_type and Type fields must appear in the identical
	78	* position in both the struct acpi_namespace_node and union acpi_operand_object
	79	* structures.
1da177e4	80	*/
61686124 BM	81	#define ACPI_OBJECT_COMMON_HEADER \
	82	union acpi_operand_object next_object; / Objects linked to parent NS node */\
	83	u8 descriptor_type; /* To differentiate various internal objs */\
	84	u8 type; /* acpi_object_type */\
	85	u16 reference_count; /* For object deletion management */\
	86	u8 flags;
	87	/*
	88	* Note: There are 3 bytes available here before the
	89	* next natural alignment boundary (for both 32/64 cases)
	90	*/
	91
	92	/* Values for Flag byte above */
1da177e4 LT	93
	94	#define AOPOBJ_AML_CONSTANT 0x01
	95	#define AOPOBJ_STATIC_POINTER 0x02
	96	#define AOPOBJ_DATA_VALID 0x04
	97	#define AOPOBJ_OBJECT_INITIALIZED 0x08
	98	#define AOPOBJ_SETUP_COMPLETE 0x10
	99	#define AOPOBJ_SINGLE_DATUM 0x20
b229cf92	100	#define AOPOBJ_INVALID 0x40 /* Used if host OS won't allow an op_region address */
1da177e4	101
1da177e4 LT	102	/******************************************************************************
	103	*
	104	* Basic data types
	105	*
	106	*****************************************************************************/
	107
4be44fcd LB	108	struct acpi_object_common {
4be44fcd LB	109	ACPI_OBJECT_COMMON_HEADER};
1da177e4	110
4be44fcd	111	struct acpi_object_integer {
7c9626ba BM	112	ACPI_OBJECT_COMMON_HEADER u8 fill[3]; /* Prevent warning on some compilers */
7c9626ba BM	113	acpi_integer value;
1da177e4 LT	114	};
	115
	116	/*
	117	* Note: The String and Buffer object must be identical through the Pointer
61686124 BM	118	* and length elements. There is code that depends on this.
	119	*
	120	* Fields common to both Strings and Buffers
1da177e4	121	*/
61686124 BM	122	#define ACPI_COMMON_BUFFER_INFO(_type) \
	123	_type *pointer; \
	124	u32 length;
	125
4be44fcd	126	struct acpi_object_string { /* Null terminated, ASCII characters only */
61686124	127	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_BUFFER_INFO(char) /* String in AML stream or allocated string */
1da177e4 LT	128	};
1da177e4 LT	129
4be44fcd	130	struct acpi_object_buffer {
61686124	131	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_BUFFER_INFO(u8) /* Buffer in AML stream or allocated buffer */
4be44fcd	132	u32 aml_length;
61686124 BM	133	u8 *aml_start;
61686124 BM	134	struct acpi_namespace_node node; / Link back to parent node */
1da177e4 LT	135	};
1da177e4 LT	136
4be44fcd	137	struct acpi_object_package {
61686124	138	ACPI_OBJECT_COMMON_HEADER struct acpi_namespace_node node; / Link back to parent node */
4be44fcd	139	union acpi_operand_object *elements; / Array of pointers to acpi_objects */
61686124 BM	140	u8 *aml_start;
	141	u32 aml_length;
	142	u32 count; /* # of elements in package */
1da177e4 LT	143	};
1da177e4 LT	144
1da177e4 LT	145	/******************************************************************************
	146	*
	147	* Complex data types
	148	*
	149	*****************************************************************************/
	150
4be44fcd	151	struct acpi_object_event {
967440e3	152	ACPI_OBJECT_COMMON_HEADER acpi_semaphore os_semaphore; /* Actual OS synchronization object */
1da177e4 LT	153	};
1da177e4 LT	154
4be44fcd LB	155	struct acpi_object_mutex {
	156	ACPI_OBJECT_COMMON_HEADER u8 sync_level; /* 0-15, specified in Mutex() call */
	157	u16 acquisition_depth; /* Allow multiple Acquires, same thread */
262a7a28	158	struct acpi_thread_state owner_thread; / Current owner of the mutex */
967440e3	159	acpi_mutex os_mutex; /* Actual OS synchronization object */
4be44fcd LB	160	union acpi_operand_object prev; / Link for list of acquired mutexes */
	161	union acpi_operand_object next; / Link for list of acquired mutexes */
	162	struct acpi_namespace_node node; / Containing namespace node */
	163	u8 original_sync_level; /* Owner's original sync level (0-15) */
1da177e4 LT	164	};
1da177e4 LT	165
4be44fcd LB	166	struct acpi_object_region {
4be44fcd LB	167	ACPI_OBJECT_COMMON_HEADER u8 space_id;
4be44fcd	168	struct acpi_namespace_node node; / Containing namespace node */
61686124	169	union acpi_operand_object handler; / Handler for region access */
4be44fcd	170	union acpi_operand_object *next;
4be44fcd	171	acpi_physical_address address;
61686124 BM	172	u32 length;
	173	};
	174
	175	struct acpi_object_method {
	176	ACPI_OBJECT_COMMON_HEADER u8 method_flags;
	177	u8 param_count;
967440e3 BM	178	u8 sync_level;
967440e3 BM	179	union acpi_operand_object *mutex;
61686124 BM	180	u8 *aml_start;
	181	ACPI_INTERNAL_METHOD implementation;
	182	u32 aml_length;
	183	u8 thread_count;
	184	acpi_owner_id owner_id;
1da177e4 LT	185	};
1da177e4 LT	186
1da177e4 LT	187	/******************************************************************************
	188	*
	189	* Objects that can be notified. All share a common notify_info area.
	190	*
	191	*****************************************************************************/
	192
61686124 BM	193	/*
	194	* Common fields for objects that support ASL notifications
	195	*/
	196	#define ACPI_COMMON_NOTIFY_INFO \
	197	union acpi_operand_object system_notify; / Handler for system notifies */\
	198	union acpi_operand_object device_notify; / Handler for driver notifies */\
	199	union acpi_operand_object handler; / Handler for Address space */
	200
4be44fcd LB	201	struct acpi_object_notify_common { /* COMMON NOTIFY for POWER, PROCESSOR, DEVICE, and THERMAL */
4be44fcd LB	202	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_NOTIFY_INFO};
1da177e4	203
4be44fcd	204	struct acpi_object_device {
1da177e4	205	ACPI_OBJECT_COMMON_HEADER
4be44fcd	206	ACPI_COMMON_NOTIFY_INFO struct acpi_gpe_block_info *gpe_block;
1da177e4 LT	207	};
1da177e4 LT	208
4be44fcd LB	209	struct acpi_object_power_resource {
	210	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_NOTIFY_INFO u32 system_level;
	211	u32 resource_order;
1da177e4 LT	212	};
1da177e4 LT	213
4be44fcd	214	struct acpi_object_processor {
7c9626ba BM	215	ACPI_OBJECT_COMMON_HEADER
	216	/* The next two fields take advantage of the 3-byte space before NOTIFY_INFO */
	217	u8 proc_id;
61686124 BM	218	u8 length;
61686124 BM	219	ACPI_COMMON_NOTIFY_INFO acpi_io_address address;
1da177e4 LT	220	};
1da177e4 LT	221
4be44fcd LB	222	struct acpi_object_thermal_zone {
4be44fcd LB	223	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_NOTIFY_INFO};
1da177e4 LT	224
	225	/******************************************************************************
	226	*
	227	* Fields. All share a common header/info field.
	228	*
	229	*****************************************************************************/
	230
61686124 BM	231	/*
	232	* Common bitfield for the field objects
	233	* "Field Datum" -- a datum from the actual field object
	234	* "Buffer Datum" -- a datum from a user buffer, read from or to be written to the field
	235	*/
	236	#define ACPI_COMMON_FIELD_INFO \
	237	u8 field_flags; /* Access, update, and lock bits */\
	238	u8 attribute; /* From access_as keyword */\
	239	u8 access_byte_width; /* Read/Write size in bytes */\
	240	struct acpi_namespace_node node; / Link back to parent node */\
	241	u32 bit_length; /* Length of field in bits */\
	242	u32 base_byte_offset; /* Byte offset within containing object */\
	243	u32 value; /* Value to store into the Bank or Index register */\
	244	u8 start_field_bit_offset;/* Bit offset within first field datum (0-63) */\
	245	u8 access_bit_width; /* Read/Write size in bits (8-64) */
	246
4be44fcd	247	struct acpi_object_field_common { /* COMMON FIELD (for BUFFER, REGION, BANK, and INDEX fields) */
61686124	248	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object region_obj; / Parent Operation Region object (REGION/BANK fields only) */
1da177e4 LT	249	};
1da177e4 LT	250
4be44fcd LB	251	struct acpi_object_region_field {
4be44fcd LB	252	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object region_obj; / Containing op_region object */
1da177e4 LT	253	};
1da177e4 LT	254
4be44fcd LB	255	struct acpi_object_bank_field {
	256	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object region_obj; / Containing op_region object */
	257	union acpi_operand_object bank_obj; / bank_select Register object */
1da177e4 LT	258	};
1da177e4 LT	259
4be44fcd LB	260	struct acpi_object_index_field {
	261	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO
	262	/*
b229cf92	263	* No "RegionObj" pointer needed since the Index and Data registers
4be44fcd LB	264	* are each field definitions unto themselves.
	265	*/
	266	union acpi_operand_object index_obj; / Index register */
	267	union acpi_operand_object data_obj; / Data register */
1da177e4 LT	268	};
1da177e4 LT	269
1da177e4 LT	270	/* The buffer_field is different in that it is part of a Buffer, not an op_region */
1da177e4 LT	271
4be44fcd LB	272	struct acpi_object_buffer_field {
4be44fcd LB	273	ACPI_OBJECT_COMMON_HEADER ACPI_COMMON_FIELD_INFO union acpi_operand_object buffer_obj; / Containing Buffer object */
1da177e4 LT	274	};
1da177e4 LT	275
1da177e4 LT	276	/******************************************************************************
	277	*
	278	* Objects for handlers
	279	*
	280	*****************************************************************************/
	281
4be44fcd LB	282	struct acpi_object_notify_handler {
	283	ACPI_OBJECT_COMMON_HEADER struct acpi_namespace_node node; / Parent device */
	284	acpi_notify_handler handler;
	285	void *context;
1da177e4 LT	286	};
1da177e4 LT	287
4be44fcd LB	288	struct acpi_object_addr_handler {
4be44fcd LB	289	ACPI_OBJECT_COMMON_HEADER u8 space_id;
61686124	290	u8 handler_flags;
4be44fcd LB	291	acpi_adr_space_handler handler;
	292	struct acpi_namespace_node node; / Parent device */
	293	void *context;
	294	acpi_adr_space_setup setup;
	295	union acpi_operand_object region_list; / regions using this handler */
	296	union acpi_operand_object *next;
1da177e4 LT	297	};
1da177e4 LT	298
61686124 BM	299	/* Flags for address handler (handler_flags) */
	300
	301	#define ACPI_ADDR_HANDLER_DEFAULT_INSTALLED 0x01
	302
1da177e4 LT	303	/******************************************************************************
	304	*
	305	* Special internal objects
	306	*
	307	*****************************************************************************/
	308
	309	/*
	310	* The Reference object type is used for these opcodes:
	311	* Arg[0-6], Local[0-7], index_op, name_op, zero_op, one_op, ones_op, debug_op
	312	*/
4be44fcd LB	313	struct acpi_object_reference {
	314	ACPI_OBJECT_COMMON_HEADER u8 target_type; /* Used for index_op */
	315	u16 opcode;
61686124	316	void object; / name_op=>HANDLE to obj, index_op=>union acpi_operand_object */
4be44fcd LB	317	struct acpi_namespace_node *node;
4be44fcd LB	318	union acpi_operand_object **where;
61686124	319	u32 offset; /* Used for arg_op, local_op, and index_op */
1da177e4 LT	320	};
1da177e4 LT	321
1da177e4 LT	322	/*
	323	* Extra object is used as additional storage for types that
	324	* have AML code in their declarations (term_args) that must be
	325	* evaluated at run time.
	326	*
	327	* Currently: Region and field_unit types
	328	*/
4be44fcd	329	struct acpi_object_extra {
61686124	330	ACPI_OBJECT_COMMON_HEADER struct acpi_namespace_node method_REG; / _REG method for this region (if any) */
4be44fcd	331	void region_context; / Region-specific data */
61686124 BM	332	u8 *aml_start;
61686124 BM	333	u32 aml_length;
1da177e4 LT	334	};
1da177e4 LT	335
1da177e4 LT	336	/* Additional data that can be attached to namespace nodes */
1da177e4 LT	337
4be44fcd LB	338	struct acpi_object_data {
	339	ACPI_OBJECT_COMMON_HEADER acpi_object_handler handler;
	340	void *pointer;
1da177e4 LT	341	};
1da177e4 LT	342
1da177e4 LT	343	/* Structure used when objects are cached for reuse */
1da177e4 LT	344
4be44fcd LB	345	struct acpi_object_cache_list {
4be44fcd LB	346	ACPI_OBJECT_COMMON_HEADER union acpi_operand_object next; / Link for object cache and internal lists */
1da177e4 LT	347	};
1da177e4 LT	348
1da177e4 LT	349	/******************************************************************************
	350	*
	351	* union acpi_operand_object Descriptor - a giant union of all of the above
	352	*
	353	*****************************************************************************/
	354
4be44fcd LB	355	union acpi_operand_object {
	356	struct acpi_object_common common;
	357	struct acpi_object_integer integer;
	358	struct acpi_object_string string;
	359	struct acpi_object_buffer buffer;
	360	struct acpi_object_package package;
	361	struct acpi_object_event event;
	362	struct acpi_object_method method;
	363	struct acpi_object_mutex mutex;
	364	struct acpi_object_region region;
	365	struct acpi_object_notify_common common_notify;
	366	struct acpi_object_device device;
	367	struct acpi_object_power_resource power_resource;
	368	struct acpi_object_processor processor;
	369	struct acpi_object_thermal_zone thermal_zone;
	370	struct acpi_object_field_common common_field;
	371	struct acpi_object_region_field field;
	372	struct acpi_object_buffer_field buffer_field;
	373	struct acpi_object_bank_field bank_field;
	374	struct acpi_object_index_field index_field;
	375	struct acpi_object_notify_handler notify;
	376	struct acpi_object_addr_handler address_space;
	377	struct acpi_object_reference reference;
	378	struct acpi_object_extra extra;
	379	struct acpi_object_data data;
	380	struct acpi_object_cache_list cache;
1da177e4 LT	381	};
1da177e4 LT	382
1da177e4 LT	383	/******************************************************************************
	384	*
	385	* union acpi_descriptor - objects that share a common descriptor identifier
	386	*
	387	*****************************************************************************/
	388
1da177e4 LT	389	/* Object descriptor types */
1da177e4 LT	390
4be44fcd	391	#define ACPI_DESC_TYPE_CACHED 0x01 /* Used only when object is cached */
1da177e4 LT	392	#define ACPI_DESC_TYPE_STATE 0x02
	393	#define ACPI_DESC_TYPE_STATE_UPDATE 0x03
	394	#define ACPI_DESC_TYPE_STATE_PACKAGE 0x04
	395	#define ACPI_DESC_TYPE_STATE_CONTROL 0x05
	396	#define ACPI_DESC_TYPE_STATE_RPSCOPE 0x06
	397	#define ACPI_DESC_TYPE_STATE_PSCOPE 0x07
	398	#define ACPI_DESC_TYPE_STATE_WSCOPE 0x08
	399	#define ACPI_DESC_TYPE_STATE_RESULT 0x09
	400	#define ACPI_DESC_TYPE_STATE_NOTIFY 0x0A
	401	#define ACPI_DESC_TYPE_STATE_THREAD 0x0B
	402	#define ACPI_DESC_TYPE_WALK 0x0C
	403	#define ACPI_DESC_TYPE_PARSER 0x0D
	404	#define ACPI_DESC_TYPE_OPERAND 0x0E
	405	#define ACPI_DESC_TYPE_NAMED 0x0F
	406	#define ACPI_DESC_TYPE_MAX 0x0F
	407
61686124 BM	408	struct acpi_common_descriptor {
	409	void *common_pointer;
	410	u8 descriptor_type; /* To differentiate various internal objs */
	411	};
	412
4be44fcd	413	union acpi_descriptor {
61686124	414	struct acpi_common_descriptor common;
4be44fcd LB	415	union acpi_operand_object object;
	416	struct acpi_namespace_node node;
	417	union acpi_parse_object op;
1da177e4 LT	418	};
1da177e4 LT	419
7c9626ba BM	420	#pragma pack()
7c9626ba BM	421
4be44fcd	422	#endif /* _ACOBJECT_H */