Linux Audio

Check our new training course

Loading...
v3.1
  1
  2/******************************************************************************
  3 *
  4 * Name: acpixf.h - External interfaces to the ACPI subsystem
  5 *
  6 *****************************************************************************/
  7
  8/*
  9 * Copyright (C) 2000 - 2011, Intel Corp.
 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 __ACXFACE_H__
 46#define __ACXFACE_H__
 47
 48/* Current ACPICA subsystem version in YYYYMMDD format */
 49
 50#define ACPI_CA_VERSION                 0x20110623
 51
 
 52#include "actypes.h"
 53#include "actbl.h"
 54
 55extern u8 acpi_gbl_permanent_mmap;
 56
 57/*
 58 * Globals that are publicly available, allowing for
 59 * run time configuration
 60 */
 61extern u32 acpi_dbg_level;
 62extern u32 acpi_dbg_layer;
 63extern u8 acpi_gbl_enable_interpreter_slack;
 64extern u8 acpi_gbl_all_methods_serialized;
 65extern u8 acpi_gbl_create_osi_method;
 66extern u8 acpi_gbl_use_default_register_widths;
 67extern acpi_name acpi_gbl_trace_method_name;
 68extern u32 acpi_gbl_trace_flags;
 69extern u32 acpi_gbl_enable_aml_debug_object;
 70extern u8 acpi_gbl_copy_dsdt_locally;
 71extern u8 acpi_gbl_truncate_io_addresses;
 72extern u8 acpi_gbl_disable_auto_repair;
 73
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 74extern u32 acpi_current_gpe_count;
 75extern struct acpi_table_fadt acpi_gbl_FADT;
 76extern u8 acpi_gbl_system_awake_and_running;
 
 77
 78extern u32 acpi_rsdt_forced;
 79/*
 80 * Global interfaces
 81 */
 82acpi_status
 83acpi_initialize_tables(struct acpi_table_desc *initial_storage,
 84		       u32 initial_table_count, u8 allow_resize);
 85
 86acpi_status __init acpi_initialize_subsystem(void);
 87
 88acpi_status acpi_enable_subsystem(u32 flags);
 89
 90acpi_status acpi_initialize_objects(u32 flags);
 91
 92acpi_status acpi_terminate(void);
 93
 94#ifdef ACPI_FUTURE_USAGE
 95acpi_status acpi_subsystem_status(void);
 96#endif
 97
 98acpi_status acpi_enable(void);
 99
100acpi_status acpi_disable(void);
101
102#ifdef ACPI_FUTURE_USAGE
103acpi_status acpi_get_system_info(struct acpi_buffer *ret_buffer);
104#endif
105
106const char *acpi_format_exception(acpi_status exception);
107
108acpi_status acpi_purge_cached_objects(void);
109
110acpi_status acpi_install_interface(acpi_string interface_name);
111
112acpi_status acpi_remove_interface(acpi_string interface_name);
113
 
 
 
 
 
