123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353 |
- /******************************************************************************
- *
- * Module Name: exdebug - Support for stores to the AML Debug Object
- *
- *****************************************************************************/
- /*
- * Copyright (C) 2000 - 2019, Intel Corp.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- * 1. Redistributions of source code must retain the above copyright
- * notice, this list of conditions, and the following disclaimer,
- * without modification.
- * 2. Redistributions in binary form must reproduce at minimum a disclaimer
- * substantially similar to the "NO WARRANTY" disclaimer below
- * ("Disclaimer") and any redistribution must be conditioned upon
- * including a substantially similar Disclaimer requirement for further
- * binary redistribution.
- * 3. Neither the names of the above-listed copyright holders nor the names
- * of any contributors may be used to endorse or promote products derived
- * from this software without specific prior written permission.
- *
- * Alternatively, this software may be distributed under the terms of the
- * GNU General Public License ("GPL") version 2 as published by the Free
- * Software Foundation.
- *
- * NO WARRANTY
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
- * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
- * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
- * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
- * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
- * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
- * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
- * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
- * POSSIBILITY OF SUCH DAMAGES.
- */
- #include "acpi.h"
- #include "accommon.h"
- #include "acinterp.h"
- #define _COMPONENT ACPI_EXECUTER
- ACPI_MODULE_NAME ("exdebug")
- #ifndef ACPI_NO_ERROR_MESSAGES
- /*******************************************************************************
- *
- * FUNCTION: AcpiExDoDebugObject
- *
- * PARAMETERS: SourceDesc - Object to be output to "Debug Object"
- * Level - Indentation level (used for packages)
- * Index - Current package element, zero if not pkg
- *
- * RETURN: None
- *
- * DESCRIPTION: Handles stores to the AML Debug Object. For example:
- * Store(INT1, Debug)
- *
- * This function is not compiled if ACPI_NO_ERROR_MESSAGES is set.
- *
- * This function is only enabled if AcpiGbl_EnableAmlDebugObject is set, or
- * if ACPI_LV_DEBUG_OBJECT is set in the AcpiDbgLevel. Thus, in the normal
- * operational case, stores to the debug object are ignored but can be easily
- * enabled if necessary.
- *
- ******************************************************************************/
- void
- AcpiExDoDebugObject (
- ACPI_OPERAND_OBJECT *SourceDesc,
- UINT32 Level,
- UINT32 Index)
- {
- UINT32 i;
- UINT32 Timer;
- ACPI_OPERAND_OBJECT *ObjectDesc;
- UINT32 Value;
- ACPI_FUNCTION_TRACE_PTR (ExDoDebugObject, SourceDesc);
- /* Output must be enabled via the DebugObject global or the DbgLevel */
- if (!AcpiGbl_EnableAmlDebugObject &&
- !(AcpiDbgLevel & ACPI_LV_DEBUG_OBJECT))
- {
- return_VOID;
- }
- /* Newline -- don't emit the line header */
- if (SourceDesc &&
- (ACPI_GET_DESCRIPTOR_TYPE (SourceDesc) == ACPI_DESC_TYPE_OPERAND) &&
- (SourceDesc->Common.Type == ACPI_TYPE_STRING))
- {
- if ((SourceDesc->String.Length == 1) &&
- (*SourceDesc->String.Pointer == '\n'))
- {
- AcpiOsPrintf ("\n");
- return_VOID;
- }
- }
- /*
- * Print line header as long as we are not in the middle of an
- * object display
- */
- if (!((Level > 0) && Index == 0))
- {
- if (AcpiGbl_DisplayDebugTimer)
- {
- /*
- * We will emit the current timer value (in microseconds) with each
- * debug output. Only need the lower 26 bits. This allows for 67
- * million microseconds or 67 seconds before rollover.
- *
- * Convert 100 nanosecond units to microseconds
- */
- Timer = ((UINT32) AcpiOsGetTimer () / 10);
- Timer &= 0x03FFFFFF;
- AcpiOsPrintf ("ACPI Debug: T=0x%8.8X %*s", Timer, Level, " ");
- }
- else
- {
- AcpiOsPrintf ("ACPI Debug: %*s", Level, " ");
- }
- }
- /* Display the index for package output only */
- if (Index > 0)
- {
- AcpiOsPrintf ("(%.2u) ", Index - 1);
- }
- if (!SourceDesc)
- {
- AcpiOsPrintf ("[Null Object]\n");
- return_VOID;
- }
- if (ACPI_GET_DESCRIPTOR_TYPE (SourceDesc) == ACPI_DESC_TYPE_OPERAND)
- {
- /* No object type prefix needed for integers and strings */
- if ((SourceDesc->Common.Type != ACPI_TYPE_INTEGER) &&
- (SourceDesc->Common.Type != ACPI_TYPE_STRING))
- {
- AcpiOsPrintf ("%s ", AcpiUtGetObjectTypeName (SourceDesc));
- }
- if (!AcpiUtValidInternalObject (SourceDesc))
- {
- AcpiOsPrintf ("%p, Invalid Internal Object!\n", SourceDesc);
- return_VOID;
- }
- }
- else if (ACPI_GET_DESCRIPTOR_TYPE (SourceDesc) == ACPI_DESC_TYPE_NAMED)
- {
- AcpiOsPrintf ("%s (Node %p)\n",
- AcpiUtGetTypeName (((ACPI_NAMESPACE_NODE *) SourceDesc)->Type),
- SourceDesc);
- return_VOID;
- }
- else
- {
- return_VOID;
- }
- /* SourceDesc is of type ACPI_DESC_TYPE_OPERAND */
- switch (SourceDesc->Common.Type)
- {
- case ACPI_TYPE_INTEGER:
- /* Output correct integer width */
- if (AcpiGbl_IntegerByteWidth == 4)
- {
- AcpiOsPrintf ("0x%8.8X\n",
- (UINT32) SourceDesc->Integer.Value);
- }
- else
- {
- AcpiOsPrintf ("0x%8.8X%8.8X\n",
- ACPI_FORMAT_UINT64 (SourceDesc->Integer.Value));
- }
- break;
- case ACPI_TYPE_BUFFER:
- AcpiOsPrintf ("[0x%.2X]\n", (UINT32) SourceDesc->Buffer.Length);
- AcpiUtDumpBuffer (SourceDesc->Buffer.Pointer,
- (SourceDesc->Buffer.Length < 256) ?
- SourceDesc->Buffer.Length : 256, DB_BYTE_DISPLAY, 0);
- break;
- case ACPI_TYPE_STRING:
- AcpiOsPrintf ("\"%s\"\n", SourceDesc->String.Pointer);
- break;
- case ACPI_TYPE_PACKAGE:
- AcpiOsPrintf ("(Contains 0x%.2X Elements):\n",
- SourceDesc->Package.Count);
- /* Output the entire contents of the package */
- for (i = 0; i < SourceDesc->Package.Count; i++)
- {
- AcpiExDoDebugObject (SourceDesc->Package.Elements[i],
- Level + 4, i + 1);
- }
- break;
- case ACPI_TYPE_LOCAL_REFERENCE:
- AcpiOsPrintf ("[%s] ", AcpiUtGetReferenceName (SourceDesc));
- /* Decode the reference */
- switch (SourceDesc->Reference.Class)
- {
- case ACPI_REFCLASS_INDEX:
- AcpiOsPrintf ("0x%X\n", SourceDesc->Reference.Value);
- break;
- case ACPI_REFCLASS_TABLE:
- /* Case for DdbHandle */
- AcpiOsPrintf ("Table Index 0x%X\n", SourceDesc->Reference.Value);
- return_VOID;
- default:
- break;
- }
- AcpiOsPrintf (" ");
- /* Check for valid node first, then valid object */
- if (SourceDesc->Reference.Node)
- {
- if (ACPI_GET_DESCRIPTOR_TYPE (SourceDesc->Reference.Node) !=
- ACPI_DESC_TYPE_NAMED)
- {
- AcpiOsPrintf (" %p - Not a valid namespace node\n",
- SourceDesc->Reference.Node);
- }
- else
- {
- AcpiOsPrintf ("Node %p [%4.4s] ", SourceDesc->Reference.Node,
- (SourceDesc->Reference.Node)->Name.Ascii);
- switch ((SourceDesc->Reference.Node)->Type)
- {
- /* These types have no attached object */
- case ACPI_TYPE_DEVICE:
- AcpiOsPrintf ("Device\n");
- break;
- case ACPI_TYPE_THERMAL:
- AcpiOsPrintf ("Thermal Zone\n");
- break;
- default:
- AcpiExDoDebugObject ((SourceDesc->Reference.Node)->Object,
- Level + 4, 0);
- break;
- }
- }
- }
- else if (SourceDesc->Reference.Object)
- {
- if (ACPI_GET_DESCRIPTOR_TYPE (SourceDesc->Reference.Object) ==
- ACPI_DESC_TYPE_NAMED)
- {
- /* Reference object is a namespace node */
- AcpiExDoDebugObject (ACPI_CAST_PTR (ACPI_OPERAND_OBJECT,
- SourceDesc->Reference.Object),
- Level + 4, 0);
- }
- else
- {
- ObjectDesc = SourceDesc->Reference.Object;
- Value = SourceDesc->Reference.Value;
- switch (ObjectDesc->Common.Type)
- {
- case ACPI_TYPE_BUFFER:
- AcpiOsPrintf ("Buffer[%u] = 0x%2.2X\n",
- Value, *SourceDesc->Reference.IndexPointer);
- break;
- case ACPI_TYPE_STRING:
- AcpiOsPrintf ("String[%u] = \"%c\" (0x%2.2X)\n",
- Value, *SourceDesc->Reference.IndexPointer,
- *SourceDesc->Reference.IndexPointer);
- break;
- case ACPI_TYPE_PACKAGE:
- AcpiOsPrintf ("Package[%u] = ", Value);
- if (!(*SourceDesc->Reference.Where))
- {
- AcpiOsPrintf ("[Uninitialized Package Element]\n");
- }
- else
- {
- AcpiExDoDebugObject (*SourceDesc->Reference.Where,
- Level+4, 0);
- }
- break;
- default:
- AcpiOsPrintf ("Unknown Reference object type %X\n",
- ObjectDesc->Common.Type);
- break;
- }
- }
- }
- break;
- default:
- AcpiOsPrintf ("(Descriptor %p)\n", SourceDesc);
- break;
- }
- ACPI_DEBUG_PRINT_RAW ((ACPI_DB_EXEC, "\n"));
- return_VOID;
- }
- #endif
|