sys/contrib/dev/acpica/amlresrc.h

   1
   2 /******************************************************************************
   3  *
   4  * Module Name: amlresrc.h - AML resource descriptors
   5  *              $Revision: 23 $
   6  *
   7  *****************************************************************************/
   8
   9 /******************************************************************************
  10  *
  11  * 1. Copyright Notice
  12  *
  13  * Some or all of this work - Copyright (c) 1999 - 2003, Intel Corp.
  14  * All rights reserved.
  15  *
  16  * 2. License
  17  *
  18  * 2.1. This is your license from Intel Corp. under its intellectual property
  19  * rights.  You may have additional license terms from the party that provided
  20  * you this software, covering your right to use that party's intellectual
  21  * property rights.
  22  *
  23  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
  24  * copy of the source code appearing in this file ("Covered Code") an
  25  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
  26  * base code distributed originally by Intel ("Original Intel Code") to copy,
  27  * make derivatives, distribute, use and display any portion of the Covered
  28  * Code in any form, with the right to sublicense such rights; and
  29  *
  30  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
  31  * license (with the right to sublicense), under only those claims of Intel
  32  * patents that are infringed by the Original Intel Code, to make, use, sell,
  33  * offer to sell, and import the Covered Code and derivative works thereof
  34  * solely to the minimum extent necessary to exercise the above copyright
  35  * license, and in no event shall the patent license extend to any additions
  36  * to or modifications of the Original Intel Code.  No other license or right
  37  * is granted directly or by implication, estoppel or otherwise;
  38  *
  39  * The above copyright and patent license is granted only if the following
  40  * conditions are met:
  41  *
  42  * 3. Conditions
  43  *
  44  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
  45  * Redistribution of source code of any substantial portion of the Covered
  46  * Code or modification with rights to further distribute source must include
  47  * the above Copyright Notice, the above License, this list of Conditions,
  48  * and the following Disclaimer and Export Compliance provision.  In addition,
  49  * Licensee must cause all Covered Code to which Licensee contributes to
  50  * contain a file documenting the changes Licensee made to create that Covered
  51  * Code and the date of any change.  Licensee must include in that file the
  52  * documentation of any changes made by any predecessor Licensee.  Licensee
  53  * must include a prominent statement that the modification is derived,
  54  * directly or indirectly, from Original Intel Code.
  55  *
  56  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
  57  * Redistribution of source code of any substantial portion of the Covered
  58  * Code or modification without rights to further distribute source must
  59  * include the following Disclaimer and Export Compliance provision in the
  60  * documentation and/or other materials provided with distribution.  In
  61  * addition, Licensee may not authorize further sublicense of source of any
  62  * portion of the Covered Code, and must include terms to the effect that the
  63  * license from Licensee to its licensee is limited to the intellectual
  64  * property embodied in the software Licensee provides to its licensee, and
  65  * not to intellectual property embodied in modifications its licensee may
  66  * make.
  67  *
  68  * 3.3. Redistribution of Executable. Redistribution in executable form of any
  69  * substantial portion of the Covered Code or modification must reproduce the
  70  * above Copyright Notice, and the following Disclaimer and Export Compliance
  71  * provision in the documentation and/or other materials provided with the
  72  * distribution.
  73  *
  74  * 3.4. Intel retains all right, title, and interest in and to the Original
  75  * Intel Code.
  76  *
  77  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
  78  * Intel shall be used in advertising or otherwise to promote the sale, use or
  79  * other dealings in products derived from or relating to the Covered Code
  80  * without prior written authorization from Intel.
  81  *
  82  * 4. Disclaimer and Export Compliance
  83  *
  84  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
  85  * HERE.  ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
  86  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT,  ASSISTANCE,
  87  * INSTALLATION, TRAINING OR OTHER SERVICES.  INTEL WILL NOT PROVIDE ANY
  88  * UPDATES, ENHANCEMENTS OR EXTENSIONS.  INTEL SPECIFICALLY DISCLAIMS ANY
  89  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
  90  * PARTICULAR PURPOSE.
  91  *
  92  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
  93  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
  94  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
  95  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
  96  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
  97  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS
  98  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
  99  * LIMITED REMEDY.
 100  *
 101  * 4.3. Licensee shall not export, either directly or indirectly, any of this
 102  * software or system incorporating such software without first obtaining any
 103  * required license or other approval from the U. S. Department of Commerce or
 104  * any other agency or department of the United States Government.  In the
 105  * event Licensee exports any such software from the United States or
 106  * re-exports any such software from a foreign destination, Licensee shall
 107  * ensure that the distribution and export/re-export of the software is in
 108  * compliance with all laws, regulations, orders, or other restrictions of the
 109  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
 110  * any of its subsidiaries will export/re-export any technical data, process,
 111  * software, or service, directly or indirectly, to any country for which the
 112  * United States government or any agency thereof requires an export license,
 113  * other governmental approval, or letter of assurance, without first obtaining
 114  * such license, approval or letter.
 115  *
 116  *****************************************************************************/
 117 /* $DragonFly: src/sys/contrib/dev/acpica/Attic/amlresrc.h,v 1.1 2003/09/24 03:32:15 drhodus Exp $                                                               */
 118
 119
 120 #ifndef __AMLRESRC_H
 121 #define __AMLRESRC_H
 122
 123
 124 #define ASL_RESNAME_ADDRESS                     "_ADR"
 125 #define ASL_RESNAME_ALIGNMENT                   "_ALN"
 126 #define ASL_RESNAME_ADDRESSSPACE                "_ASI"
 127 #define ASL_RESNAME_BASEADDRESS                 "_BAS"
 128 #define ASL_RESNAME_BUSMASTER                   "_BM_"  /* Master(1), Slave(0) */
 129 #define ASL_RESNAME_DECODE                      "_DEC"
 130 #define ASL_RESNAME_DMA                         "_DMA"
 131 #define ASL_RESNAME_DMATYPE                     "_TYP"  /* Compatible(0), A(1), B(2), F(3) */
 132 #define ASL_RESNAME_GRANULARITY                 "_GRA"
 133 #define ASL_RESNAME_INTERRUPT                   "_INT"
 134 #define ASL_RESNAME_INTERRUPTLEVEL              "_LL_"  /* ActiveLo(1), ActiveHi(0) */
 135 #define ASL_RESNAME_INTERRUPTSHARE              "_SHR"  /* Shareable(1), NoShare(0) */
 136 #define ASL_RESNAME_INTERRUPTTYPE               "_HE_"  /* Edge(1), Level(0) */
 137 #define ASL_RESNAME_LENGTH                      "_LEN"
 138 #define ASL_RESNAME_MEMATTRIBUTES               "_MTP"  /* Memory(0), Reserved(1), ACPI(2), NVS(3) */
 139 #define ASL_RESNAME_MEMTYPE                     "_MEM"  /* NonCache(0), Cacheable(1) Cache+combine(2), Cache+prefetch(3) */
 140 #define ASL_RESNAME_MAXADDR                     "_MAX"
 141 #define ASL_RESNAME_MINADDR                     "_MIN"
 142 #define ASL_RESNAME_MAXTYPE                     "_MAF"
 143 #define ASL_RESNAME_MINTYPE                     "_MIF"
 144 #define ASL_RESNAME_REGISTERBITOFFSET           "_RBO"
 145 #define ASL_RESNAME_REGISTERBITWIDTH            "_RBW"
 146 #define ASL_RESNAME_RANGETYPE                   "_RNG"
 147 #define ASL_RESNAME_READWRITETYPE               "_RW_"  /* ReadOnly(0), Writeable (1) */
 148 #define ASL_RESNAME_TRANSLATION                 "_TRA"
 149 #define ASL_RESNAME_TRANSTYPE                   "_TRS"  /* Sparse(1), Dense(0) */
 150 #define ASL_RESNAME_TYPE                        "_TTP"  /* Translation(1), Static (0) */
 151 #define ASL_RESNAME_XFERTYPE                    "_SIZ"  /* 8(0), 8And16(1), 16(2) */
 152
 153
 154 /* Default sizes for "small" resource descriptors */
 155
 156 #define ASL_RDESC_IRQ_SIZE                      0x02
 157 #define ASL_RDESC_DMA_SIZE                      0x02
 158 #define ASL_RDESC_ST_DEPEND_SIZE                0x00
 159 #define ASL_RDESC_END_DEPEND_SIZE               0x00
 160 #define ASL_RDESC_IO_SIZE                       0x07
 161 #define ASL_RDESC_FIXED_IO_SIZE                 0x03
 162 #define ASL_RDESC_END_TAG_SIZE                  0x01
 163
 164
 165 typedef struct asl_resource_node
 166 {
 167     UINT32                      BufferLength;
 168     void                        *Buffer;
 169     struct asl_resource_node    *Next;
 170
 171 } ASL_RESOURCE_NODE;
 172
 173
 174 /*
 175  * Resource descriptors defined in the ACPI specification.
 176  *
 177  * Alignment must be BYTE because these descriptors
 178  * are used to overlay the AML byte stream.
 179  */
 180 #pragma pack(1)
 181
 182 typedef struct asl_irq_format_desc
 183 {
 184     UINT8                       DescriptorType;
 185     UINT16                      IrqMask;
 186     UINT8                       Flags;
 187
 188 } ASL_IRQ_FORMAT_DESC;
 189
 190
 191 typedef struct asl_irq_noflags_desc
 192 {
 193     UINT8                       DescriptorType;
 194     UINT16                      IrqMask;
 195
 196 } ASL_IRQ_NOFLAGS_DESC;
 197
 198
 199 typedef struct asl_dma_format_desc
 200 {
 201     UINT8                       DescriptorType;
 202     UINT8                       DmaChannelMask;
 203     UINT8                       Flags;
 204
 205 } ASL_DMA_FORMAT_DESC;
 206
 207
 208 typedef struct asl_start_dependent_desc
 209 {
 210     UINT8                       DescriptorType;
 211     UINT8                       Flags;
 212
 213 } ASL_START_DEPENDENT_DESC;
 214
 215
 216 typedef struct asl_start_dependent_noprio_desc
 217 {
 218     UINT8                       DescriptorType;
 219
 220 } ASL_START_DEPENDENT_NOPRIO_DESC;
 221
 222
 223 typedef struct asl_end_dependent_desc
 224 {
 225     UINT8                       DescriptorType;
 226
 227 } ASL_END_DEPENDENT_DESC;
 228
 229
 230 typedef struct asl_io_port_desc
 231 {
 232     UINT8                       DescriptorType;
 233     UINT8                       Information;
 234     UINT16                      AddressMin;
 235     UINT16                      AddressMax;
 236     UINT8                       Alignment;
 237     UINT8                       Length;
 238
 239 } ASL_IO_PORT_DESC;
 240
 241
 242 typedef struct asl_fixed_io_port_desc
 243 {
 244     UINT8                       DescriptorType;
 245     UINT16                      BaseAddress;
 246     UINT8                       Length;
 247
 248 } ASL_FIXED_IO_PORT_DESC;
 249
 250
 251 typedef struct asl_small_vendor_desc
 252 {
 253     UINT8                       DescriptorType;
 254     UINT8                       VendorDefined[7];
 255
 256 } ASL_SMALL_VENDOR_DESC;
 257
 258
 259 typedef struct asl_end_tag_desc
 260 {
 261     UINT8                       DescriptorType;
 262     UINT8                       Checksum;
 263
 264 } ASL_END_TAG_DESC;
 265
 266
 267 /* LARGE descriptors */
 268
 269 typedef struct asl_memory_24_desc
 270 {
 271     UINT8                       DescriptorType;
 272     UINT16                      Length;
 273     UINT8                       Information;
 274     UINT16                      AddressMin;
 275     UINT16                      AddressMax;
 276     UINT16                      Alignment;
 277     UINT16                      RangeLength;
 278
 279 } ASL_MEMORY_24_DESC;
 280
 281
 282 typedef struct asl_large_vendor_desc
 283 {
 284     UINT8                       DescriptorType;
 285     UINT16                      Length;
 286     UINT8                       VendorDefined[1];
 287
 288 } ASL_LARGE_VENDOR_DESC;
 289
 290
 291 typedef struct asl_memory_32_desc
 292 {
 293     UINT8                       DescriptorType;
 294     UINT16                      Length;
 295     UINT8                       Information;
 296     UINT32                      AddressMin;
 297     UINT32                      AddressMax;
 298     UINT32                      Alignment;
 299     UINT32                      RangeLength;
 300
 301 } ASL_MEMORY_32_DESC;
 302
 303
 304 typedef struct asl_fixed_memory_32_desc
 305 {
 306     UINT8                       DescriptorType;
 307     UINT16                      Length;
 308     UINT8                       Information;
 309     UINT32                      BaseAddress;
 310     UINT32                      RangeLength;
 311
 312 } ASL_FIXED_MEMORY_32_DESC;
 313
 314
 315 typedef struct asl_qword_address_desc
 316 {
 317     UINT8                       DescriptorType;
 318     UINT16                      Length;
 319     UINT8                       ResourceType;
 320     UINT8                       Flags;
 321     UINT8                       SpecificFlags;
 322     UINT64                      Granularity;
 323     UINT64                      AddressMin;
 324     UINT64                      AddressMax;
 325     UINT64                      TranslationOffset;
 326     UINT64                      AddressLength;
 327     UINT8                       OptionalFields[2];
 328
 329 } ASL_QWORD_ADDRESS_DESC;
 330
 331
 332 typedef struct asl_dword_address_desc
 333 {
 334     UINT8                       DescriptorType;
 335     UINT16                      Length;
 336     UINT8                       ResourceType;
 337     UINT8                       Flags;
 338     UINT8                       SpecificFlags;
 339     UINT32                      Granularity;
 340     UINT32                      AddressMin;
 341     UINT32                      AddressMax;
 342     UINT32                      TranslationOffset;
 343     UINT32                      AddressLength;
 344     UINT8                       OptionalFields[2];
 345
 346 } ASL_DWORD_ADDRESS_DESC;
 347
 348
 349 typedef struct asl_word_address_desc
 350 {
 351     UINT8                       DescriptorType;
 352     UINT16                      Length;
 353     UINT8                       ResourceType;
 354     UINT8                       Flags;
 355     UINT8                       SpecificFlags;
 356     UINT16                      Granularity;
 357     UINT16                      AddressMin;
 358     UINT16                      AddressMax;
 359     UINT16                      TranslationOffset;
 360     UINT16                      AddressLength;
 361     UINT8                       OptionalFields[2];
 362
 363 } ASL_WORD_ADDRESS_DESC;
 364
 365
 366 typedef struct asl_extended_xrupt_desc
 367 {
 368     UINT8                       DescriptorType;
 369     UINT16                      Length;
 370     UINT8                       Flags;
 371     UINT8                       TableLength;
 372     UINT32                      InterruptNumber[1];
 373     /* ResSourceIndex, ResSource optional fields follow */
 374
 375 } ASL_EXTENDED_XRUPT_DESC;
 376
 377
 378 typedef struct asl_general_register_desc
 379 {
 380     UINT8                       DescriptorType;
 381     UINT16                      Length;
 382     UINT8                       AddressSpaceId;
 383     UINT8                       BitWidth;
 384     UINT8                       BitOffset;
 385     UINT8                       Reserved;
 386     UINT64                      Address;
 387
 388 } ASL_GENERAL_REGISTER_DESC;
 389
 390 /* restore default alignment */
 391
 392 #pragma pack()
 393
 394 /* Union of all resource descriptors, sow we can allocate the worst case */
 395
 396 typedef union asl_resource_desc
 397 {
 398     ASL_IRQ_FORMAT_DESC         Irq;
 399     ASL_DMA_FORMAT_DESC         Dma;
 400     ASL_START_DEPENDENT_DESC    Std;
 401     ASL_END_DEPENDENT_DESC      End;
 402     ASL_IO_PORT_DESC            Iop;
 403     ASL_FIXED_IO_PORT_DESC      Fio;
 404     ASL_SMALL_VENDOR_DESC       Smv;
 405     ASL_END_TAG_DESC            Et;
 406
 407     ASL_MEMORY_24_DESC          M24;
 408     ASL_LARGE_VENDOR_DESC       Lgv;
 409     ASL_MEMORY_32_DESC          M32;
 410     ASL_FIXED_MEMORY_32_DESC    F32;
 411     ASL_QWORD_ADDRESS_DESC      Qas;
 412     ASL_DWORD_ADDRESS_DESC      Das;
 413     ASL_WORD_ADDRESS_DESC       Was;
 414     ASL_EXTENDED_XRUPT_DESC     Exx;
 415     ASL_GENERAL_REGISTER_DESC   Grg;
 416     UINT32                      U32Item;
 417     UINT16                      U16Item;
 418     UINT8                       U8Item;
 419
 420 } ASL_RESOURCE_DESC;
 421
 422
 423 #endif
 424