114/*
115 * ACPI Memory management
116 */
117void *acpi_allocate(u32 size);
118
119void *acpi_callocate(u32 size);
120
121void acpi_free(void *address);
122
123/*
124 * ACPI table manipulation interfaces
125 */
126acpi_status acpi_reallocate_root_table(void);
127
128acpi_status acpi_find_root_pointer(acpi_size *rsdp_address);
129
130acpi_status acpi_load_tables(void);
131
132acpi_status acpi_load_table(struct acpi_table_header *table_ptr);
133
134acpi_status acpi_unload_table_id(acpi_owner_id id);
135
136acpi_status
137acpi_get_table_header(acpi_string signature,
138		      u32 instance,
139		      struct acpi_table_header *out_table_header);
140
141acpi_status
142acpi_get_table_with_size(acpi_string signature,
143	       u32 instance, struct acpi_table_header **out_table,
144	       acpi_size *tbl_size);
145acpi_status
146acpi_get_table(acpi_string signature,
147	       u32 instance, struct acpi_table_header **out_table);
148
149acpi_status
150acpi_get_table_by_index(u32 table_index,
151			struct acpi_table_header **out_table);
152
153acpi_status
154acpi_install_table_handler(acpi_tbl_handler handler, void *context);
155
156acpi_status acpi_remove_table_handler(acpi_tbl_handler handler);
157
158/*
159 * Namespace and name interfaces
160 */
161acpi_status
162acpi_walk_namespace(acpi_object_type type,
163		    acpi_handle start_object,
164		    u32 max_depth,
165		    acpi_walk_callback pre_order_visit,
166		    acpi_walk_callback post_order_visit,
167		    void *context, void **return_value);
168
169acpi_status
170acpi_get_devices(const char *HID,
171		 acpi_walk_callback user_function,
172		 void *context, void **return_value);
173
174acpi_status
175acpi_get_name(acpi_handle object,
176	      u32 name_type, struct acpi_buffer *ret_path_ptr);
177
178acpi_status
179acpi_get_handle(acpi_handle parent,
180		acpi_string pathname, acpi_handle * ret_handle);
181
182acpi_status
183acpi_attach_data(acpi_handle object, acpi_object_handler handler, void *data);
184
185acpi_status acpi_detach_data(acpi_handle object, acpi_object_handler handler);
186
187acpi_status
188acpi_get_data(acpi_handle object, acpi_object_handler handler, void **data);
189
190acpi_status
191acpi_debug_trace(char *name, u32 debug_level, u32 debug_layer, u32 flags);
192
193/*
194 * Object manipulation and enumeration
195 */
196acpi_status
197acpi_evaluate_object(acpi_handle object,
198		     acpi_string pathname,
199		     struct acpi_object_list *parameter_objects,
200		     struct acpi_buffer *return_object_buffer);
201
202acpi_status
203acpi_evaluate_object_typed(acpi_handle object,
204			   acpi_string pathname,
205			   struct acpi_object_list *external_params,
206			   struct acpi_buffer *return_buffer,
207			   acpi_object_type return_type);
208
209acpi_status
210acpi_get_object_info(acpi_handle object,
211		     struct acpi_device_info **return_buffer);
212
213acpi_status acpi_install_method(u8 *buffer);
214
215acpi_status
216acpi_get_next_object(acpi_object_type type,
217		     acpi_handle parent,
218		     acpi_handle child, acpi_handle * out_handle);
219
220acpi_status acpi_get_type(acpi_handle object, acpi_object_type * out_type);
221
222acpi_status acpi_get_id(acpi_handle object, acpi_owner_id * out_type);
223
224acpi_status acpi_get_parent(acpi_handle object, acpi_handle * out_handle);
225
226/*
227 * Handler interfaces
228 */
229acpi_status
230acpi_install_initialization_handler(acpi_init_handler handler, u32 function);
231
232acpi_status
233acpi_install_global_event_handler(ACPI_GBL_EVENT_HANDLER handler,
234				 void *context);
235
236acpi_status
237acpi_install_fixed_event_handler(u32 acpi_event,
238				 acpi_event_handler handler, void *context);
239
240acpi_status
241acpi_remove_fixed_event_handler(u32 acpi_event, acpi_event_handler handler);
242
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
243acpi_status
244acpi_install_notify_handler(acpi_handle device,
245			    u32 handler_type,
246			    acpi_notify_handler handler, void *context);
247
248acpi_status
249acpi_remove_notify_handler(acpi_handle device,
250			   u32 handler_type, acpi_notify_handler handler);
251
252acpi_status
253acpi_install_address_space_handler(acpi_handle device,
254				   acpi_adr_space_type space_id,
255				   acpi_adr_space_handler handler,
256				   acpi_adr_space_setup setup, void *context);
257
258acpi_status
259acpi_remove_address_space_handler(acpi_handle device,
260				  acpi_adr_space_type space_id,
261				  acpi_adr_space_handler handler);
262
263acpi_status
264acpi_install_gpe_handler(acpi_handle gpe_device,
265			 u32 gpe_number,
266			 u32 type, acpi_gpe_handler address, void *context);
267
268acpi_status
269acpi_remove_gpe_handler(acpi_handle gpe_device,
270			u32 gpe_number, acpi_gpe_handler address);
271
272#ifdef ACPI_FUTURE_USAGE
273acpi_status acpi_install_exception_handler(acpi_exception_handler handler);
274#endif
275
276acpi_status acpi_install_interface_handler(acpi_interface_handler handler);
277
278/*
279 * Event interfaces
280 */
281acpi_status acpi_acquire_global_lock(u16 timeout, u32 * handle);
 
 
 
 
282
283acpi_status acpi_release_global_lock(u32 handle);
 
 
 
 
284
285acpi_status acpi_enable_event(u32 event, u32 flags);
286
287acpi_status acpi_disable_event(u32 event, u32 flags);
 
 
 
 
288
289acpi_status acpi_clear_event(u32 event);
 
