| | 1 | /** @file\r |
| | 2 | SRAT table parser\r |
| | 3 | \r |
| | 4 | Copyright (c) 2016 - 2019, ARM Limited. All rights reserved.\r |
| | 5 | SPDX-License-Identifier: BSD-2-Clause-Patent\r |
| | 6 | \r |
| | 7 | @par Reference(s):\r |
| | 8 | - ACPI 6.2 Specification - Errata A, September 2017\r |
| | 9 | **/\r |
| | 10 | \r |
| | 11 | #include <IndustryStandard/Acpi.h>\r |
| | 12 | #include <Library/PrintLib.h>\r |
| | 13 | #include <Library/UefiLib.h>\r |
| | 14 | #include "AcpiParser.h"\r |
| | 15 | #include "AcpiTableParser.h"\r |
| | 16 | \r |
| | 17 | // Local Variables\r |
| | 18 | STATIC CONST UINT8* SratRAType;\r |
| | 19 | STATIC CONST UINT8* SratRALength;\r |
| | 20 | STATIC ACPI_DESCRIPTION_HEADER_INFO AcpiHdrInfo;\r |
| | 21 | \r |
| | 22 | /**\r |
| | 23 | This function validates the Reserved field in the SRAT table header.\r |
| | 24 | \r |
| | 25 | @param [in] Ptr Pointer to the start of the field data.\r |
| | 26 | @param [in] Context Pointer to context specific information e.g. this\r |
| | 27 | could be a pointer to the ACPI table header.\r |
| | 28 | **/\r |
| | 29 | STATIC\r |
| | 30 | VOID\r |
| | 31 | EFIAPI\r |
| | 32 | ValidateSratReserved (\r |
| | 33 | IN UINT8* Ptr,\r |
| | 34 | IN VOID* Context\r |
| | 35 | )\r |
| | 36 | {\r |
| | 37 | if (*(UINT32*)Ptr != 1) {\r |
| | 38 | IncrementErrorCount ();\r |
| | 39 | Print (L"\nERROR: Reserved should be 1 for backward compatibility.\n");\r |
| | 40 | }\r |
| | 41 | }\r |
| | 42 | \r |
| | 43 | /**\r |
| | 44 | This function traces the APIC Proximity Domain field.\r |
| | 45 | \r |
| | 46 | @param [in] Format Format string for tracing the data.\r |
| | 47 | @param [in] Ptr Pointer to the start of the buffer.\r |
| | 48 | **/\r |
| | 49 | STATIC\r |
| | 50 | VOID\r |
| | 51 | EFIAPI\r |
| | 52 | DumpSratApicProximity (\r |
| | 53 | IN CONST CHAR16* Format,\r |
| | 54 | IN UINT8* Ptr\r |
| | 55 | )\r |
| | 56 | {\r |
| | 57 | UINT32 ProximityDomain;\r |
| | 58 | \r |
| | 59 | ProximityDomain = Ptr[0] | (Ptr[1] << 8) | (Ptr[2] << 16);\r |
| | 60 | \r |
| | 61 | Print (Format, ProximityDomain);\r |
| | 62 | }\r |
| | 63 | \r |
| | 64 | /**\r |
| | 65 | An ACPI_PARSER array describing the SRAT Table.\r |
| | 66 | **/\r |
| | 67 | STATIC CONST ACPI_PARSER SratParser[] = {\r |
| | 68 | PARSE_ACPI_HEADER (&AcpiHdrInfo),\r |
| | 69 | {L"Reserved", 4, 36, L"0x%x", NULL, NULL, ValidateSratReserved, NULL},\r |
| | 70 | {L"Reserved", 8, 40, L"0x%lx", NULL, NULL, NULL, NULL}\r |
| | 71 | };\r |
| | 72 | \r |
| | 73 | /**\r |
| | 74 | An ACPI_PARSER array describing the Resource Allocation structure header.\r |
| | 75 | **/\r |
| | 76 | STATIC CONST ACPI_PARSER SratResourceAllocationParser[] = {\r |
| | 77 | {L"Type", 1, 0, NULL, NULL, (VOID**)&SratRAType, NULL, NULL},\r |
| | 78 | {L"Length", 1, 1, NULL, NULL, (VOID**)&SratRALength, NULL, NULL}\r |
| | 79 | };\r |
| | 80 | \r |
| | 81 | /**\r |
| | 82 | An ACPI_PARSER array describing the GICC Affinity structure.\r |
| | 83 | **/\r |
| | 84 | STATIC CONST ACPI_PARSER SratGicCAffinityParser[] = {\r |
| | 85 | {L"Type", 1, 0, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 86 | {L"Length", 1, 1, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 87 | \r |
| | 88 | {L"Proximity Domain", 4, 2, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 89 | {L"ACPI Processor UID", 4, 6, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 90 | {L"Flags", 4, 10, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 91 | {L"Clock Domain", 4, 14, L"0x%x", NULL, NULL, NULL, NULL}\r |
| | 92 | };\r |
| | 93 | \r |
| | 94 | /**\r |
| | 95 | An ACPI_PARSER array describing the GIC ITS Affinity structure.\r |
| | 96 | **/\r |
| | 97 | STATIC CONST ACPI_PARSER SratGicITSAffinityParser[] = {\r |
| | 98 | {L"Type", 1, 0, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 99 | {L"Length", 1, 1, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 100 | \r |
| | 101 | {L"Proximity Domain", 4, 2, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 102 | {L"Reserved", 2, 6, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 103 | {L"ITS Id", 4, 8, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 104 | };\r |
| | 105 | \r |
| | 106 | /**\r |
| | 107 | An ACPI_PARSER array describing the Memory Affinity structure.\r |
| | 108 | **/\r |
| | 109 | STATIC CONST ACPI_PARSER SratMemAffinityParser[] = {\r |
| | 110 | {L"Type", 1, 0, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 111 | {L"Length", 1, 1, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 112 | \r |
| | 113 | {L"Proximity Domain", 4, 2, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 114 | {L"Reserved", 2, 6, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 115 | {L"Base Address Low", 4, 8, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 116 | {L"Base Address High", 4, 12, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 117 | {L"Length Low", 4, 16, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 118 | {L"Length High", 4, 20, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 119 | {L"Reserved", 4, 24, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 120 | {L"Flags", 4, 28, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 121 | {L"Reserved", 8, 32, L"0x%lx", NULL, NULL, NULL, NULL}\r |
| | 122 | };\r |
| | 123 | \r |
| | 124 | /**\r |
| | 125 | An ACPI_PARSER array describing the APIC/SAPIC Affinity structure.\r |
| | 126 | **/\r |
| | 127 | STATIC CONST ACPI_PARSER SratApciSapicAffinityParser[] = {\r |
| | 128 | {L"Type", 1, 0, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 129 | {L"Length", 1, 1, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 130 | \r |
| | 131 | {L"Proximity Domain [7:0]", 1, 2, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 132 | {L"APIC ID", 1, 3, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 133 | {L"Flags", 4, 4, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 134 | {L"Local SAPIC EID", 1, 8, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 135 | {L"Proximity Domain [31:8]", 3, 9, L"0x%x", DumpSratApicProximity,\r |
| | 136 | NULL, NULL, NULL},\r |
| | 137 | {L"Clock Domain", 4, 12, L"0x%x", NULL, NULL, NULL, NULL}\r |
| | 138 | };\r |
| | 139 | \r |
| | 140 | /**\r |
| | 141 | An ACPI_PARSER array describing the Processor Local x2APIC Affinity structure.\r |
| | 142 | **/\r |
| | 143 | STATIC CONST ACPI_PARSER SratX2ApciAffinityParser[] = {\r |
| | 144 | {L"Type", 1, 0, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 145 | {L"Length", 1, 1, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 146 | \r |
| | 147 | {L"Reserved", 2, 2, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 148 | {L"Proximity Domain", 4, 4, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 149 | {L"X2APIC ID", 4, 8, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 150 | {L"Flags", 4, 12, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 151 | {L"Clock Domain", 4, 16, L"0x%x", NULL, NULL, NULL, NULL},\r |
| | 152 | {L"Reserved", 4, 20, L"0x%x", NULL, NULL, NULL, NULL}\r |
| | 153 | };\r |
| | 154 | \r |
| | 155 | /**\r |
| | 156 | This function parses the ACPI SRAT table.\r |
| | 157 | When trace is enabled this function parses the SRAT table and\r |
| | 158 | traces the ACPI table fields.\r |
| | 159 | \r |
| | 160 | This function parses the following Resource Allocation Structures:\r |
| | 161 | - Processor Local APIC/SAPIC Affinity Structure\r |
| | 162 | - Memory Affinity Structure\r |
| | 163 | - Processor Local x2APIC Affinity Structure\r |
| | 164 | - GICC Affinity Structure\r |
| | 165 | \r |
| | 166 | This function also performs validation of the ACPI table fields.\r |
| | 167 | \r |
| | 168 | @param [in] Trace If TRUE, trace the ACPI fields.\r |
| | 169 | @param [in] Ptr Pointer to the start of the buffer.\r |
| | 170 | @param [in] AcpiTableLength Length of the ACPI table.\r |
| | 171 | @param [in] AcpiTableRevision Revision of the ACPI table.\r |
| | 172 | **/\r |
| | 173 | VOID\r |
| | 174 | EFIAPI\r |
| | 175 | ParseAcpiSrat (\r |
| | 176 | IN BOOLEAN Trace,\r |
| | 177 | IN UINT8* Ptr,\r |
| | 178 | IN UINT32 AcpiTableLength,\r |
| | 179 | IN UINT8 AcpiTableRevision\r |
| | 180 | )\r |
| | 181 | {\r |
| | 182 | UINT32 Offset;\r |
| | 183 | UINT8* ResourcePtr;\r |
| | 184 | UINT32 GicCAffinityIndex;\r |
| | 185 | UINT32 GicITSAffinityIndex;\r |
| | 186 | UINT32 MemoryAffinityIndex;\r |
| | 187 | UINT32 ApicSapicAffinityIndex;\r |
| | 188 | UINT32 X2ApicAffinityIndex;\r |
| | 189 | CHAR8 Buffer[80]; // Used for AsciiName param of ParseAcpi\r |
| | 190 | \r |
| | 191 | GicCAffinityIndex = 0;\r |
| | 192 | GicITSAffinityIndex = 0;\r |
| | 193 | MemoryAffinityIndex = 0;\r |
| | 194 | ApicSapicAffinityIndex = 0;\r |
| | 195 | X2ApicAffinityIndex = 0;\r |
| | 196 | \r |
| | 197 | if (!Trace) {\r |
| | 198 | return;\r |
| | 199 | }\r |
| | 200 | \r |
| | 201 | Offset = ParseAcpi (\r |
| | 202 | TRUE,\r |
| | 203 | 0,\r |
| | 204 | "SRAT",\r |
| | 205 | Ptr,\r |
| | 206 | AcpiTableLength,\r |
| | 207 | PARSER_PARAMS (SratParser)\r |
| | 208 | );\r |
| | 209 | ResourcePtr = Ptr + Offset;\r |
| | 210 | \r |
| | 211 | while (Offset < AcpiTableLength) {\r |
| | 212 | ParseAcpi (\r |
| | 213 | FALSE,\r |
| | 214 | 0,\r |
| | 215 | NULL,\r |
| | 216 | ResourcePtr,\r |
| | 217 | 2, // The length is 1 byte at offset 1\r |
| | 218 | PARSER_PARAMS (SratResourceAllocationParser)\r |
| | 219 | );\r |
| | 220 | \r |
| | 221 | switch (*SratRAType) {\r |
| | 222 | case EFI_ACPI_6_2_GICC_AFFINITY:\r |
| | 223 | AsciiSPrint (\r |
| | 224 | Buffer,\r |
| | 225 | sizeof (Buffer),\r |
| | 226 | "GICC Affinity Structure [%d]",\r |
| | 227 | GicCAffinityIndex++\r |
| | 228 | );\r |
| | 229 | ParseAcpi (\r |
| | 230 | TRUE,\r |
| | 231 | 2,\r |
| | 232 | Buffer,\r |
| | 233 | ResourcePtr,\r |
| | 234 | *SratRALength,\r |
| | 235 | PARSER_PARAMS (SratGicCAffinityParser)\r |
| | 236 | );\r |
| | 237 | break;\r |
| | 238 | \r |
| | 239 | case EFI_ACPI_6_2_GIC_ITS_AFFINITY:\r |
| | 240 | AsciiSPrint (\r |
| | 241 | Buffer,\r |
| | 242 | sizeof (Buffer),\r |
| | 243 | "GIC ITS Affinity Structure [%d]",\r |
| | 244 | GicITSAffinityIndex++\r |
| | 245 | );\r |
| | 246 | ParseAcpi (\r |
| | 247 | TRUE,\r |
| | 248 | 2,\r |
| | 249 | Buffer,\r |
| | 250 | ResourcePtr,\r |
| | 251 | *SratRALength,\r |
| | 252 | PARSER_PARAMS (SratGicITSAffinityParser)\r |
| | 253 | );\r |
| | 254 | break;\r |
| | 255 | \r |
| | 256 | case EFI_ACPI_6_2_MEMORY_AFFINITY:\r |
| | 257 | AsciiSPrint (\r |
| | 258 | Buffer,\r |
| | 259 | sizeof (Buffer),\r |
| | 260 | "Memory Affinity Structure [%d]",\r |
| | 261 | MemoryAffinityIndex++\r |
| | 262 | );\r |
| | 263 | ParseAcpi (\r |
| | 264 | TRUE,\r |
| | 265 | 2,\r |
| | 266 | Buffer,\r |
| | 267 | ResourcePtr,\r |
| | 268 | *SratRALength,\r |
| | 269 | PARSER_PARAMS (SratMemAffinityParser)\r |
| | 270 | );\r |
| | 271 | break;\r |
| | 272 | \r |
| | 273 | case EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY:\r |
| | 274 | AsciiSPrint (\r |
| | 275 | Buffer,\r |
| | 276 | sizeof (Buffer),\r |
| | 277 | "APIC/SAPIC Affinity Structure [%d]",\r |
| | 278 | ApicSapicAffinityIndex++\r |
| | 279 | );\r |
| | 280 | ParseAcpi (\r |
| | 281 | TRUE,\r |
| | 282 | 2,\r |
| | 283 | Buffer,\r |
| | 284 | ResourcePtr,\r |
| | 285 | *SratRALength,\r |
| | 286 | PARSER_PARAMS (SratApciSapicAffinityParser)\r |
| | 287 | );\r |
| | 288 | break;\r |
| | 289 | \r |
| | 290 | case EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_AFFINITY:\r |
| | 291 | AsciiSPrint (\r |
| | 292 | Buffer,\r |
| | 293 | sizeof (Buffer),\r |
| | 294 | "X2APIC Affinity Structure [%d]",\r |
| | 295 | X2ApicAffinityIndex++\r |
| | 296 | );\r |
| | 297 | ParseAcpi (\r |
| | 298 | TRUE,\r |
| | 299 | 2,\r |
| | 300 | Buffer,\r |
| | 301 | ResourcePtr,\r |
| | 302 | *SratRALength,\r |
| | 303 | PARSER_PARAMS (SratX2ApciAffinityParser)\r |
| | 304 | );\r |
| | 305 | break;\r |
| | 306 | \r |
| | 307 | default:\r |
| | 308 | IncrementErrorCount ();\r |
| | 309 | Print (L"ERROR: Unknown SRAT Affinity type = 0x%x\n", *SratRAType);\r |
| | 310 | break;\r |
| | 311 | }\r |
| | 312 | \r |
| | 313 | ResourcePtr += (*SratRALength);\r |
| | 314 | Offset += (*SratRALength);\r |
| | 315 | }\r |
| | 316 | }\r |
projects / mirror_edk2.git / blame_incremental