1 /******************************************************************************
2 *
3 * Module Name: utids - support for device IDs - HID, UID, CID, SUB, CLS
4 *
5 *****************************************************************************/
6
7 /*
8 * Copyright (C) 2000 - 2022, 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 "acinterp.h"
47
48
49 #define _COMPONENT ACPI_UTILITIES
50 ACPI_MODULE_NAME ("utids")
51
52
53 /*******************************************************************************
54 *
55 * FUNCTION: AcpiUtExecute_HID
56 *
57 * PARAMETERS: DeviceNode - Node for the device
58 * ReturnId - Where the string HID is returned
59 *
60 * RETURN: Status
61 *
62 * DESCRIPTION: Executes the _HID control method that returns the hardware
63 * ID of the device. The HID is either an 32-bit encoded EISAID
64 * Integer or a String. A string is always returned. An EISAID
65 * is converted to a string.
66 *
67 * NOTE: Internal function, no parameter validation
68 *
69 ******************************************************************************/
70
71 ACPI_STATUS
AcpiUtExecute_HID(ACPI_NAMESPACE_NODE * DeviceNode,ACPI_PNP_DEVICE_ID ** ReturnId)72 AcpiUtExecute_HID (
73 ACPI_NAMESPACE_NODE *DeviceNode,
74 ACPI_PNP_DEVICE_ID **ReturnId)
75 {
76 ACPI_OPERAND_OBJECT *ObjDesc;
77 ACPI_PNP_DEVICE_ID *Hid;
78 UINT32 Length;
79 ACPI_STATUS Status;
80
81
82 ACPI_FUNCTION_TRACE (UtExecute_HID);
83
84
85 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__HID,
86 ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING, &ObjDesc);
87 if (ACPI_FAILURE (Status))
88 {
89 return_ACPI_STATUS (Status);
90 }
91
92 /* Get the size of the String to be returned, includes null terminator */
93
94 if (ObjDesc->Common.Type == ACPI_TYPE_INTEGER)
95 {
96 Length = ACPI_EISAID_STRING_SIZE;
97 }
98 else
99 {
100 Length = ObjDesc->String.Length + 1;
101 }
102
103 /* Allocate a buffer for the HID */
104
105 Hid = ACPI_ALLOCATE_ZEROED (
106 sizeof (ACPI_PNP_DEVICE_ID) + (ACPI_SIZE) Length);
107 if (!Hid)
108 {
109 Status = AE_NO_MEMORY;
110 goto Cleanup;
111 }
112
113 /* Area for the string starts after PNP_DEVICE_ID struct */
114
115 Hid->String = ACPI_ADD_PTR (char, Hid, sizeof (ACPI_PNP_DEVICE_ID));
116
117 /* Convert EISAID to a string or simply copy existing string */
118
119 if (ObjDesc->Common.Type == ACPI_TYPE_INTEGER)
120 {
121 AcpiExEisaIdToString (Hid->String, ObjDesc->Integer.Value);
122 }
123 else
124 {
125 strcpy (Hid->String, ObjDesc->String.Pointer);
126 }
127
128 Hid->Length = Length;
129 *ReturnId = Hid;
130
131
132 Cleanup:
133
134 /* On exit, we must delete the return object */
135
136 AcpiUtRemoveReference (ObjDesc);
137 return_ACPI_STATUS (Status);
138 }
139
140
141 /*******************************************************************************
142 *
143 * FUNCTION: AcpiUtExecute_UID
144 *
145 * PARAMETERS: DeviceNode - Node for the device
146 * ReturnId - Where the string UID is returned
147 *
148 * RETURN: Status
149 *
150 * DESCRIPTION: Executes the _UID control method that returns the unique
151 * ID of the device. The UID is either a 64-bit Integer (NOT an
152 * EISAID) or a string. Always returns a string. A 64-bit integer
153 * is converted to a decimal string.
154 *
155 * NOTE: Internal function, no parameter validation
156 *
157 ******************************************************************************/
158
159 ACPI_STATUS
AcpiUtExecute_UID(ACPI_NAMESPACE_NODE * DeviceNode,ACPI_PNP_DEVICE_ID ** ReturnId)160 AcpiUtExecute_UID (
161 ACPI_NAMESPACE_NODE *DeviceNode,
162 ACPI_PNP_DEVICE_ID **ReturnId)
163 {
164 ACPI_OPERAND_OBJECT *ObjDesc;
165 ACPI_PNP_DEVICE_ID *Uid;
166 UINT32 Length;
167 ACPI_STATUS Status;
168
169
170 ACPI_FUNCTION_TRACE (UtExecute_UID);
171
172
173 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__UID,
174 ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING, &ObjDesc);
175 if (ACPI_FAILURE (Status))
176 {
177 return_ACPI_STATUS (Status);
178 }
179
180 /* Get the size of the String to be returned, includes null terminator */
181
182 if (ObjDesc->Common.Type == ACPI_TYPE_INTEGER)
183 {
184 Length = ACPI_MAX64_DECIMAL_DIGITS + 1;
185 }
186 else
187 {
188 Length = ObjDesc->String.Length + 1;
189 }
190
191 /* Allocate a buffer for the UID */
192
193 Uid = ACPI_ALLOCATE_ZEROED (
194 sizeof (ACPI_PNP_DEVICE_ID) + (ACPI_SIZE) Length);
195 if (!Uid)
196 {
197 Status = AE_NO_MEMORY;
198 goto Cleanup;
199 }
200
201 /* Area for the string starts after PNP_DEVICE_ID struct */
202
203 Uid->String = ACPI_ADD_PTR (char, Uid, sizeof (ACPI_PNP_DEVICE_ID));
204
205 /* Convert an Integer to string, or just copy an existing string */
206
207 if (ObjDesc->Common.Type == ACPI_TYPE_INTEGER)
208 {
209 AcpiExIntegerToString (Uid->String, ObjDesc->Integer.Value);
210 }
211 else
212 {
213 strcpy (Uid->String, ObjDesc->String.Pointer);
214 }
215
216 Uid->Length = Length;
217 *ReturnId = Uid;
218
219
220 Cleanup:
221
222 /* On exit, we must delete the return object */
223
224 AcpiUtRemoveReference (ObjDesc);
225 return_ACPI_STATUS (Status);
226 }
227
228
229 /*******************************************************************************
230 *
231 * FUNCTION: AcpiUtExecute_CID
232 *
233 * PARAMETERS: DeviceNode - Node for the device
234 * ReturnCidList - Where the CID list is returned
235 *
236 * RETURN: Status, list of CID strings
237 *
238 * DESCRIPTION: Executes the _CID control method that returns one or more
239 * compatible hardware IDs for the device.
240 *
241 * NOTE: Internal function, no parameter validation
242 *
243 * A _CID method can return either a single compatible ID or a package of
244 * compatible IDs. Each compatible ID can be one of the following:
245 * 1) Integer (32 bit compressed EISA ID) or
246 * 2) String (PCI ID format, e.g. "PCI\VEN_vvvv&DEV_dddd&SUBSYS_ssssssss")
247 *
248 * The Integer CIDs are converted to string format by this function.
249 *
250 ******************************************************************************/
251
252 ACPI_STATUS
AcpiUtExecute_CID(ACPI_NAMESPACE_NODE * DeviceNode,ACPI_PNP_DEVICE_ID_LIST ** ReturnCidList)253 AcpiUtExecute_CID (
254 ACPI_NAMESPACE_NODE *DeviceNode,
255 ACPI_PNP_DEVICE_ID_LIST **ReturnCidList)
256 {
257 ACPI_OPERAND_OBJECT **CidObjects;
258 ACPI_OPERAND_OBJECT *ObjDesc;
259 ACPI_PNP_DEVICE_ID_LIST *CidList;
260 char *NextIdString;
261 UINT32 StringAreaSize;
262 UINT32 Length;
263 UINT32 CidListSize;
264 ACPI_STATUS Status;
265 UINT32 Count;
266 UINT32 i;
267
268
269 ACPI_FUNCTION_TRACE (UtExecute_CID);
270
271
272 /* Evaluate the _CID method for this device */
273
274 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__CID,
275 ACPI_BTYPE_INTEGER | ACPI_BTYPE_STRING | ACPI_BTYPE_PACKAGE,
276 &ObjDesc);
277 if (ACPI_FAILURE (Status))
278 {
279 return_ACPI_STATUS (Status);
280 }
281
282 /*
283 * Get the count and size of the returned _CIDs. _CID can return either
284 * a Package of Integers/Strings or a single Integer or String.
285 * Note: This section also validates that all CID elements are of the
286 * correct type (Integer or String).
287 */
288 if (ObjDesc->Common.Type == ACPI_TYPE_PACKAGE)
289 {
290 Count = ObjDesc->Package.Count;
291 CidObjects = ObjDesc->Package.Elements;
292 }
293 else /* Single Integer or String CID */
294 {
295 Count = 1;
296 CidObjects = &ObjDesc;
297 }
298
299 StringAreaSize = 0;
300 for (i = 0; i < Count; i++)
301 {
302 /* String lengths include null terminator */
303
304 switch (CidObjects[i]->Common.Type)
305 {
306 case ACPI_TYPE_INTEGER:
307
308 StringAreaSize += ACPI_EISAID_STRING_SIZE;
309 break;
310
311 case ACPI_TYPE_STRING:
312
313 StringAreaSize += CidObjects[i]->String.Length + 1;
314 break;
315
316 default:
317
318 Status = AE_TYPE;
319 goto Cleanup;
320 }
321 }
322
323 /*
324 * Now that we know the length of the CIDs, allocate return buffer:
325 * 1) Size of the base structure +
326 * 2) Size of the CID PNP_DEVICE_ID array +
327 * 3) Size of the actual CID strings
328 */
329 CidListSize = sizeof (ACPI_PNP_DEVICE_ID_LIST) +
330 (Count * sizeof (ACPI_PNP_DEVICE_ID)) +
331 StringAreaSize;
332
333 CidList = ACPI_ALLOCATE_ZEROED (CidListSize);
334 if (!CidList)
335 {
336 Status = AE_NO_MEMORY;
337 goto Cleanup;
338 }
339
340 /* Area for CID strings starts after the CID PNP_DEVICE_ID array */
341
342 NextIdString = ACPI_CAST_PTR (char, CidList->Ids) +
343 ((ACPI_SIZE) Count * sizeof (ACPI_PNP_DEVICE_ID));
344
345 /* Copy/convert the CIDs to the return buffer */
346
347 for (i = 0; i < Count; i++)
348 {
349 if (CidObjects[i]->Common.Type == ACPI_TYPE_INTEGER)
350 {
351 /* Convert the Integer (EISAID) CID to a string */
352
353 AcpiExEisaIdToString (
354 NextIdString, CidObjects[i]->Integer.Value);
355 Length = ACPI_EISAID_STRING_SIZE;
356 }
357 else /* ACPI_TYPE_STRING */
358 {
359 /* Copy the String CID from the returned object */
360
361 strcpy (NextIdString, CidObjects[i]->String.Pointer);
362 Length = CidObjects[i]->String.Length + 1;
363 }
364
365 CidList->Ids[i].String = NextIdString;
366 CidList->Ids[i].Length = Length;
367 NextIdString += Length;
368 }
369
370 /* Finish the CID list */
371
372 CidList->Count = Count;
373 CidList->ListSize = CidListSize;
374 *ReturnCidList = CidList;
375
376
377 Cleanup:
378
379 /* On exit, we must delete the _CID return object */
380
381 AcpiUtRemoveReference (ObjDesc);
382 return_ACPI_STATUS (Status);
383 }
384
385
386 /*******************************************************************************
387 *
388 * FUNCTION: AcpiUtExecute_CLS
389 *
390 * PARAMETERS: DeviceNode - Node for the device
391 * ReturnId - Where the _CLS is returned
392 *
393 * RETURN: Status
394 *
395 * DESCRIPTION: Executes the _CLS control method that returns PCI-defined
396 * class code of the device. The _CLS value is always a package
397 * containing PCI class information as a list of integers.
398 * The returned string has format "BBSSPP", where:
399 * BB = Base-class code
400 * SS = Sub-class code
401 * PP = Programming Interface code
402 *
403 ******************************************************************************/
404
405 ACPI_STATUS
AcpiUtExecute_CLS(ACPI_NAMESPACE_NODE * DeviceNode,ACPI_PNP_DEVICE_ID ** ReturnId)406 AcpiUtExecute_CLS (
407 ACPI_NAMESPACE_NODE *DeviceNode,
408 ACPI_PNP_DEVICE_ID **ReturnId)
409 {
410 ACPI_OPERAND_OBJECT *ObjDesc;
411 ACPI_OPERAND_OBJECT **ClsObjects;
412 UINT32 Count;
413 ACPI_PNP_DEVICE_ID *Cls;
414 UINT32 Length;
415 ACPI_STATUS Status;
416 UINT8 ClassCode[3] = {0, 0, 0};
417
418
419 ACPI_FUNCTION_TRACE (UtExecute_CLS);
420
421
422 Status = AcpiUtEvaluateObject (DeviceNode, METHOD_NAME__CLS,
423 ACPI_BTYPE_PACKAGE, &ObjDesc);
424 if (ACPI_FAILURE (Status))
425 {
426 return_ACPI_STATUS (Status);
427 }
428
429 /* Get the size of the String to be returned, includes null terminator */
430
431 Length = ACPI_PCICLS_STRING_SIZE;
432 ClsObjects = ObjDesc->Package.Elements;
433 Count = ObjDesc->Package.Count;
434
435 if (ObjDesc->Common.Type == ACPI_TYPE_PACKAGE)
436 {
437 if (Count > 0 && ClsObjects[0]->Common.Type == ACPI_TYPE_INTEGER)
438 {
439 ClassCode[0] = (UINT8) ClsObjects[0]->Integer.Value;
440 }
441 if (Count > 1 && ClsObjects[1]->Common.Type == ACPI_TYPE_INTEGER)
442 {
443 ClassCode[1] = (UINT8) ClsObjects[1]->Integer.Value;
444 }
445 if (Count > 2 && ClsObjects[2]->Common.Type == ACPI_TYPE_INTEGER)
446 {
447 ClassCode[2] = (UINT8) ClsObjects[2]->Integer.Value;
448 }
449 }
450
451 /* Allocate a buffer for the CLS */
452
453 Cls = ACPI_ALLOCATE_ZEROED (
454 sizeof (ACPI_PNP_DEVICE_ID) + (ACPI_SIZE) Length);
455 if (!Cls)
456 {
457 Status = AE_NO_MEMORY;
458 goto Cleanup;
459 }
460
461 /* Area for the string starts after PNP_DEVICE_ID struct */
462
463 Cls->String = ACPI_ADD_PTR (char, Cls, sizeof (ACPI_PNP_DEVICE_ID));
464
465 /* Simply copy existing string */
466
467 AcpiExPciClsToString (Cls->String, ClassCode);
468 Cls->Length = Length;
469 *ReturnId = Cls;
470
471
472 Cleanup:
473
474 /* On exit, we must delete the return object */
475
476 AcpiUtRemoveReference (ObjDesc);
477 return_ACPI_STATUS (Status);
478 }
479