290
291acpi_status acpi_get_event_status(u32 event, acpi_event_status * event_status);
292
 
 
 
 
293/*
294 * GPE Interfaces
295 */
296acpi_status acpi_enable_gpe(acpi_handle gpe_device, u32 gpe_number);
297
298acpi_status acpi_disable_gpe(acpi_handle gpe_device, u32 gpe_number);
 
 
299
300acpi_status acpi_clear_gpe(acpi_handle gpe_device, u32 gpe_number);
 
 
301
302acpi_status
303acpi_setup_gpe_for_wake(acpi_handle parent_device,
304			acpi_handle gpe_device, u32 gpe_number);
305
306acpi_status acpi_set_gpe_wake_mask(acpi_handle gpe_device, u32 gpe_number, u8 action);
 
 
307
308acpi_status
309acpi_get_gpe_status(acpi_handle gpe_device,
310		    u32 gpe_number, acpi_event_status *event_status);
311
312acpi_status acpi_disable_all_gpes(void);
 
 
 
 
 
 
 
 
 
 
 
 
 
313
314acpi_status acpi_enable_all_runtime_gpes(void);
315
316acpi_status acpi_get_gpe_device(u32 gpe_index, acpi_handle *gpe_device);
317
318acpi_status
319acpi_install_gpe_block(acpi_handle gpe_device,
320		       struct acpi_generic_address *gpe_block_address,
321		       u32 register_count, u32 interrupt_number);
322
323acpi_status acpi_remove_gpe_block(acpi_handle gpe_device);
324
325acpi_status acpi_update_all_gpes(void);
 
 
 
 
 
 
326
327/*
328 * Resource interfaces
329 */
330typedef
331acpi_status(*acpi_walk_resource_callback) (struct acpi_resource * resource,
332					   void *context);
333
334acpi_status
335acpi_get_vendor_resource(acpi_handle device,
336			 char *name,
337			 struct acpi_vendor_uuid *uuid,
338			 struct acpi_buffer *ret_buffer);
339
340acpi_status
341acpi_get_current_resources(acpi_handle device, struct acpi_buffer *ret_buffer);
342
343#ifdef ACPI_FUTURE_USAGE
344acpi_status
345acpi_get_possible_resources(acpi_handle device, struct acpi_buffer *ret_buffer);
346#endif
347
348acpi_status
 
 
 
 
349acpi_walk_resources(acpi_handle device,
350		    char *name,
351		    acpi_walk_resource_callback user_function, void *context);
352
353acpi_status
354acpi_set_current_resources(acpi_handle device, struct acpi_buffer *in_buffer);
355
356acpi_status
357acpi_get_irq_routing_table(acpi_handle device, struct acpi_buffer *ret_buffer);
358
359acpi_status
360acpi_resource_to_address64(struct acpi_resource *resource,
361			   struct acpi_resource_address64 *out);
362
 
 
 
 
 
