1 /*******************************************************************************
3 * Module Name: rscreate - Create resource lists/tables
5 ******************************************************************************/
8 * Copyright (C) 2000 - 2011, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
44 #define __RSCREATE_C__
46 #include <contrib/dev/acpica/include/acpi.h>
47 #include <contrib/dev/acpica/include/accommon.h>
48 #include <contrib/dev/acpica/include/acresrc.h>
49 #include <contrib/dev/acpica/include/acnamesp.h>
51 #define _COMPONENT ACPI_RESOURCES
52 ACPI_MODULE_NAME ("rscreate")
55 /*******************************************************************************
57 * FUNCTION: AcpiRsCreateResourceList
59 * PARAMETERS: AmlBuffer - Pointer to the resource byte stream
60 * OutputBuffer - Pointer to the user's buffer
62 * RETURN: Status: AE_OK if okay, else a valid ACPI_STATUS code
63 * If OutputBuffer is not large enough, OutputBufferLength
64 * indicates how large OutputBuffer should be, else it
65 * indicates how may UINT8 elements of OutputBuffer are valid.
67 * DESCRIPTION: Takes the byte stream returned from a _CRS, _PRS control method
68 * execution and parses the stream to create a linked list
69 * of device resources.
71 ******************************************************************************/
74 AcpiRsCreateResourceList (
75 ACPI_OPERAND_OBJECT *AmlBuffer,
76 ACPI_BUFFER *OutputBuffer)
81 ACPI_SIZE ListSizeNeeded = 0;
82 UINT32 AmlBufferLength;
86 ACPI_FUNCTION_TRACE (RsCreateResourceList);
89 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "AmlBuffer = %p\n",
92 /* Params already validated, so we don't re-validate here */
94 AmlBufferLength = AmlBuffer->Buffer.Length;
95 AmlStart = AmlBuffer->Buffer.Pointer;
98 * Pass the AmlBuffer into a module that can calculate
99 * the buffer size needed for the linked list
101 Status = AcpiRsGetListLength (AmlStart, AmlBufferLength,
104 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Status=%X ListSizeNeeded=%X\n",
105 Status, (UINT32) ListSizeNeeded));
106 if (ACPI_FAILURE (Status))
108 return_ACPI_STATUS (Status);
111 /* Validate/Allocate/Clear caller buffer */
113 Status = AcpiUtInitializeBuffer (OutputBuffer, ListSizeNeeded);
114 if (ACPI_FAILURE (Status))
116 return_ACPI_STATUS (Status);
119 /* Do the conversion */
121 Resource = OutputBuffer->Pointer;
122 Status = AcpiUtWalkAmlResources (AmlStart, AmlBufferLength,
123 AcpiRsConvertAmlToResources, &Resource);
124 if (ACPI_FAILURE (Status))
126 return_ACPI_STATUS (Status);
129 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "OutputBuffer %p Length %X\n",
130 OutputBuffer->Pointer, (UINT32) OutputBuffer->Length));
131 return_ACPI_STATUS (AE_OK);
135 /*******************************************************************************
137 * FUNCTION: AcpiRsCreatePciRoutingTable
139 * PARAMETERS: PackageObject - Pointer to an ACPI_OPERAND_OBJECT
141 * OutputBuffer - Pointer to the user's buffer
143 * RETURN: Status AE_OK if okay, else a valid ACPI_STATUS code.
144 * If the OutputBuffer is too small, the error will be
145 * AE_BUFFER_OVERFLOW and OutputBuffer->Length will point
146 * to the size buffer needed.
148 * DESCRIPTION: Takes the ACPI_OPERAND_OBJECT package and creates a
149 * linked list of PCI interrupt descriptions
151 * NOTE: It is the caller's responsibility to ensure that the start of the
152 * output buffer is aligned properly (if necessary).
154 ******************************************************************************/
157 AcpiRsCreatePciRoutingTable (
158 ACPI_OPERAND_OBJECT *PackageObject,
159 ACPI_BUFFER *OutputBuffer)
162 ACPI_OPERAND_OBJECT **TopObjectList;
163 ACPI_OPERAND_OBJECT **SubObjectList;
164 ACPI_OPERAND_OBJECT *ObjDesc;
165 ACPI_SIZE BufferSizeNeeded = 0;
166 UINT32 NumberOfElements;
168 ACPI_PCI_ROUTING_TABLE *UserPrt;
169 ACPI_NAMESPACE_NODE *Node;
171 ACPI_BUFFER PathBuffer;
174 ACPI_FUNCTION_TRACE (RsCreatePciRoutingTable);
177 /* Params already validated, so we don't re-validate here */
179 /* Get the required buffer length */
181 Status = AcpiRsGetPciRoutingTableLength (PackageObject,
183 if (ACPI_FAILURE (Status))
185 return_ACPI_STATUS (Status);
188 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "BufferSizeNeeded = %X\n",
189 (UINT32) BufferSizeNeeded));
191 /* Validate/Allocate/Clear caller buffer */
193 Status = AcpiUtInitializeBuffer (OutputBuffer, BufferSizeNeeded);
194 if (ACPI_FAILURE (Status))
196 return_ACPI_STATUS (Status);
200 * Loop through the ACPI_INTERNAL_OBJECTS - Each object should be a
201 * package that in turn contains an UINT64 Address, a UINT8 Pin,
202 * a Name, and a UINT8 SourceIndex.
204 TopObjectList = PackageObject->Package.Elements;
205 NumberOfElements = PackageObject->Package.Count;
206 Buffer = OutputBuffer->Pointer;
207 UserPrt = ACPI_CAST_PTR (ACPI_PCI_ROUTING_TABLE, Buffer);
209 for (Index = 0; Index < NumberOfElements; Index++)
212 * Point UserPrt past this current structure
214 * NOTE: On the first iteration, UserPrt->Length will
215 * be zero because we cleared the return buffer earlier
217 Buffer += UserPrt->Length;
218 UserPrt = ACPI_CAST_PTR (ACPI_PCI_ROUTING_TABLE, Buffer);
221 * Fill in the Length field with the information we have at this point.
222 * The minus four is to subtract the size of the UINT8 Source[4] member
223 * because it is added below.
225 UserPrt->Length = (sizeof (ACPI_PCI_ROUTING_TABLE) - 4);
227 /* Each element of the top-level package must also be a package */
229 if ((*TopObjectList)->Common.Type != ACPI_TYPE_PACKAGE)
231 ACPI_ERROR ((AE_INFO,
232 "(PRT[%u]) Need sub-package, found %s",
233 Index, AcpiUtGetObjectTypeName (*TopObjectList)));
234 return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
237 /* Each sub-package must be of length 4 */
239 if ((*TopObjectList)->Package.Count != 4)
241 ACPI_ERROR ((AE_INFO,
242 "(PRT[%u]) Need package of length 4, found length %u",
243 Index, (*TopObjectList)->Package.Count));
244 return_ACPI_STATUS (AE_AML_PACKAGE_LIMIT);
248 * Dereference the sub-package.
249 * The SubObjectList will now point to an array of the four IRQ
250 * elements: [Address, Pin, Source, SourceIndex]
252 SubObjectList = (*TopObjectList)->Package.Elements;
254 /* 1) First subobject: Dereference the PRT.Address */
256 ObjDesc = SubObjectList[0];
257 if (ObjDesc->Common.Type != ACPI_TYPE_INTEGER)
259 ACPI_ERROR ((AE_INFO, "(PRT[%u].Address) Need Integer, found %s",
260 Index, AcpiUtGetObjectTypeName (ObjDesc)));
261 return_ACPI_STATUS (AE_BAD_DATA);
264 UserPrt->Address = ObjDesc->Integer.Value;
266 /* 2) Second subobject: Dereference the PRT.Pin */
268 ObjDesc = SubObjectList[1];
269 if (ObjDesc->Common.Type != ACPI_TYPE_INTEGER)
271 ACPI_ERROR ((AE_INFO, "(PRT[%u].Pin) Need Integer, found %s",
272 Index, AcpiUtGetObjectTypeName (ObjDesc)));
273 return_ACPI_STATUS (AE_BAD_DATA);
276 UserPrt->Pin = (UINT32) ObjDesc->Integer.Value;
279 * If the BIOS has erroneously reversed the _PRT SourceName (index 2)
280 * and the SourceIndex (index 3), fix it. _PRT is important enough to
281 * workaround this BIOS error. This also provides compatibility with
282 * other ACPI implementations.
284 ObjDesc = SubObjectList[3];
285 if (!ObjDesc || (ObjDesc->Common.Type != ACPI_TYPE_INTEGER))
287 SubObjectList[3] = SubObjectList[2];
288 SubObjectList[2] = ObjDesc;
290 ACPI_WARNING ((AE_INFO,
291 "(PRT[%X].Source) SourceName and SourceIndex are reversed, fixed",
296 * 3) Third subobject: Dereference the PRT.SourceName
297 * The name may be unresolved (slack mode), so allow a null object
299 ObjDesc = SubObjectList[2];
302 switch (ObjDesc->Common.Type)
304 case ACPI_TYPE_LOCAL_REFERENCE:
306 if (ObjDesc->Reference.Class != ACPI_REFCLASS_NAME)
308 ACPI_ERROR ((AE_INFO,
309 "(PRT[%u].Source) Need name, found Reference Class 0x%X",
310 Index, ObjDesc->Reference.Class));
311 return_ACPI_STATUS (AE_BAD_DATA);
314 Node = ObjDesc->Reference.Node;
316 /* Use *remaining* length of the buffer as max for pathname */
318 PathBuffer.Length = OutputBuffer->Length -
319 (UINT32) ((UINT8 *) UserPrt->Source -
320 (UINT8 *) OutputBuffer->Pointer);
321 PathBuffer.Pointer = UserPrt->Source;
323 Status = AcpiNsHandleToPathname ((ACPI_HANDLE) Node, &PathBuffer);
325 /* +1 to include null terminator */
327 UserPrt->Length += (UINT32) ACPI_STRLEN (UserPrt->Source) + 1;
331 case ACPI_TYPE_STRING:
333 ACPI_STRCPY (UserPrt->Source, ObjDesc->String.Pointer);
336 * Add to the Length field the length of the string
337 * (add 1 for terminator)
339 UserPrt->Length += ObjDesc->String.Length + 1;
343 case ACPI_TYPE_INTEGER:
345 * If this is a number, then the Source Name is NULL, since the
346 * entire buffer was zeroed out, we can leave this alone.
348 * Add to the Length field the length of the UINT32 NULL
350 UserPrt->Length += sizeof (UINT32);
356 ACPI_ERROR ((AE_INFO,
357 "(PRT[%u].Source) Need Ref/String/Integer, found %s",
358 Index, AcpiUtGetObjectTypeName (ObjDesc)));
359 return_ACPI_STATUS (AE_BAD_DATA);
363 /* Now align the current length */
365 UserPrt->Length = (UINT32) ACPI_ROUND_UP_TO_64BIT (UserPrt->Length);
367 /* 4) Fourth subobject: Dereference the PRT.SourceIndex */
369 ObjDesc = SubObjectList[3];
370 if (ObjDesc->Common.Type != ACPI_TYPE_INTEGER)
372 ACPI_ERROR ((AE_INFO,
373 "(PRT[%u].SourceIndex) Need Integer, found %s",
374 Index, AcpiUtGetObjectTypeName (ObjDesc)));
375 return_ACPI_STATUS (AE_BAD_DATA);
378 UserPrt->SourceIndex = (UINT32) ObjDesc->Integer.Value;
380 /* Point to the next ACPI_OPERAND_OBJECT in the top level package */
385 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "OutputBuffer %p Length %X\n",
386 OutputBuffer->Pointer, (UINT32) OutputBuffer->Length));
387 return_ACPI_STATUS (AE_OK);
391 /*******************************************************************************
393 * FUNCTION: AcpiRsCreateAmlResources
395 * PARAMETERS: LinkedListBuffer - Pointer to the resource linked list
396 * OutputBuffer - Pointer to the user's buffer
398 * RETURN: Status AE_OK if okay, else a valid ACPI_STATUS code.
399 * If the OutputBuffer is too small, the error will be
400 * AE_BUFFER_OVERFLOW and OutputBuffer->Length will point
401 * to the size buffer needed.
403 * DESCRIPTION: Takes the linked list of device resources and
404 * creates a bytestream to be used as input for the
405 * _SRS control method.
407 ******************************************************************************/
410 AcpiRsCreateAmlResources (
411 ACPI_RESOURCE *LinkedListBuffer,
412 ACPI_BUFFER *OutputBuffer)
415 ACPI_SIZE AmlSizeNeeded = 0;
418 ACPI_FUNCTION_TRACE (RsCreateAmlResources);
421 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "LinkedListBuffer = %p\n",
425 * Params already validated, so we don't re-validate here
427 * Pass the LinkedListBuffer into a module that calculates
428 * the buffer size needed for the byte stream.
430 Status = AcpiRsGetAmlLength (LinkedListBuffer,
433 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "AmlSizeNeeded=%X, %s\n",
434 (UINT32) AmlSizeNeeded, AcpiFormatException (Status)));
435 if (ACPI_FAILURE (Status))
437 return_ACPI_STATUS (Status);
440 /* Validate/Allocate/Clear caller buffer */
442 Status = AcpiUtInitializeBuffer (OutputBuffer, AmlSizeNeeded);
443 if (ACPI_FAILURE (Status))
445 return_ACPI_STATUS (Status);
448 /* Do the conversion */
450 Status = AcpiRsConvertResourcesToAml (LinkedListBuffer, AmlSizeNeeded,
451 OutputBuffer->Pointer);
452 if (ACPI_FAILURE (Status))
454 return_ACPI_STATUS (Status);
457 ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "OutputBuffer %p Length %X\n",
458 OutputBuffer->Pointer, (UINT32) OutputBuffer->Length));
459 return_ACPI_STATUS (AE_OK);