xref: /freebsd/sys/contrib/dev/acpica/include/achware.h (revision 7750ad47a9a7dbc83f87158464170c8640723293)
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 
48 /* Values for the _SST predefined method */
49 
50 #define ACPI_SST_INDICATOR_OFF  0
51 #define ACPI_SST_WORKING        1
52 #define ACPI_SST_WAKING         2
53 #define ACPI_SST_SLEEPING       3
54 #define ACPI_SST_SLEEP_CONTEXT  4
55 
56 
57 /*
58  * hwacpi - high level functions
59  */
60 ACPI_STATUS
61 AcpiHwSetMode (
62     UINT32                  Mode);
63 
64 UINT32
65 AcpiHwGetMode (
66     void);
67 
68 
69 /*
70  * hwregs - ACPI Register I/O
71  */
72 ACPI_STATUS
73 AcpiHwValidateRegister (
74     ACPI_GENERIC_ADDRESS    *Reg,
75     UINT8                   MaxBitWidth,
76     UINT64                  *Address);
77 
78 ACPI_STATUS
79 AcpiHwRead (
80     UINT32                  *Value,
81     ACPI_GENERIC_ADDRESS    *Reg);
82 
83 ACPI_STATUS
84 AcpiHwWrite (
85     UINT32                  Value,
86     ACPI_GENERIC_ADDRESS    *Reg);
87 
88 ACPI_BIT_REGISTER_INFO *
89 AcpiHwGetBitRegisterInfo (
90     UINT32                  RegisterId);
91 
92 ACPI_STATUS
93 AcpiHwWritePm1Control (
94     UINT32                  Pm1aControl,
95     UINT32                  Pm1bControl);
96 
97 ACPI_STATUS
98 AcpiHwRegisterRead (
99     UINT32                  RegisterId,
100     UINT32                  *ReturnValue);
101 
102 ACPI_STATUS
103 AcpiHwRegisterWrite (
104     UINT32                  RegisterId,
105     UINT32                  Value);
106 
107 ACPI_STATUS
108 AcpiHwClearAcpiStatus (
109     void);
110 
111 
112 /*
113  * hwsleep - sleep/wake support (Legacy sleep registers)
114  */
115 ACPI_STATUS
116 AcpiHwLegacySleep (
117     UINT8                   SleepState,
118     UINT8                   Flags);
119 
120 ACPI_STATUS
121 AcpiHwLegacyWakePrep (
122     UINT8                   SleepState,
123     UINT8                   Flags);
124 
125 ACPI_STATUS
126 AcpiHwLegacyWake (
127     UINT8                   SleepState,
128     UINT8                   Flags);
129 
130 
131 /*
132  * hwesleep - sleep/wake support (Extended FADT-V5 sleep registers)
133  */
134 void
135 AcpiHwExecuteSleepMethod (
136     char                    *MethodName,
137     UINT32                  IntegerArgument);
138 
139 ACPI_STATUS
140 AcpiHwExtendedSleep (
141     UINT8                   SleepState,
142     UINT8                   Flags);
143 
144 ACPI_STATUS
145 AcpiHwExtendedWakePrep (
146     UINT8                   SleepState,
147     UINT8                   Flags);
148 
149 ACPI_STATUS
150 AcpiHwExtendedWake (
151     UINT8                   SleepState,
152     UINT8                   Flags);
153 
154 
155 /*
156  * hwvalid - Port I/O with validation
157  */
158 ACPI_STATUS
159 AcpiHwReadPort (
160     ACPI_IO_ADDRESS         Address,
161     UINT32                  *Value,
162     UINT32                  Width);
163 
164 ACPI_STATUS
165 AcpiHwWritePort (
166     ACPI_IO_ADDRESS         Address,
167     UINT32                  Value,
168     UINT32                  Width);
169 
170 
171 /*
172  * hwgpe - GPE support
173  */
174 UINT32
175 AcpiHwGetGpeRegisterBit (
176     ACPI_GPE_EVENT_INFO     *GpeEventInfo,
177     ACPI_GPE_REGISTER_INFO  *GpeRegisterInfo);
178 
179 ACPI_STATUS
180 AcpiHwLowSetGpe (
181     ACPI_GPE_EVENT_INFO     *GpeEventInfo,
182     UINT32                  Action);
183 
184 ACPI_STATUS
185 AcpiHwDisableGpeBlock (
186     ACPI_GPE_XRUPT_INFO     *GpeXruptInfo,
187     ACPI_GPE_BLOCK_INFO     *GpeBlock,
188     void                    *Context);
189 
190 ACPI_STATUS
191 AcpiHwClearGpe (
192     ACPI_GPE_EVENT_INFO     *GpeEventInfo);
193 
194 ACPI_STATUS
195 AcpiHwClearGpeBlock (
196     ACPI_GPE_XRUPT_INFO     *GpeXruptInfo,
197     ACPI_GPE_BLOCK_INFO     *GpeBlock,
198     void                    *Context);
199 
200 ACPI_STATUS
201 AcpiHwGetGpeStatus (
202     ACPI_GPE_EVENT_INFO     *GpeEventInfo,
203     ACPI_EVENT_STATUS       *EventStatus);
204 
205 ACPI_STATUS
206 AcpiHwDisableAllGpes (
207     void);
208 
209 ACPI_STATUS
210 AcpiHwEnableAllRuntimeGpes (
211     void);
212 
213 ACPI_STATUS
214 AcpiHwEnableAllWakeupGpes (
215     void);
216 
217 ACPI_STATUS
218 AcpiHwEnableRuntimeGpeBlock (
219     ACPI_GPE_XRUPT_INFO     *GpeXruptInfo,
220     ACPI_GPE_BLOCK_INFO     *GpeBlock,
221     void                    *Context);
222 
223 
224 /*
225  * hwpci - PCI configuration support
226  */
227 ACPI_STATUS
228 AcpiHwDerivePciId (
229     ACPI_PCI_ID             *PciId,
230     ACPI_HANDLE             RootPciDevice,
231     ACPI_HANDLE             PciRegion);
232 
233 
234 #endif /* __ACHWARE_H__ */
235