363/*
364 * Hardware (ACPI device) interfaces
365 */
366acpi_status acpi_reset(void);
367
368acpi_status acpi_read_bit_register(u32 register_id, u32 *return_value);
369
370acpi_status acpi_write_bit_register(u32 register_id, u32 value);
371
372acpi_status acpi_set_firmware_waking_vector(u32 physical_address);
 
 
 
 
 
 
373
374#if ACPI_MACHINE_WIDTH == 64
375acpi_status acpi_set_firmware_waking_vector64(u64 physical_address);
 
 
376#endif
377
378acpi_status acpi_read(u64 *value, struct acpi_generic_address *reg);
379
380acpi_status acpi_write(u64 value, struct acpi_generic_address *reg);
381
 
 
 
382acpi_status
383acpi_get_sleep_type_data(u8 sleep_state, u8 * slp_typ_a, u8 * slp_typ_b);
384
385acpi_status acpi_enter_sleep_state_prep(u8 sleep_state);
386
387acpi_status asmlinkage acpi_enter_sleep_state(u8 sleep_state);
388
389acpi_status asmlinkage acpi_enter_sleep_state_s4bios(void);
390
391acpi_status acpi_leave_sleep_state_prep(u8 sleep_state);
392
393acpi_status acpi_leave_sleep_state(u8 sleep_state);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
394
395/*
396 * Error/Warning output
397 */
398void ACPI_INTERNAL_VAR_XFACE
399acpi_error(const char *module_name,
400	   u32 line_number, const char *format, ...) ACPI_PRINTF_LIKE(3);
401
402void ACPI_INTERNAL_VAR_XFACE
403acpi_exception(const char *module_name,
404	       u32 line_number,
405	       acpi_status status, const char *format, ...) ACPI_PRINTF_LIKE(4);
406
407void ACPI_INTERNAL_VAR_XFACE
408acpi_warning(const char *module_name,
409	     u32 line_number, const char *format, ...) ACPI_PRINTF_LIKE(3);
410
411void ACPI_INTERNAL_VAR_XFACE
412acpi_info(const char *module_name,
413	  u32 line_number, const char *format, ...) ACPI_PRINTF_LIKE(3);
414
415/*
416 * Debug output
417 */
418#ifdef ACPI_DEBUG_OUTPUT
419
420void ACPI_INTERNAL_VAR_XFACE
421acpi_debug_print(u32 requested_debug_level,
422		 u32 line_number,
423		 const char *function_name,
424		 const char *module_name,
425		 u32 component_id, const char *format, ...) ACPI_PRINTF_LIKE(6);
426
427void ACPI_INTERNAL_VAR_XFACE
428acpi_debug_print_raw(u32 requested_debug_level,
429		     u32 line_number,
430		     const char *function_name,
431		     const char *module_name,
432		     u32 component_id,
433		     const char *format, ...) ACPI_PRINTF_LIKE(6);
434#endif
435
436#endif				/* __ACXFACE_H__ */
v3.5.6
  1
  2/******************************************************************************
  3 *
  4 * Name: acpixf.h - External interfaces to the ACPI subsystem
  5 *
  6 *****************************************************************************/
  7
  8/*
  9 * Copyright (C) 2000 - 2011, Intel Corp.
 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 __ACXFACE_H__
 46#define __ACXFACE_H__
 47
 48/* Current ACPICA subsystem version in YYYYMMDD format */
 49
 50#define ACPI_CA_VERSION                 0x20120320
 51
 52#include "acconfig.h"
 53#include "actypes.h"
 54#include "actbl.h"
 55
 56extern u8 acpi_gbl_permanent_mmap;
 57
 58/*
 59 * Globals that are publicly available, allowing for
 60 * run time configuration
 61 */
 62extern u32 acpi_dbg_level;
 63extern u32 acpi_dbg_layer;
 64extern u8 acpi_gbl_enable_interpreter_slack;
 65extern u8 acpi_gbl_all_methods_serialized;
 66extern u8 acpi_gbl_create_osi_method;
 67extern u8 acpi_gbl_use_default_register_widths;
 68extern acpi_name acpi_gbl_trace_method_name;
 69extern u32 acpi_gbl_trace_flags;
 70extern bool acpi_gbl_enable_aml_debug_object;
 71extern u8 acpi_gbl_copy_dsdt_locally;
 72extern u8 acpi_gbl_truncate_io_addresses;
 73extern u8 acpi_gbl_disable_auto_repair;
 74
 75/*
 76 * Hardware-reduced prototypes. All interfaces that use these macros will
 77 * be configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag
 78 * is set to TRUE.
 79 */
 80#if (!ACPI_REDUCED_HARDWARE)
 81#define ACPI_HW_DEPENDENT_RETURN_STATUS(prototype) \
 82	prototype;
 83
 84#define ACPI_HW_DEPENDENT_RETURN_OK(prototype) \
 85	prototype;
 86
 87#define ACPI_HW_DEPENDENT_RETURN_VOID(prototype) \
 88	prototype;
 89
 90#else
 91#define ACPI_HW_DEPENDENT_RETURN_STATUS(prototype) \
 92	static ACPI_INLINE prototype {return(AE_NOT_CONFIGURED);}
 93
 94#define ACPI_HW_DEPENDENT_RETURN_OK(prototype) \
 95	static ACPI_INLINE prototype {return(AE_OK);}
 96
 97#define ACPI_HW_DEPENDENT_RETURN_VOID(prototype) \
 98	static ACPI_INLINE prototype {}
 99
