dbconvert.c revision 1.1.1.19 1 1.1 christos /*******************************************************************************
2 1.1 christos *
3 1.1 christos * Module Name: dbconvert - debugger miscellaneous conversion routines
4 1.1 christos *
5 1.1 christos ******************************************************************************/
6 1.1 christos
7 1.1.1.18 christos /******************************************************************************
8 1.1.1.18 christos *
9 1.1.1.18 christos * 1. Copyright Notice
10 1.1.1.18 christos *
11 1.1.1.19 christos * Some or all of this work - Copyright (c) 1999 - 2025, Intel Corp.
12 1.1 christos * All rights reserved.
13 1.1 christos *
14 1.1.1.18 christos * 2. License
15 1.1.1.18 christos *
16 1.1.1.18 christos * 2.1. This is your license from Intel Corp. under its intellectual property
17 1.1.1.18 christos * rights. You may have additional license terms from the party that provided
18 1.1.1.18 christos * you this software, covering your right to use that party's intellectual
19 1.1.1.18 christos * property rights.
20 1.1.1.18 christos *
21 1.1.1.18 christos * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22 1.1.1.18 christos * copy of the source code appearing in this file ("Covered Code") an
23 1.1.1.18 christos * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24 1.1.1.18 christos * base code distributed originally by Intel ("Original Intel Code") to copy,
25 1.1.1.18 christos * make derivatives, distribute, use and display any portion of the Covered
26 1.1.1.18 christos * Code in any form, with the right to sublicense such rights; and
27 1.1.1.18 christos *
28 1.1.1.18 christos * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29 1.1.1.18 christos * license (with the right to sublicense), under only those claims of Intel
30 1.1.1.18 christos * patents that are infringed by the Original Intel Code, to make, use, sell,
31 1.1.1.18 christos * offer to sell, and import the Covered Code and derivative works thereof
32 1.1.1.18 christos * solely to the minimum extent necessary to exercise the above copyright
33 1.1.1.18 christos * license, and in no event shall the patent license extend to any additions
34 1.1.1.18 christos * to or modifications of the Original Intel Code. No other license or right
35 1.1.1.18 christos * is granted directly or by implication, estoppel or otherwise;
36 1.1.1.18 christos *
37 1.1.1.18 christos * The above copyright and patent license is granted only if the following
38 1.1.1.18 christos * conditions are met:
39 1.1.1.18 christos *
40 1.1.1.18 christos * 3. Conditions
41 1.1.1.18 christos *
42 1.1.1.18 christos * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43 1.1.1.18 christos * Redistribution of source code of any substantial portion of the Covered
44 1.1.1.18 christos * Code or modification with rights to further distribute source must include
45 1.1.1.18 christos * the above Copyright Notice, the above License, this list of Conditions,
46 1.1.1.18 christos * and the following Disclaimer and Export Compliance provision. In addition,
47 1.1.1.18 christos * Licensee must cause all Covered Code to which Licensee contributes to
48 1.1.1.18 christos * contain a file documenting the changes Licensee made to create that Covered
49 1.1.1.18 christos * Code and the date of any change. Licensee must include in that file the
50 1.1.1.18 christos * documentation of any changes made by any predecessor Licensee. Licensee
51 1.1.1.18 christos * must include a prominent statement that the modification is derived,
52 1.1.1.18 christos * directly or indirectly, from Original Intel Code.
53 1.1.1.18 christos *
54 1.1.1.18 christos * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55 1.1.1.18 christos * Redistribution of source code of any substantial portion of the Covered
56 1.1.1.18 christos * Code or modification without rights to further distribute source must
57 1.1.1.18 christos * include the following Disclaimer and Export Compliance provision in the
58 1.1.1.18 christos * documentation and/or other materials provided with distribution. In
59 1.1.1.18 christos * addition, Licensee may not authorize further sublicense of source of any
60 1.1.1.18 christos * portion of the Covered Code, and must include terms to the effect that the
61 1.1.1.18 christos * license from Licensee to its licensee is limited to the intellectual
62 1.1.1.18 christos * property embodied in the software Licensee provides to its licensee, and
63 1.1.1.18 christos * not to intellectual property embodied in modifications its licensee may
64 1.1.1.18 christos * make.
65 1.1.1.18 christos *
66 1.1.1.18 christos * 3.3. Redistribution of Executable. Redistribution in executable form of any
67 1.1.1.18 christos * substantial portion of the Covered Code or modification must reproduce the
68 1.1.1.18 christos * above Copyright Notice, and the following Disclaimer and Export Compliance
69 1.1.1.18 christos * provision in the documentation and/or other materials provided with the
70 1.1.1.18 christos * distribution.
71 1.1.1.18 christos *
72 1.1.1.18 christos * 3.4. Intel retains all right, title, and interest in and to the Original
73 1.1.1.18 christos * Intel Code.
74 1.1.1.18 christos *
75 1.1.1.18 christos * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76 1.1.1.18 christos * Intel shall be used in advertising or otherwise to promote the sale, use or
77 1.1.1.18 christos * other dealings in products derived from or relating to the Covered Code
78 1.1.1.18 christos * without prior written authorization from Intel.
79 1.1.1.18 christos *
80 1.1.1.18 christos * 4. Disclaimer and Export Compliance
81 1.1.1.18 christos *
82 1.1.1.18 christos * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83 1.1.1.18 christos * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84 1.1.1.18 christos * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85 1.1.1.18 christos * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86 1.1.1.18 christos * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87 1.1.1.18 christos * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88 1.1.1.18 christos * PARTICULAR PURPOSE.
89 1.1.1.18 christos *
90 1.1.1.18 christos * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91 1.1.1.18 christos * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92 1.1.1.18 christos * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93 1.1.1.18 christos * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94 1.1.1.18 christos * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95 1.1.1.18 christos * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96 1.1.1.18 christos * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97 1.1.1.18 christos * LIMITED REMEDY.
98 1.1.1.18 christos *
99 1.1.1.18 christos * 4.3. Licensee shall not export, either directly or indirectly, any of this
100 1.1.1.18 christos * software or system incorporating such software without first obtaining any
101 1.1.1.18 christos * required license or other approval from the U. S. Department of Commerce or
102 1.1.1.18 christos * any other agency or department of the United States Government. In the
103 1.1.1.18 christos * event Licensee exports any such software from the United States or
104 1.1.1.18 christos * re-exports any such software from a foreign destination, Licensee shall
105 1.1.1.18 christos * ensure that the distribution and export/re-export of the software is in
106 1.1.1.18 christos * compliance with all laws, regulations, orders, or other restrictions of the
107 1.1.1.18 christos * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108 1.1.1.18 christos * any of its subsidiaries will export/re-export any technical data, process,
109 1.1.1.18 christos * software, or service, directly or indirectly, to any country for which the
110 1.1.1.18 christos * United States government or any agency thereof requires an export license,
111 1.1.1.18 christos * other governmental approval, or letter of assurance, without first obtaining
112 1.1.1.18 christos * such license, approval or letter.
113 1.1.1.18 christos *
114 1.1.1.18 christos *****************************************************************************
115 1.1.1.18 christos *
116 1.1.1.18 christos * Alternatively, you may choose to be licensed under the terms of the
117 1.1.1.18 christos * following license:
118 1.1.1.18 christos *
119 1.1 christos * Redistribution and use in source and binary forms, with or without
120 1.1 christos * modification, are permitted provided that the following conditions
121 1.1 christos * are met:
122 1.1 christos * 1. Redistributions of source code must retain the above copyright
123 1.1 christos * notice, this list of conditions, and the following disclaimer,
124 1.1 christos * without modification.
125 1.1 christos * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126 1.1 christos * substantially similar to the "NO WARRANTY" disclaimer below
127 1.1 christos * ("Disclaimer") and any redistribution must be conditioned upon
128 1.1 christos * including a substantially similar Disclaimer requirement for further
129 1.1 christos * binary redistribution.
130 1.1 christos * 3. Neither the names of the above-listed copyright holders nor the names
131 1.1 christos * of any contributors may be used to endorse or promote products derived
132 1.1 christos * from this software without specific prior written permission.
133 1.1 christos *
134 1.1 christos * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135 1.1 christos * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136 1.1.1.14 christos * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137 1.1 christos * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138 1.1.1.18 christos * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139 1.1.1.18 christos * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140 1.1.1.18 christos * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141 1.1.1.18 christos * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142 1.1.1.18 christos * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143 1.1.1.18 christos * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144 1.1.1.18 christos * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145 1.1.1.18 christos *
146 1.1.1.18 christos * Alternatively, you may choose to be licensed under the terms of the
147 1.1.1.18 christos * GNU General Public License ("GPL") version 2 as published by the Free
148 1.1.1.18 christos * Software Foundation.
149 1.1.1.18 christos *
150 1.1.1.18 christos *****************************************************************************/
151 1.1 christos
152 1.1 christos #include "acpi.h"
153 1.1 christos #include "accommon.h"
154 1.1 christos #include "acdebug.h"
155 1.1 christos
156 1.1 christos
157 1.1 christos #define _COMPONENT ACPI_CA_DEBUGGER
158 1.1 christos ACPI_MODULE_NAME ("dbconvert")
159 1.1 christos
160 1.1 christos
161 1.1 christos #define DB_DEFAULT_PKG_ELEMENTS 33
162 1.1 christos
163 1.1 christos
164 1.1 christos /*******************************************************************************
165 1.1 christos *
166 1.1 christos * FUNCTION: AcpiDbHexCharToValue
167 1.1 christos *
168 1.1 christos * PARAMETERS: HexChar - Ascii Hex digit, 0-9|a-f|A-F
169 1.1 christos * ReturnValue - Where the converted value is returned
170 1.1 christos *
171 1.1 christos * RETURN: Status
172 1.1 christos *
173 1.1 christos * DESCRIPTION: Convert a single hex character to a 4-bit number (0-16).
174 1.1 christos *
175 1.1 christos ******************************************************************************/
176 1.1 christos
177 1.1 christos ACPI_STATUS
178 1.1 christos AcpiDbHexCharToValue (
179 1.1 christos int HexChar,
180 1.1 christos UINT8 *ReturnValue)
181 1.1 christos {
182 1.1 christos UINT8 Value;
183 1.1 christos
184 1.1 christos
185 1.1 christos /* Digit must be ascii [0-9a-fA-F] */
186 1.1 christos
187 1.1.1.4 christos if (!isxdigit (HexChar))
188 1.1 christos {
189 1.1 christos return (AE_BAD_HEX_CONSTANT);
190 1.1 christos }
191 1.1 christos
192 1.1 christos if (HexChar <= 0x39)
193 1.1 christos {
194 1.1 christos Value = (UINT8) (HexChar - 0x30);
195 1.1 christos }
196 1.1 christos else
197 1.1 christos {
198 1.1.1.4 christos Value = (UINT8) (toupper (HexChar) - 0x37);
199 1.1 christos }
200 1.1 christos
201 1.1 christos *ReturnValue = Value;
202 1.1 christos return (AE_OK);
203 1.1 christos }
204 1.1 christos
205 1.1 christos
206 1.1 christos /*******************************************************************************
207 1.1 christos *
208 1.1 christos * FUNCTION: AcpiDbHexByteToBinary
209 1.1 christos *
210 1.1 christos * PARAMETERS: HexByte - Double hex digit (0x00 - 0xFF) in format:
211 1.1 christos * HiByte then LoByte.
212 1.1 christos * ReturnValue - Where the converted value is returned
213 1.1 christos *
214 1.1 christos * RETURN: Status
215 1.1 christos *
216 1.1 christos * DESCRIPTION: Convert two hex characters to an 8 bit number (0 - 255).
217 1.1 christos *
218 1.1 christos ******************************************************************************/
219 1.1 christos
220 1.1 christos static ACPI_STATUS
221 1.1 christos AcpiDbHexByteToBinary (
222 1.1 christos char *HexByte,
223 1.1 christos UINT8 *ReturnValue)
224 1.1 christos {
225 1.1 christos UINT8 Local0;
226 1.1 christos UINT8 Local1;
227 1.1 christos ACPI_STATUS Status;
228 1.1 christos
229 1.1 christos
230 1.1 christos /* High byte */
231 1.1 christos
232 1.1 christos Status = AcpiDbHexCharToValue (HexByte[0], &Local0);
233 1.1 christos if (ACPI_FAILURE (Status))
234 1.1 christos {
235 1.1 christos return (Status);
236 1.1 christos }
237 1.1 christos
238 1.1 christos /* Low byte */
239 1.1 christos
240 1.1 christos Status = AcpiDbHexCharToValue (HexByte[1], &Local1);
241 1.1 christos if (ACPI_FAILURE (Status))
242 1.1 christos {
243 1.1 christos return (Status);
244 1.1 christos }
245 1.1 christos
246 1.1 christos *ReturnValue = (UINT8) ((Local0 << 4) | Local1);
247 1.1 christos return (AE_OK);
248 1.1 christos }
249 1.1 christos
250 1.1 christos
251 1.1 christos /*******************************************************************************
252 1.1 christos *
253 1.1 christos * FUNCTION: AcpiDbConvertToBuffer
254 1.1 christos *
255 1.1 christos * PARAMETERS: String - Input string to be converted
256 1.1 christos * Object - Where the buffer object is returned
257 1.1 christos *
258 1.1 christos * RETURN: Status
259 1.1 christos *
260 1.1 christos * DESCRIPTION: Convert a string to a buffer object. String is treated a list
261 1.1 christos * of buffer elements, each separated by a space or comma.
262 1.1 christos *
263 1.1 christos ******************************************************************************/
264 1.1 christos
265 1.1 christos static ACPI_STATUS
266 1.1 christos AcpiDbConvertToBuffer (
267 1.1 christos char *String,
268 1.1 christos ACPI_OBJECT *Object)
269 1.1 christos {
270 1.1 christos UINT32 i;
271 1.1 christos UINT32 j;
272 1.1 christos UINT32 Length;
273 1.1 christos UINT8 *Buffer;
274 1.1 christos ACPI_STATUS Status;
275 1.1 christos
276 1.1 christos
277 1.1.1.12 christos /* Skip all preceding white space*/
278 1.1.1.12 christos
279 1.1.1.12 christos AcpiUtRemoveWhitespace (&String);
280 1.1.1.12 christos
281 1.1 christos /* Generate the final buffer length */
282 1.1 christos
283 1.1 christos for (i = 0, Length = 0; String[i];)
284 1.1 christos {
285 1.1 christos i+=2;
286 1.1 christos Length++;
287 1.1 christos
288 1.1 christos while (String[i] &&
289 1.1 christos ((String[i] == ',') || (String[i] == ' ')))
290 1.1 christos {
291 1.1 christos i++;
292 1.1 christos }
293 1.1 christos }
294 1.1 christos
295 1.1 christos Buffer = ACPI_ALLOCATE (Length);
296 1.1 christos if (!Buffer)
297 1.1 christos {
298 1.1 christos return (AE_NO_MEMORY);
299 1.1 christos }
300 1.1 christos
301 1.1 christos /* Convert the command line bytes to the buffer */
302 1.1 christos
303 1.1 christos for (i = 0, j = 0; String[i];)
304 1.1 christos {
305 1.1 christos Status = AcpiDbHexByteToBinary (&String[i], &Buffer[j]);
306 1.1 christos if (ACPI_FAILURE (Status))
307 1.1 christos {
308 1.1 christos ACPI_FREE (Buffer);
309 1.1 christos return (Status);
310 1.1 christos }
311 1.1 christos
312 1.1 christos j++;
313 1.1.1.5 christos i += 2;
314 1.1 christos while (String[i] &&
315 1.1 christos ((String[i] == ',') || (String[i] == ' ')))
316 1.1 christos {
317 1.1 christos i++;
318 1.1 christos }
319 1.1 christos }
320 1.1 christos
321 1.1 christos Object->Type = ACPI_TYPE_BUFFER;
322 1.1 christos Object->Buffer.Pointer = Buffer;
323 1.1 christos Object->Buffer.Length = Length;
324 1.1 christos return (AE_OK);
325 1.1 christos }
326 1.1 christos
327 1.1 christos
328 1.1 christos /*******************************************************************************
329 1.1 christos *
330 1.1 christos * FUNCTION: AcpiDbConvertToPackage
331 1.1 christos *
332 1.1 christos * PARAMETERS: String - Input string to be converted
333 1.1 christos * Object - Where the package object is returned
334 1.1 christos *
335 1.1 christos * RETURN: Status
336 1.1 christos *
337 1.1 christos * DESCRIPTION: Convert a string to a package object. Handles nested packages
338 1.1 christos * via recursion with AcpiDbConvertToObject.
339 1.1 christos *
340 1.1 christos ******************************************************************************/
341 1.1 christos
342 1.1 christos ACPI_STATUS
343 1.1 christos AcpiDbConvertToPackage (
344 1.1 christos char *String,
345 1.1 christos ACPI_OBJECT *Object)
346 1.1 christos {
347 1.1 christos char *This;
348 1.1 christos char *Next;
349 1.1 christos UINT32 i;
350 1.1 christos ACPI_OBJECT_TYPE Type;
351 1.1 christos ACPI_OBJECT *Elements;
352 1.1 christos ACPI_STATUS Status;
353 1.1 christos
354 1.1 christos
355 1.1 christos Elements = ACPI_ALLOCATE_ZEROED (
356 1.1 christos DB_DEFAULT_PKG_ELEMENTS * sizeof (ACPI_OBJECT));
357 1.1.1.17 christos if (!Elements)
358 1.1.1.17 christos return (AE_NO_MEMORY);
359 1.1 christos
360 1.1 christos This = String;
361 1.1 christos for (i = 0; i < (DB_DEFAULT_PKG_ELEMENTS - 1); i++)
362 1.1 christos {
363 1.1 christos This = AcpiDbGetNextToken (This, &Next, &Type);
364 1.1 christos if (!This)
365 1.1 christos {
366 1.1 christos break;
367 1.1 christos }
368 1.1 christos
369 1.1 christos /* Recursive call to convert each package element */
370 1.1 christos
371 1.1 christos Status = AcpiDbConvertToObject (Type, This, &Elements[i]);
372 1.1 christos if (ACPI_FAILURE (Status))
373 1.1 christos {
374 1.1 christos AcpiDbDeleteObjects (i + 1, Elements);
375 1.1 christos ACPI_FREE (Elements);
376 1.1 christos return (Status);
377 1.1 christos }
378 1.1 christos
379 1.1 christos This = Next;
380 1.1 christos }
381 1.1 christos
382 1.1 christos Object->Type = ACPI_TYPE_PACKAGE;
383 1.1 christos Object->Package.Count = i;
384 1.1 christos Object->Package.Elements = Elements;
385 1.1 christos return (AE_OK);
386 1.1 christos }
387 1.1 christos
388 1.1 christos
389 1.1 christos /*******************************************************************************
390 1.1 christos *
391 1.1 christos * FUNCTION: AcpiDbConvertToObject
392 1.1 christos *
393 1.1 christos * PARAMETERS: Type - Object type as determined by parser
394 1.1 christos * String - Input string to be converted
395 1.1 christos * Object - Where the new object is returned
396 1.1 christos *
397 1.1 christos * RETURN: Status
398 1.1 christos *
399 1.1 christos * DESCRIPTION: Convert a typed and tokenized string to an ACPI_OBJECT. Typing:
400 1.1 christos * 1) String objects were surrounded by quotes.
401 1.1 christos * 2) Buffer objects were surrounded by parentheses.
402 1.1 christos * 3) Package objects were surrounded by brackets "[]".
403 1.1 christos * 4) All standalone tokens are treated as integers.
404 1.1 christos *
405 1.1 christos ******************************************************************************/
406 1.1 christos
407 1.1 christos ACPI_STATUS
408 1.1 christos AcpiDbConvertToObject (
409 1.1 christos ACPI_OBJECT_TYPE Type,
410 1.1 christos char *String,
411 1.1 christos ACPI_OBJECT *Object)
412 1.1 christos {
413 1.1 christos ACPI_STATUS Status = AE_OK;
414 1.1 christos
415 1.1 christos
416 1.1 christos switch (Type)
417 1.1 christos {
418 1.1 christos case ACPI_TYPE_STRING:
419 1.1 christos
420 1.1 christos Object->Type = ACPI_TYPE_STRING;
421 1.1 christos Object->String.Pointer = String;
422 1.1.1.4 christos Object->String.Length = (UINT32) strlen (String);
423 1.1 christos break;
424 1.1 christos
425 1.1 christos case ACPI_TYPE_BUFFER:
426 1.1 christos
427 1.1 christos Status = AcpiDbConvertToBuffer (String, Object);
428 1.1 christos break;
429 1.1 christos
430 1.1 christos case ACPI_TYPE_PACKAGE:
431 1.1 christos
432 1.1 christos Status = AcpiDbConvertToPackage (String, Object);
433 1.1 christos break;
434 1.1 christos
435 1.1 christos default:
436 1.1 christos
437 1.1 christos Object->Type = ACPI_TYPE_INTEGER;
438 1.1.1.9 christos Status = AcpiUtStrtoul64 (String, &Object->Integer.Value);
439 1.1 christos break;
440 1.1 christos }
441 1.1 christos
442 1.1 christos return (Status);
443 1.1 christos }
444 1.1 christos
445 1.1 christos
446 1.1 christos /*******************************************************************************
447 1.1 christos *
448 1.1 christos * FUNCTION: AcpiDbEncodePldBuffer
449 1.1 christos *
450 1.1 christos * PARAMETERS: PldInfo - _PLD buffer struct (Using local struct)
451 1.1 christos *
452 1.1 christos * RETURN: Encode _PLD buffer suitable for return value from _PLD
453 1.1 christos *
454 1.1 christos * DESCRIPTION: Bit-packs a _PLD buffer struct. Used to test the _PLD macros
455 1.1 christos *
456 1.1 christos ******************************************************************************/
457 1.1 christos
458 1.1 christos UINT8 *
459 1.1 christos AcpiDbEncodePldBuffer (
460 1.1 christos ACPI_PLD_INFO *PldInfo)
461 1.1 christos {
462 1.1 christos UINT32 *Buffer;
463 1.1 christos UINT32 Dword;
464 1.1 christos
465 1.1 christos
466 1.1 christos Buffer = ACPI_ALLOCATE_ZEROED (ACPI_PLD_BUFFER_SIZE);
467 1.1 christos if (!Buffer)
468 1.1 christos {
469 1.1 christos return (NULL);
470 1.1 christos }
471 1.1 christos
472 1.1 christos /* First 32 bits */
473 1.1 christos
474 1.1 christos Dword = 0;
475 1.1 christos ACPI_PLD_SET_REVISION (&Dword, PldInfo->Revision);
476 1.1 christos ACPI_PLD_SET_IGNORE_COLOR (&Dword, PldInfo->IgnoreColor);
477 1.1.1.3 christos ACPI_PLD_SET_RED (&Dword, PldInfo->Red);
478 1.1.1.3 christos ACPI_PLD_SET_GREEN (&Dword, PldInfo->Green);
479 1.1.1.3 christos ACPI_PLD_SET_BLUE (&Dword, PldInfo->Blue);
480 1.1 christos ACPI_MOVE_32_TO_32 (&Buffer[0], &Dword);
481 1.1 christos
482 1.1 christos /* Second 32 bits */
483 1.1 christos
484 1.1 christos Dword = 0;
485 1.1 christos ACPI_PLD_SET_WIDTH (&Dword, PldInfo->Width);
486 1.1 christos ACPI_PLD_SET_HEIGHT (&Dword, PldInfo->Height);
487 1.1 christos ACPI_MOVE_32_TO_32 (&Buffer[1], &Dword);
488 1.1 christos
489 1.1 christos /* Third 32 bits */
490 1.1 christos
491 1.1 christos Dword = 0;
492 1.1 christos ACPI_PLD_SET_USER_VISIBLE (&Dword, PldInfo->UserVisible);
493 1.1 christos ACPI_PLD_SET_DOCK (&Dword, PldInfo->Dock);
494 1.1 christos ACPI_PLD_SET_LID (&Dword, PldInfo->Lid);
495 1.1 christos ACPI_PLD_SET_PANEL (&Dword, PldInfo->Panel);
496 1.1 christos ACPI_PLD_SET_VERTICAL (&Dword, PldInfo->VerticalPosition);
497 1.1 christos ACPI_PLD_SET_HORIZONTAL (&Dword, PldInfo->HorizontalPosition);
498 1.1 christos ACPI_PLD_SET_SHAPE (&Dword, PldInfo->Shape);
499 1.1 christos ACPI_PLD_SET_ORIENTATION (&Dword, PldInfo->GroupOrientation);
500 1.1 christos ACPI_PLD_SET_TOKEN (&Dword, PldInfo->GroupToken);
501 1.1 christos ACPI_PLD_SET_POSITION (&Dword, PldInfo->GroupPosition);
502 1.1 christos ACPI_PLD_SET_BAY (&Dword, PldInfo->Bay);
503 1.1 christos ACPI_MOVE_32_TO_32 (&Buffer[2], &Dword);
504 1.1 christos
505 1.1 christos /* Fourth 32 bits */
506 1.1 christos
507 1.1 christos Dword = 0;
508 1.1 christos ACPI_PLD_SET_EJECTABLE (&Dword, PldInfo->Ejectable);
509 1.1 christos ACPI_PLD_SET_OSPM_EJECT (&Dword, PldInfo->OspmEjectRequired);
510 1.1 christos ACPI_PLD_SET_CABINET (&Dword, PldInfo->CabinetNumber);
511 1.1 christos ACPI_PLD_SET_CARD_CAGE (&Dword, PldInfo->CardCageNumber);
512 1.1 christos ACPI_PLD_SET_REFERENCE (&Dword, PldInfo->Reference);
513 1.1 christos ACPI_PLD_SET_ROTATION (&Dword, PldInfo->Rotation);
514 1.1 christos ACPI_PLD_SET_ORDER (&Dword, PldInfo->Order);
515 1.1 christos ACPI_MOVE_32_TO_32 (&Buffer[3], &Dword);
516 1.1 christos
517 1.1 christos if (PldInfo->Revision >= 2)
518 1.1 christos {
519 1.1 christos /* Fifth 32 bits */
520 1.1 christos
521 1.1 christos Dword = 0;
522 1.1 christos ACPI_PLD_SET_VERT_OFFSET (&Dword, PldInfo->VerticalOffset);
523 1.1 christos ACPI_PLD_SET_HORIZ_OFFSET (&Dword, PldInfo->HorizontalOffset);
524 1.1 christos ACPI_MOVE_32_TO_32 (&Buffer[4], &Dword);
525 1.1 christos }
526 1.1 christos
527 1.1 christos return (ACPI_CAST_PTR (UINT8, Buffer));
528 1.1 christos }
529 1.1 christos
530 1.1 christos
531 1.1 christos /*******************************************************************************
532 1.1 christos *
533 1.1 christos * FUNCTION: AcpiDbDumpPldBuffer
534 1.1 christos *
535 1.1 christos * PARAMETERS: ObjDesc - Object returned from _PLD method
536 1.1 christos *
537 1.1 christos * RETURN: None.
538 1.1 christos *
539 1.1 christos * DESCRIPTION: Dumps formatted contents of a _PLD return buffer.
540 1.1 christos *
541 1.1 christos ******************************************************************************/
542 1.1 christos
543 1.1 christos #define ACPI_PLD_OUTPUT "%20s : %-6X\n"
544 1.1 christos
545 1.1 christos void
546 1.1 christos AcpiDbDumpPldBuffer (
547 1.1 christos ACPI_OBJECT *ObjDesc)
548 1.1 christos {
549 1.1 christos ACPI_OBJECT *BufferDesc;
550 1.1 christos ACPI_PLD_INFO *PldInfo;
551 1.1 christos UINT8 *NewBuffer;
552 1.1 christos ACPI_STATUS Status;
553 1.1 christos
554 1.1 christos
555 1.1 christos /* Object must be of type Package with at least one Buffer element */
556 1.1 christos
557 1.1 christos if (ObjDesc->Type != ACPI_TYPE_PACKAGE)
558 1.1 christos {
559 1.1 christos return;
560 1.1 christos }
561 1.1 christos
562 1.1 christos BufferDesc = &ObjDesc->Package.Elements[0];
563 1.1 christos if (BufferDesc->Type != ACPI_TYPE_BUFFER)
564 1.1 christos {
565 1.1 christos return;
566 1.1 christos }
567 1.1 christos
568 1.1 christos /* Convert _PLD buffer to local _PLD struct */
569 1.1 christos
570 1.1 christos Status = AcpiDecodePldBuffer (BufferDesc->Buffer.Pointer,
571 1.1 christos BufferDesc->Buffer.Length, &PldInfo);
572 1.1 christos if (ACPI_FAILURE (Status))
573 1.1 christos {
574 1.1 christos return;
575 1.1 christos }
576 1.1 christos
577 1.1 christos /* Encode local _PLD struct back to a _PLD buffer */
578 1.1 christos
579 1.1 christos NewBuffer = AcpiDbEncodePldBuffer (PldInfo);
580 1.1 christos if (!NewBuffer)
581 1.1 christos {
582 1.1.1.6 christos goto Exit;
583 1.1 christos }
584 1.1 christos
585 1.1 christos /* The two bit-packed buffers should match */
586 1.1 christos
587 1.1.1.4 christos if (memcmp (NewBuffer, BufferDesc->Buffer.Pointer,
588 1.1 christos BufferDesc->Buffer.Length))
589 1.1 christos {
590 1.1 christos AcpiOsPrintf ("Converted _PLD buffer does not compare. New:\n");
591 1.1 christos
592 1.1 christos AcpiUtDumpBuffer (NewBuffer,
593 1.1 christos BufferDesc->Buffer.Length, DB_BYTE_DISPLAY, 0);
594 1.1 christos }
595 1.1 christos
596 1.1 christos /* First 32-bit dword */
597 1.1 christos
598 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Revision", PldInfo->Revision);
599 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_IgnoreColor", PldInfo->IgnoreColor);
600 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Red", PldInfo->Red);
601 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Green", PldInfo->Green);
602 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Blue", PldInfo->Blue);
603 1.1 christos
604 1.1 christos /* Second 32-bit dword */
605 1.1 christos
606 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Width", PldInfo->Width);
607 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Height", PldInfo->Height);
608 1.1 christos
609 1.1 christos /* Third 32-bit dword */
610 1.1 christos
611 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_UserVisible", PldInfo->UserVisible);
612 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Dock", PldInfo->Dock);
613 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Lid", PldInfo->Lid);
614 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Panel", PldInfo->Panel);
615 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_VerticalPosition", PldInfo->VerticalPosition);
616 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_HorizontalPosition", PldInfo->HorizontalPosition);
617 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Shape", PldInfo->Shape);
618 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_GroupOrientation", PldInfo->GroupOrientation);
619 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_GroupToken", PldInfo->GroupToken);
620 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_GroupPosition", PldInfo->GroupPosition);
621 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Bay", PldInfo->Bay);
622 1.1 christos
623 1.1 christos /* Fourth 32-bit dword */
624 1.1 christos
625 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Ejectable", PldInfo->Ejectable);
626 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_EjectRequired", PldInfo->OspmEjectRequired);
627 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_CabinetNumber", PldInfo->CabinetNumber);
628 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_CardCageNumber", PldInfo->CardCageNumber);
629 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Reference", PldInfo->Reference);
630 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Rotation", PldInfo->Rotation);
631 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_Order", PldInfo->Order);
632 1.1 christos
633 1.1 christos /* Fifth 32-bit dword */
634 1.1 christos
635 1.1 christos if (BufferDesc->Buffer.Length > 16)
636 1.1 christos {
637 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_VerticalOffset", PldInfo->VerticalOffset);
638 1.1.1.3 christos AcpiOsPrintf (ACPI_PLD_OUTPUT, "PLD_HorizontalOffset", PldInfo->HorizontalOffset);
639 1.1 christos }
640 1.1 christos
641 1.1 christos ACPI_FREE (NewBuffer);
642 1.1.1.6 christos Exit:
643 1.1.1.6 christos ACPI_FREE (PldInfo);
644 1.1 christos }
645