]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - sys/contrib/dev/acpica/dmresrcl.c
This commit was generated by cvs2svn to compensate for changes in r149245,
[FreeBSD/FreeBSD.git] / sys / contrib / dev / acpica / dmresrcl.c
1 /*******************************************************************************
2  *
3  * Module Name: dmresrcl.c - "Large" Resource Descriptor disassembly
4  *              $Revision: 12 $
5  *
6  ******************************************************************************/
7
8 /******************************************************************************
9  *
10  * 1. Copyright Notice
11  *
12  * Some or all of this work - Copyright (c) 1999 - 2004, Intel Corp.
13  * All rights reserved.
14  *
15  * 2. License
16  *
17  * 2.1. This is your license from Intel Corp. under its intellectual property
18  * rights.  You may have additional license terms from the party that provided
19  * you this software, covering your right to use that party's intellectual
20  * property rights.
21  *
22  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23  * copy of the source code appearing in this file ("Covered Code") an
24  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25  * base code distributed originally by Intel ("Original Intel Code") to copy,
26  * make derivatives, distribute, use and display any portion of the Covered
27  * Code in any form, with the right to sublicense such rights; and
28  *
29  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30  * license (with the right to sublicense), under only those claims of Intel
31  * patents that are infringed by the Original Intel Code, to make, use, sell,
32  * offer to sell, and import the Covered Code and derivative works thereof
33  * solely to the minimum extent necessary to exercise the above copyright
34  * license, and in no event shall the patent license extend to any additions
35  * to or modifications of the Original Intel Code.  No other license or right
36  * is granted directly or by implication, estoppel or otherwise;
37  *
38  * The above copyright and patent license is granted only if the following
39  * conditions are met:
40  *
41  * 3. Conditions
42  *
43  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44  * Redistribution of source code of any substantial portion of the Covered
45  * Code or modification with rights to further distribute source must include
46  * the above Copyright Notice, the above License, this list of Conditions,
47  * and the following Disclaimer and Export Compliance provision.  In addition,
48  * Licensee must cause all Covered Code to which Licensee contributes to
49  * contain a file documenting the changes Licensee made to create that Covered
50  * Code and the date of any change.  Licensee must include in that file the
51  * documentation of any changes made by any predecessor Licensee.  Licensee
52  * must include a prominent statement that the modification is derived,
53  * directly or indirectly, from Original Intel Code.
54  *
55  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56  * Redistribution of source code of any substantial portion of the Covered
57  * Code or modification without rights to further distribute source must
58  * include the following Disclaimer and Export Compliance provision in the
59  * documentation and/or other materials provided with distribution.  In
60  * addition, Licensee may not authorize further sublicense of source of any
61  * portion of the Covered Code, and must include terms to the effect that the
62  * license from Licensee to its licensee is limited to the intellectual
63  * property embodied in the software Licensee provides to its licensee, and
64  * not to intellectual property embodied in modifications its licensee may
65  * make.
66  *
67  * 3.3. Redistribution of Executable. Redistribution in executable form of any
68  * substantial portion of the Covered Code or modification must reproduce the
69  * above Copyright Notice, and the following Disclaimer and Export Compliance
70  * provision in the documentation and/or other materials provided with the
71  * distribution.
72  *
73  * 3.4. Intel retains all right, title, and interest in and to the Original
74  * Intel Code.
75  *
76  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77  * Intel shall be used in advertising or otherwise to promote the sale, use or
78  * other dealings in products derived from or relating to the Covered Code
79  * without prior written authorization from Intel.
80  *
81  * 4. Disclaimer and Export Compliance
82  *
83  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84  * HERE.  ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT,  ASSISTANCE,
86  * INSTALLATION, TRAINING OR OTHER SERVICES.  INTEL WILL NOT PROVIDE ANY
87  * UPDATES, ENHANCEMENTS OR EXTENSIONS.  INTEL SPECIFICALLY DISCLAIMS ANY
88  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
89  * PARTICULAR PURPOSE.
90  *
91  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS
97  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
98  * LIMITED REMEDY.
99  *
100  * 4.3. Licensee shall not export, either directly or indirectly, any of this
101  * software or system incorporating such software without first obtaining any
102  * required license or other approval from the U. S. Department of Commerce or
103  * any other agency or department of the United States Government.  In the
104  * event Licensee exports any such software from the United States or
105  * re-exports any such software from a foreign destination, Licensee shall
106  * ensure that the distribution and export/re-export of the software is in
107  * compliance with all laws, regulations, orders, or other restrictions of the
108  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109  * any of its subsidiaries will export/re-export any technical data, process,
110  * software, or service, directly or indirectly, to any country for which the
111  * United States government or any agency thereof requires an export license,
112  * other governmental approval, or letter of assurance, without first obtaining
113  * such license, approval or letter.
114  *
115  *****************************************************************************/
116
117
118 #include "acpi.h"
119 #include "acdisasm.h"
120
121
122 #ifdef ACPI_DISASSEMBLER
123
124 #define _COMPONENT          ACPI_CA_DEBUGGER
125         ACPI_MODULE_NAME    ("dbresrcl")
126
127
128 /*******************************************************************************
129  *
130  * FUNCTION:    AcpiDmIoFlags
131  *
132  * PARAMETERS:  Flags               - Flag byte to be decoded
133  *
134  * RETURN:      None
135  *
136  * DESCRIPTION: Decode the flags specific to IO Address space descriptors
137  *
138  ******************************************************************************/
139
140 void
141 AcpiDmIoFlags (
142         UINT8               Flags)
143 {
144     AcpiOsPrintf ("%s, %s, %s, %s,",
145         AcpiGbl_ConsumeDecode [(Flags & 1)],
146         AcpiGbl_MinDecode [(Flags & 0x4) >> 2],
147         AcpiGbl_MaxDecode [(Flags & 0x8) >> 3],
148         AcpiGbl_DECDecode [(Flags & 0x2) >> 1]);
149 }
150
151
152 /*******************************************************************************
153  *
154  * FUNCTION:    AcpiDmMemoryFlags
155  *
156  * PARAMETERS:  Flags               - Flag byte to be decoded
157  *              SpecificFlags       - "Specific" flag byte to be decoded
158  *
159  * RETURN:      None
160  *
161  * DESCRIPTION: Decode flags specific to Memory Address Space descriptors
162  *
163  ******************************************************************************/
164
165 void
166 AcpiDmMemoryFlags (
167     UINT8                   Flags,
168     UINT8                   SpecificFlags)
169 {
170     AcpiOsPrintf ("%s, %s, %s, %s, %s, %s,",
171         AcpiGbl_ConsumeDecode [(Flags & 1)],
172         AcpiGbl_DECDecode [(Flags & 0x2) >> 1],
173         AcpiGbl_MinDecode [(Flags & 0x4) >> 2],
174         AcpiGbl_MaxDecode [(Flags & 0x8) >> 3],
175         AcpiGbl_MEMDecode [(SpecificFlags & 0x6) >> 1],
176         AcpiGbl_RWDecode [(SpecificFlags & 0x1)]);
177 }
178
179
180 /*******************************************************************************
181  *
182  * FUNCTION:    AcpiDmWordDescriptor
183  *
184  * PARAMETERS:  Resource            - Pointer to the resource descriptor
185  *              Length              - Length of the descriptor in bytes
186  *              Level               - Current source code indentation level
187  *
188  * RETURN:      None
189  *
190  * DESCRIPTION: Decode a Word Address Space descriptor
191  *
192  ******************************************************************************/
193
194 void
195 AcpiDmWordDescriptor (
196     ASL_WORD_ADDRESS_DESC   *Resource,
197     UINT32                  Length,
198     UINT32                  Level)
199 {
200
201     AcpiDmIndent (Level);
202     AcpiOsPrintf ("%s (",
203         AcpiGbl_WordDecode [(Resource->ResourceType & 3)]);
204
205     AcpiDmIoFlags (Resource->Flags);
206
207     if ((Resource->ResourceType & 0x3) == 1)
208     {
209         AcpiOsPrintf (" %s,",
210             AcpiGbl_RNGDecode [(Resource->SpecificFlags & 0x3)]);
211     }
212
213     /* The WORD values */
214
215     AcpiOsPrintf ("\n");
216     AcpiDmIndent (Level + 1);
217     AcpiOsPrintf ("0x%4.4X,\n",
218         (UINT32) Resource->Granularity);
219     AcpiDmIndent (Level + 1);
220     AcpiOsPrintf ("0x%4.4X,\n",
221         (UINT32) Resource->AddressMin);
222     AcpiDmIndent (Level + 1);
223     AcpiOsPrintf ("0x%4.4X,\n",
224         (UINT32) Resource->AddressMax);
225     AcpiDmIndent (Level + 1);
226     AcpiOsPrintf ("0x%4.4X,\n",
227         (UINT32) Resource->TranslationOffset);
228     AcpiDmIndent (Level + 1);
229     AcpiOsPrintf ("0x%4.4X",
230         (UINT32) Resource->AddressLength);
231
232     /* Optional fields */
233
234     if (Length > 13)
235     {
236         AcpiOsPrintf (", 0x%2.2X",
237             (UINT32) Resource->OptionalFields[0]);
238     }
239
240     if (Length > 14)
241     {
242         AcpiOsPrintf (", %s",
243             &Resource->OptionalFields[1]);
244     }
245     AcpiOsPrintf (")\n");
246 }
247
248
249 /*******************************************************************************
250  *
251  * FUNCTION:    AcpiDmDwordDescriptor
252  *
253  * PARAMETERS:  Resource            - Pointer to the resource descriptor
254  *              Length              - Length of the descriptor in bytes
255  *              Level               - Current source code indentation level
256  *
257  * RETURN:      None
258  *
259  * DESCRIPTION: Decode a DWord Address Space descriptor
260  *
261  ******************************************************************************/
262
263 void
264 AcpiDmDwordDescriptor (
265     ASL_DWORD_ADDRESS_DESC  *Resource,
266     UINT32                  Length,
267     UINT32                  Level)
268 {
269
270     AcpiDmIndent (Level);
271     AcpiOsPrintf ("D%s (",
272         AcpiGbl_WordDecode [(Resource->ResourceType & 3)]);
273
274     if ((Resource->ResourceType & 0x3) == 1)
275     {
276         AcpiDmIoFlags (Resource->Flags);
277         AcpiOsPrintf (" %s,",
278             AcpiGbl_RNGDecode [(Resource->SpecificFlags & 0x3)]);
279     }
280     else
281     {
282         AcpiDmMemoryFlags (Resource->Flags, Resource->SpecificFlags);
283     }
284
285     /* The DWORD values */
286
287     AcpiOsPrintf ("\n");
288     AcpiDmIndent (Level + 1);
289     AcpiOsPrintf ("0x%8.8X,\n",
290         Resource->Granularity);
291     AcpiDmIndent (Level + 1);
292     AcpiOsPrintf ("0x%8.8X,\n",
293         Resource->AddressMin);
294     AcpiDmIndent (Level + 1);
295     AcpiOsPrintf ("0x%8.8X,\n",
296         Resource->AddressMax);
297     AcpiDmIndent (Level + 1);
298     AcpiOsPrintf ("0x%8.8X,\n",
299         Resource->TranslationOffset);
300     AcpiDmIndent (Level + 1);
301     AcpiOsPrintf ("0x%8.8X",
302         Resource->AddressLength);
303
304     /* Optional fields */
305
306     if (Length > 23)
307     {
308         AcpiOsPrintf (", 0x%2.2X",
309             Resource->OptionalFields[0]);
310     }
311     if (Length > 24)
312     {
313         AcpiOsPrintf (", %s",
314             &Resource->OptionalFields[1]);
315     }
316     AcpiOsPrintf (")\n");
317 }
318
319
320 /*******************************************************************************
321  *
322  * FUNCTION:    AcpiDmQwordDescriptor
323  *
324  * PARAMETERS:  Resource            - Pointer to the resource descriptor
325  *              Length              - Length of the descriptor in bytes
326  *              Level               - Current source code indentation level
327  *
328  * RETURN:      None
329  *
330  * DESCRIPTION: Decode a QWord Address Space descriptor
331  *
332  ******************************************************************************/
333
334 void
335 AcpiDmQwordDescriptor (
336     ASL_QWORD_ADDRESS_DESC  *Resource,
337     UINT32                  Length,
338     UINT32                  Level)
339 {
340
341     AcpiDmIndent (Level);
342     AcpiOsPrintf ("Q%s (",
343         AcpiGbl_WordDecode [(Resource->ResourceType & 3)]);
344
345     if ((Resource->ResourceType & 0x3) == 1)
346     {
347         AcpiDmIoFlags (Resource->Flags);
348         AcpiOsPrintf (" %s,",
349             AcpiGbl_RNGDecode [(Resource->SpecificFlags & 0x3)]);
350     }
351     else
352     {
353         AcpiDmMemoryFlags (Resource->Flags, Resource->SpecificFlags);
354     }
355
356     /* The QWORD values */
357
358     AcpiOsPrintf ("\n");
359     AcpiDmIndent (Level + 1);
360     AcpiOsPrintf ("0x%8.8X%8.8X,\n",
361         ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->Granularity)));
362
363     AcpiDmIndent (Level + 1);
364     AcpiOsPrintf ("0x%8.8X%8.8X,\n",
365         ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->AddressMin)));
366
367     AcpiDmIndent (Level + 1);
368     AcpiOsPrintf ("0x%8.8X%8.8X,\n",
369         ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->AddressMax)));
370
371     AcpiDmIndent (Level + 1);
372     AcpiOsPrintf ("0x%8.8X%8.8X,\n",
373         ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->TranslationOffset)));
374
375     AcpiDmIndent (Level + 1);
376     AcpiOsPrintf ("0x%8.8X%8.8X",
377         ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->AddressLength)));
378
379     /* Optional fields */
380
381     if (Length > 43)
382     {
383         AcpiOsPrintf (", 0x%2.2X",
384             Resource->OptionalFields[0]);
385     }
386     if (Length > 44)
387     {
388         AcpiOsPrintf (", %s",
389             &Resource->OptionalFields[1]);
390     }
391
392     AcpiOsPrintf (")\n");
393 }
394
395
396 /*******************************************************************************
397  *
398  * FUNCTION:    AcpiDmMemory24Descriptor
399  *
400  * PARAMETERS:  Resource            - Pointer to the resource descriptor
401  *              Length              - Length of the descriptor in bytes
402  *              Level               - Current source code indentation level
403  *
404  * RETURN:      None
405  *
406  * DESCRIPTION: Decode a Memory24 descriptor
407  *
408  ******************************************************************************/
409
410 void
411 AcpiDmMemory24Descriptor (
412     ASL_MEMORY_24_DESC      *Resource,
413     UINT32                  Length,
414     UINT32                  Level)
415 {
416
417     AcpiDmIndent (Level);
418     AcpiOsPrintf ("Memory24 (%s, 0x%4.4X, 0x%4.4X, 0x%4.4X, 0x%4.4X)\n",
419         AcpiGbl_RWDecode [Resource->Information & 1],
420         (UINT32) Resource->AddressMin,
421         (UINT32) Resource->AddressMax,
422         (UINT32) Resource->Alignment,
423         (UINT32) Resource->RangeLength);
424 }
425
426
427 /*******************************************************************************
428  *
429  * FUNCTION:    AcpiDmMemory32Descriptor
430  *
431  * PARAMETERS:  Resource            - Pointer to the resource descriptor
432  *              Length              - Length of the descriptor in bytes
433  *              Level               - Current source code indentation level
434  *
435  * RETURN:      None
436  *
437  * DESCRIPTION: Decode a Memory32 descriptor
438  *
439  ******************************************************************************/
440
441 void
442 AcpiDmMemory32Descriptor (
443     ASL_MEMORY_32_DESC      *Resource,
444     UINT32                  Length,
445     UINT32                  Level)
446 {
447
448     AcpiDmIndent (Level);
449     AcpiOsPrintf ("Memory32 (%s, 0x%8.8X, 0x%8.8X, 0x%8.8X, 0x%8.8X)\n",
450         AcpiGbl_RWDecode [Resource->Information & 1],
451         Resource->AddressMin,
452         Resource->AddressMax,
453         Resource->Alignment,
454         Resource->RangeLength);
455 }
456
457
458 /*******************************************************************************
459  *
460  * FUNCTION:    AcpiDmFixedMem32Descriptor
461  *
462  * PARAMETERS:  Resource            - Pointer to the resource descriptor
463  *              Length              - Length of the descriptor in bytes
464  *              Level               - Current source code indentation level
465  *
466  * RETURN:      None
467  *
468  * DESCRIPTION: Decode a Fixed Memory32 descriptor
469  *
470  ******************************************************************************/
471
472 void
473 AcpiDmFixedMem32Descriptor (
474     ASL_FIXED_MEMORY_32_DESC *Resource,
475     UINT32                  Length,
476     UINT32                  Level)
477 {
478
479     AcpiDmIndent (Level);
480     AcpiOsPrintf ("Memory32Fixed (%s, 0x%8.8X, 0x%8.8X)\n",
481         AcpiGbl_RWDecode [Resource->Information & 1],
482         Resource->BaseAddress,
483         Resource->RangeLength);
484 }
485
486
487 /*******************************************************************************
488  *
489  * FUNCTION:    AcpiDmGenericRegisterDescriptor
490  *
491  * PARAMETERS:  Resource            - Pointer to the resource descriptor
492  *              Length              - Length of the descriptor in bytes
493  *              Level               - Current source code indentation level
494  *
495  * RETURN:      None
496  *
497  * DESCRIPTION: Decode a Generic Register descriptor
498  *
499  ******************************************************************************/
500
501 void
502 AcpiDmGenericRegisterDescriptor (
503     ASL_GENERAL_REGISTER_DESC *Resource,
504     UINT32                  Length,
505     UINT32                  Level)
506 {
507
508     AcpiDmIndent (Level);
509     AcpiOsPrintf ("Register (");
510
511     AcpiDmAddressSpace (Resource->AddressSpaceId);
512
513     AcpiOsPrintf ("0x%2.2X, 0x%2.2X, 0x%8.8X%8.8X)\n",
514         (UINT32) Resource->BitWidth,
515         (UINT32) Resource->BitOffset,
516         ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Resource->Address)));
517 }
518
519
520 /*******************************************************************************
521  *
522  * FUNCTION:    AcpiDmInterruptDescriptor
523  *
524  * PARAMETERS:  Resource            - Pointer to the resource descriptor
525  *              Length              - Length of the descriptor in bytes
526  *              Level               - Current source code indentation level
527  *
528  * RETURN:      None
529  *
530  * DESCRIPTION: Decode a extended Interrupt descriptor
531  *
532  ******************************************************************************/
533
534 void
535 AcpiDmInterruptDescriptor (
536     ASL_EXTENDED_XRUPT_DESC *Resource,
537     UINT32                  Length,
538     UINT32                  Level)
539 {
540     UINT32                  i;
541     UINT8                   *Rover;
542
543
544     AcpiDmIndent (Level);
545     AcpiOsPrintf ("Interrupt (%s, %s, %s, %s",
546         AcpiGbl_ConsumeDecode [(Resource->Flags & 1)],
547         AcpiGbl_HEDecode [(Resource->Flags >> 1) & 1],
548         AcpiGbl_LLDecode [(Resource->Flags >> 2) & 1],
549         AcpiGbl_SHRDecode [(Resource->Flags >> 3) & 1]);
550
551     /* Resource Index/Source, optional -- at end of descriptor */
552
553     if (Resource->Length > (UINT16) (4 * Resource->TableLength) + 2)
554     {
555         /* Get a pointer past the interrupt values */
556
557         Rover = ((UINT8 *) Resource) + ((4 * Resource->TableLength) + 5);
558
559         /* Resource Index */
560         /* Resource Source */
561
562         AcpiOsPrintf (", 0x%X, \"%s\"", (UINT32) Rover[0], (char *) &Rover[1]);
563     }
564
565     AcpiOsPrintf (")\n");
566     AcpiDmIndent (Level);
567     AcpiOsPrintf ("{\n");
568     for (i = 0; i < Resource->TableLength; i++)
569     {
570         AcpiDmIndent (Level + 1);
571         AcpiOsPrintf ("0x%8.8X,\n", (UINT32) Resource->InterruptNumber[i]);
572     }
573
574     AcpiDmIndent (Level);
575     AcpiOsPrintf ("}\n");
576 }
577
578
579 /*******************************************************************************
580  *
581  * FUNCTION:    AcpiDmVendorLargeDescriptor
582  *
583  * PARAMETERS:  Resource            - Pointer to the resource descriptor
584  *              Length              - Length of the descriptor in bytes
585  *              Level               - Current source code indentation level
586  *
587  * RETURN:      None
588  *
589  * DESCRIPTION: Decode a Vendor Large descriptor
590  *
591  ******************************************************************************/
592
593 void
594 AcpiDmVendorLargeDescriptor (
595     ASL_LARGE_VENDOR_DESC   *Resource,
596     UINT32                  Length,
597     UINT32                  Level)
598 {
599
600     AcpiDmIndent (Level);
601     AcpiOsPrintf ("VendorLong ()\n");
602     AcpiDmIndent (Level);
603
604     AcpiOsPrintf ("{\n");
605
606     AcpiDmDisasmByteList (Level + 1, (UINT8 *) Resource->VendorDefined, Length);
607     AcpiDmIndent (Level);
608     AcpiOsPrintf ("}\n");
609 }
610
611
612 #endif
613