1 /******************************************************************************
2  *
3  * Name: achware.h -- hardware specific interfaces
4  *
5  *****************************************************************************/
6 
7 /*
8  * Copyright (C) 2000 - 2011, Intel Corp.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions, and the following disclaimer,
16  *    without modification.
17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18  *    substantially similar to the "NO WARRANTY" disclaimer below
19  *    ("Disclaimer") and any redistribution must be conditioned upon
20  *    including a substantially similar Disclaimer requirement for further
21  *    binary redistribution.
22  * 3. Neither the names of the above-listed copyright holders nor the names
23  *    of any contributors may be used to endorse or promote products derived
24  *    from this software without specific prior written permission.
25  *
26  * Alternatively, this software may be distributed under the terms of the
27  * GNU General Public License ("GPL") version 2 as published by the Free
28  * Software Foundation.
29  *
30  * NO WARRANTY
31  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41  * POSSIBILITY OF SUCH DAMAGES.
42  */
43 
44 #ifndef __ACHWARE_H__
45 #define __ACHWARE_H__
46 
47 /* Values for the _SST predefined method */
48 
49 #define ACPI_SST_INDICATOR_OFF  0
50 #define ACPI_SST_WORKING        1
51 #define ACPI_SST_WAKING         2
52 #define ACPI_SST_SLEEPING       3
53 #define ACPI_SST_SLEEP_CONTEXT  4
54 
55 /*
56  * hwacpi - high level functions
57  */
58 acpi_status acpi_hw_set_mode(u32 mode);
59 
60 u32 acpi_hw_get_mode(void);
61 
62 /*
63  * hwregs - ACPI Register I/O
64  */
65 acpi_status
66 acpi_hw_validate_register(struct acpi_generic_address *reg,
67 			  u8 max_bit_width, u64 *address);
68 
69 acpi_status acpi_hw_read(u32 *value, struct acpi_generic_address *reg);
70 
71 acpi_status acpi_hw_write(u32 value, struct acpi_generic_address *reg);
72 
73 struct acpi_bit_register_info *acpi_hw_get_bit_register_info(u32 register_id);
74 
75 acpi_status acpi_hw_write_pm1_control(u32 pm1a_control, u32 pm1b_control);
76 
77 acpi_status acpi_hw_register_read(u32 register_id, u32 *return_value);
78 
79 acpi_status acpi_hw_register_write(u32 register_id, u32 value);
80 
81 acpi_status acpi_hw_clear_acpi_status(void);
82 
83 /*
84  * hwvalid - Port I/O with validation
85  */
86 acpi_status acpi_hw_read_port(acpi_io_address address, u32 *value, u32 width);
87 
88 acpi_status acpi_hw_write_port(acpi_io_address address, u32 value, u32 width);
89 
90 /*
91  * hwgpe - GPE support
92  */
93 u32 acpi_hw_get_gpe_register_bit(struct acpi_gpe_event_info *gpe_event_info,
94 			     struct acpi_gpe_register_info *gpe_register_info);
95 
96 acpi_status
97 acpi_hw_low_set_gpe(struct acpi_gpe_event_info *gpe_event_info, u32 action);
98 
99 acpi_status
100 acpi_hw_disable_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
101 			  struct acpi_gpe_block_info *gpe_block, void *context);
102 
103 acpi_status acpi_hw_clear_gpe(struct acpi_gpe_event_info *gpe_event_info);
104 
105 acpi_status
106 acpi_hw_clear_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
107 			struct acpi_gpe_block_info *gpe_block, void *context);
108 
109 acpi_status
110 acpi_hw_get_gpe_status(struct acpi_gpe_event_info *gpe_event_info,
111 		       acpi_event_status * event_status);
112 
113 acpi_status acpi_hw_disable_all_gpes(void);
114 
115 acpi_status acpi_hw_enable_all_runtime_gpes(void);
116 
117 acpi_status acpi_hw_enable_all_wakeup_gpes(void);
118 
119 acpi_status
120 acpi_hw_enable_runtime_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
121 				 struct acpi_gpe_block_info *gpe_block,
122 				 void *context);
123 
124 /*
125  * hwpci - PCI configuration support
126  */
127 acpi_status
128 acpi_hw_derive_pci_id(struct acpi_pci_id *pci_id,
129 		      acpi_handle root_pci_device, acpi_handle pci_region);
130 
131 #ifdef	ACPI_FUTURE_USAGE
132 /*
133  * hwtimer - ACPI Timer prototypes
134  */
135 acpi_status acpi_get_timer_resolution(u32 * resolution);
136 
137 acpi_status acpi_get_timer(u32 * ticks);
138 
139 acpi_status
140 acpi_get_timer_duration(u32 start_ticks, u32 end_ticks, u32 * time_elapsed);
141 #endif				/* ACPI_FUTURE_USAGE */
142 
143 #endif				/* __ACHWARE_H__ */
144