Home | History | Annotate | Line # | Download | only in common 
      1 /******************************************************************************
      2  *
      3  * Module Name: ahuuids - Table of known ACPI-related UUIDs
      4  *
      5  *****************************************************************************/
      6 
      7 /*
      8  * Copyright (C) 2000 - 2026, Intel Corp.
      9  * All rights reserved.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, this list of conditions, and the following disclaimer,
     16  *    without modification.
     17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  *    including a substantially similar Disclaimer requirement for further
     21  *    binary redistribution.
     22  * 3. Neither the names of the above-listed copyright holders nor the names
     23  *    of any contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * Alternatively, this software may be distributed under the terms of the
     27  * GNU General Public License ("GPL") version 2 as published by the Free
     28  * Software Foundation.
     29  *
     30  * NO WARRANTY
     31  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     34  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  * POSSIBILITY OF SUCH DAMAGES.
     42  */
     43 
     44 #include "acpi.h"
     45 #include "accommon.h"
     46 #include "acuuid.h"
     47 
     48 #define _COMPONENT          ACPI_UTILITIES
     49         ACPI_MODULE_NAME    ("ahuuids")
     50 
     51 
     52 /*
     53  * Table of "known" (ACPI-related) UUIDs
     54  */
     55 const AH_UUID  Gbl_AcpiUuids[] =
     56 {
     57     {"[Controllers]",               NULL},
     58     {"GPIO Controller",             UUID_GPIO_CONTROLLER},
     59     {"USB Controller",              UUID_USB_CONTROLLER},
     60     {"SATA Controller",             UUID_SATA_CONTROLLER},
     61 
     62     {"[Devices]",                   NULL},
     63     {"PCI Host Bridge Device",      UUID_PCI_HOST_BRIDGE},
     64     {"HID I2C Device",              UUID_I2C_DEVICE},
     65     {"Power Button Device",         UUID_POWER_BUTTON},
     66     {"Memory Device",               UUID_MEMORY_DEVICE},
     67     {"Generic Buttons Device",      UUID_GENERIC_BUTTONS_DEVICE},
     68     {"NVDIMM Root Device",          UUID_NVDIMM_ROOT_DEVICE},
     69     {"Control Method Battery",      UUID_CONTROL_METHOD_BATTERY},
     70 
     71     {"[Interfaces]",                NULL},
     72     {"Device Labeling Interface",   UUID_DEVICE_LABELING},
     73     {"Physical Presence Interface", UUID_PHYSICAL_PRESENCE},
     74 
     75     {"[Trusted Platform Module]",   NULL},
     76     {"TPM Hardware Information",    UUID_HARDWARE_INFORMATION},
     77     {"TPM Start Method",            UUID_START_METHOD},
     78     {"TPM Memory Clear",            UUID_MEMORY_CLEAR},
     79 
     80     {"[Non-volatile DIMM and NFIT table]",       NULL},
     81     {"NVDIMM Device",               UUID_NFIT_DIMM},
     82     {"Volatile Memory Region",      UUID_VOLATILE_MEMORY},
     83     {"Persistent Memory Region",    UUID_PERSISTENT_MEMORY},
     84     {"NVDIMM Control Region",       UUID_CONTROL_REGION},
     85     {"NVDIMM Data Region",          UUID_DATA_REGION},
     86     {"Volatile Virtual Disk",       UUID_VOLATILE_VIRTUAL_DISK},
     87     {"Volatile Virtual CD",         UUID_VOLATILE_VIRTUAL_CD},
     88     {"Persistent Virtual Disk",     UUID_PERSISTENT_VIRTUAL_DISK},
     89     {"Persistent Virtual CD",       UUID_PERSISTENT_VIRTUAL_CD},
     90     {"Microsoft NVDIMM Command set",UUID_NFIT_DIMM_N_MSFT},
     91     {"HP NDIMM HPE1",               UUID_NFIT_DIMM_N_HPE1},
     92     {"HP NDIMM HPE2",               UUID_NFIT_DIMM_N_HPE2},
     93     {"Virtual NVDIMM",              UUID_NFIT_DIMM_N_HYPERV},
     94 
     95     {"[Processor Properties]",      NULL},
     96     {"Cache Properties",            UUID_CACHE_PROPERTIES},
     97     {"Physical Package Property",   UUID_PHYSICAL_PROPERTY},
     98 
     99     {"[Modern Standby]",            NULL},
    100     {"Modern Standby Microsoft",    UUID_LPS0_MICROSOFT},
    101     {"Modern Standby Intel",        UUID_LPS0_INTEL},
    102     {"Modern Standby AMD",          UUID_LPS0_AMD},
    103 
    104     {"[Miscellaneous]",             NULL},
    105     {"Platform-wide Capabilities",  UUID_PLATFORM_CAPABILITIES},
    106     {"Dynamic Enumeration",         UUID_DYNAMIC_ENUMERATION},
    107     {"Battery Thermal Limit",       UUID_BATTERY_THERMAL_LIMIT},
    108     {"Thermal Extensions",          UUID_THERMAL_EXTENSIONS},
    109     {"Device Properties for _DSD",  UUID_DEVICE_PROPERTIES},
    110     {"Device Graphs for _DSD",      UUID_DEVICE_GRAPHS},
    111     {"Hierarchical Data Extension", UUID_HIERARCHICAL_DATA_EXTENSION},
    112     {"ARM Coresight Graph",         UUID_CORESIGHT_GRAPH},
    113     {"USB4 Capabilities",           UUID_USB4_CAPABILITIES},
    114     {"First Function ID for _DSM",  UUID_1ST_FUNCTION_ID},
    115     {"Second Function ID for _DSM", UUID_2ND_FUNCTION_ID},
    116     {"Fan Trip Points",             UUID_FAN_TRIP_POINTS},
    117 
    118     {NULL, NULL}
    119 };
    120 
    121 
    122 /*******************************************************************************
    123  *
    124  * FUNCTION:    AcpiAhMatchUuid
    125  *
    126  * PARAMETERS:  Data                - Data buffer containing a UUID
    127  *
    128  * RETURN:      ASCII description string for the UUID if it is found.
    129  *
    130  * DESCRIPTION: Returns a description string for "known" UUIDs, which are
    131  *              are UUIDs that are related to ACPI in some way.
    132  *
    133  ******************************************************************************/
    134 
    135 const char *
    136 AcpiAhMatchUuid (
    137     UINT8                   *Data)
    138 {
    139     const AH_UUID           *Info;
    140     UINT8                   UuidBuffer[UUID_BUFFER_LENGTH];
    141 
    142 
    143     /* Walk the table of known ACPI-related UUIDs */
    144 
    145     for (Info = Gbl_AcpiUuids; Info->Description; Info++)
    146     {
    147         /* Null string means description is a UUID class */
    148 
    149         if (!Info->String)
    150         {
    151             continue;
    152         }
    153 
    154         AcpiUtConvertStringToUuid (Info->String, UuidBuffer);
    155 
    156         if (!memcmp (Data, UuidBuffer, UUID_BUFFER_LENGTH))
    157         {
    158             return (Info->Description);
    159         }
    160     }
    161 
    162     return (NULL);
    163 }
    164