100#endif				/* !ACPI_REDUCED_HARDWARE */
101
102extern u32 acpi_current_gpe_count;
103extern struct acpi_table_fadt acpi_gbl_FADT;
104extern u8 acpi_gbl_system_awake_and_running;
105extern u8 acpi_gbl_reduced_hardware;	/* ACPI 5.0 */
106
107extern u32 acpi_rsdt_forced;
108/*
109 * Global interfaces
110 */
111acpi_status
112acpi_initialize_tables(struct acpi_table_desc *initial_storage,
113		       u32 initial_table_count, u8 allow_resize);
114
115acpi_status __init acpi_initialize_subsystem(void);
116
117acpi_status acpi_enable_subsystem(u32 flags);
118
119acpi_status acpi_initialize_objects(u32 flags);
120
121acpi_status acpi_terminate(void);
122
123#ifdef ACPI_FUTURE_USAGE
124acpi_status acpi_subsystem_status(void);
125#endif
126
127ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_enable(void))
128ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_disable(void))
 
129
130#ifdef ACPI_FUTURE_USAGE
131acpi_status acpi_get_system_info(struct acpi_buffer *ret_buffer);
132#endif
133
134const char *acpi_format_exception(acpi_status exception);
135
136acpi_status acpi_purge_cached_objects(void);
137
138acpi_status acpi_install_interface(acpi_string interface_name);
139
140acpi_status acpi_remove_interface(acpi_string interface_name);
141
142u32
143acpi_check_address_range(acpi_adr_space_type space_id,
144			 acpi_physical_address address,
145			 acpi_size length, u8 warn);
146
147/*
148 * ACPI Memory management
149 */
150void *acpi_allocate(u32 size);
151
152void *acpi_callocate(u32 size);
153
154void acpi_free(void *address);
155
156/*
157 * ACPI table manipulation interfaces
158 */
159acpi_status acpi_reallocate_root_table(void);
160
161acpi_status acpi_find_root_pointer(acpi_size *rsdp_address);
162
163acpi_status acpi_load_tables(void);
164
165acpi_status acpi_load_table(struct acpi_table_header *table_ptr);
166
167acpi_status acpi_unload_table_id(acpi_owner_id id);
168
169acpi_status
170acpi_get_table_header(acpi_string signature,
171		      u32 instance,
172		      struct acpi_table_header *out_table_header);
173
174acpi_status
175acpi_get_table_with_size(acpi_string signature,
176	       u32 instance, struct acpi_table_header **out_table,
177	       acpi_size *tbl_size);
178acpi_status
179acpi_get_table(acpi_string signature,
180	       u32 instance, struct acpi_table_header **out_table);
181
182acpi_status
183acpi_get_table_by_index(u32 table_index,
184			struct acpi_table_header **out_table);
185
186acpi_status
187acpi_install_table_handler(acpi_tbl_handler handler, void *context);
188
189acpi_status acpi_remove_table_handler(acpi_tbl_handler handler);
190
191/*
192 * Namespace and name interfaces
193 */
194acpi_status
195acpi_walk_namespace(acpi_object_type type,
196		    acpi_handle start_object,
197		    u32 max_depth,
198		    acpi_walk_callback pre_order_visit,
199		    acpi_walk_callback post_order_visit,
200		    void *context, void **return_value);
201
202acpi_status
203acpi_get_devices(const char *HID,
204		 acpi_walk_callback user_function,
205		 void *context, void **return_value);
206
207acpi_status
208acpi_get_name(acpi_handle object,
209	      u32 name_type, struct acpi_buffer *ret_path_ptr);
210
211acpi_status
212acpi_get_handle(acpi_handle parent,
213		acpi_string pathname, acpi_handle * ret_handle);
214
215acpi_status
216acpi_attach_data(acpi_handle object, acpi_object_handler handler, void *data);
217
218acpi_status acpi_detach_data(acpi_handle object, acpi_object_handler handler);
219
220acpi_status
221acpi_get_data(acpi_handle object, acpi_object_handler handler, void **data);
222
223acpi_status
224acpi_debug_trace(char *name, u32 debug_level, u32 debug_layer, u32 flags);
225
226/*
227 * Object manipulation and enumeration
228 */
229acpi_status
230acpi_evaluate_object(acpi_handle object,
231		     acpi_string pathname,
232		     struct acpi_object_list *parameter_objects,
233		     struct acpi_buffer *return_object_buffer);
234
235acpi_status
236acpi_evaluate_object_typed(acpi_handle object,
237			   acpi_string pathname,
238			   struct acpi_object_list *external_params,
239			   struct acpi_buffer *return_buffer,
240			   acpi_object_type return_type);
241
242acpi_status
243acpi_get_object_info(acpi_handle object,
244		     struct acpi_device_info **return_buffer);
245
246acpi_status acpi_install_method(u8 *buffer);
247
248acpi_status
249acpi_get_next_object(acpi_object_type type,
250		     acpi_handle parent,
251		     acpi_handle child, acpi_handle * out_handle);
252
253acpi_status acpi_get_type(acpi_handle object, acpi_object_type * out_type);
254
255acpi_status acpi_get_id(acpi_handle object, acpi_owner_id * out_type);
256
257acpi_status acpi_get_parent(acpi_handle object, acpi_handle * out_handle);
258
259/*
260 * Handler interfaces
261 */
262acpi_status
263acpi_install_initialization_handler(acpi_init_handler handler, u32 function);
264
265ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
266				acpi_install_global_event_handler
267				(ACPI_GBL_EVENT_HANDLER handler, void *context))
268
269ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
270				 acpi_install_fixed_event_handler(u32
271								  acpi_event,
272								  acpi_event_handler
273								  handler,
274								  void
275								  *context))
276ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
277				 acpi_remove_fixed_event_handler(u32 acpi_event,
278								 acpi_event_handler
279								 handler))
280ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
281				 acpi_install_gpe_handler(acpi_handle
282							  gpe_device,
283							  u32 gpe_number,
284							  u32 type,
285							  acpi_gpe_handler
286							  address,
287							  void *context))
288ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
289				 acpi_remove_gpe_handler(acpi_handle gpe_device,
290							 u32 gpe_number,
291							 acpi_gpe_handler
292							 address))
293acpi_status
294acpi_install_notify_handler(acpi_handle device,
295			    u32 handler_type,
296			    acpi_notify_handler handler, void *context);
297
298acpi_status
299acpi_remove_notify_handler(acpi_handle device,
300			   u32 handler_type, acpi_notify_handler handler);
301
302acpi_status
303acpi_install_address_space_handler(acpi_handle device,
304				   acpi_adr_space_type space_id,
305				   acpi_adr_space_handler handler,
306				   acpi_adr_space_setup setup, void *context);
307
308acpi_status
309acpi_remove_address_space_handler(acpi_handle device,
310				  acpi_adr_space_type space_id,
311				  acpi_adr_space_handler handler);
312
 
 
 
 
 
 
 
 
 
