Home | History | Annotate | Line # | Download | only in utilities
      1 /*******************************************************************************
      2  *
      3  * Module Name: utresdecode - Resource descriptor keyword strings
      4  *
      5  ******************************************************************************/
      6 
      7 /******************************************************************************
      8  *
      9  * 1. Copyright Notice
     10  *
     11  * Some or all of this work - Copyright (c) 1999 - 2025, 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 "acresrc.h"
    155 
    156 
    157 #define _COMPONENT          ACPI_UTILITIES
    158         ACPI_MODULE_NAME    ("utresdecode")
    159 
    160 
    161 #if defined (ACPI_DEBUG_OUTPUT) || \
    162     defined (ACPI_DISASSEMBLER) || \
    163     defined (ACPI_DEBUGGER)
    164 
    165 /*
    166  * Strings used to decode resource descriptors.
    167  * Used by both the disassembler and the debugger resource dump routines
    168  */
    169 const char                      *AcpiGbl_BmDecode[] =
    170 {
    171     "NotBusMaster",
    172     "BusMaster"
    173 };
    174 
    175 const char                      *AcpiGbl_ConfigDecode[] =
    176 {
    177     "0 - Good Configuration",
    178     "1 - Acceptable Configuration",
    179     "2 - Suboptimal Configuration",
    180     "3 - ***Invalid Configuration***",
    181 };
    182 
    183 const char                      *AcpiGbl_ConsumeDecode[] =
    184 {
    185     "ResourceProducer",
    186     "ResourceConsumer"
    187 };
    188 
    189 const char                      *AcpiGbl_DecDecode[] =
    190 {
    191     "PosDecode",
    192     "SubDecode"
    193 };
    194 
    195 const char                      *AcpiGbl_HeDecode[] =
    196 {
    197     "Level",
    198     "Edge"
    199 };
    200 
    201 const char                      *AcpiGbl_IoDecode[] =
    202 {
    203     "Decode10",
    204     "Decode16"
    205 };
    206 
    207 const char                      *AcpiGbl_LlDecode[] =
    208 {
    209     "ActiveHigh",
    210     "ActiveLow",
    211     "ActiveBoth",
    212     "Reserved"
    213 };
    214 
    215 const char                      *AcpiGbl_MaxDecode[] =
    216 {
    217     "MaxNotFixed",
    218     "MaxFixed"
    219 };
    220 
    221 const char                      *AcpiGbl_MemDecode[] =
    222 {
    223     "NonCacheable",
    224     "Cacheable",
    225     "WriteCombining",
    226     "Prefetchable"
    227 };
    228 
    229 const char                      *AcpiGbl_MinDecode[] =
    230 {
    231     "MinNotFixed",
    232     "MinFixed"
    233 };
    234 
    235 const char                      *AcpiGbl_MtpDecode[] =
    236 {
    237     "AddressRangeMemory",
    238     "AddressRangeReserved",
    239     "AddressRangeACPI",
    240     "AddressRangeNVS"
    241 };
    242 
    243 const char                      *AcpiGbl_PhyDecode[] =
    244 {
    245     "Type C",
    246     "Type D",
    247     "Unknown Type",
    248     "Unknown Type"
    249 };
    250 
    251 const char                      *AcpiGbl_RngDecode[] =
    252 {
    253     "InvalidRanges",
    254     "NonISAOnlyRanges",
    255     "ISAOnlyRanges",
    256     "EntireRange"
    257 };
    258 
    259 const char                      *AcpiGbl_RwDecode[] =
    260 {
    261     "ReadOnly",
    262     "ReadWrite"
    263 };
    264 
    265 const char                      *AcpiGbl_ShrDecode[] =
    266 {
    267     "Exclusive",
    268     "Shared",
    269     "ExclusiveAndWake",         /* ACPI 5.0 */
    270     "SharedAndWake"             /* ACPI 5.0 */
    271 };
    272 
    273 const char                      *AcpiGbl_SizDecode[] =
    274 {
    275     "Transfer8",
    276     "Transfer8_16",
    277     "Transfer16",
    278     "InvalidSize"
    279 };
    280 
    281 const char                      *AcpiGbl_TrsDecode[] =
    282 {
    283     "DenseTranslation",
    284     "SparseTranslation"
    285 };
    286 
    287 const char                      *AcpiGbl_TtpDecode[] =
    288 {
    289     "TypeStatic",
    290     "TypeTranslation"
    291 };
    292 
    293 const char                      *AcpiGbl_TypDecode[] =
    294 {
    295     "Compatibility",
    296     "TypeA",
    297     "TypeB",
    298     "TypeF"
    299 };
    300 
    301 const char                      *AcpiGbl_PpcDecode[] =
    302 {
    303     "PullDefault",
    304     "PullUp",
    305     "PullDown",
    306     "PullNone"
    307 };
    308 
    309 const char                      *AcpiGbl_IorDecode[] =
    310 {
    311     "IoRestrictionNone",
    312     "IoRestrictionInputOnly",
    313     "IoRestrictionOutputOnly",
    314     "IoRestrictionNoneAndPreserve"
    315 };
    316 
    317 const char                      *AcpiGbl_DtsDecode[] =
    318 {
    319     "Width8bit",
    320     "Width16bit",
    321     "Width32bit",
    322     "Width64bit",
    323     "Width128bit",
    324     "Width256bit",
    325 };
    326 
    327 /* GPIO connection type */
    328 
    329 const char                      *AcpiGbl_CtDecode[] =
    330 {
    331     "Interrupt",
    332     "I/O"
    333 };
    334 
    335 /* Serial bus type */
    336 
    337 const char                      *AcpiGbl_SbtDecode[] =
    338 {
    339     "/* UNKNOWN serial bus type */",
    340     "I2C",
    341     "SPI",
    342     "UART",
    343     "CSI2"
    344 };
    345 
    346 /* I2C serial bus access mode */
    347 
    348 const char                      *AcpiGbl_AmDecode[] =
    349 {
    350     "AddressingMode7Bit",
    351     "AddressingMode10Bit"
    352 };
    353 
    354 /* I2C serial bus slave mode */
    355 
    356 const char                      *AcpiGbl_SmDecode[] =
    357 {
    358     "ControllerInitiated",
    359     "DeviceInitiated"
    360 };
    361 
    362 /* SPI serial bus wire mode */
    363 
    364 const char                      *AcpiGbl_WmDecode[] =
    365 {
    366     "FourWireMode",
    367     "ThreeWireMode"
    368 };
    369 
    370 /* SPI serial clock phase */
    371 
    372 const char                      *AcpiGbl_CphDecode[] =
    373 {
    374     "ClockPhaseFirst",
    375     "ClockPhaseSecond"
    376 };
    377 
    378 /* SPI serial bus clock polarity */
    379 
    380 const char                      *AcpiGbl_CpoDecode[] =
    381 {
    382     "ClockPolarityLow",
    383     "ClockPolarityHigh"
    384 };
    385 
    386 /* SPI serial bus device polarity */
    387 
    388 const char                      *AcpiGbl_DpDecode[] =
    389 {
    390     "PolarityLow",
    391     "PolarityHigh"
    392 };
    393 
    394 /* UART serial bus endian */
    395 
    396 const char                      *AcpiGbl_EdDecode[] =
    397 {
    398     "LittleEndian",
    399     "BigEndian"
    400 };
    401 
    402 /* UART serial bus bits per byte */
    403 
    404 const char                      *AcpiGbl_BpbDecode[] =
    405 {
    406     "DataBitsFive",
    407     "DataBitsSix",
    408     "DataBitsSeven",
    409     "DataBitsEight",
    410     "DataBitsNine",
    411     "/* UNKNOWN Bits per byte */",
    412     "/* UNKNOWN Bits per byte */",
    413     "/* UNKNOWN Bits per byte */"
    414 };
    415 
    416 /* UART serial bus stop bits */
    417 
    418 const char                      *AcpiGbl_SbDecode[] =
    419 {
    420     "StopBitsZero",
    421     "StopBitsOne",
    422     "StopBitsOnePlusHalf",
    423     "StopBitsTwo"
    424 };
    425 
    426 /* UART serial bus flow control */
    427 
    428 const char                      *AcpiGbl_FcDecode[] =
    429 {
    430     "FlowControlNone",
    431     "FlowControlHardware",
    432     "FlowControlXON",
    433     "/* UNKNOWN flow control keyword */"
    434 };
    435 
    436 /* UART serial bus parity type */
    437 
    438 const char                      *AcpiGbl_PtDecode[] =
    439 {
    440     "ParityTypeNone",
    441     "ParityTypeEven",
    442     "ParityTypeOdd",
    443     "ParityTypeMark",
    444     "ParityTypeSpace",
    445     "/* UNKNOWN parity keyword */",
    446     "/* UNKNOWN parity keyword */",
    447     "/* UNKNOWN parity keyword */"
    448 };
    449 
    450 /* PinConfig type */
    451 
    452 const char                      *AcpiGbl_PtypDecode[] =
    453 {
    454     "Default",
    455     "Bias Pull-up",
    456     "Bias Pull-down",
    457     "Bias Default",
    458     "Bias Disable",
    459     "Bias High Impedance",
    460     "Bias Bus Hold",
    461     "Drive Open Drain",
    462     "Drive Open Source",
    463     "Drive Push Pull",
    464     "Drive Strength",
    465     "Slew Rate",
    466     "Input Debounce",
    467     "Input Schmitt Trigger",
    468 };
    469 
    470 const char                      *AcpiGbl_ClockInputMode[] =
    471 {
    472     "Fixed",
    473     "Variable",
    474 };
    475 
    476 const char                      *AcpiGbl_ClockInputScale[] =
    477 {
    478     "Hz",
    479     "KHz",
    480     "MHz",
    481 };
    482 
    483 #endif
    484