17c478bd9Sstevel@tonic-gate /*******************************************************************************
27c478bd9Sstevel@tonic-gate *
37c478bd9Sstevel@tonic-gate * Module Name: utmisc - common utility procedures
47c478bd9Sstevel@tonic-gate *
57c478bd9Sstevel@tonic-gate ******************************************************************************/
67c478bd9Sstevel@tonic-gate
7*35786f68SRobert Mustacchi /******************************************************************************
8*35786f68SRobert Mustacchi *
9*35786f68SRobert Mustacchi * 1. Copyright Notice
10*35786f68SRobert Mustacchi *
11*35786f68SRobert Mustacchi * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
127c478bd9Sstevel@tonic-gate * All rights reserved.
137c478bd9Sstevel@tonic-gate *
14*35786f68SRobert Mustacchi * 2. License
15*35786f68SRobert Mustacchi *
16*35786f68SRobert Mustacchi * 2.1. This is your license from Intel Corp. under its intellectual property
17*35786f68SRobert Mustacchi * rights. You may have additional license terms from the party that provided
18*35786f68SRobert Mustacchi * you this software, covering your right to use that party's intellectual
19*35786f68SRobert Mustacchi * property rights.
20*35786f68SRobert Mustacchi *
21*35786f68SRobert Mustacchi * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22*35786f68SRobert Mustacchi * copy of the source code appearing in this file ("Covered Code") an
23*35786f68SRobert Mustacchi * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24*35786f68SRobert Mustacchi * base code distributed originally by Intel ("Original Intel Code") to copy,
25*35786f68SRobert Mustacchi * make derivatives, distribute, use and display any portion of the Covered
26*35786f68SRobert Mustacchi * Code in any form, with the right to sublicense such rights; and
27*35786f68SRobert Mustacchi *
28*35786f68SRobert Mustacchi * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29*35786f68SRobert Mustacchi * license (with the right to sublicense), under only those claims of Intel
30*35786f68SRobert Mustacchi * patents that are infringed by the Original Intel Code, to make, use, sell,
31*35786f68SRobert Mustacchi * offer to sell, and import the Covered Code and derivative works thereof
32*35786f68SRobert Mustacchi * solely to the minimum extent necessary to exercise the above copyright
33*35786f68SRobert Mustacchi * license, and in no event shall the patent license extend to any additions
34*35786f68SRobert Mustacchi * to or modifications of the Original Intel Code. No other license or right
35*35786f68SRobert Mustacchi * is granted directly or by implication, estoppel or otherwise;
36*35786f68SRobert Mustacchi *
37*35786f68SRobert Mustacchi * The above copyright and patent license is granted only if the following
38*35786f68SRobert Mustacchi * conditions are met:
39*35786f68SRobert Mustacchi *
40*35786f68SRobert Mustacchi * 3. Conditions
41*35786f68SRobert Mustacchi *
42*35786f68SRobert Mustacchi * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
44*35786f68SRobert Mustacchi * Code or modification with rights to further distribute source must include
45*35786f68SRobert Mustacchi * the above Copyright Notice, the above License, this list of Conditions,
46*35786f68SRobert Mustacchi * and the following Disclaimer and Export Compliance provision. In addition,
47*35786f68SRobert Mustacchi * Licensee must cause all Covered Code to which Licensee contributes to
48*35786f68SRobert Mustacchi * contain a file documenting the changes Licensee made to create that Covered
49*35786f68SRobert Mustacchi * Code and the date of any change. Licensee must include in that file the
50*35786f68SRobert Mustacchi * documentation of any changes made by any predecessor Licensee. Licensee
51*35786f68SRobert Mustacchi * must include a prominent statement that the modification is derived,
52*35786f68SRobert Mustacchi * directly or indirectly, from Original Intel Code.
53*35786f68SRobert Mustacchi *
54*35786f68SRobert Mustacchi * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
56*35786f68SRobert Mustacchi * Code or modification without rights to further distribute source must
57*35786f68SRobert Mustacchi * include the following Disclaimer and Export Compliance provision in the
58*35786f68SRobert Mustacchi * documentation and/or other materials provided with distribution. In
59*35786f68SRobert Mustacchi * addition, Licensee may not authorize further sublicense of source of any
60*35786f68SRobert Mustacchi * portion of the Covered Code, and must include terms to the effect that the
61*35786f68SRobert Mustacchi * license from Licensee to its licensee is limited to the intellectual
62*35786f68SRobert Mustacchi * property embodied in the software Licensee provides to its licensee, and
63*35786f68SRobert Mustacchi * not to intellectual property embodied in modifications its licensee may
64*35786f68SRobert Mustacchi * make.
65*35786f68SRobert Mustacchi *
66*35786f68SRobert Mustacchi * 3.3. Redistribution of Executable. Redistribution in executable form of any
67*35786f68SRobert Mustacchi * substantial portion of the Covered Code or modification must reproduce the
68*35786f68SRobert Mustacchi * above Copyright Notice, and the following Disclaimer and Export Compliance
69*35786f68SRobert Mustacchi * provision in the documentation and/or other materials provided with the
70*35786f68SRobert Mustacchi * distribution.
71*35786f68SRobert Mustacchi *
72*35786f68SRobert Mustacchi * 3.4. Intel retains all right, title, and interest in and to the Original
73*35786f68SRobert Mustacchi * Intel Code.
74*35786f68SRobert Mustacchi *
75*35786f68SRobert Mustacchi * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76*35786f68SRobert Mustacchi * Intel shall be used in advertising or otherwise to promote the sale, use or
77*35786f68SRobert Mustacchi * other dealings in products derived from or relating to the Covered Code
78*35786f68SRobert Mustacchi * without prior written authorization from Intel.
79*35786f68SRobert Mustacchi *
80*35786f68SRobert Mustacchi * 4. Disclaimer and Export Compliance
81*35786f68SRobert Mustacchi *
82*35786f68SRobert Mustacchi * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83*35786f68SRobert Mustacchi * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84*35786f68SRobert Mustacchi * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85*35786f68SRobert Mustacchi * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86*35786f68SRobert Mustacchi * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87*35786f68SRobert Mustacchi * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88*35786f68SRobert Mustacchi * PARTICULAR PURPOSE.
89*35786f68SRobert Mustacchi *
90*35786f68SRobert Mustacchi * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91*35786f68SRobert Mustacchi * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92*35786f68SRobert Mustacchi * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93*35786f68SRobert Mustacchi * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94*35786f68SRobert Mustacchi * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95*35786f68SRobert Mustacchi * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96*35786f68SRobert Mustacchi * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97*35786f68SRobert Mustacchi * LIMITED REMEDY.
98*35786f68SRobert Mustacchi *
99*35786f68SRobert Mustacchi * 4.3. Licensee shall not export, either directly or indirectly, any of this
100*35786f68SRobert Mustacchi * software or system incorporating such software without first obtaining any
101*35786f68SRobert Mustacchi * required license or other approval from the U. S. Department of Commerce or
102*35786f68SRobert Mustacchi * any other agency or department of the United States Government. In the
103*35786f68SRobert Mustacchi * event Licensee exports any such software from the United States or
104*35786f68SRobert Mustacchi * re-exports any such software from a foreign destination, Licensee shall
105*35786f68SRobert Mustacchi * ensure that the distribution and export/re-export of the software is in
106*35786f68SRobert Mustacchi * compliance with all laws, regulations, orders, or other restrictions of the
107*35786f68SRobert Mustacchi * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108*35786f68SRobert Mustacchi * any of its subsidiaries will export/re-export any technical data, process,
109*35786f68SRobert Mustacchi * software, or service, directly or indirectly, to any country for which the
110*35786f68SRobert Mustacchi * United States government or any agency thereof requires an export license,
111*35786f68SRobert Mustacchi * other governmental approval, or letter of assurance, without first obtaining
112*35786f68SRobert Mustacchi * such license, approval or letter.
113*35786f68SRobert Mustacchi *
114*35786f68SRobert Mustacchi *****************************************************************************
115*35786f68SRobert Mustacchi *
116*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
117*35786f68SRobert Mustacchi * following license:
118*35786f68SRobert Mustacchi *
11926f3cdf0SGordon Ross * Redistribution and use in source and binary forms, with or without
12026f3cdf0SGordon Ross * modification, are permitted provided that the following conditions
12126f3cdf0SGordon Ross * are met:
12226f3cdf0SGordon Ross * 1. Redistributions of source code must retain the above copyright
12326f3cdf0SGordon Ross * notice, this list of conditions, and the following disclaimer,
12426f3cdf0SGordon Ross * without modification.
12526f3cdf0SGordon Ross * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12626f3cdf0SGordon Ross * substantially similar to the "NO WARRANTY" disclaimer below
12726f3cdf0SGordon Ross * ("Disclaimer") and any redistribution must be conditioned upon
12826f3cdf0SGordon Ross * including a substantially similar Disclaimer requirement for further
12926f3cdf0SGordon Ross * binary redistribution.
13026f3cdf0SGordon Ross * 3. Neither the names of the above-listed copyright holders nor the names
13126f3cdf0SGordon Ross * of any contributors may be used to endorse or promote products derived
13226f3cdf0SGordon Ross * from this software without specific prior written permission.
13326f3cdf0SGordon Ross *
13426f3cdf0SGordon Ross * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
13526f3cdf0SGordon Ross * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136*35786f68SRobert Mustacchi * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
13726f3cdf0SGordon Ross * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138*35786f68SRobert Mustacchi * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139*35786f68SRobert Mustacchi * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140*35786f68SRobert Mustacchi * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141*35786f68SRobert Mustacchi * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142*35786f68SRobert Mustacchi * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143*35786f68SRobert Mustacchi * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144*35786f68SRobert Mustacchi * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145*35786f68SRobert Mustacchi *
146*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
147*35786f68SRobert Mustacchi * GNU General Public License ("GPL") version 2 as published by the Free
148*35786f68SRobert Mustacchi * Software Foundation.
149*35786f68SRobert Mustacchi *
150*35786f68SRobert Mustacchi *****************************************************************************/
1517c478bd9Sstevel@tonic-gate
1527c478bd9Sstevel@tonic-gate #include "acpi.h"
153aa2aa9a6SDana Myers #include "accommon.h"
1547c478bd9Sstevel@tonic-gate #include "acnamesp.h"
1557c478bd9Sstevel@tonic-gate
1567c478bd9Sstevel@tonic-gate
1577c478bd9Sstevel@tonic-gate #define _COMPONENT ACPI_UTILITIES
1587b1019a6SJerry Jelinek ACPI_MODULE_NAME ("utmisc")
1597c478bd9Sstevel@tonic-gate
1607c478bd9Sstevel@tonic-gate
16127f7c583Smyers /*******************************************************************************
16227f7c583Smyers *
1637b1019a6SJerry Jelinek * FUNCTION: AcpiUtIsPciRootBridge
16427f7c583Smyers *
1657b1019a6SJerry Jelinek * PARAMETERS: Id - The HID/CID in string format
16627f7c583Smyers *
1677b1019a6SJerry Jelinek * RETURN: TRUE if the Id is a match for a PCI/PCI-Express Root Bridge
16827f7c583Smyers *
1697b1019a6SJerry Jelinek * DESCRIPTION: Determine if the input ID is a PCI Root Bridge ID.
17027f7c583Smyers *
17127f7c583Smyers ******************************************************************************/
17227f7c583Smyers
17327f7c583Smyers BOOLEAN
AcpiUtIsPciRootBridge(char * Id)1747b1019a6SJerry Jelinek AcpiUtIsPciRootBridge (
1757b1019a6SJerry Jelinek char *Id)
17627f7c583Smyers {
17727f7c583Smyers
1787b1019a6SJerry Jelinek /*
1797b1019a6SJerry Jelinek * Check if this is a PCI root bridge.
1807b1019a6SJerry Jelinek * ACPI 3.0+: check for a PCI Express root also.
1817b1019a6SJerry Jelinek */
1827b1019a6SJerry Jelinek if (!(strcmp (Id,
1837b1019a6SJerry Jelinek PCI_ROOT_HID_STRING)) ||
18427f7c583Smyers
1857b1019a6SJerry Jelinek !(strcmp (Id,
1867b1019a6SJerry Jelinek PCI_EXPRESS_ROOT_HID_STRING)))
1877b1019a6SJerry Jelinek {
1887b1019a6SJerry Jelinek return (TRUE);
18927f7c583Smyers }
19027f7c583Smyers
1917b1019a6SJerry Jelinek return (FALSE);
19227f7c583Smyers }
19327f7c583Smyers
19427f7c583Smyers
1957b1019a6SJerry Jelinek #if (defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP || defined ACPI_NAMES_APP)
1967c478bd9Sstevel@tonic-gate /*******************************************************************************
1977c478bd9Sstevel@tonic-gate *
1987b1019a6SJerry Jelinek * FUNCTION: AcpiUtIsAmlTable
1997c478bd9Sstevel@tonic-gate *
2007b1019a6SJerry Jelinek * PARAMETERS: Table - An ACPI table
2017c478bd9Sstevel@tonic-gate *
2027b1019a6SJerry Jelinek * RETURN: TRUE if table contains executable AML; FALSE otherwise
2037c478bd9Sstevel@tonic-gate *
2047b1019a6SJerry Jelinek * DESCRIPTION: Check ACPI Signature for a table that contains AML code.
2057b1019a6SJerry Jelinek * Currently, these are DSDT,SSDT,PSDT. All other table types are
2067b1019a6SJerry Jelinek * data tables that do not contain AML code.
2077c478bd9Sstevel@tonic-gate *
2087c478bd9Sstevel@tonic-gate ******************************************************************************/
2097c478bd9Sstevel@tonic-gate
2107c478bd9Sstevel@tonic-gate BOOLEAN
AcpiUtIsAmlTable(ACPI_TABLE_HEADER * Table)2117b1019a6SJerry Jelinek AcpiUtIsAmlTable (
2127b1019a6SJerry Jelinek ACPI_TABLE_HEADER *Table)
2137c478bd9Sstevel@tonic-gate {
2147c478bd9Sstevel@tonic-gate
2157b1019a6SJerry Jelinek /* These are the only tables that contain executable AML */
2167c478bd9Sstevel@tonic-gate
2177b1019a6SJerry Jelinek if (ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_DSDT) ||
2187b1019a6SJerry Jelinek ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_PSDT) ||
2197b1019a6SJerry Jelinek ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_SSDT) ||
2207b1019a6SJerry Jelinek ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_OSDT))
2217c478bd9Sstevel@tonic-gate {
2227b1019a6SJerry Jelinek return (TRUE);
2237c478bd9Sstevel@tonic-gate }
2247c478bd9Sstevel@tonic-gate
2257b1019a6SJerry Jelinek return (FALSE);
2267c478bd9Sstevel@tonic-gate }
2277b1019a6SJerry Jelinek #endif
2287c478bd9Sstevel@tonic-gate
2297c478bd9Sstevel@tonic-gate
2307c478bd9Sstevel@tonic-gate /*******************************************************************************
2317c478bd9Sstevel@tonic-gate *
2327b1019a6SJerry Jelinek * FUNCTION: AcpiUtDwordByteSwap
2337c478bd9Sstevel@tonic-gate *
2347b1019a6SJerry Jelinek * PARAMETERS: Value - Value to be converted
235db2bae30SDana Myers *
2367b1019a6SJerry Jelinek * RETURN: UINT32 integer with bytes swapped
237db2bae30SDana Myers *
2387b1019a6SJerry Jelinek * DESCRIPTION: Convert a 32-bit value to big-endian (swap the bytes)
2397c478bd9Sstevel@tonic-gate *
2407c478bd9Sstevel@tonic-gate ******************************************************************************/
2417c478bd9Sstevel@tonic-gate
2427b1019a6SJerry Jelinek UINT32
AcpiUtDwordByteSwap(UINT32 Value)2437b1019a6SJerry Jelinek AcpiUtDwordByteSwap (
2447b1019a6SJerry Jelinek UINT32 Value)
2457c478bd9Sstevel@tonic-gate {
2467b1019a6SJerry Jelinek union
2477b1019a6SJerry Jelinek {
2487b1019a6SJerry Jelinek UINT32 Value;
2497b1019a6SJerry Jelinek UINT8 Bytes[4];
2507b1019a6SJerry Jelinek } Out;
2517b1019a6SJerry Jelinek union
2527b1019a6SJerry Jelinek {
2537b1019a6SJerry Jelinek UINT32 Value;
2547b1019a6SJerry Jelinek UINT8 Bytes[4];
2557b1019a6SJerry Jelinek } In;
256db2bae30SDana Myers
257db2bae30SDana Myers
2587b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
259db2bae30SDana Myers
26027f7c583Smyers
2617b1019a6SJerry Jelinek In.Value = Value;
262db2bae30SDana Myers
2637b1019a6SJerry Jelinek Out.Bytes[0] = In.Bytes[3];
2647b1019a6SJerry Jelinek Out.Bytes[1] = In.Bytes[2];
2657b1019a6SJerry Jelinek Out.Bytes[2] = In.Bytes[1];
2667b1019a6SJerry Jelinek Out.Bytes[3] = In.Bytes[0];
267db2bae30SDana Myers
2687b1019a6SJerry Jelinek return (Out.Value);
2697c478bd9Sstevel@tonic-gate }
2707c478bd9Sstevel@tonic-gate
2717c478bd9Sstevel@tonic-gate
2727c478bd9Sstevel@tonic-gate /*******************************************************************************
2737c478bd9Sstevel@tonic-gate *
2747b1019a6SJerry Jelinek * FUNCTION: AcpiUtSetIntegerWidth
2757c478bd9Sstevel@tonic-gate *
2767b1019a6SJerry Jelinek * PARAMETERS: Revision From DSDT header
2777c478bd9Sstevel@tonic-gate *
2787b1019a6SJerry Jelinek * RETURN: None
2797c478bd9Sstevel@tonic-gate *
2807b1019a6SJerry Jelinek * DESCRIPTION: Set the global integer bit width based upon the revision
2817b1019a6SJerry Jelinek * of the DSDT. For Revision 1 and 0, Integers are 32 bits.
2827b1019a6SJerry Jelinek * For Revision 2 and above, Integers are 64 bits. Yes, this
2837b1019a6SJerry Jelinek * makes a difference.
2847c478bd9Sstevel@tonic-gate *
2857c478bd9Sstevel@tonic-gate ******************************************************************************/
2867c478bd9Sstevel@tonic-gate
2877b1019a6SJerry Jelinek void
AcpiUtSetIntegerWidth(UINT8 Revision)2887b1019a6SJerry Jelinek AcpiUtSetIntegerWidth (
2897b1019a6SJerry Jelinek UINT8 Revision)
2907c478bd9Sstevel@tonic-gate {
29127f7c583Smyers
2927b1019a6SJerry Jelinek if (Revision < 2)
2937c478bd9Sstevel@tonic-gate {
2947b1019a6SJerry Jelinek /* 32-bit case */
2957c478bd9Sstevel@tonic-gate
2967b1019a6SJerry Jelinek AcpiGbl_IntegerBitWidth = 32;
2977b1019a6SJerry Jelinek AcpiGbl_IntegerNybbleWidth = 8;
2987b1019a6SJerry Jelinek AcpiGbl_IntegerByteWidth = 4;
2997c478bd9Sstevel@tonic-gate }
3007c478bd9Sstevel@tonic-gate else
3017c478bd9Sstevel@tonic-gate {
3027b1019a6SJerry Jelinek /* 64-bit case (ACPI 2.0+) */
3037b1019a6SJerry Jelinek
3047b1019a6SJerry Jelinek AcpiGbl_IntegerBitWidth = 64;
3057b1019a6SJerry Jelinek AcpiGbl_IntegerNybbleWidth = 16;
3067b1019a6SJerry Jelinek AcpiGbl_IntegerByteWidth = 8;
3077c478bd9Sstevel@tonic-gate }
3087c478bd9Sstevel@tonic-gate }
3097c478bd9Sstevel@tonic-gate
3107c478bd9Sstevel@tonic-gate
3117c478bd9Sstevel@tonic-gate /*******************************************************************************
3127c478bd9Sstevel@tonic-gate *
3137c478bd9Sstevel@tonic-gate * FUNCTION: AcpiUtCreateUpdateStateAndPush
3147c478bd9Sstevel@tonic-gate *
3157c478bd9Sstevel@tonic-gate * PARAMETERS: Object - Object to be added to the new state
3167c478bd9Sstevel@tonic-gate * Action - Increment/Decrement
3177c478bd9Sstevel@tonic-gate * StateList - List the state will be added to
3187c478bd9Sstevel@tonic-gate *
3197c478bd9Sstevel@tonic-gate * RETURN: Status
3207c478bd9Sstevel@tonic-gate *
3217c478bd9Sstevel@tonic-gate * DESCRIPTION: Create a new state and push it
3227c478bd9Sstevel@tonic-gate *
3237c478bd9Sstevel@tonic-gate ******************************************************************************/
3247c478bd9Sstevel@tonic-gate
3257c478bd9Sstevel@tonic-gate ACPI_STATUS
AcpiUtCreateUpdateStateAndPush(ACPI_OPERAND_OBJECT * Object,UINT16 Action,ACPI_GENERIC_STATE ** StateList)3267c478bd9Sstevel@tonic-gate AcpiUtCreateUpdateStateAndPush (
3277c478bd9Sstevel@tonic-gate ACPI_OPERAND_OBJECT *Object,
3287c478bd9Sstevel@tonic-gate UINT16 Action,
3297c478bd9Sstevel@tonic-gate ACPI_GENERIC_STATE **StateList)
3307c478bd9Sstevel@tonic-gate {
3317c478bd9Sstevel@tonic-gate ACPI_GENERIC_STATE *State;
3327c478bd9Sstevel@tonic-gate
3337c478bd9Sstevel@tonic-gate
3347c478bd9Sstevel@tonic-gate ACPI_FUNCTION_ENTRY ();
3357c478bd9Sstevel@tonic-gate
3367c478bd9Sstevel@tonic-gate
3377c478bd9Sstevel@tonic-gate /* Ignore null objects; these are expected */
3387c478bd9Sstevel@tonic-gate
3397c478bd9Sstevel@tonic-gate if (!Object)
3407c478bd9Sstevel@tonic-gate {
3417c478bd9Sstevel@tonic-gate return (AE_OK);
3427c478bd9Sstevel@tonic-gate }
3437c478bd9Sstevel@tonic-gate
3447c478bd9Sstevel@tonic-gate State = AcpiUtCreateUpdateState (Object, Action);
3457c478bd9Sstevel@tonic-gate if (!State)
3467c478bd9Sstevel@tonic-gate {
3477c478bd9Sstevel@tonic-gate return (AE_NO_MEMORY);
3487c478bd9Sstevel@tonic-gate }
3497c478bd9Sstevel@tonic-gate
3507c478bd9Sstevel@tonic-gate AcpiUtPushGenericState (StateList, State);
3517c478bd9Sstevel@tonic-gate return (AE_OK);
3527c478bd9Sstevel@tonic-gate }
3537c478bd9Sstevel@tonic-gate
3547c478bd9Sstevel@tonic-gate
3557c478bd9Sstevel@tonic-gate /*******************************************************************************
3567c478bd9Sstevel@tonic-gate *
3577c478bd9Sstevel@tonic-gate * FUNCTION: AcpiUtWalkPackageTree
3587c478bd9Sstevel@tonic-gate *
3597c478bd9Sstevel@tonic-gate * PARAMETERS: SourceObject - The package to walk
3607c478bd9Sstevel@tonic-gate * TargetObject - Target object (if package is being copied)
3617c478bd9Sstevel@tonic-gate * WalkCallback - Called once for each package element
3627c478bd9Sstevel@tonic-gate * Context - Passed to the callback function
3637c478bd9Sstevel@tonic-gate *
3647c478bd9Sstevel@tonic-gate * RETURN: Status
3657c478bd9Sstevel@tonic-gate *
366*35786f68SRobert Mustacchi * DESCRIPTION: Walk through a package, including subpackages
3677c478bd9Sstevel@tonic-gate *
3687c478bd9Sstevel@tonic-gate ******************************************************************************/
3697c478bd9Sstevel@tonic-gate
3707c478bd9Sstevel@tonic-gate ACPI_STATUS
AcpiUtWalkPackageTree(ACPI_OPERAND_OBJECT * SourceObject,void * TargetObject,ACPI_PKG_CALLBACK WalkCallback,void * Context)3717c478bd9Sstevel@tonic-gate AcpiUtWalkPackageTree (
3727c478bd9Sstevel@tonic-gate ACPI_OPERAND_OBJECT *SourceObject,
3737c478bd9Sstevel@tonic-gate void *TargetObject,
3747c478bd9Sstevel@tonic-gate ACPI_PKG_CALLBACK WalkCallback,
3757c478bd9Sstevel@tonic-gate void *Context)
3767c478bd9Sstevel@tonic-gate {
3777c478bd9Sstevel@tonic-gate ACPI_STATUS Status = AE_OK;
3787c478bd9Sstevel@tonic-gate ACPI_GENERIC_STATE *StateList = NULL;
3797c478bd9Sstevel@tonic-gate ACPI_GENERIC_STATE *State;
3807c478bd9Sstevel@tonic-gate ACPI_OPERAND_OBJECT *ThisSourceObj;
381*35786f68SRobert Mustacchi UINT32 ThisIndex;
3827c478bd9Sstevel@tonic-gate
3837c478bd9Sstevel@tonic-gate
38427f7c583Smyers ACPI_FUNCTION_TRACE (UtWalkPackageTree);
3857c478bd9Sstevel@tonic-gate
3867c478bd9Sstevel@tonic-gate
3877c478bd9Sstevel@tonic-gate State = AcpiUtCreatePkgState (SourceObject, TargetObject, 0);
3887c478bd9Sstevel@tonic-gate if (!State)
3897c478bd9Sstevel@tonic-gate {
3907c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_NO_MEMORY);
3917c478bd9Sstevel@tonic-gate }
3927c478bd9Sstevel@tonic-gate
3937c478bd9Sstevel@tonic-gate while (State)
3947c478bd9Sstevel@tonic-gate {
3957c478bd9Sstevel@tonic-gate /* Get one element of the package */
3967c478bd9Sstevel@tonic-gate
3977b1019a6SJerry Jelinek ThisIndex = State->Pkg.Index;
398*35786f68SRobert Mustacchi ThisSourceObj =
3997b1019a6SJerry Jelinek State->Pkg.SourceObject->Package.Elements[ThisIndex];
400*35786f68SRobert Mustacchi State->Pkg.ThisTargetObj =
401*35786f68SRobert Mustacchi &State->Pkg.SourceObject->Package.Elements[ThisIndex];
4027c478bd9Sstevel@tonic-gate
4037c478bd9Sstevel@tonic-gate /*
4047c478bd9Sstevel@tonic-gate * Check for:
4057b1019a6SJerry Jelinek * 1) An uninitialized package element. It is completely
4067c478bd9Sstevel@tonic-gate * legal to declare a package and leave it uninitialized
4077c478bd9Sstevel@tonic-gate * 2) Not an internal object - can be a namespace node instead
4087b1019a6SJerry Jelinek * 3) Any type other than a package. Packages are handled in else
4097c478bd9Sstevel@tonic-gate * case below.
4107c478bd9Sstevel@tonic-gate */
4117c478bd9Sstevel@tonic-gate if ((!ThisSourceObj) ||
4127b1019a6SJerry Jelinek (ACPI_GET_DESCRIPTOR_TYPE (ThisSourceObj) !=
4137b1019a6SJerry Jelinek ACPI_DESC_TYPE_OPERAND) ||
414aa2aa9a6SDana Myers (ThisSourceObj->Common.Type != ACPI_TYPE_PACKAGE))
4157c478bd9Sstevel@tonic-gate {
4167c478bd9Sstevel@tonic-gate Status = WalkCallback (ACPI_COPY_TYPE_SIMPLE, ThisSourceObj,
417*35786f68SRobert Mustacchi State, Context);
4187c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
4197c478bd9Sstevel@tonic-gate {
4207c478bd9Sstevel@tonic-gate return_ACPI_STATUS (Status);
4217c478bd9Sstevel@tonic-gate }
4227c478bd9Sstevel@tonic-gate
4237c478bd9Sstevel@tonic-gate State->Pkg.Index++;
4247b1019a6SJerry Jelinek while (State->Pkg.Index >=
4257b1019a6SJerry Jelinek State->Pkg.SourceObject->Package.Count)
4267c478bd9Sstevel@tonic-gate {
4277c478bd9Sstevel@tonic-gate /*
4287c478bd9Sstevel@tonic-gate * We've handled all of the objects at this level, This means
4297b1019a6SJerry Jelinek * that we have just completed a package. That package may
4307c478bd9Sstevel@tonic-gate * have contained one or more packages itself.
4317c478bd9Sstevel@tonic-gate *
4327c478bd9Sstevel@tonic-gate * Delete this state and pop the previous state (package).
4337c478bd9Sstevel@tonic-gate */
4347c478bd9Sstevel@tonic-gate AcpiUtDeleteGenericState (State);
4357c478bd9Sstevel@tonic-gate State = AcpiUtPopGenericState (&StateList);
4367c478bd9Sstevel@tonic-gate
4377c478bd9Sstevel@tonic-gate /* Finished when there are no more states */
4387c478bd9Sstevel@tonic-gate
4397c478bd9Sstevel@tonic-gate if (!State)
4407c478bd9Sstevel@tonic-gate {
4417c478bd9Sstevel@tonic-gate /*
4427c478bd9Sstevel@tonic-gate * We have handled all of the objects in the top level
4437c478bd9Sstevel@tonic-gate * package just add the length of the package objects
4447c478bd9Sstevel@tonic-gate * and exit
4457c478bd9Sstevel@tonic-gate */
4467c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_OK);
4477c478bd9Sstevel@tonic-gate }
4487c478bd9Sstevel@tonic-gate
4497c478bd9Sstevel@tonic-gate /*
4507c478bd9Sstevel@tonic-gate * Go back up a level and move the index past the just
4517c478bd9Sstevel@tonic-gate * completed package object.
4527c478bd9Sstevel@tonic-gate */
4537c478bd9Sstevel@tonic-gate State->Pkg.Index++;
4547c478bd9Sstevel@tonic-gate }
4557c478bd9Sstevel@tonic-gate }
4567c478bd9Sstevel@tonic-gate else
4577c478bd9Sstevel@tonic-gate {
4587c478bd9Sstevel@tonic-gate /* This is a subobject of type package */
4597c478bd9Sstevel@tonic-gate
4607b1019a6SJerry Jelinek Status = WalkCallback (
4617b1019a6SJerry Jelinek ACPI_COPY_TYPE_PACKAGE, ThisSourceObj, State, Context);
4627c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
4637c478bd9Sstevel@tonic-gate {
4647c478bd9Sstevel@tonic-gate return_ACPI_STATUS (Status);
4657c478bd9Sstevel@tonic-gate }
4667c478bd9Sstevel@tonic-gate
4677c478bd9Sstevel@tonic-gate /*
4687c478bd9Sstevel@tonic-gate * Push the current state and create a new one
4697c478bd9Sstevel@tonic-gate * The callback above returned a new target package object.
4707c478bd9Sstevel@tonic-gate */
4717c478bd9Sstevel@tonic-gate AcpiUtPushGenericState (&StateList, State);
4727b1019a6SJerry Jelinek State = AcpiUtCreatePkgState (
4737b1019a6SJerry Jelinek ThisSourceObj, State->Pkg.ThisTargetObj, 0);
4747c478bd9Sstevel@tonic-gate if (!State)
4757c478bd9Sstevel@tonic-gate {
476aa2aa9a6SDana Myers /* Free any stacked Update State objects */
477aa2aa9a6SDana Myers
478aa2aa9a6SDana Myers while (StateList)
479aa2aa9a6SDana Myers {
480aa2aa9a6SDana Myers State = AcpiUtPopGenericState (&StateList);
481aa2aa9a6SDana Myers AcpiUtDeleteGenericState (State);
482aa2aa9a6SDana Myers }
4837c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_NO_MEMORY);
4847c478bd9Sstevel@tonic-gate }
4857c478bd9Sstevel@tonic-gate }
4867c478bd9Sstevel@tonic-gate }
4877c478bd9Sstevel@tonic-gate
4887c478bd9Sstevel@tonic-gate /* We should never get here */
4897c478bd9Sstevel@tonic-gate
490*35786f68SRobert Mustacchi ACPI_ERROR ((AE_INFO,
491*35786f68SRobert Mustacchi "State list did not terminate correctly"));
492*35786f68SRobert Mustacchi
4937c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_AML_INTERNAL);
4947c478bd9Sstevel@tonic-gate }
4957c478bd9Sstevel@tonic-gate
4967c478bd9Sstevel@tonic-gate
4977b1019a6SJerry Jelinek #ifdef ACPI_DEBUG_OUTPUT
4987b1019a6SJerry Jelinek /*******************************************************************************
4997b1019a6SJerry Jelinek *
5007b1019a6SJerry Jelinek * FUNCTION: AcpiUtDisplayInitPathname
5017b1019a6SJerry Jelinek *
5027b1019a6SJerry Jelinek * PARAMETERS: Type - Object type of the node
5037b1019a6SJerry Jelinek * ObjHandle - Handle whose pathname will be displayed
5047b1019a6SJerry Jelinek * Path - Additional path string to be appended.
5057b1019a6SJerry Jelinek * (NULL if no extra path)
5067b1019a6SJerry Jelinek *
5077b1019a6SJerry Jelinek * RETURN: ACPI_STATUS
5087b1019a6SJerry Jelinek *
5097b1019a6SJerry Jelinek * DESCRIPTION: Display full pathname of an object, DEBUG ONLY
5107b1019a6SJerry Jelinek *
5117b1019a6SJerry Jelinek ******************************************************************************/
5127b1019a6SJerry Jelinek
5137b1019a6SJerry Jelinek void
AcpiUtDisplayInitPathname(UINT8 Type,ACPI_NAMESPACE_NODE * ObjHandle,const char * Path)5147b1019a6SJerry Jelinek AcpiUtDisplayInitPathname (
5157b1019a6SJerry Jelinek UINT8 Type,
5167b1019a6SJerry Jelinek ACPI_NAMESPACE_NODE *ObjHandle,
5177b1019a6SJerry Jelinek const char *Path)
5187b1019a6SJerry Jelinek {
5197b1019a6SJerry Jelinek ACPI_STATUS Status;
5207b1019a6SJerry Jelinek ACPI_BUFFER Buffer;
5217b1019a6SJerry Jelinek
5227b1019a6SJerry Jelinek
5237b1019a6SJerry Jelinek ACPI_FUNCTION_ENTRY ();
5247b1019a6SJerry Jelinek
5257b1019a6SJerry Jelinek
5267b1019a6SJerry Jelinek /* Only print the path if the appropriate debug level is enabled */
5277b1019a6SJerry Jelinek
5287b1019a6SJerry Jelinek if (!(AcpiDbgLevel & ACPI_LV_INIT_NAMES))
5297b1019a6SJerry Jelinek {
5307b1019a6SJerry Jelinek return;
5317b1019a6SJerry Jelinek }
5327b1019a6SJerry Jelinek
5337b1019a6SJerry Jelinek /* Get the full pathname to the node */
5347b1019a6SJerry Jelinek
5357b1019a6SJerry Jelinek Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
5367b1019a6SJerry Jelinek Status = AcpiNsHandleToPathname (ObjHandle, &Buffer, TRUE);
5377b1019a6SJerry Jelinek if (ACPI_FAILURE (Status))
5387b1019a6SJerry Jelinek {
5397b1019a6SJerry Jelinek return;
5407b1019a6SJerry Jelinek }
5417b1019a6SJerry Jelinek
5427b1019a6SJerry Jelinek /* Print what we're doing */
5437b1019a6SJerry Jelinek
5447b1019a6SJerry Jelinek switch (Type)
5457b1019a6SJerry Jelinek {
5467b1019a6SJerry Jelinek case ACPI_TYPE_METHOD:
5477b1019a6SJerry Jelinek
5487b1019a6SJerry Jelinek AcpiOsPrintf ("Executing ");
5497b1019a6SJerry Jelinek break;
5507b1019a6SJerry Jelinek
5517b1019a6SJerry Jelinek default:
5527b1019a6SJerry Jelinek
5537b1019a6SJerry Jelinek AcpiOsPrintf ("Initializing ");
5547b1019a6SJerry Jelinek break;
5557b1019a6SJerry Jelinek }
5567b1019a6SJerry Jelinek
5577b1019a6SJerry Jelinek /* Print the object type and pathname */
5587b1019a6SJerry Jelinek
5597b1019a6SJerry Jelinek AcpiOsPrintf ("%-12s %s",
5607b1019a6SJerry Jelinek AcpiUtGetTypeName (Type), (char *) Buffer.Pointer);
5617b1019a6SJerry Jelinek
5627b1019a6SJerry Jelinek /* Extra path is used to append names like _STA, _INI, etc. */
5637b1019a6SJerry Jelinek
5647b1019a6SJerry Jelinek if (Path)
5657b1019a6SJerry Jelinek {
5667b1019a6SJerry Jelinek AcpiOsPrintf (".%s", Path);
5677b1019a6SJerry Jelinek }
5687b1019a6SJerry Jelinek AcpiOsPrintf ("\n");
5697b1019a6SJerry Jelinek
5707b1019a6SJerry Jelinek ACPI_FREE (Buffer.Pointer);
5717b1019a6SJerry Jelinek }
5727b1019a6SJerry Jelinek #endif
573