xref: /illumos-gate/usr/src/cmd/acpi/common/dmrestag.c (revision 35786f68)
1 /******************************************************************************
2  *
3  * Module Name: dmrestag - Add tags to resource descriptors (Application-level)
4  *
5  *****************************************************************************/
6 
7 /******************************************************************************
8  *
9  * 1. Copyright Notice
10  *
11  * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
12  * All rights reserved.
13  *
14  * 2. License
15  *
16  * 2.1. This is your license from Intel Corp. under its intellectual property
17  * rights. You may have additional license terms from the party that provided
18  * you this software, covering your right to use that party's intellectual
19  * property rights.
20  *
21  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22  * copy of the source code appearing in this file ("Covered Code") an
23  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24  * base code distributed originally by Intel ("Original Intel Code") to copy,
25  * make derivatives, distribute, use and display any portion of the Covered
26  * Code in any form, with the right to sublicense such rights; and
27  *
28  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29  * license (with the right to sublicense), under only those claims of Intel
30  * patents that are infringed by the Original Intel Code, to make, use, sell,
31  * offer to sell, and import the Covered Code and derivative works thereof
32  * solely to the minimum extent necessary to exercise the above copyright
33  * license, and in no event shall the patent license extend to any additions
34  * to or modifications of the Original Intel Code. No other license or right
35  * is granted directly or by implication, estoppel or otherwise;
36  *
37  * The above copyright and patent license is granted only if the following
38  * conditions are met:
39  *
40  * 3. Conditions
41  *
42  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43  * Redistribution of source code of any substantial portion of the Covered
44  * Code or modification with rights to further distribute source must include
45  * the above Copyright Notice, the above License, this list of Conditions,
46  * and the following Disclaimer and Export Compliance provision. In addition,
47  * Licensee must cause all Covered Code to which Licensee contributes to
48  * contain a file documenting the changes Licensee made to create that Covered
49  * Code and the date of any change. Licensee must include in that file the
50  * documentation of any changes made by any predecessor Licensee. Licensee
51  * must include a prominent statement that the modification is derived,
52  * directly or indirectly, from Original Intel Code.
53  *
54  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55  * Redistribution of source code of any substantial portion of the Covered
56  * Code or modification without rights to further distribute source must
57  * include the following Disclaimer and Export Compliance provision in the
58  * documentation and/or other materials provided with distribution. In
59  * addition, Licensee may not authorize further sublicense of source of any
60  * portion of the Covered Code, and must include terms to the effect that the
61  * license from Licensee to its licensee is limited to the intellectual
62  * property embodied in the software Licensee provides to its licensee, and
63  * not to intellectual property embodied in modifications its licensee may
64  * make.
65  *
66  * 3.3. Redistribution of Executable. Redistribution in executable form of any
67  * substantial portion of the Covered Code or modification must reproduce the
68  * above Copyright Notice, and the following Disclaimer and Export Compliance
69  * provision in the documentation and/or other materials provided with the
70  * distribution.
71  *
72  * 3.4. Intel retains all right, title, and interest in and to the Original
73  * Intel Code.
74  *
75  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76  * Intel shall be used in advertising or otherwise to promote the sale, use or
77  * other dealings in products derived from or relating to the Covered Code
78  * without prior written authorization from Intel.
79  *
80  * 4. Disclaimer and Export Compliance
81  *
82  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83  * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85  * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86  * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88  * PARTICULAR PURPOSE.
89  *
90  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97  * LIMITED REMEDY.
98  *
99  * 4.3. Licensee shall not export, either directly or indirectly, any of this
100  * software or system incorporating such software without first obtaining any
101  * required license or other approval from the U. S. Department of Commerce or
102  * any other agency or department of the United States Government. In the
103  * event Licensee exports any such software from the United States or
104  * re-exports any such software from a foreign destination, Licensee shall
105  * ensure that the distribution and export/re-export of the software is in
106  * compliance with all laws, regulations, orders, or other restrictions of the
107  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108  * any of its subsidiaries will export/re-export any technical data, process,
109  * software, or service, directly or indirectly, to any country for which the
110  * United States government or any agency thereof requires an export license,
111  * other governmental approval, or letter of assurance, without first obtaining
112  * such license, approval or letter.
113  *
114  *****************************************************************************
115  *
116  * Alternatively, you may choose to be licensed under the terms of the
117  * following license:
118  *
119  * Redistribution and use in source and binary forms, with or without
120  * modification, are permitted provided that the following conditions
121  * are met:
122  * 1. Redistributions of source code must retain the above copyright
123  *    notice, this list of conditions, and the following disclaimer,
124  *    without modification.
125  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126  *    substantially similar to the "NO WARRANTY" disclaimer below
127  *    ("Disclaimer") and any redistribution must be conditioned upon
128  *    including a substantially similar Disclaimer requirement for further
129  *    binary redistribution.
130  * 3. Neither the names of the above-listed copyright holders nor the names
131  *    of any contributors may be used to endorse or promote products derived
132  *    from this software without specific prior written permission.
133  *
134  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145  *
146  * Alternatively, you may choose to be licensed under the terms of the
147  * GNU General Public License ("GPL") version 2 as published by the Free
148  * Software Foundation.
149  *
150  *****************************************************************************/
151 
152 #include "acpi.h"
153 #include "accommon.h"
154 #include "acparser.h"
155 #include "acdisasm.h"
156 #include "acnamesp.h"
157 #include "amlcode.h"
158 
159 /* This module used for application-level code only */
160 
161 #define _COMPONENT          ACPI_CA_DISASSEMBLER
162         ACPI_MODULE_NAME    ("dmrestag")
163 
164 /* Local prototypes */
165 
166 static void
167 AcpiDmUpdateResourceName (
168     ACPI_NAMESPACE_NODE     *ResourceNode);
169 
170 static char *
171 AcpiDmSearchTagList (
172     UINT32                  BitIndex,
173     const ACPI_RESOURCE_TAG *TagList);
174 
175 static char *
176 AcpiDmGetResourceTag (
177     UINT32                  BitIndex,
178     AML_RESOURCE            *Resource,
179     UINT8                   ResourceIndex);
180 
181 static char *
182 AcpiGetTagPathname (
183     ACPI_PARSE_OBJECT       *Op,
184     ACPI_NAMESPACE_NODE     *BufferNode,
185     ACPI_NAMESPACE_NODE     *ResourceNode,
186     UINT32                  BitIndex);
187 
188 static ACPI_NAMESPACE_NODE *
189 AcpiDmGetResourceNode (
190     ACPI_NAMESPACE_NODE     *BufferNode,
191     UINT32                  BitIndex);
192 
193 static ACPI_STATUS
194 AcpiDmAddResourceToNamespace (
195     UINT8                   *Aml,
196     UINT32                  Length,
197     UINT32                  Offset,
198     UINT8                   ResourceIndex,
199     void                    **Context);
200 
201 static void
202 AcpiDmAddResourcesToNamespace (
203     ACPI_NAMESPACE_NODE     *BufferNode,
204     ACPI_PARSE_OBJECT       *Op);
205 
206 
207 /******************************************************************************
208  *
209  * Resource Tag tables
210  *
211  * These are the predefined tags that refer to elements of a resource
212  * descriptor. Each name and offset is defined in the ACPI specification.
213  *
214  * Each table entry contains the bit offset of the field and the associated
215  * name.
216  *
217  ******************************************************************************/
218 
219 static const ACPI_RESOURCE_TAG      AcpiDmIrqTags[] =
220 {
221     {( 1 * 8),      ACPI_RESTAG_INTERRUPT},
222     {( 3 * 8) + 0,  ACPI_RESTAG_INTERRUPTTYPE},
223     {( 3 * 8) + 3,  ACPI_RESTAG_INTERRUPTLEVEL},
224     {( 3 * 8) + 4,  ACPI_RESTAG_INTERRUPTSHARE},
225     {0,             NULL}
226 };
227 
228 static const ACPI_RESOURCE_TAG      AcpiDmDmaTags[] =
229 {
230     {( 1 * 8),      ACPI_RESTAG_DMA},
231     {( 2 * 8) + 0,  ACPI_RESTAG_XFERTYPE},
232     {( 2 * 8) + 2,  ACPI_RESTAG_BUSMASTER},
233     {( 2 * 8) + 5,  ACPI_RESTAG_DMATYPE},
234     {0,             NULL}
235 };
236 
237 static const ACPI_RESOURCE_TAG      AcpiDmIoTags[] =
238 {
239     {( 1 * 8) + 0,  ACPI_RESTAG_DECODE},
240     {( 2 * 8),      ACPI_RESTAG_MINADDR},
241     {( 4 * 8),      ACPI_RESTAG_MAXADDR},
242     {( 6 * 8),      ACPI_RESTAG_ALIGNMENT},
243     {( 7 * 8),      ACPI_RESTAG_LENGTH},
244     {0,             NULL}
245 };
246 
247 static const ACPI_RESOURCE_TAG      AcpiDmFixedIoTags[] =
248 {
249     {( 1 * 8),      ACPI_RESTAG_BASEADDRESS},
250     {( 3 * 8),      ACPI_RESTAG_LENGTH},
251     {0,             NULL}
252 };
253 
254 static const ACPI_RESOURCE_TAG      AcpiDmFixedDmaTags[] =
255 {
256     {( 1 * 8),      ACPI_RESTAG_DMA},
257     {( 3 * 8),      ACPI_RESTAG_DMATYPE},
258     {( 5 * 8),      ACPI_RESTAG_XFERTYPE},
259     {0,             NULL}
260 };
261 
262 static const ACPI_RESOURCE_TAG      AcpiDmMemory24Tags[] =
263 {
264     {( 3 * 8) + 0,  ACPI_RESTAG_READWRITETYPE},
265     {( 4 * 8),      ACPI_RESTAG_MINADDR},
266     {( 6 * 8),      ACPI_RESTAG_MAXADDR},
267     {( 8 * 8),      ACPI_RESTAG_ALIGNMENT},
268     {(10 * 8),      ACPI_RESTAG_LENGTH},
269     {0,             NULL}
270 };
271 
272 static const ACPI_RESOURCE_TAG      AcpiDmRegisterTags[] =
273 {
274     {( 3 * 8),      ACPI_RESTAG_ADDRESSSPACE},
275     {( 4 * 8),      ACPI_RESTAG_REGISTERBITWIDTH},
276     {( 5 * 8),      ACPI_RESTAG_REGISTERBITOFFSET},
277     {( 6 * 8),      ACPI_RESTAG_ACCESSSIZE},
278     {( 7 * 8),      ACPI_RESTAG_ADDRESS},
279     {0,             NULL}
280 };
281 
282 static const ACPI_RESOURCE_TAG      AcpiDmMemory32Tags[] =
283 {
284     {( 3 * 8) + 0,  ACPI_RESTAG_READWRITETYPE},
285     {( 4 * 8),      ACPI_RESTAG_MINADDR},
286     {( 8 * 8),      ACPI_RESTAG_MAXADDR},
287     {(12 * 8),      ACPI_RESTAG_ALIGNMENT},
288     {(16 * 8),      ACPI_RESTAG_LENGTH},
289     {0,             NULL}
290 };
291 
292 static const ACPI_RESOURCE_TAG      AcpiDmFixedMemory32Tags[] =
293 {
294     {( 3 * 8) + 0,  ACPI_RESTAG_READWRITETYPE},
295     {( 4 * 8),      ACPI_RESTAG_BASEADDRESS},
296     {( 8 * 8),      ACPI_RESTAG_LENGTH},
297     {0,             NULL}
298 };
299 
300 static const ACPI_RESOURCE_TAG      AcpiDmInterruptTags[] =
301 {
302     {( 3 * 8) + 1,  ACPI_RESTAG_INTERRUPTTYPE},
303     {( 3 * 8) + 2,  ACPI_RESTAG_INTERRUPTLEVEL},
304     {( 3 * 8) + 3,  ACPI_RESTAG_INTERRUPTSHARE},
305     {( 5 * 8),      ACPI_RESTAG_INTERRUPT},
306     {0,             NULL}
307 };
308 
309 static const ACPI_RESOURCE_TAG      AcpiDmAddress16Tags[] =
310 {
311     {( 4 * 8) + 1,  ACPI_RESTAG_DECODE},
312     {( 4 * 8) + 2,  ACPI_RESTAG_MINTYPE},
313     {( 4 * 8) + 3,  ACPI_RESTAG_MAXTYPE},
314     {( 6 * 8),      ACPI_RESTAG_GRANULARITY},
315     {( 8 * 8),      ACPI_RESTAG_MINADDR},
316     {(10 * 8),      ACPI_RESTAG_MAXADDR},
317     {(12 * 8),      ACPI_RESTAG_TRANSLATION},
318     {(14 * 8),      ACPI_RESTAG_LENGTH},
319     {0,             NULL}
320 };
321 
322 static const ACPI_RESOURCE_TAG      AcpiDmAddress32Tags[] =
323 {
324     {( 4 * 8) + 1,  ACPI_RESTAG_DECODE},
325     {( 4 * 8) + 2,  ACPI_RESTAG_MINTYPE},
326     {( 4 * 8) + 3,  ACPI_RESTAG_MAXTYPE},
327     {( 6 * 8),      ACPI_RESTAG_GRANULARITY},
328     {(10 * 8),      ACPI_RESTAG_MINADDR},
329     {(14 * 8),      ACPI_RESTAG_MAXADDR},
330     {(18 * 8),      ACPI_RESTAG_TRANSLATION},
331     {(22 * 8),      ACPI_RESTAG_LENGTH},
332     {0,             NULL}
333 };
334 
335 static const ACPI_RESOURCE_TAG      AcpiDmAddress64Tags[] =
336 {
337     {( 4 * 8) + 1,  ACPI_RESTAG_DECODE},
338     {( 4 * 8) + 2,  ACPI_RESTAG_MINTYPE},
339     {( 4 * 8) + 3,  ACPI_RESTAG_MAXTYPE},
340     {( 6 * 8),      ACPI_RESTAG_GRANULARITY},
341     {(14 * 8),      ACPI_RESTAG_MINADDR},
342     {(22 * 8),      ACPI_RESTAG_MAXADDR},
343     {(30 * 8),      ACPI_RESTAG_TRANSLATION},
344     {(38 * 8),      ACPI_RESTAG_LENGTH},
345     {0,             NULL}
346 };
347 
348 static const ACPI_RESOURCE_TAG      AcpiDmExtendedAddressTags[] =
349 {
350     {( 4 * 8) + 1,  ACPI_RESTAG_DECODE},
351     {( 4 * 8) + 2,  ACPI_RESTAG_MINTYPE},
352     {( 4 * 8) + 3,  ACPI_RESTAG_MAXTYPE},
353     {( 8 * 8),      ACPI_RESTAG_GRANULARITY},
354     {(16 * 8),      ACPI_RESTAG_MINADDR},
355     {(24 * 8),      ACPI_RESTAG_MAXADDR},
356     {(32 * 8),      ACPI_RESTAG_TRANSLATION},
357     {(40 * 8),      ACPI_RESTAG_LENGTH},
358     {(48 * 8),      ACPI_RESTAG_TYPESPECIFICATTRIBUTES},
359     {0,             NULL}
360 };
361 
362 /* Subtype tables for GPIO descriptors */
363 
364 static const ACPI_RESOURCE_TAG      AcpiDmGpioIntTags[] =
365 {
366     {( 7 * 8) + 0,  ACPI_RESTAG_MODE},
367     {( 7 * 8) + 1,  ACPI_RESTAG_POLARITY},
368     {( 7 * 8) + 3,  ACPI_RESTAG_INTERRUPTSHARE},
369     {( 9 * 8),      ACPI_RESTAG_PINCONFIG},
370     {(10 * 8),      ACPI_RESTAG_DRIVESTRENGTH},
371     {(12 * 8),      ACPI_RESTAG_DEBOUNCETIME},
372     {0,             NULL}
373 };
374 
375 static const ACPI_RESOURCE_TAG      AcpiDmGpioIoTags[] =
376 {
377     {( 7 * 8) + 0,  ACPI_RESTAG_IORESTRICTION},
378     {( 7 * 8) + 3,  ACPI_RESTAG_INTERRUPTSHARE},
379     {( 9 * 8),      ACPI_RESTAG_PINCONFIG},
380     {(10 * 8),      ACPI_RESTAG_DRIVESTRENGTH},
381     {(12 * 8),      ACPI_RESTAG_DEBOUNCETIME},
382     {0,             NULL}
383 };
384 
385 /* Subtype tables for SerialBus descriptors */
386 
387 static const ACPI_RESOURCE_TAG      AcpiDmI2cSerialBusTags[] =
388 {
389     {( 6 * 8) + 0,  ACPI_RESTAG_SLAVEMODE},
390     {( 6 * 8) + 2,  ACPI_RESTAG_INTERRUPTSHARE},    /* V2 - ACPI 6.0 */
391     {( 7 * 8) + 0,  ACPI_RESTAG_MODE},
392     {(12 * 8),      ACPI_RESTAG_SPEED},
393     {(16 * 8),      ACPI_RESTAG_ADDRESS},
394     {0,             NULL}
395 };
396 
397 static const ACPI_RESOURCE_TAG      AcpiDmSpiSerialBusTags[] =
398 {
399     {( 6 * 8) + 0,  ACPI_RESTAG_SLAVEMODE},
400     {( 6 * 8) + 2,  ACPI_RESTAG_INTERRUPTSHARE},    /* V2 - ACPI 6.0 */
401     {( 7 * 8) + 0,  ACPI_RESTAG_MODE},
402     {( 7 * 8) + 1,  ACPI_RESTAG_DEVICEPOLARITY},
403     {(12 * 8),      ACPI_RESTAG_SPEED},
404     {(16 * 8),      ACPI_RESTAG_LENGTH},
405     {(17 * 8),      ACPI_RESTAG_PHASE},
406     {(18 * 8),      ACPI_RESTAG_POLARITY},
407     {(19 * 8),      ACPI_RESTAG_ADDRESS},
408     {0,             NULL}
409 };
410 
411 static const ACPI_RESOURCE_TAG      AcpiDmUartSerialBusTags[] =
412 {
413     {( 6 * 8) + 0,  ACPI_RESTAG_SLAVEMODE},         /* Note: not part of original macro */
414     {( 6 * 8) + 2,  ACPI_RESTAG_INTERRUPTSHARE},    /* V2 - ACPI 6.0 */
415     {( 7 * 8) + 0,  ACPI_RESTAG_FLOWCONTROL},
416     {( 7 * 8) + 2,  ACPI_RESTAG_STOPBITS},
417     {( 7 * 8) + 4,  ACPI_RESTAG_LENGTH},
418     {( 7 * 8) + 7,  ACPI_RESTAG_ENDIANNESS},
419     {(12 * 8),      ACPI_RESTAG_SPEED},
420     {(16 * 8),      ACPI_RESTAG_LENGTH_RX},
421     {(18 * 8),      ACPI_RESTAG_LENGTH_TX},
422     {(20 * 8),      ACPI_RESTAG_PARITY},
423     {(21 * 8),      ACPI_RESTAG_LINE},
424     {0,             NULL}
425 };
426 
427 /* Subtype tables for PinFunction descriptor */
428 
429 static const ACPI_RESOURCE_TAG      AcpiDmPinFunctionTags[] =
430 {
431     {( 4 * 8),      ACPI_RESTAG_INTERRUPTSHARE},
432     {( 6 * 8),      ACPI_RESTAG_PINCONFIG},
433     {( 7 * 8),      ACPI_RESTAG_FUNCTION},
434     {0,             NULL}
435 };
436 
437 /* Subtype tables for PinConfig descriptor */
438 
439 static const ACPI_RESOURCE_TAG      AcpiDmPinConfigTags[] =
440 {
441     {( 4 * 8),      ACPI_RESTAG_INTERRUPTSHARE},
442     {( 6 * 8),      ACPI_RESTAG_PINCONFIG_TYPE},
443     {( 7 * 8),      ACPI_RESTAG_PINCONFIG_VALUE},
444     {0,             NULL}
445 };
446 
447 /* Subtype tables for PinGroupFunction descriptor */
448 
449 static const ACPI_RESOURCE_TAG      AcpiDmPinGroupFunctionTags[] =
450 {
451     {( 6 * 8),      ACPI_RESTAG_FUNCTION},
452     {0,             NULL}
453 };
454 
455 /* Subtype tables for Address descriptor type-specific flags */
456 
457 static const ACPI_RESOURCE_TAG      AcpiDmMemoryFlagTags[] =
458 {
459     {( 5 * 8) + 0,  ACPI_RESTAG_READWRITETYPE},
460     {( 5 * 8) + 1,  ACPI_RESTAG_MEMTYPE},
461     {( 5 * 8) + 3,  ACPI_RESTAG_MEMATTRIBUTES},
462     {( 5 * 8) + 5,  ACPI_RESTAG_TYPE},
463     {0,             NULL}
464 };
465 
466 static const ACPI_RESOURCE_TAG      AcpiDmIoFlagTags[] =
467 {
468     {( 5 * 8) + 0,  ACPI_RESTAG_RANGETYPE},
469     {( 5 * 8) + 4,  ACPI_RESTAG_TYPE},
470     {( 5 * 8) + 5,  ACPI_RESTAG_TRANSTYPE},
471     {0,             NULL}
472 };
473 
474 
475 /*
476  * Dispatch table used to obtain the correct tag table for a descriptor.
477  *
478  * A NULL in this table means one of three things:
479  * 1) The descriptor ID is reserved and invalid
480  * 2) The descriptor has no tags associated with it
481  * 3) The descriptor has subtypes and a separate table will be used.
482  */
483 static const ACPI_RESOURCE_TAG      *AcpiGbl_ResourceTags[] =
484 {
485     /* Small descriptors */
486 
487     NULL,                           /* 0x00, Reserved */
488     NULL,                           /* 0x01, Reserved */
489     NULL,                           /* 0x02, Reserved */
490     NULL,                           /* 0x03, Reserved */
491     AcpiDmIrqTags,                  /* 0x04, ACPI_RESOURCE_NAME_IRQ_FORMAT */
492     AcpiDmDmaTags,                  /* 0x05, ACPI_RESOURCE_NAME_DMA_FORMAT */
493     NULL,                           /* 0x06, ACPI_RESOURCE_NAME_START_DEPENDENT */
494     NULL,                           /* 0x07, ACPI_RESOURCE_NAME_END_DEPENDENT */
495     AcpiDmIoTags,                   /* 0x08, ACPI_RESOURCE_NAME_IO_PORT */
496     AcpiDmFixedIoTags,              /* 0x09, ACPI_RESOURCE_NAME_FIXED_IO_PORT */
497     AcpiDmFixedDmaTags,             /* 0x0A, ACPI_RESOURCE_NAME_FIXED_DMA */
498     NULL,                           /* 0x0B, Reserved */
499     NULL,                           /* 0x0C, Reserved */
500     NULL,                           /* 0x0D, Reserved */
501     NULL,                           /* 0x0E, ACPI_RESOURCE_NAME_SMALL_VENDOR */
502     NULL,                           /* 0x0F, ACPI_RESOURCE_NAME_END_TAG (not used) */
503 
504     /* Large descriptors */
505 
506     NULL,                           /* 0x00, Reserved */
507     AcpiDmMemory24Tags,             /* 0x01, ACPI_RESOURCE_NAME_MEMORY_24 */
508     AcpiDmRegisterTags,             /* 0x02, ACPI_RESOURCE_NAME_GENERIC_REGISTER */
509     NULL,                           /* 0x03, Reserved */
510     NULL,                           /* 0x04, ACPI_RESOURCE_NAME_LARGE_VENDOR */
511     AcpiDmMemory32Tags,             /* 0x05, ACPI_RESOURCE_NAME_MEMORY_32 */
512     AcpiDmFixedMemory32Tags,        /* 0x06, ACPI_RESOURCE_NAME_FIXED_MEMORY_32 */
513     AcpiDmAddress32Tags,            /* 0x07, ACPI_RESOURCE_NAME_DWORD_ADDRESS_SPACE */
514     AcpiDmAddress16Tags,            /* 0x08, ACPI_RESOURCE_NAME_WORD_ADDRESS_SPACE */
515     AcpiDmInterruptTags,            /* 0x09, ACPI_RESOURCE_NAME_EXTENDED_XRUPT */
516     AcpiDmAddress64Tags,            /* 0x0A, ACPI_RESOURCE_NAME_QWORD_ADDRESS_SPACE */
517     AcpiDmExtendedAddressTags,      /* 0x0B, ACPI_RESOURCE_NAME_EXTENDED_ADDRESS_SPACE */
518     NULL,                           /* 0x0C, ACPI_RESOURCE_NAME_GPIO - Use Subtype table below */
519     AcpiDmPinFunctionTags,          /* 0x0D, ACPI_RESOURCE_NAME_PIN_FUNCTION */
520     NULL,                           /* 0x0E, ACPI_RESOURCE_NAME_SERIAL_BUS - Use Subtype table below */
521     AcpiDmPinConfigTags,            /* 0x0F, ACPI_RESOURCE_NAME_PIN_CONFIG */
522     NULL,                           /* 0x10, ACPI_RESOURCE_NAME_PIN_GROUP */
523     AcpiDmPinGroupFunctionTags,     /* 0x11, ACPI_RESOURCE_NAME_PIN_GROUP_FUNCTION */
524     AcpiDmPinConfigTags,            /* 0x12, ACPI_RESOURCE_NAME_PIN_GROUP_CONFIG - Same as PinConfig */
525 };
526 
527 /* GPIO Subtypes */
528 
529 static const ACPI_RESOURCE_TAG      *AcpiGbl_GpioResourceTags[] =
530 {
531     AcpiDmGpioIntTags,              /* 0x00 Interrupt Connection */
532     AcpiDmGpioIoTags                /* 0x01 I/O Connection */
533 };
534 
535 /* Serial Bus Subtypes */
536 
537 static const ACPI_RESOURCE_TAG      *AcpiGbl_SerialResourceTags[] =
538 {
539     NULL,                           /* 0x00 Reserved */
540     AcpiDmI2cSerialBusTags,         /* 0x01 I2C SerialBus */
541     AcpiDmSpiSerialBusTags,         /* 0x02 SPI SerialBus */
542     AcpiDmUartSerialBusTags         /* 0x03 UART SerialBus */
543 };
544 
545 /*
546  * Globals used to generate unique resource descriptor names. We use names that
547  * start with underscore and a prefix letter that is not used by other ACPI
548  * reserved names. To this, we append hex 0x00 through 0xFF. These 5 prefixes
549  * allow for 5*256 = 1280 unique names, probably sufficient for any single ASL
550  * file. If this becomes too small, we can use alpha+numerals for a total
551  * of 5*36*36 = 6480.
552  */
553 #define ACPI_NUM_RES_PREFIX     5
554 
555 static UINT32                   AcpiGbl_NextResourceId = 0;
556 static UINT8                    AcpiGbl_NextPrefix = 0;
557 static char                     AcpiGbl_Prefix[ACPI_NUM_RES_PREFIX] =
558                                     {'Y','Z','J','K','X'};
559 
560 
561 /*******************************************************************************
562  *
563  * FUNCTION:    AcpiDmCheckResourceReference
564  *
565  * PARAMETERS:  Op                  - Parse Op for the AML opcode
566  *              WalkState           - Current walk state (with valid scope)
567  *
568  * RETURN:      None
569  *
570  * DESCRIPTION: Convert a reference to a resource descriptor to a symbolic
571  *              reference if possible
572  *
573  * NOTE:        Bit index is used to transparently handle both resource bit
574  *              fields and byte fields.
575  *
576  ******************************************************************************/
577 
578 void
AcpiDmCheckResourceReference(ACPI_PARSE_OBJECT * Op,ACPI_WALK_STATE * WalkState)579 AcpiDmCheckResourceReference (
580     ACPI_PARSE_OBJECT       *Op,
581     ACPI_WALK_STATE         *WalkState)
582 {
583     ACPI_STATUS             Status;
584     ACPI_PARSE_OBJECT       *BufferNameOp;
585     ACPI_PARSE_OBJECT       *IndexOp;
586     ACPI_NAMESPACE_NODE     *BufferNode;
587     ACPI_NAMESPACE_NODE     *ResourceNode;
588     const ACPI_OPCODE_INFO  *OpInfo;
589     UINT32                  BitIndex;
590 
591 
592     /* We are only interested in the CreateXxxxField opcodes */
593 
594     OpInfo = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
595     if (OpInfo->Type != AML_TYPE_CREATE_FIELD)
596     {
597         return;
598     }
599 
600     /* Get the buffer term operand */
601 
602     BufferNameOp = AcpiPsGetDepthNext (NULL, Op);
603 
604     /* Must be a named buffer, not an arg or local or method call */
605 
606     if (BufferNameOp->Common.AmlOpcode != AML_INT_NAMEPATH_OP)
607     {
608         return;
609     }
610 
611     /* Get the Index term, must be an integer constant to convert */
612 
613     IndexOp = BufferNameOp->Common.Next;
614 
615     /* Major cheat: The Node field is also used for the Tag ptr. Clear it now */
616 
617     IndexOp->Common.Node = NULL;
618 
619     OpInfo = AcpiPsGetOpcodeInfo (IndexOp->Common.AmlOpcode);
620     if (OpInfo->ObjectType != ACPI_TYPE_INTEGER)
621     {
622         return;
623     }
624 
625     /* Get the bit offset of the descriptor within the buffer */
626 
627     if ((Op->Common.AmlOpcode == AML_CREATE_BIT_FIELD_OP) ||
628         (Op->Common.AmlOpcode == AML_CREATE_FIELD_OP))
629     {
630         /* Index operand is a bit offset */
631 
632         BitIndex = (UINT32) IndexOp->Common.Value.Integer;
633     }
634     else
635     {
636         /* Index operand is a byte offset, convert to bits */
637 
638         BitIndex = (UINT32) ACPI_MUL_8 (IndexOp->Common.Value.Integer);
639     }
640 
641     /* Lookup the buffer in the namespace */
642 
643     Status = AcpiNsLookup (WalkState->ScopeInfo,
644         BufferNameOp->Common.Value.String, ACPI_TYPE_BUFFER,
645         ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT, WalkState,
646         &BufferNode);
647     if (ACPI_FAILURE (Status))
648     {
649         return;
650     }
651 
652     /* Validate object type, we must have a buffer */
653 
654     if (BufferNode->Type != ACPI_TYPE_BUFFER)
655     {
656         return;
657     }
658 
659     /* Find the resource descriptor node corresponding to the index */
660 
661     ResourceNode = AcpiDmGetResourceNode (BufferNode, BitIndex);
662     if (!ResourceNode)
663     {
664         return;
665     }
666 
667     /* Translate the Index to a resource tag pathname */
668 
669     AcpiGetTagPathname (IndexOp, BufferNode, ResourceNode, BitIndex);
670 }
671 
672 
673 /*******************************************************************************
674  *
675  * FUNCTION:    AcpiDmGetResourceNode
676  *
677  * PARAMETERS:  BufferNode          - Node for the parent buffer
678  *              BitIndex            - Index into the resource descriptor
679  *
680  * RETURN:      Namespace node for the resource descriptor. NULL if not found
681  *
682  * DESCRIPTION: Find a resource descriptor that corresponds to the bit index
683  *
684  ******************************************************************************/
685 
686 static ACPI_NAMESPACE_NODE *
AcpiDmGetResourceNode(ACPI_NAMESPACE_NODE * BufferNode,UINT32 BitIndex)687 AcpiDmGetResourceNode (
688     ACPI_NAMESPACE_NODE     *BufferNode,
689     UINT32                  BitIndex)
690 {
691     ACPI_NAMESPACE_NODE     *Node;
692     UINT32                  ByteIndex = ACPI_DIV_8 (BitIndex);
693 
694 
695     /*
696      * Child list contains an entry for each resource descriptor. Find
697      * the descriptor that corresponds to the Index.
698      *
699      * If there are no children, this is not a resource template
700      */
701     Node = BufferNode->Child;
702     while (Node)
703     {
704         /*
705          * Check if the Index falls within this resource.
706          *
707          * Value contains the resource offset, Object contains the resource
708          * length (both in bytes)
709          */
710         if ((ByteIndex >= Node->Value) &&
711             (ByteIndex < (Node->Value + Node->Length)))
712         {
713             return (Node);
714         }
715 
716         Node = Node->Peer;
717     }
718 
719     return (NULL);
720 }
721 
722 
723 /*******************************************************************************
724  *
725  * FUNCTION:    AcpiGetTagPathname
726  *
727  * PARAMETERS:  BufferNode          - Node for the parent buffer
728  *              ResourceNode        - Node for a resource descriptor
729  *              BitIndex            - Index into the resource descriptor
730  *
731  * RETURN:      Full pathname for a resource tag. NULL if no match.
732  *              Path is returned in AML (packed) format.
733  *
734  * DESCRIPTION: Convert a BitIndex into a symbolic resource tag (full pathname)
735  *
736  ******************************************************************************/
737 
738 static char *
AcpiGetTagPathname(ACPI_PARSE_OBJECT * IndexOp,ACPI_NAMESPACE_NODE * BufferNode,ACPI_NAMESPACE_NODE * ResourceNode,UINT32 BitIndex)739 AcpiGetTagPathname (
740     ACPI_PARSE_OBJECT       *IndexOp,
741     ACPI_NAMESPACE_NODE     *BufferNode,
742     ACPI_NAMESPACE_NODE     *ResourceNode,
743     UINT32                  BitIndex)
744 {
745     ACPI_STATUS             Status;
746     UINT32                  ResourceBitIndex;
747     UINT8                   ResourceTableIndex;
748     ACPI_SIZE               RequiredSize;
749     char                    *Pathname;
750     AML_RESOURCE            *Aml;
751     ACPI_PARSE_OBJECT       *Op;
752     char                    *InternalPath;
753     char                    *Tag;
754 
755 
756     /* Get the Op that contains the actual buffer data */
757 
758     Op = BufferNode->Op->Common.Value.Arg;
759     Op = Op->Common.Next;
760     if (!Op)
761     {
762         return (NULL);
763     }
764 
765     /* Get the individual resource descriptor and validate it */
766 
767     Aml = ACPI_CAST_PTR (
768         AML_RESOURCE, &Op->Named.Data[ResourceNode->Value]);
769 
770     Status = AcpiUtValidateResource (NULL, Aml, &ResourceTableIndex);
771     if (ACPI_FAILURE (Status))
772     {
773         return (NULL);
774     }
775 
776     /* Get offset into this descriptor (from offset into entire buffer) */
777 
778     ResourceBitIndex = BitIndex - ACPI_MUL_8 (ResourceNode->Value);
779 
780     /* Get the tag associated with this resource descriptor and offset */
781 
782     Tag = AcpiDmGetResourceTag (ResourceBitIndex, Aml, ResourceTableIndex);
783     if (!Tag)
784     {
785         return (NULL);
786     }
787 
788     /*
789      * Now that we know that we have a reference that can be converted to a
790      * symbol, change the name of the resource to a unique name.
791      */
792     AcpiDmUpdateResourceName (ResourceNode);
793 
794     /* Get the full pathname to the parent buffer */
795 
796     RequiredSize = AcpiNsBuildNormalizedPath (BufferNode, NULL, 0, FALSE);
797     if (!RequiredSize)
798     {
799         return (NULL);
800     }
801 
802     Pathname = ACPI_ALLOCATE_ZEROED (RequiredSize + ACPI_PATH_SEGMENT_LENGTH);
803     if (!Pathname)
804     {
805         return (NULL);
806     }
807 
808     (void) AcpiNsBuildNormalizedPath (BufferNode, Pathname,
809         RequiredSize, FALSE);
810 
811     /*
812      * Create the full path to the resource and tag by: remove the buffer name,
813      * append the resource descriptor name, append a dot, append the tag name.
814      *
815      * TBD: Always using the full path is a bit brute force, the path can be
816      * often be optimized with carats (if the original buffer namepath is a
817      * single nameseg). This doesn't really matter, because these paths do not
818      * end up in the final compiled AML, it's just an appearance issue for the
819      * disassembled code.
820      */
821     Pathname[strlen (Pathname) - ACPI_NAME_SIZE] = 0;
822     strncat (Pathname, ResourceNode->Name.Ascii, ACPI_NAME_SIZE);
823     strcat (Pathname, ".");
824     strncat (Pathname, Tag, ACPI_NAME_SIZE);
825 
826     /* Internalize the namepath to AML format */
827 
828     AcpiNsInternalizeName (Pathname, &InternalPath);
829     ACPI_FREE (Pathname);
830 
831     /* Update the Op with the symbol */
832 
833     AcpiPsInitOp (IndexOp, AML_INT_NAMEPATH_OP);
834     IndexOp->Common.Value.String = InternalPath;
835 
836     /*
837      * We will need the tag later. Cheat by putting it in the Node field.
838      * Note, Tag is a const that is part of a lookup table.
839      */
840     IndexOp->Common.Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Tag);
841     return (InternalPath);
842 }
843 
844 
845 /*******************************************************************************
846  *
847  * FUNCTION:    AcpiDmUpdateResourceName
848  *
849  * PARAMETERS:  ResourceNode        - Node for a resource descriptor
850  *
851  * RETURN:      Stores new name in the ResourceNode
852  *
853  * DESCRIPTION: Create a new, unique name for a resource descriptor. Used by
854  *              both the disassembly of the descriptor itself and any symbolic
855  *              references to the descriptor. Ignored if a unique name has
856  *              already been assigned to the resource.
857  *
858  * NOTE: Single threaded, suitable for applications only!
859  *
860  ******************************************************************************/
861 
862 static void
AcpiDmUpdateResourceName(ACPI_NAMESPACE_NODE * ResourceNode)863 AcpiDmUpdateResourceName (
864     ACPI_NAMESPACE_NODE     *ResourceNode)
865 {
866     char                    Name[ACPI_NAME_SIZE];
867 
868 
869     /* Ignore if a unique name has already been assigned */
870 
871     if (ResourceNode->Name.Integer != ACPI_DEFAULT_RESNAME)
872     {
873         return;
874     }
875 
876     /* Generate a new ACPI name for the descriptor */
877 
878     Name[0] = '_';
879     Name[1] = AcpiGbl_Prefix[AcpiGbl_NextPrefix];
880     Name[2] = AcpiUtHexToAsciiChar ((UINT64) AcpiGbl_NextResourceId, 4);
881     Name[3] = AcpiUtHexToAsciiChar ((UINT64) AcpiGbl_NextResourceId, 0);
882 
883     /* Update globals for next name */
884 
885     AcpiGbl_NextResourceId++;
886     if (AcpiGbl_NextResourceId >= 256)
887     {
888         AcpiGbl_NextResourceId = 0;
889         AcpiGbl_NextPrefix++;
890 
891         if (AcpiGbl_NextPrefix > ACPI_NUM_RES_PREFIX)
892         {
893             AcpiGbl_NextPrefix = 0;
894         }
895     }
896 
897     /* Change the resource descriptor name */
898 
899     ResourceNode->Name.Integer = *ACPI_CAST_PTR (UINT32, &Name[0]);
900 }
901 
902 
903 /*******************************************************************************
904  *
905  * FUNCTION:    AcpiDmGetResourceTag
906  *
907  * PARAMETERS:  BitIndex            - Index into the resource descriptor
908  *              Resource            - Pointer to the raw resource data
909  *              ResourceIndex       - Index correspoinding to the resource type
910  *
911  * RETURN:      Pointer to the resource tag (ACPI_NAME). NULL if no match.
912  *
913  * DESCRIPTION: Convert a BitIndex into a symbolic resource tag.
914  *
915  * Note: ResourceIndex should be previously validated and guaranteed to ve
916  *       valid.
917  *
918  ******************************************************************************/
919 
920 static char *
AcpiDmGetResourceTag(UINT32 BitIndex,AML_RESOURCE * Resource,UINT8 ResourceIndex)921 AcpiDmGetResourceTag (
922     UINT32                  BitIndex,
923     AML_RESOURCE            *Resource,
924     UINT8                   ResourceIndex)
925 {
926     const ACPI_RESOURCE_TAG *TagList;
927     char                    *Tag = NULL;
928 
929 
930     /* Get the tag list for this resource descriptor type */
931 
932     TagList = AcpiGbl_ResourceTags[ResourceIndex];
933 
934     /*
935      * Handle descriptors that have multiple subtypes
936      */
937     switch (Resource->DescriptorType)
938     {
939     case ACPI_RESOURCE_NAME_ADDRESS16:
940     case ACPI_RESOURCE_NAME_ADDRESS32:
941     case ACPI_RESOURCE_NAME_ADDRESS64:
942     case ACPI_RESOURCE_NAME_EXTENDED_ADDRESS64:
943         /*
944          * Subtype differentiation is the flags.
945          * Kindof brute force, but just blindly search for an index match
946          */
947         if (Resource->Address.ResourceType == ACPI_ADDRESS_TYPE_MEMORY_RANGE)
948         {
949             Tag = AcpiDmSearchTagList (BitIndex, AcpiDmMemoryFlagTags);
950         }
951         else if (Resource->Address.ResourceType == ACPI_ADDRESS_TYPE_IO_RANGE)
952         {
953             Tag = AcpiDmSearchTagList (BitIndex, AcpiDmIoFlagTags);
954         }
955 
956         /* If we found a match, all done. Else, drop to normal search below */
957 
958         if (Tag)
959         {
960             return (Tag);
961         }
962         break;
963 
964     case ACPI_RESOURCE_NAME_GPIO:
965 
966         /* GPIO connection has 2 subtypes: Interrupt and I/O */
967 
968         if (Resource->Gpio.ConnectionType > AML_RESOURCE_MAX_GPIOTYPE)
969         {
970             return (NULL);
971         }
972 
973         TagList = AcpiGbl_GpioResourceTags[Resource->Gpio.ConnectionType];
974         break;
975 
976     case ACPI_RESOURCE_NAME_SERIAL_BUS:
977 
978         /* SerialBus has 3 subtypes: I2C, SPI, and UART */
979 
980         if ((Resource->CommonSerialBus.Type == 0) ||
981             (Resource->CommonSerialBus.Type > AML_RESOURCE_MAX_SERIALBUSTYPE))
982         {
983             return (NULL);
984         }
985 
986         TagList = AcpiGbl_SerialResourceTags[Resource->CommonSerialBus.Type];
987         break;
988 
989     default:
990 
991         break;
992     }
993 
994     /* Search for a match against the BitIndex */
995 
996     if (TagList)
997     {
998         Tag = AcpiDmSearchTagList (BitIndex, TagList);
999     }
1000 
1001     return (Tag);
1002 }
1003 
1004 
1005 /*******************************************************************************
1006  *
1007  * FUNCTION:    AcpiDmSearchTagList
1008  *
1009  * PARAMETERS:  BitIndex            - Index into the resource descriptor
1010  *              TagList             - List to search
1011  *
1012  * RETURN:      Pointer to a tag (ACPI_NAME). NULL if no match found.
1013  *
1014  * DESCRIPTION: Search a tag list for a match to the input BitIndex. Matches
1015  *              a fixed offset to a symbolic resource tag name.
1016  *
1017  ******************************************************************************/
1018 
1019 static char *
AcpiDmSearchTagList(UINT32 BitIndex,const ACPI_RESOURCE_TAG * TagList)1020 AcpiDmSearchTagList (
1021     UINT32                  BitIndex,
1022     const ACPI_RESOURCE_TAG *TagList)
1023 {
1024 
1025     /*
1026      * Walk the null-terminated tag list to find a matching bit offset.
1027      * We are looking for an exact match.
1028      */
1029     for ( ; TagList->Tag; TagList++)
1030     {
1031         if (BitIndex == TagList->BitIndex)
1032         {
1033             return (TagList->Tag);
1034         }
1035     }
1036 
1037     /* A matching offset was not found */
1038 
1039     return (NULL);
1040 }
1041 
1042 
1043 /*******************************************************************************
1044  *
1045  * FUNCTION:    AcpiDmFindResources
1046  *
1047  * PARAMETERS:  Root                - Root of the parse tree
1048  *
1049  * RETURN:      None
1050  *
1051  * DESCRIPTION: Add all ResourceTemplate declarations to the namespace. Each
1052  *              resource descriptor in each template is given a node -- used
1053  *              for later conversion of resource references to symbolic refs.
1054  *
1055  ******************************************************************************/
1056 
1057 void
AcpiDmFindResources(ACPI_PARSE_OBJECT * Root)1058 AcpiDmFindResources (
1059     ACPI_PARSE_OBJECT       *Root)
1060 {
1061     ACPI_PARSE_OBJECT       *Op = Root;
1062     ACPI_PARSE_OBJECT       *Parent;
1063 
1064 
1065     /* Walk the entire parse tree */
1066 
1067     while (Op)
1068     {
1069         /* We are interested in Buffer() declarations */
1070 
1071         if (Op->Common.AmlOpcode == AML_BUFFER_OP)
1072         {
1073             /* And only declarations of the form Name (XXXX, Buffer()... ) */
1074 
1075             Parent = Op->Common.Parent;
1076             if (Parent->Common.AmlOpcode == AML_NAME_OP)
1077             {
1078                 /*
1079                  * If the buffer is a resource template, add the individual
1080                  * resource descriptors to the namespace, as children of the
1081                  * buffer node.
1082                  */
1083                 if (ACPI_SUCCESS (AcpiDmIsResourceTemplate (NULL, Op)))
1084                 {
1085                     Op->Common.DisasmOpcode = ACPI_DASM_RESOURCE;
1086                     AcpiDmAddResourcesToNamespace (Parent->Common.Node, Op);
1087                 }
1088             }
1089         }
1090 
1091         Op = AcpiPsGetDepthNext (Root, Op);
1092     }
1093 }
1094 
1095 
1096 /*******************************************************************************
1097  *
1098  * FUNCTION:    AcpiDmAddResourcesToNamespace
1099  *
1100  * PARAMETERS:  BufferNode          - Node for the parent buffer
1101  *              Op                  - Parse op for the buffer
1102  *
1103  * RETURN:      None
1104  *
1105  * DESCRIPTION: Add an entire resource template to the namespace. Each
1106  *              resource descriptor is added as a namespace node.
1107  *
1108  ******************************************************************************/
1109 
1110 static void
AcpiDmAddResourcesToNamespace(ACPI_NAMESPACE_NODE * BufferNode,ACPI_PARSE_OBJECT * Op)1111 AcpiDmAddResourcesToNamespace (
1112     ACPI_NAMESPACE_NODE     *BufferNode,
1113     ACPI_PARSE_OBJECT       *Op)
1114 {
1115     ACPI_PARSE_OBJECT       *NextOp;
1116 
1117 
1118     /* Get to the ByteData list */
1119 
1120     NextOp = Op->Common.Value.Arg;
1121     NextOp = NextOp->Common.Next;
1122     if (!NextOp)
1123     {
1124         return;
1125     }
1126 
1127     /* Set Node and Op to point to each other */
1128 
1129     BufferNode->Op = Op;
1130     Op->Common.Node = BufferNode;
1131 
1132     /*
1133      * Insert each resource into the namespace
1134      * NextOp contains the Aml pointer and the Aml length
1135      */
1136     AcpiUtWalkAmlResources (NULL, (UINT8 *) NextOp->Named.Data,
1137         (ACPI_SIZE) NextOp->Common.Value.Integer,
1138         AcpiDmAddResourceToNamespace, (void **) BufferNode);
1139 }
1140 
1141 
1142 /*******************************************************************************
1143  *
1144  * FUNCTION:    AcpiDmAddResourceToNamespace
1145  *
1146  * PARAMETERS:  ACPI_WALK_AML_CALLBACK
1147  *              BufferNode              - Node for the parent buffer
1148  *
1149  * RETURN:      Status
1150  *
1151  * DESCRIPTION: Add one resource descriptor to the namespace as a child of the
1152  *              parent buffer. The same name is used for each descriptor. This
1153  *              is changed later to a unique name if the resource is actually
1154  *              referenced by an AML operator.
1155  *
1156  ******************************************************************************/
1157 
1158 static ACPI_STATUS
AcpiDmAddResourceToNamespace(UINT8 * Aml,UINT32 Length,UINT32 Offset,UINT8 ResourceIndex,void ** Context)1159 AcpiDmAddResourceToNamespace (
1160     UINT8                   *Aml,
1161     UINT32                  Length,
1162     UINT32                  Offset,
1163     UINT8                   ResourceIndex,
1164     void                    **Context)
1165 {
1166     ACPI_STATUS             Status;
1167     ACPI_GENERIC_STATE      ScopeInfo;
1168     ACPI_NAMESPACE_NODE     *Node;
1169 
1170 
1171     /* TBD: Don't need to add descriptors that have no tags defined? */
1172 
1173     /* Add the resource to the namespace, as child of the buffer */
1174 
1175     ScopeInfo.Scope.Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Context);
1176     Status = AcpiNsLookup (&ScopeInfo, "_TMP", ACPI_TYPE_LOCAL_RESOURCE,
1177         ACPI_IMODE_LOAD_PASS2,
1178         ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE | ACPI_NS_PREFIX_IS_SCOPE,
1179         NULL, &Node);
1180     if (ACPI_FAILURE (Status))
1181     {
1182         return (AE_OK);
1183     }
1184 
1185     /* Set the name to the default, changed later if resource is referenced */
1186 
1187     Node->Name.Integer = ACPI_DEFAULT_RESNAME;
1188 
1189     /* Save the offset of the descriptor (within the original buffer) */
1190 
1191     Node->Value = Offset;
1192     Node->Length = Length;
1193     return (AE_OK);
1194 }
1195