1bc36eafdSMike Gerdts /*******************************************************************************
2bc36eafdSMike Gerdts *
3bc36eafdSMike Gerdts * Module Name: rsxface - Public interfaces to the resource manager
4bc36eafdSMike Gerdts *
5bc36eafdSMike Gerdts ******************************************************************************/
6bc36eafdSMike Gerdts
7*35786f68SRobert Mustacchi /******************************************************************************
8*35786f68SRobert Mustacchi *
9*35786f68SRobert Mustacchi * 1. Copyright Notice
10*35786f68SRobert Mustacchi *
11*35786f68SRobert Mustacchi * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
12bc36eafdSMike Gerdts * All rights reserved.
13bc36eafdSMike Gerdts *
14*35786f68SRobert Mustacchi * 2. License
15*35786f68SRobert Mustacchi *
16*35786f68SRobert Mustacchi * 2.1. This is your license from Intel Corp. under its intellectual property
17*35786f68SRobert Mustacchi * rights. You may have additional license terms from the party that provided
18*35786f68SRobert Mustacchi * you this software, covering your right to use that party's intellectual
19*35786f68SRobert Mustacchi * property rights.
20*35786f68SRobert Mustacchi *
21*35786f68SRobert Mustacchi * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22*35786f68SRobert Mustacchi * copy of the source code appearing in this file ("Covered Code") an
23*35786f68SRobert Mustacchi * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24*35786f68SRobert Mustacchi * base code distributed originally by Intel ("Original Intel Code") to copy,
25*35786f68SRobert Mustacchi * make derivatives, distribute, use and display any portion of the Covered
26*35786f68SRobert Mustacchi * Code in any form, with the right to sublicense such rights; and
27*35786f68SRobert Mustacchi *
28*35786f68SRobert Mustacchi * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29*35786f68SRobert Mustacchi * license (with the right to sublicense), under only those claims of Intel
30*35786f68SRobert Mustacchi * patents that are infringed by the Original Intel Code, to make, use, sell,
31*35786f68SRobert Mustacchi * offer to sell, and import the Covered Code and derivative works thereof
32*35786f68SRobert Mustacchi * solely to the minimum extent necessary to exercise the above copyright
33*35786f68SRobert Mustacchi * license, and in no event shall the patent license extend to any additions
34*35786f68SRobert Mustacchi * to or modifications of the Original Intel Code. No other license or right
35*35786f68SRobert Mustacchi * is granted directly or by implication, estoppel or otherwise;
36*35786f68SRobert Mustacchi *
37*35786f68SRobert Mustacchi * The above copyright and patent license is granted only if the following
38*35786f68SRobert Mustacchi * conditions are met:
39*35786f68SRobert Mustacchi *
40*35786f68SRobert Mustacchi * 3. Conditions
41*35786f68SRobert Mustacchi *
42*35786f68SRobert Mustacchi * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
44*35786f68SRobert Mustacchi * Code or modification with rights to further distribute source must include
45*35786f68SRobert Mustacchi * the above Copyright Notice, the above License, this list of Conditions,
46*35786f68SRobert Mustacchi * and the following Disclaimer and Export Compliance provision. In addition,
47*35786f68SRobert Mustacchi * Licensee must cause all Covered Code to which Licensee contributes to
48*35786f68SRobert Mustacchi * contain a file documenting the changes Licensee made to create that Covered
49*35786f68SRobert Mustacchi * Code and the date of any change. Licensee must include in that file the
50*35786f68SRobert Mustacchi * documentation of any changes made by any predecessor Licensee. Licensee
51*35786f68SRobert Mustacchi * must include a prominent statement that the modification is derived,
52*35786f68SRobert Mustacchi * directly or indirectly, from Original Intel Code.
53*35786f68SRobert Mustacchi *
54*35786f68SRobert Mustacchi * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
56*35786f68SRobert Mustacchi * Code or modification without rights to further distribute source must
57*35786f68SRobert Mustacchi * include the following Disclaimer and Export Compliance provision in the
58*35786f68SRobert Mustacchi * documentation and/or other materials provided with distribution. In
59*35786f68SRobert Mustacchi * addition, Licensee may not authorize further sublicense of source of any
60*35786f68SRobert Mustacchi * portion of the Covered Code, and must include terms to the effect that the
61*35786f68SRobert Mustacchi * license from Licensee to its licensee is limited to the intellectual
62*35786f68SRobert Mustacchi * property embodied in the software Licensee provides to its licensee, and
63*35786f68SRobert Mustacchi * not to intellectual property embodied in modifications its licensee may
64*35786f68SRobert Mustacchi * make.
65*35786f68SRobert Mustacchi *
66*35786f68SRobert Mustacchi * 3.3. Redistribution of Executable. Redistribution in executable form of any
67*35786f68SRobert Mustacchi * substantial portion of the Covered Code or modification must reproduce the
68*35786f68SRobert Mustacchi * above Copyright Notice, and the following Disclaimer and Export Compliance
69*35786f68SRobert Mustacchi * provision in the documentation and/or other materials provided with the
70*35786f68SRobert Mustacchi * distribution.
71*35786f68SRobert Mustacchi *
72*35786f68SRobert Mustacchi * 3.4. Intel retains all right, title, and interest in and to the Original
73*35786f68SRobert Mustacchi * Intel Code.
74*35786f68SRobert Mustacchi *
75*35786f68SRobert Mustacchi * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76*35786f68SRobert Mustacchi * Intel shall be used in advertising or otherwise to promote the sale, use or
77*35786f68SRobert Mustacchi * other dealings in products derived from or relating to the Covered Code
78*35786f68SRobert Mustacchi * without prior written authorization from Intel.
79*35786f68SRobert Mustacchi *
80*35786f68SRobert Mustacchi * 4. Disclaimer and Export Compliance
81*35786f68SRobert Mustacchi *
82*35786f68SRobert Mustacchi * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83*35786f68SRobert Mustacchi * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84*35786f68SRobert Mustacchi * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85*35786f68SRobert Mustacchi * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86*35786f68SRobert Mustacchi * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87*35786f68SRobert Mustacchi * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88*35786f68SRobert Mustacchi * PARTICULAR PURPOSE.
89*35786f68SRobert Mustacchi *
90*35786f68SRobert Mustacchi * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91*35786f68SRobert Mustacchi * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92*35786f68SRobert Mustacchi * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93*35786f68SRobert Mustacchi * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94*35786f68SRobert Mustacchi * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95*35786f68SRobert Mustacchi * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96*35786f68SRobert Mustacchi * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97*35786f68SRobert Mustacchi * LIMITED REMEDY.
98*35786f68SRobert Mustacchi *
99*35786f68SRobert Mustacchi * 4.3. Licensee shall not export, either directly or indirectly, any of this
100*35786f68SRobert Mustacchi * software or system incorporating such software without first obtaining any
101*35786f68SRobert Mustacchi * required license or other approval from the U. S. Department of Commerce or
102*35786f68SRobert Mustacchi * any other agency or department of the United States Government. In the
103*35786f68SRobert Mustacchi * event Licensee exports any such software from the United States or
104*35786f68SRobert Mustacchi * re-exports any such software from a foreign destination, Licensee shall
105*35786f68SRobert Mustacchi * ensure that the distribution and export/re-export of the software is in
106*35786f68SRobert Mustacchi * compliance with all laws, regulations, orders, or other restrictions of the
107*35786f68SRobert Mustacchi * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108*35786f68SRobert Mustacchi * any of its subsidiaries will export/re-export any technical data, process,
109*35786f68SRobert Mustacchi * software, or service, directly or indirectly, to any country for which the
110*35786f68SRobert Mustacchi * United States government or any agency thereof requires an export license,
111*35786f68SRobert Mustacchi * other governmental approval, or letter of assurance, without first obtaining
112*35786f68SRobert Mustacchi * such license, approval or letter.
113*35786f68SRobert Mustacchi *
114*35786f68SRobert Mustacchi *****************************************************************************
115*35786f68SRobert Mustacchi *
116*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
117*35786f68SRobert Mustacchi * following license:
118*35786f68SRobert Mustacchi *
119bc36eafdSMike Gerdts * Redistribution and use in source and binary forms, with or without
120bc36eafdSMike Gerdts * modification, are permitted provided that the following conditions
121bc36eafdSMike Gerdts * are met:
122bc36eafdSMike Gerdts * 1. Redistributions of source code must retain the above copyright
123bc36eafdSMike Gerdts * notice, this list of conditions, and the following disclaimer,
124bc36eafdSMike Gerdts * without modification.
125bc36eafdSMike Gerdts * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126bc36eafdSMike Gerdts * substantially similar to the "NO WARRANTY" disclaimer below
127bc36eafdSMike Gerdts * ("Disclaimer") and any redistribution must be conditioned upon
128bc36eafdSMike Gerdts * including a substantially similar Disclaimer requirement for further
129bc36eafdSMike Gerdts * binary redistribution.
130bc36eafdSMike Gerdts * 3. Neither the names of the above-listed copyright holders nor the names
131bc36eafdSMike Gerdts * of any contributors may be used to endorse or promote products derived
132bc36eafdSMike Gerdts * from this software without specific prior written permission.
133bc36eafdSMike Gerdts *
134*35786f68SRobert Mustacchi * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135*35786f68SRobert Mustacchi * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136*35786f68SRobert Mustacchi * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137*35786f68SRobert Mustacchi * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138*35786f68SRobert Mustacchi * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139*35786f68SRobert Mustacchi * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140*35786f68SRobert Mustacchi * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141*35786f68SRobert Mustacchi * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142*35786f68SRobert Mustacchi * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143*35786f68SRobert Mustacchi * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144*35786f68SRobert Mustacchi * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145*35786f68SRobert Mustacchi *
146*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
147bc36eafdSMike Gerdts * GNU General Public License ("GPL") version 2 as published by the Free
148bc36eafdSMike Gerdts * Software Foundation.
149bc36eafdSMike Gerdts *
150*35786f68SRobert Mustacchi *****************************************************************************/
151bc36eafdSMike Gerdts
152bc36eafdSMike Gerdts #define EXPORT_ACPI_INTERFACES
153bc36eafdSMike Gerdts
154bc36eafdSMike Gerdts #include "acpi.h"
155bc36eafdSMike Gerdts #include "accommon.h"
156bc36eafdSMike Gerdts #include "acresrc.h"
157bc36eafdSMike Gerdts #include "acnamesp.h"
158bc36eafdSMike Gerdts
159bc36eafdSMike Gerdts #define _COMPONENT ACPI_RESOURCES
160bc36eafdSMike Gerdts ACPI_MODULE_NAME ("rsxface")
161bc36eafdSMike Gerdts
162bc36eafdSMike Gerdts /* Local macros for 16,32-bit to 64-bit conversion */
163bc36eafdSMike Gerdts
164bc36eafdSMike Gerdts #define ACPI_COPY_FIELD(Out, In, Field) ((Out)->Field = (In)->Field)
165bc36eafdSMike Gerdts #define ACPI_COPY_ADDRESS(Out, In) \
166bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, ResourceType); \
167bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, ProducerConsumer); \
168bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Decode); \
169bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, MinAddressFixed); \
170bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, MaxAddressFixed); \
171bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Info); \
172bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Address.Granularity); \
173bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Address.Minimum); \
174bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Address.Maximum); \
175bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Address.TranslationOffset); \
176bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, Address.AddressLength); \
177bc36eafdSMike Gerdts ACPI_COPY_FIELD(Out, In, ResourceSource);
178bc36eafdSMike Gerdts
179bc36eafdSMike Gerdts
180bc36eafdSMike Gerdts /* Local prototypes */
181bc36eafdSMike Gerdts
182bc36eafdSMike Gerdts static ACPI_STATUS
183bc36eafdSMike Gerdts AcpiRsMatchVendorResource (
184bc36eafdSMike Gerdts ACPI_RESOURCE *Resource,
185bc36eafdSMike Gerdts void *Context);
186bc36eafdSMike Gerdts
187bc36eafdSMike Gerdts static ACPI_STATUS
188bc36eafdSMike Gerdts AcpiRsValidateParameters (
189bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
190bc36eafdSMike Gerdts ACPI_BUFFER *Buffer,
191bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE **ReturnNode);
192bc36eafdSMike Gerdts
193bc36eafdSMike Gerdts
194bc36eafdSMike Gerdts /*******************************************************************************
195bc36eafdSMike Gerdts *
196bc36eafdSMike Gerdts * FUNCTION: AcpiRsValidateParameters
197bc36eafdSMike Gerdts *
198bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to a device
199bc36eafdSMike Gerdts * Buffer - Pointer to a data buffer
200bc36eafdSMike Gerdts * ReturnNode - Pointer to where the device node is returned
201bc36eafdSMike Gerdts *
202bc36eafdSMike Gerdts * RETURN: Status
203bc36eafdSMike Gerdts *
204bc36eafdSMike Gerdts * DESCRIPTION: Common parameter validation for resource interfaces
205bc36eafdSMike Gerdts *
206bc36eafdSMike Gerdts ******************************************************************************/
207bc36eafdSMike Gerdts
208bc36eafdSMike Gerdts static ACPI_STATUS
AcpiRsValidateParameters(ACPI_HANDLE DeviceHandle,ACPI_BUFFER * Buffer,ACPI_NAMESPACE_NODE ** ReturnNode)209bc36eafdSMike Gerdts AcpiRsValidateParameters (
210bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
211bc36eafdSMike Gerdts ACPI_BUFFER *Buffer,
212bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE **ReturnNode)
213bc36eafdSMike Gerdts {
214bc36eafdSMike Gerdts ACPI_STATUS Status;
215bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
216bc36eafdSMike Gerdts
217bc36eafdSMike Gerdts
218bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (RsValidateParameters);
219bc36eafdSMike Gerdts
220bc36eafdSMike Gerdts
221bc36eafdSMike Gerdts /*
222bc36eafdSMike Gerdts * Must have a valid handle to an ACPI device
223bc36eafdSMike Gerdts */
224bc36eafdSMike Gerdts if (!DeviceHandle)
225bc36eafdSMike Gerdts {
226bc36eafdSMike Gerdts return_ACPI_STATUS (AE_BAD_PARAMETER);
227bc36eafdSMike Gerdts }
228bc36eafdSMike Gerdts
229bc36eafdSMike Gerdts Node = AcpiNsValidateHandle (DeviceHandle);
230bc36eafdSMike Gerdts if (!Node)
231bc36eafdSMike Gerdts {
232bc36eafdSMike Gerdts return_ACPI_STATUS (AE_BAD_PARAMETER);
233bc36eafdSMike Gerdts }
234bc36eafdSMike Gerdts
235bc36eafdSMike Gerdts if (Node->Type != ACPI_TYPE_DEVICE)
236bc36eafdSMike Gerdts {
237bc36eafdSMike Gerdts return_ACPI_STATUS (AE_TYPE);
238bc36eafdSMike Gerdts }
239bc36eafdSMike Gerdts
240bc36eafdSMike Gerdts /*
241bc36eafdSMike Gerdts * Validate the user buffer object
242bc36eafdSMike Gerdts *
243bc36eafdSMike Gerdts * if there is a non-zero buffer length we also need a valid pointer in
244bc36eafdSMike Gerdts * the buffer. If it's a zero buffer length, we'll be returning the
245bc36eafdSMike Gerdts * needed buffer size (later), so keep going.
246bc36eafdSMike Gerdts */
247bc36eafdSMike Gerdts Status = AcpiUtValidateBuffer (Buffer);
248bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
249bc36eafdSMike Gerdts {
250bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
251bc36eafdSMike Gerdts }
252bc36eafdSMike Gerdts
253bc36eafdSMike Gerdts *ReturnNode = Node;
254bc36eafdSMike Gerdts return_ACPI_STATUS (AE_OK);
255bc36eafdSMike Gerdts }
256bc36eafdSMike Gerdts
257bc36eafdSMike Gerdts
258bc36eafdSMike Gerdts /*******************************************************************************
259bc36eafdSMike Gerdts *
260bc36eafdSMike Gerdts * FUNCTION: AcpiGetIrqRoutingTable
261bc36eafdSMike Gerdts *
262bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to the Bus device we are querying
263bc36eafdSMike Gerdts * RetBuffer - Pointer to a buffer to receive the
264bc36eafdSMike Gerdts * current resources for the device
265bc36eafdSMike Gerdts *
266bc36eafdSMike Gerdts * RETURN: Status
267bc36eafdSMike Gerdts *
268bc36eafdSMike Gerdts * DESCRIPTION: This function is called to get the IRQ routing table for a
269bc36eafdSMike Gerdts * specific bus. The caller must first acquire a handle for the
270bc36eafdSMike Gerdts * desired bus. The routine table is placed in the buffer pointed
271bc36eafdSMike Gerdts * to by the RetBuffer variable parameter.
272bc36eafdSMike Gerdts *
273bc36eafdSMike Gerdts * If the function fails an appropriate status will be returned
274bc36eafdSMike Gerdts * and the value of RetBuffer is undefined.
275bc36eafdSMike Gerdts *
276bc36eafdSMike Gerdts * This function attempts to execute the _PRT method contained in
277bc36eafdSMike Gerdts * the object indicated by the passed DeviceHandle.
278bc36eafdSMike Gerdts *
279bc36eafdSMike Gerdts ******************************************************************************/
280bc36eafdSMike Gerdts
281bc36eafdSMike Gerdts ACPI_STATUS
AcpiGetIrqRoutingTable(ACPI_HANDLE DeviceHandle,ACPI_BUFFER * RetBuffer)282bc36eafdSMike Gerdts AcpiGetIrqRoutingTable (
283bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
284bc36eafdSMike Gerdts ACPI_BUFFER *RetBuffer)
285bc36eafdSMike Gerdts {
286bc36eafdSMike Gerdts ACPI_STATUS Status;
287bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
288bc36eafdSMike Gerdts
289bc36eafdSMike Gerdts
290bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiGetIrqRoutingTable);
291bc36eafdSMike Gerdts
292bc36eafdSMike Gerdts
293bc36eafdSMike Gerdts /* Validate parameters then dispatch to internal routine */
294bc36eafdSMike Gerdts
295bc36eafdSMike Gerdts Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
296bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
297bc36eafdSMike Gerdts {
298bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
299bc36eafdSMike Gerdts }
300bc36eafdSMike Gerdts
301bc36eafdSMike Gerdts Status = AcpiRsGetPrtMethodData (Node, RetBuffer);
302bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
303bc36eafdSMike Gerdts }
304bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiGetIrqRoutingTable)305bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiGetIrqRoutingTable)
306bc36eafdSMike Gerdts
307bc36eafdSMike Gerdts
308bc36eafdSMike Gerdts /*******************************************************************************
309bc36eafdSMike Gerdts *
310bc36eafdSMike Gerdts * FUNCTION: AcpiGetCurrentResources
311bc36eafdSMike Gerdts *
312bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to the device object for the
313bc36eafdSMike Gerdts * device we are querying
314bc36eafdSMike Gerdts * RetBuffer - Pointer to a buffer to receive the
315bc36eafdSMike Gerdts * current resources for the device
316bc36eafdSMike Gerdts *
317bc36eafdSMike Gerdts * RETURN: Status
318bc36eafdSMike Gerdts *
319bc36eafdSMike Gerdts * DESCRIPTION: This function is called to get the current resources for a
320bc36eafdSMike Gerdts * specific device. The caller must first acquire a handle for
321bc36eafdSMike Gerdts * the desired device. The resource data is placed in the buffer
322bc36eafdSMike Gerdts * pointed to by the RetBuffer variable parameter.
323bc36eafdSMike Gerdts *
324bc36eafdSMike Gerdts * If the function fails an appropriate status will be returned
325bc36eafdSMike Gerdts * and the value of RetBuffer is undefined.
326bc36eafdSMike Gerdts *
327bc36eafdSMike Gerdts * This function attempts to execute the _CRS method contained in
328bc36eafdSMike Gerdts * the object indicated by the passed DeviceHandle.
329bc36eafdSMike Gerdts *
330bc36eafdSMike Gerdts ******************************************************************************/
331bc36eafdSMike Gerdts
332bc36eafdSMike Gerdts ACPI_STATUS
333bc36eafdSMike Gerdts AcpiGetCurrentResources (
334bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
335bc36eafdSMike Gerdts ACPI_BUFFER *RetBuffer)
336bc36eafdSMike Gerdts {
337bc36eafdSMike Gerdts ACPI_STATUS Status;
338bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
339bc36eafdSMike Gerdts
340bc36eafdSMike Gerdts
341bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiGetCurrentResources);
342bc36eafdSMike Gerdts
343bc36eafdSMike Gerdts
344bc36eafdSMike Gerdts /* Validate parameters then dispatch to internal routine */
345bc36eafdSMike Gerdts
346bc36eafdSMike Gerdts Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
347bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
348bc36eafdSMike Gerdts {
349bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
350bc36eafdSMike Gerdts }
351bc36eafdSMike Gerdts
352bc36eafdSMike Gerdts Status = AcpiRsGetCrsMethodData (Node, RetBuffer);
353bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
354bc36eafdSMike Gerdts }
355bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiGetCurrentResources)356bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiGetCurrentResources)
357bc36eafdSMike Gerdts
358bc36eafdSMike Gerdts
359bc36eafdSMike Gerdts /*******************************************************************************
360bc36eafdSMike Gerdts *
361bc36eafdSMike Gerdts * FUNCTION: AcpiGetPossibleResources
362bc36eafdSMike Gerdts *
363bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to the device object for the
364bc36eafdSMike Gerdts * device we are querying
365bc36eafdSMike Gerdts * RetBuffer - Pointer to a buffer to receive the
366bc36eafdSMike Gerdts * resources for the device
367bc36eafdSMike Gerdts *
368bc36eafdSMike Gerdts * RETURN: Status
369bc36eafdSMike Gerdts *
370bc36eafdSMike Gerdts * DESCRIPTION: This function is called to get a list of the possible resources
371bc36eafdSMike Gerdts * for a specific device. The caller must first acquire a handle
372bc36eafdSMike Gerdts * for the desired device. The resource data is placed in the
373bc36eafdSMike Gerdts * buffer pointed to by the RetBuffer variable.
374bc36eafdSMike Gerdts *
375bc36eafdSMike Gerdts * If the function fails an appropriate status will be returned
376bc36eafdSMike Gerdts * and the value of RetBuffer is undefined.
377bc36eafdSMike Gerdts *
378bc36eafdSMike Gerdts ******************************************************************************/
379bc36eafdSMike Gerdts
380bc36eafdSMike Gerdts ACPI_STATUS
381bc36eafdSMike Gerdts AcpiGetPossibleResources (
382bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
383bc36eafdSMike Gerdts ACPI_BUFFER *RetBuffer)
384bc36eafdSMike Gerdts {
385bc36eafdSMike Gerdts ACPI_STATUS Status;
386bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
387bc36eafdSMike Gerdts
388bc36eafdSMike Gerdts
389bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiGetPossibleResources);
390bc36eafdSMike Gerdts
391bc36eafdSMike Gerdts
392bc36eafdSMike Gerdts /* Validate parameters then dispatch to internal routine */
393bc36eafdSMike Gerdts
394bc36eafdSMike Gerdts Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
395bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
396bc36eafdSMike Gerdts {
397bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
398bc36eafdSMike Gerdts }
399bc36eafdSMike Gerdts
400bc36eafdSMike Gerdts Status = AcpiRsGetPrsMethodData (Node, RetBuffer);
401bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
402bc36eafdSMike Gerdts }
403bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiGetPossibleResources)404bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiGetPossibleResources)
405bc36eafdSMike Gerdts
406bc36eafdSMike Gerdts
407bc36eafdSMike Gerdts /*******************************************************************************
408bc36eafdSMike Gerdts *
409bc36eafdSMike Gerdts * FUNCTION: AcpiSetCurrentResources
410bc36eafdSMike Gerdts *
411bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to the device object for the
412bc36eafdSMike Gerdts * device we are setting resources
413bc36eafdSMike Gerdts * InBuffer - Pointer to a buffer containing the
414bc36eafdSMike Gerdts * resources to be set for the device
415bc36eafdSMike Gerdts *
416bc36eafdSMike Gerdts * RETURN: Status
417bc36eafdSMike Gerdts *
418bc36eafdSMike Gerdts * DESCRIPTION: This function is called to set the current resources for a
419bc36eafdSMike Gerdts * specific device. The caller must first acquire a handle for
420bc36eafdSMike Gerdts * the desired device. The resource data is passed to the routine
421bc36eafdSMike Gerdts * the buffer pointed to by the InBuffer variable.
422bc36eafdSMike Gerdts *
423bc36eafdSMike Gerdts ******************************************************************************/
424bc36eafdSMike Gerdts
425bc36eafdSMike Gerdts ACPI_STATUS
426bc36eafdSMike Gerdts AcpiSetCurrentResources (
427bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
428bc36eafdSMike Gerdts ACPI_BUFFER *InBuffer)
429bc36eafdSMike Gerdts {
430bc36eafdSMike Gerdts ACPI_STATUS Status;
431bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
432bc36eafdSMike Gerdts
433bc36eafdSMike Gerdts
434bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiSetCurrentResources);
435bc36eafdSMike Gerdts
436bc36eafdSMike Gerdts
437bc36eafdSMike Gerdts /* Validate the buffer, don't allow zero length */
438bc36eafdSMike Gerdts
439bc36eafdSMike Gerdts if ((!InBuffer) ||
440bc36eafdSMike Gerdts (!InBuffer->Pointer) ||
441bc36eafdSMike Gerdts (!InBuffer->Length))
442bc36eafdSMike Gerdts {
443bc36eafdSMike Gerdts return_ACPI_STATUS (AE_BAD_PARAMETER);
444bc36eafdSMike Gerdts }
445bc36eafdSMike Gerdts
446bc36eafdSMike Gerdts /* Validate parameters then dispatch to internal routine */
447bc36eafdSMike Gerdts
448bc36eafdSMike Gerdts Status = AcpiRsValidateParameters (DeviceHandle, InBuffer, &Node);
449bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
450bc36eafdSMike Gerdts {
451bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
452bc36eafdSMike Gerdts }
453bc36eafdSMike Gerdts
454bc36eafdSMike Gerdts Status = AcpiRsSetSrsMethodData (Node, InBuffer);
455bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
456bc36eafdSMike Gerdts }
457bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiSetCurrentResources)458bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiSetCurrentResources)
459bc36eafdSMike Gerdts
460bc36eafdSMike Gerdts
461bc36eafdSMike Gerdts /*******************************************************************************
462bc36eafdSMike Gerdts *
463bc36eafdSMike Gerdts * FUNCTION: AcpiGetEventResources
464bc36eafdSMike Gerdts *
465bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to the device object for the
466bc36eafdSMike Gerdts * device we are getting resources
467bc36eafdSMike Gerdts * InBuffer - Pointer to a buffer containing the
468bc36eafdSMike Gerdts * resources to be set for the device
469bc36eafdSMike Gerdts *
470bc36eafdSMike Gerdts * RETURN: Status
471bc36eafdSMike Gerdts *
472bc36eafdSMike Gerdts * DESCRIPTION: This function is called to get the event resources for a
473bc36eafdSMike Gerdts * specific device. The caller must first acquire a handle for
474bc36eafdSMike Gerdts * the desired device. The resource data is passed to the routine
475bc36eafdSMike Gerdts * the buffer pointed to by the InBuffer variable. Uses the
476bc36eafdSMike Gerdts * _AEI method.
477bc36eafdSMike Gerdts *
478bc36eafdSMike Gerdts ******************************************************************************/
479bc36eafdSMike Gerdts
480bc36eafdSMike Gerdts ACPI_STATUS
481bc36eafdSMike Gerdts AcpiGetEventResources (
482bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
483bc36eafdSMike Gerdts ACPI_BUFFER *RetBuffer)
484bc36eafdSMike Gerdts {
485bc36eafdSMike Gerdts ACPI_STATUS Status;
486bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
487bc36eafdSMike Gerdts
488bc36eafdSMike Gerdts
489bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiGetEventResources);
490bc36eafdSMike Gerdts
491bc36eafdSMike Gerdts
492bc36eafdSMike Gerdts /* Validate parameters then dispatch to internal routine */
493bc36eafdSMike Gerdts
494bc36eafdSMike Gerdts Status = AcpiRsValidateParameters (DeviceHandle, RetBuffer, &Node);
495bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
496bc36eafdSMike Gerdts {
497bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
498bc36eafdSMike Gerdts }
499bc36eafdSMike Gerdts
500bc36eafdSMike Gerdts Status = AcpiRsGetAeiMethodData (Node, RetBuffer);
501bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
502bc36eafdSMike Gerdts }
503bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiGetEventResources)504bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiGetEventResources)
505bc36eafdSMike Gerdts
506bc36eafdSMike Gerdts
507bc36eafdSMike Gerdts /******************************************************************************
508bc36eafdSMike Gerdts *
509bc36eafdSMike Gerdts * FUNCTION: AcpiResourceToAddress64
510bc36eafdSMike Gerdts *
511bc36eafdSMike Gerdts * PARAMETERS: Resource - Pointer to a resource
512bc36eafdSMike Gerdts * Out - Pointer to the users's return buffer
513bc36eafdSMike Gerdts * (a struct acpi_resource_address64)
514bc36eafdSMike Gerdts *
515bc36eafdSMike Gerdts * RETURN: Status
516bc36eafdSMike Gerdts *
517bc36eafdSMike Gerdts * DESCRIPTION: If the resource is an address16, address32, or address64,
518bc36eafdSMike Gerdts * copy it to the address64 return buffer. This saves the
519bc36eafdSMike Gerdts * caller from having to duplicate code for different-sized
520bc36eafdSMike Gerdts * addresses.
521bc36eafdSMike Gerdts *
522bc36eafdSMike Gerdts ******************************************************************************/
523bc36eafdSMike Gerdts
524bc36eafdSMike Gerdts ACPI_STATUS
525bc36eafdSMike Gerdts AcpiResourceToAddress64 (
526bc36eafdSMike Gerdts ACPI_RESOURCE *Resource,
527bc36eafdSMike Gerdts ACPI_RESOURCE_ADDRESS64 *Out)
528bc36eafdSMike Gerdts {
529bc36eafdSMike Gerdts ACPI_RESOURCE_ADDRESS16 *Address16;
530bc36eafdSMike Gerdts ACPI_RESOURCE_ADDRESS32 *Address32;
531bc36eafdSMike Gerdts
532bc36eafdSMike Gerdts
533bc36eafdSMike Gerdts if (!Resource || !Out)
534bc36eafdSMike Gerdts {
535bc36eafdSMike Gerdts return (AE_BAD_PARAMETER);
536bc36eafdSMike Gerdts }
537bc36eafdSMike Gerdts
538bc36eafdSMike Gerdts /* Convert 16 or 32 address descriptor to 64 */
539bc36eafdSMike Gerdts
540bc36eafdSMike Gerdts switch (Resource->Type)
541bc36eafdSMike Gerdts {
542bc36eafdSMike Gerdts case ACPI_RESOURCE_TYPE_ADDRESS16:
543bc36eafdSMike Gerdts
544bc36eafdSMike Gerdts Address16 = ACPI_CAST_PTR (
545bc36eafdSMike Gerdts ACPI_RESOURCE_ADDRESS16, &Resource->Data);
546bc36eafdSMike Gerdts ACPI_COPY_ADDRESS (Out, Address16);
547bc36eafdSMike Gerdts break;
548bc36eafdSMike Gerdts
549bc36eafdSMike Gerdts case ACPI_RESOURCE_TYPE_ADDRESS32:
550bc36eafdSMike Gerdts
551bc36eafdSMike Gerdts Address32 = ACPI_CAST_PTR (
552bc36eafdSMike Gerdts ACPI_RESOURCE_ADDRESS32, &Resource->Data);
553bc36eafdSMike Gerdts ACPI_COPY_ADDRESS (Out, Address32);
554bc36eafdSMike Gerdts break;
555bc36eafdSMike Gerdts
556bc36eafdSMike Gerdts case ACPI_RESOURCE_TYPE_ADDRESS64:
557bc36eafdSMike Gerdts
558bc36eafdSMike Gerdts /* Simple copy for 64 bit source */
559bc36eafdSMike Gerdts
560bc36eafdSMike Gerdts memcpy (Out, &Resource->Data, sizeof (ACPI_RESOURCE_ADDRESS64));
561bc36eafdSMike Gerdts break;
562bc36eafdSMike Gerdts
563bc36eafdSMike Gerdts default:
564bc36eafdSMike Gerdts
565bc36eafdSMike Gerdts return (AE_BAD_PARAMETER);
566bc36eafdSMike Gerdts }
567bc36eafdSMike Gerdts
568bc36eafdSMike Gerdts return (AE_OK);
569bc36eafdSMike Gerdts }
570bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiResourceToAddress64)571bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiResourceToAddress64)
572bc36eafdSMike Gerdts
573bc36eafdSMike Gerdts
574bc36eafdSMike Gerdts /*******************************************************************************
575bc36eafdSMike Gerdts *
576bc36eafdSMike Gerdts * FUNCTION: AcpiGetVendorResource
577bc36eafdSMike Gerdts *
578bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle for the parent device object
579bc36eafdSMike Gerdts * Name - Method name for the parent resource
580bc36eafdSMike Gerdts * (METHOD_NAME__CRS or METHOD_NAME__PRS)
581bc36eafdSMike Gerdts * Uuid - Pointer to the UUID to be matched.
582bc36eafdSMike Gerdts * includes both subtype and 16-byte UUID
583bc36eafdSMike Gerdts * RetBuffer - Where the vendor resource is returned
584bc36eafdSMike Gerdts *
585bc36eafdSMike Gerdts * RETURN: Status
586bc36eafdSMike Gerdts *
587bc36eafdSMike Gerdts * DESCRIPTION: Walk a resource template for the specified device to find a
588bc36eafdSMike Gerdts * vendor-defined resource that matches the supplied UUID and
589bc36eafdSMike Gerdts * UUID subtype. Returns a ACPI_RESOURCE of type Vendor.
590bc36eafdSMike Gerdts *
591bc36eafdSMike Gerdts ******************************************************************************/
592bc36eafdSMike Gerdts
593bc36eafdSMike Gerdts ACPI_STATUS
594bc36eafdSMike Gerdts AcpiGetVendorResource (
595bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
596bc36eafdSMike Gerdts char *Name,
597bc36eafdSMike Gerdts ACPI_VENDOR_UUID *Uuid,
598bc36eafdSMike Gerdts ACPI_BUFFER *RetBuffer)
599bc36eafdSMike Gerdts {
600bc36eafdSMike Gerdts ACPI_VENDOR_WALK_INFO Info;
601bc36eafdSMike Gerdts ACPI_STATUS Status;
602bc36eafdSMike Gerdts
603bc36eafdSMike Gerdts
604bc36eafdSMike Gerdts /* Other parameters are validated by AcpiWalkResources */
605bc36eafdSMike Gerdts
606bc36eafdSMike Gerdts if (!Uuid || !RetBuffer)
607bc36eafdSMike Gerdts {
608bc36eafdSMike Gerdts return (AE_BAD_PARAMETER);
609bc36eafdSMike Gerdts }
610bc36eafdSMike Gerdts
611bc36eafdSMike Gerdts Info.Uuid = Uuid;
612bc36eafdSMike Gerdts Info.Buffer = RetBuffer;
613bc36eafdSMike Gerdts Info.Status = AE_NOT_EXIST;
614bc36eafdSMike Gerdts
615bc36eafdSMike Gerdts /* Walk the _CRS or _PRS resource list for this device */
616bc36eafdSMike Gerdts
617bc36eafdSMike Gerdts Status = AcpiWalkResources (
618bc36eafdSMike Gerdts DeviceHandle, Name, AcpiRsMatchVendorResource, &Info);
619bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
620bc36eafdSMike Gerdts {
621bc36eafdSMike Gerdts return (Status);
622bc36eafdSMike Gerdts }
623bc36eafdSMike Gerdts
624bc36eafdSMike Gerdts return (Info.Status);
625bc36eafdSMike Gerdts }
626bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiGetVendorResource)627bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiGetVendorResource)
628bc36eafdSMike Gerdts
629bc36eafdSMike Gerdts
630bc36eafdSMike Gerdts /*******************************************************************************
631bc36eafdSMike Gerdts *
632bc36eafdSMike Gerdts * FUNCTION: AcpiRsMatchVendorResource
633bc36eafdSMike Gerdts *
634bc36eafdSMike Gerdts * PARAMETERS: ACPI_WALK_RESOURCE_CALLBACK
635bc36eafdSMike Gerdts *
636bc36eafdSMike Gerdts * RETURN: Status
637bc36eafdSMike Gerdts *
638bc36eafdSMike Gerdts * DESCRIPTION: Match a vendor resource via the ACPI 3.0 UUID
639bc36eafdSMike Gerdts *
640bc36eafdSMike Gerdts ******************************************************************************/
641bc36eafdSMike Gerdts
642bc36eafdSMike Gerdts static ACPI_STATUS
643bc36eafdSMike Gerdts AcpiRsMatchVendorResource (
644bc36eafdSMike Gerdts ACPI_RESOURCE *Resource,
645bc36eafdSMike Gerdts void *Context)
646bc36eafdSMike Gerdts {
647bc36eafdSMike Gerdts ACPI_VENDOR_WALK_INFO *Info = Context;
648bc36eafdSMike Gerdts ACPI_RESOURCE_VENDOR_TYPED *Vendor;
649bc36eafdSMike Gerdts ACPI_BUFFER *Buffer;
650bc36eafdSMike Gerdts ACPI_STATUS Status;
651bc36eafdSMike Gerdts
652bc36eafdSMike Gerdts
653bc36eafdSMike Gerdts /* Ignore all descriptors except Vendor */
654bc36eafdSMike Gerdts
655bc36eafdSMike Gerdts if (Resource->Type != ACPI_RESOURCE_TYPE_VENDOR)
656bc36eafdSMike Gerdts {
657bc36eafdSMike Gerdts return (AE_OK);
658bc36eafdSMike Gerdts }
659bc36eafdSMike Gerdts
660bc36eafdSMike Gerdts Vendor = &Resource->Data.VendorTyped;
661bc36eafdSMike Gerdts
662bc36eafdSMike Gerdts /*
663bc36eafdSMike Gerdts * For a valid match, these conditions must hold:
664bc36eafdSMike Gerdts *
665bc36eafdSMike Gerdts * 1) Length of descriptor data must be at least as long as a UUID struct
666bc36eafdSMike Gerdts * 2) The UUID subtypes must match
667bc36eafdSMike Gerdts * 3) The UUID data must match
668bc36eafdSMike Gerdts */
669bc36eafdSMike Gerdts if ((Vendor->ByteLength < (ACPI_UUID_LENGTH + 1)) ||
670bc36eafdSMike Gerdts (Vendor->UuidSubtype != Info->Uuid->Subtype) ||
671bc36eafdSMike Gerdts (memcmp (Vendor->Uuid, Info->Uuid->Data, ACPI_UUID_LENGTH)))
672bc36eafdSMike Gerdts {
673bc36eafdSMike Gerdts return (AE_OK);
674bc36eafdSMike Gerdts }
675bc36eafdSMike Gerdts
676bc36eafdSMike Gerdts /* Validate/Allocate/Clear caller buffer */
677bc36eafdSMike Gerdts
678bc36eafdSMike Gerdts Buffer = Info->Buffer;
679bc36eafdSMike Gerdts Status = AcpiUtInitializeBuffer (Buffer, Resource->Length);
680bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
681bc36eafdSMike Gerdts {
682bc36eafdSMike Gerdts return (Status);
683bc36eafdSMike Gerdts }
684bc36eafdSMike Gerdts
685bc36eafdSMike Gerdts /* Found the correct resource, copy and return it */
686bc36eafdSMike Gerdts
687bc36eafdSMike Gerdts memcpy (Buffer->Pointer, Resource, Resource->Length);
688bc36eafdSMike Gerdts Buffer->Length = Resource->Length;
689bc36eafdSMike Gerdts
690bc36eafdSMike Gerdts /* Found the desired descriptor, terminate resource walk */
691bc36eafdSMike Gerdts
692bc36eafdSMike Gerdts Info->Status = AE_OK;
693bc36eafdSMike Gerdts return (AE_CTRL_TERMINATE);
694bc36eafdSMike Gerdts }
695bc36eafdSMike Gerdts
696bc36eafdSMike Gerdts
697bc36eafdSMike Gerdts /*******************************************************************************
698bc36eafdSMike Gerdts *
699bc36eafdSMike Gerdts * FUNCTION: AcpiWalkResourceBuffer
700bc36eafdSMike Gerdts *
701bc36eafdSMike Gerdts * PARAMETERS: Buffer - Formatted buffer returned by one of the
702bc36eafdSMike Gerdts * various Get*Resource functions
703bc36eafdSMike Gerdts * UserFunction - Called for each resource
704bc36eafdSMike Gerdts * Context - Passed to UserFunction
705bc36eafdSMike Gerdts *
706bc36eafdSMike Gerdts * RETURN: Status
707bc36eafdSMike Gerdts *
708bc36eafdSMike Gerdts * DESCRIPTION: Walks the input resource template. The UserFunction is called
709bc36eafdSMike Gerdts * once for each resource in the list.
710bc36eafdSMike Gerdts *
711bc36eafdSMike Gerdts ******************************************************************************/
712bc36eafdSMike Gerdts
713bc36eafdSMike Gerdts ACPI_STATUS
AcpiWalkResourceBuffer(ACPI_BUFFER * Buffer,ACPI_WALK_RESOURCE_CALLBACK UserFunction,void * Context)714bc36eafdSMike Gerdts AcpiWalkResourceBuffer (
715bc36eafdSMike Gerdts ACPI_BUFFER *Buffer,
716bc36eafdSMike Gerdts ACPI_WALK_RESOURCE_CALLBACK UserFunction,
717bc36eafdSMike Gerdts void *Context)
718bc36eafdSMike Gerdts {
719bc36eafdSMike Gerdts ACPI_STATUS Status = AE_OK;
720bc36eafdSMike Gerdts ACPI_RESOURCE *Resource;
721bc36eafdSMike Gerdts ACPI_RESOURCE *ResourceEnd;
722bc36eafdSMike Gerdts
723bc36eafdSMike Gerdts
724bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiWalkResourceBuffer);
725bc36eafdSMike Gerdts
726bc36eafdSMike Gerdts
727bc36eafdSMike Gerdts /* Parameter validation */
728bc36eafdSMike Gerdts
729bc36eafdSMike Gerdts if (!Buffer || !Buffer->Pointer || !UserFunction)
730bc36eafdSMike Gerdts {
731bc36eafdSMike Gerdts return_ACPI_STATUS (AE_BAD_PARAMETER);
732bc36eafdSMike Gerdts }
733bc36eafdSMike Gerdts
734bc36eafdSMike Gerdts /* Buffer contains the resource list and length */
735bc36eafdSMike Gerdts
736bc36eafdSMike Gerdts Resource = ACPI_CAST_PTR (ACPI_RESOURCE, Buffer->Pointer);
737bc36eafdSMike Gerdts ResourceEnd = ACPI_ADD_PTR (
738bc36eafdSMike Gerdts ACPI_RESOURCE, Buffer->Pointer, Buffer->Length);
739bc36eafdSMike Gerdts
740bc36eafdSMike Gerdts /* Walk the resource list until the EndTag is found (or buffer end) */
741bc36eafdSMike Gerdts
742bc36eafdSMike Gerdts while (Resource < ResourceEnd)
743bc36eafdSMike Gerdts {
744bc36eafdSMike Gerdts /* Sanity check the resource type */
745bc36eafdSMike Gerdts
746bc36eafdSMike Gerdts if (Resource->Type > ACPI_RESOURCE_TYPE_MAX)
747bc36eafdSMike Gerdts {
748bc36eafdSMike Gerdts Status = AE_AML_INVALID_RESOURCE_TYPE;
749bc36eafdSMike Gerdts break;
750bc36eafdSMike Gerdts }
751bc36eafdSMike Gerdts
752bc36eafdSMike Gerdts /* Sanity check the length. It must not be zero, or we loop forever */
753bc36eafdSMike Gerdts
754bc36eafdSMike Gerdts if (!Resource->Length)
755bc36eafdSMike Gerdts {
756bc36eafdSMike Gerdts return_ACPI_STATUS (AE_AML_BAD_RESOURCE_LENGTH);
757bc36eafdSMike Gerdts }
758bc36eafdSMike Gerdts
759bc36eafdSMike Gerdts /* Invoke the user function, abort on any error returned */
760bc36eafdSMike Gerdts
761bc36eafdSMike Gerdts Status = UserFunction (Resource, Context);
762bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
763bc36eafdSMike Gerdts {
764bc36eafdSMike Gerdts if (Status == AE_CTRL_TERMINATE)
765bc36eafdSMike Gerdts {
766bc36eafdSMike Gerdts /* This is an OK termination by the user function */
767bc36eafdSMike Gerdts
768bc36eafdSMike Gerdts Status = AE_OK;
769bc36eafdSMike Gerdts }
770bc36eafdSMike Gerdts break;
771bc36eafdSMike Gerdts }
772bc36eafdSMike Gerdts
773bc36eafdSMike Gerdts /* EndTag indicates end-of-list */
774bc36eafdSMike Gerdts
775bc36eafdSMike Gerdts if (Resource->Type == ACPI_RESOURCE_TYPE_END_TAG)
776bc36eafdSMike Gerdts {
777bc36eafdSMike Gerdts break;
778bc36eafdSMike Gerdts }
779bc36eafdSMike Gerdts
780bc36eafdSMike Gerdts /* Get the next resource descriptor */
781bc36eafdSMike Gerdts
782bc36eafdSMike Gerdts Resource = ACPI_NEXT_RESOURCE (Resource);
783bc36eafdSMike Gerdts }
784bc36eafdSMike Gerdts
785bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
786bc36eafdSMike Gerdts }
787bc36eafdSMike Gerdts
ACPI_EXPORT_SYMBOL(AcpiWalkResourceBuffer)788bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiWalkResourceBuffer)
789bc36eafdSMike Gerdts
790bc36eafdSMike Gerdts
791bc36eafdSMike Gerdts /*******************************************************************************
792bc36eafdSMike Gerdts *
793bc36eafdSMike Gerdts * FUNCTION: AcpiWalkResources
794bc36eafdSMike Gerdts *
795bc36eafdSMike Gerdts * PARAMETERS: DeviceHandle - Handle to the device object for the
796bc36eafdSMike Gerdts * device we are querying
797bc36eafdSMike Gerdts * Name - Method name of the resources we want.
798bc36eafdSMike Gerdts * (METHOD_NAME__CRS, METHOD_NAME__PRS, or
799*35786f68SRobert Mustacchi * METHOD_NAME__AEI or METHOD_NAME__DMA)
800bc36eafdSMike Gerdts * UserFunction - Called for each resource
801bc36eafdSMike Gerdts * Context - Passed to UserFunction
802bc36eafdSMike Gerdts *
803bc36eafdSMike Gerdts * RETURN: Status
804bc36eafdSMike Gerdts *
805bc36eafdSMike Gerdts * DESCRIPTION: Retrieves the current or possible resource list for the
806bc36eafdSMike Gerdts * specified device. The UserFunction is called once for
807bc36eafdSMike Gerdts * each resource in the list.
808bc36eafdSMike Gerdts *
809bc36eafdSMike Gerdts ******************************************************************************/
810bc36eafdSMike Gerdts
811bc36eafdSMike Gerdts ACPI_STATUS
812bc36eafdSMike Gerdts AcpiWalkResources (
813bc36eafdSMike Gerdts ACPI_HANDLE DeviceHandle,
814bc36eafdSMike Gerdts char *Name,
815bc36eafdSMike Gerdts ACPI_WALK_RESOURCE_CALLBACK UserFunction,
816bc36eafdSMike Gerdts void *Context)
817bc36eafdSMike Gerdts {
818bc36eafdSMike Gerdts ACPI_STATUS Status;
819bc36eafdSMike Gerdts ACPI_BUFFER Buffer;
820bc36eafdSMike Gerdts
821bc36eafdSMike Gerdts
822bc36eafdSMike Gerdts ACPI_FUNCTION_TRACE (AcpiWalkResources);
823bc36eafdSMike Gerdts
824bc36eafdSMike Gerdts
825bc36eafdSMike Gerdts /* Parameter validation */
826bc36eafdSMike Gerdts
827bc36eafdSMike Gerdts if (!DeviceHandle || !UserFunction || !Name ||
828bc36eafdSMike Gerdts (!ACPI_COMPARE_NAME (Name, METHOD_NAME__CRS) &&
829bc36eafdSMike Gerdts !ACPI_COMPARE_NAME (Name, METHOD_NAME__PRS) &&
830*35786f68SRobert Mustacchi !ACPI_COMPARE_NAME (Name, METHOD_NAME__AEI) &&
831*35786f68SRobert Mustacchi !ACPI_COMPARE_NAME (Name, METHOD_NAME__DMA)))
832bc36eafdSMike Gerdts {
833bc36eafdSMike Gerdts return_ACPI_STATUS (AE_BAD_PARAMETER);
834bc36eafdSMike Gerdts }
835bc36eafdSMike Gerdts
836*35786f68SRobert Mustacchi /* Get the _CRS/_PRS/_AEI/_DMA resource list */
837bc36eafdSMike Gerdts
838bc36eafdSMike Gerdts Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
839bc36eafdSMike Gerdts Status = AcpiRsGetMethodData (DeviceHandle, Name, &Buffer);
840bc36eafdSMike Gerdts if (ACPI_FAILURE (Status))
841bc36eafdSMike Gerdts {
842bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
843bc36eafdSMike Gerdts }
844bc36eafdSMike Gerdts
845bc36eafdSMike Gerdts /* Walk the resource list and cleanup */
846bc36eafdSMike Gerdts
847bc36eafdSMike Gerdts Status = AcpiWalkResourceBuffer (&Buffer, UserFunction, Context);
848bc36eafdSMike Gerdts ACPI_FREE (Buffer.Pointer);
849bc36eafdSMike Gerdts return_ACPI_STATUS (Status);
850bc36eafdSMike Gerdts }
851bc36eafdSMike Gerdts
852bc36eafdSMike Gerdts ACPI_EXPORT_SYMBOL (AcpiWalkResources)
853