1 /******************************************************************************
2  *
3  * Name: achware.h -- hardware specific interfaces
4  *
5  *****************************************************************************/
6 
7 /*
8  * Copyright (C) 2000 - 2012, 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  * hwsleep - sleep/wake support (Legacy sleep registers)
85  */
86 acpi_status acpi_hw_legacy_sleep(u8 sleep_state, u8 flags);
87 
88 acpi_status acpi_hw_legacy_wake_prep(u8 sleep_state, u8 flags);
89 
90 acpi_status acpi_hw_legacy_wake(u8 sleep_state, u8 flags);
91 
92 /*
93  * hwesleep - sleep/wake support (Extended FADT-V5 sleep registers)
94  */
95 void acpi_hw_execute_sleep_method(char *method_name, u32 integer_argument);
96 
97 acpi_status acpi_hw_extended_sleep(u8 sleep_state, u8 flags);
98 
99 acpi_status acpi_hw_extended_wake_prep(u8 sleep_state, u8 flags);
100 
101 acpi_status acpi_hw_extended_wake(u8 sleep_state, u8 flags);
102 
103 /*
104  * hwvalid - Port I/O with validation
105  */
106 acpi_status acpi_hw_read_port(acpi_io_address address, u32 *value, u32 width);
107 
108 acpi_status acpi_hw_write_port(acpi_io_address address, u32 value, u32 width);
109 
110 /*
111  * hwgpe - GPE support
112  */
113 u32 acpi_hw_get_gpe_register_bit(struct acpi_gpe_event_info *gpe_event_info,
114 			     struct acpi_gpe_register_info *gpe_register_info);
115 
116 acpi_status
117 acpi_hw_low_set_gpe(struct acpi_gpe_event_info *gpe_event_info, u32 action);
118 
119 acpi_status
120 acpi_hw_disable_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
121 			  struct acpi_gpe_block_info *gpe_block, void *context);
122 
123 acpi_status acpi_hw_clear_gpe(struct acpi_gpe_event_info *gpe_event_info);
124 
125 acpi_status
126 acpi_hw_clear_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
127 			struct acpi_gpe_block_info *gpe_block, void *context);
128 
129 acpi_status
130 acpi_hw_get_gpe_status(struct acpi_gpe_event_info *gpe_event_info,
131 		       acpi_event_status * event_status);
132 
133 acpi_status acpi_hw_disable_all_gpes(void);
134 
135 acpi_status acpi_hw_enable_all_runtime_gpes(void);
136 
137 acpi_status acpi_hw_enable_all_wakeup_gpes(void);
138 
139 acpi_status
140 acpi_hw_enable_runtime_gpe_block(struct acpi_gpe_xrupt_info *gpe_xrupt_info,
141 				 struct acpi_gpe_block_info *gpe_block,
142 				 void *context);
143 
144 /*
145  * hwpci - PCI configuration support
146  */
147 acpi_status
148 acpi_hw_derive_pci_id(struct acpi_pci_id *pci_id,
149 		      acpi_handle root_pci_device, acpi_handle pci_region);
150 
151 #endif				/* __ACHWARE_H__ */
152