313#ifdef ACPI_FUTURE_USAGE
314acpi_status acpi_install_exception_handler(acpi_exception_handler handler);
315#endif
316
317acpi_status acpi_install_interface_handler(acpi_interface_handler handler);
318
319/*
320 * Global Lock interfaces
321 */
322ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
323				acpi_acquire_global_lock(u16 timeout,
324							 u32 *handle))
325ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
326				acpi_release_global_lock(u32 handle))
327
328/*
329 * Interfaces to AML mutex objects
330 */
331acpi_status
332acpi_acquire_mutex(acpi_handle handle, acpi_string pathname, u16 timeout);
333
334acpi_status acpi_release_mutex(acpi_handle handle, acpi_string pathname);
335
336/*
337 * Fixed Event interfaces
338 */
339ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
340				acpi_enable_event(u32 event, u32 flags))
341
342ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
343				acpi_disable_event(u32 event, u32 flags))
344
345ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_clear_event(u32 event))
346
347ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
348				acpi_get_event_status(u32 event,
349						      acpi_event_status
350						      *event_status))
351/*
352 * General Purpose Event (GPE) Interfaces
353 */
354ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_update_all_gpes(void))
355
356ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
357				acpi_enable_gpe(acpi_handle gpe_device,
358						u32 gpe_number))
359
360ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
361				acpi_disable_gpe(acpi_handle gpe_device,
362						 u32 gpe_number))
363
364ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
365				acpi_clear_gpe(acpi_handle gpe_device,
366					       u32 gpe_number))
367
368ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
369				acpi_set_gpe(acpi_handle gpe_device,
370					     u32 gpe_number, u8 action))
371
372ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
373				acpi_finish_gpe(acpi_handle gpe_device,
374						u32 gpe_number))
375
376ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
377				acpi_setup_gpe_for_wake(acpi_handle
378							parent_device,
379							acpi_handle gpe_device,
380							u32 gpe_number))
381ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
382				 acpi_set_gpe_wake_mask(acpi_handle gpe_device,
383							u32 gpe_number,
384							u8 action))
385ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
386				 acpi_get_gpe_status(acpi_handle gpe_device,
387						     u32 gpe_number,
388						     acpi_event_status
389						     *event_status))
390
391ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_disable_all_gpes(void))
392
393ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_enable_all_runtime_gpes(void))
394
395ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
396				acpi_get_gpe_device(u32 gpe_index,
397						    acpi_handle * gpe_device))
 
398
399ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
400				acpi_install_gpe_block(acpi_handle gpe_device,
401						       struct
402						       acpi_generic_address
403						       *gpe_block_address,
404						       u32 register_count,
405						       u32 interrupt_number))
406ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
407				 acpi_remove_gpe_block(acpi_handle gpe_device))
408
409/*
410 * Resource interfaces
411 */
412typedef
413acpi_status(*acpi_walk_resource_callback) (struct acpi_resource * resource,
414					   void *context);
415
416acpi_status
417acpi_get_vendor_resource(acpi_handle device,
418			 char *name,
419			 struct acpi_vendor_uuid *uuid,
420			 struct acpi_buffer *ret_buffer);
421
422acpi_status
423acpi_get_current_resources(acpi_handle device, struct acpi_buffer *ret_buffer);
424
425#ifdef ACPI_FUTURE_USAGE
426acpi_status
427acpi_get_possible_resources(acpi_handle device, struct acpi_buffer *ret_buffer);
428#endif
429
430acpi_status
431acpi_get_event_resources(acpi_handle device_handle,
432			 struct acpi_buffer *ret_buffer);
433
434acpi_status
435acpi_walk_resources(acpi_handle device,
436		    char *name,
437		    acpi_walk_resource_callback user_function, void *context);
438
439acpi_status
440acpi_set_current_resources(acpi_handle device, struct acpi_buffer *in_buffer);
441
442acpi_status
443acpi_get_irq_routing_table(acpi_handle device, struct acpi_buffer *ret_buffer);
444
445acpi_status
446acpi_resource_to_address64(struct acpi_resource *resource,
447			   struct acpi_resource_address64 *out);
448
449acpi_status
450acpi_buffer_to_resource(u8 *aml_buffer,
451			u16 aml_buffer_length,
452			struct acpi_resource **resource_ptr);
453
454/*
455 * Hardware (ACPI device) interfaces
456 */
457acpi_status acpi_reset(void);
458
459ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
460				acpi_read_bit_register(u32 register_id,
461						       u32 *return_value))
462
463ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
464				acpi_write_bit_register(u32 register_id,
465							u32 value))
466
467ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
468				acpi_set_firmware_waking_vector(u32
469								physical_address))
470
471#if ACPI_MACHINE_WIDTH == 64
472ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
473				acpi_set_firmware_waking_vector64(u64
474								  physical_address))
475#endif
476
477acpi_status acpi_read(u64 *value, struct acpi_generic_address *reg);
478
479acpi_status acpi_write(u64 value, struct acpi_generic_address *reg);
480
481/*
482 * Sleep/Wake interfaces
483 */
484acpi_status
485acpi_get_sleep_type_data(u8 sleep_state, u8 * slp_typ_a, u8 * slp_typ_b);
486
487acpi_status acpi_enter_sleep_state_prep(u8 sleep_state);
488
489acpi_status asmlinkage acpi_enter_sleep_state(u8 sleep_state, u8 flags);
490
491ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status asmlinkage acpi_enter_sleep_state_s4bios(void))
492
493acpi_status acpi_leave_sleep_state_prep(u8 sleep_state, u8 flags);
494
495acpi_status acpi_leave_sleep_state(u8 sleep_state);
496
497/*
498 * ACPI Timer interfaces
499 */
500#ifdef ACPI_FUTURE_USAGE
501ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
502				acpi_get_timer_resolution(u32 *resolution))
503
504ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status acpi_get_timer(u32 *ticks))
505
506ACPI_HW_DEPENDENT_RETURN_STATUS(acpi_status
507				acpi_get_timer_duration(u32 start_ticks,
508							u32 end_ticks,
509							u32 *time_elapsed))
510#endif				/* ACPI_FUTURE_USAGE */
511
512/*
513 * Error/Warning output
514 */
515void ACPI_INTERNAL_VAR_XFACE
516acpi_error(const char *module_name,
517	   u32 line_number, const char *format, ...) ACPI_PRINTF_LIKE(3);
518
519void ACPI_INTERNAL_VAR_XFACE
520acpi_exception(const char *module_name,
521	       u32 line_number,
522	       acpi_status status, const char *format, ...) ACPI_PRINTF_LIKE(4);
523
524void ACPI_INTERNAL_VAR_XFACE
525acpi_warning(const char *module_name,
526	     u32 line_number, const char *format, ...) ACPI_PRINTF_LIKE(3);
527
528void ACPI_INTERNAL_VAR_XFACE
529acpi_info(const char *module_name,
530	  u32 line_number, const char *format, ...) ACPI_PRINTF_LIKE(3);
531
532/*
533 * Debug output
534 */
535#ifdef ACPI_DEBUG_OUTPUT
536
537void ACPI_INTERNAL_VAR_XFACE
538acpi_debug_print(u32 requested_debug_level,
539		 u32 line_number,
540		 const char *function_name,
541		 const char *module_name,
542		 u32 component_id, const char *format, ...) ACPI_PRINTF_LIKE(6);
543
544void ACPI_INTERNAL_VAR_XFACE
545acpi_debug_print_raw(u32 requested_debug_level,
546		     u32 line_number,
547		     const char *function_name,
548		     const char *module_name,
549		     u32 component_id,
550		     const char *format, ...) ACPI_PRINTF_LIKE(6);
551#endif
552
553#endif				/* __ACXFACE_H__ */