Commit | Line | Data |
---|---|---|
42f8fb75 BM |
1 | /****************************************************************************** |
2 | * | |
3 | * Module Name: psopinfo - AML opcode information functions and dispatch tables | |
4 | * | |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
25f044e6 | 8 | * Copyright (C) 2000 - 2013, Intel Corp. |
42f8fb75 BM |
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 MERCHANTIBILITY 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/acpi.h> | |
45 | #include "accommon.h" | |
46 | #include "acparser.h" | |
47 | #include "acopcode.h" | |
48 | #include "amlcode.h" | |
49 | ||
50 | #define _COMPONENT ACPI_PARSER | |
51 | ACPI_MODULE_NAME("psopinfo") | |
52 | ||
53 | extern const u8 acpi_gbl_short_op_index[]; | |
54 | extern const u8 acpi_gbl_long_op_index[]; | |
55 | ||
56 | static const u8 acpi_gbl_argument_count[] = | |
57 | { 0, 1, 1, 1, 1, 2, 2, 2, 2, 3, 3, 6 }; | |
58 | ||
59 | /******************************************************************************* | |
60 | * | |
61 | * FUNCTION: acpi_ps_get_opcode_info | |
62 | * | |
63 | * PARAMETERS: opcode - The AML opcode | |
64 | * | |
65 | * RETURN: A pointer to the info about the opcode. | |
66 | * | |
67 | * DESCRIPTION: Find AML opcode description based on the opcode. | |
68 | * NOTE: This procedure must ALWAYS return a valid pointer! | |
69 | * | |
70 | ******************************************************************************/ | |
71 | ||
72 | const struct acpi_opcode_info *acpi_ps_get_opcode_info(u16 opcode) | |
73 | { | |
74 | ACPI_FUNCTION_NAME(ps_get_opcode_info); | |
75 | ||
76 | /* | |
77 | * Detect normal 8-bit opcode or extended 16-bit opcode | |
78 | */ | |
79 | if (!(opcode & 0xFF00)) { | |
80 | ||
81 | /* Simple (8-bit) opcode: 0-255, can't index beyond table */ | |
82 | ||
83 | return (&acpi_gbl_aml_op_info | |
84 | [acpi_gbl_short_op_index[(u8)opcode]]); | |
85 | } | |
86 | ||
87 | if (((opcode & 0xFF00) == AML_EXTENDED_OPCODE) && | |
88 | (((u8)opcode) <= MAX_EXTENDED_OPCODE)) { | |
89 | ||
90 | /* Valid extended (16-bit) opcode */ | |
91 | ||
92 | return (&acpi_gbl_aml_op_info | |
93 | [acpi_gbl_long_op_index[(u8)opcode]]); | |
94 | } | |
95 | ||
96 | /* Unknown AML opcode */ | |
97 | ||
98 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, | |
99 | "Unknown AML opcode [%4.4X]\n", opcode)); | |
100 | ||
101 | return (&acpi_gbl_aml_op_info[_UNK]); | |
102 | } | |
103 | ||
104 | /******************************************************************************* | |
105 | * | |
106 | * FUNCTION: acpi_ps_get_opcode_name | |
107 | * | |
108 | * PARAMETERS: opcode - The AML opcode | |
109 | * | |
110 | * RETURN: A pointer to the name of the opcode (ASCII String) | |
111 | * Note: Never returns NULL. | |
112 | * | |
113 | * DESCRIPTION: Translate an opcode into a human-readable string | |
114 | * | |
115 | ******************************************************************************/ | |
116 | ||
117 | char *acpi_ps_get_opcode_name(u16 opcode) | |
118 | { | |
119 | #if defined(ACPI_DISASSEMBLER) || defined (ACPI_DEBUG_OUTPUT) | |
120 | ||
121 | const struct acpi_opcode_info *op; | |
122 | ||
123 | op = acpi_ps_get_opcode_info(opcode); | |
124 | ||
125 | /* Always guaranteed to return a valid pointer */ | |
126 | ||
127 | return (op->name); | |
128 | ||
129 | #else | |
130 | return ("OpcodeName unavailable"); | |
131 | ||
132 | #endif | |
133 | } | |
134 | ||
135 | /******************************************************************************* | |
136 | * | |
137 | * FUNCTION: acpi_ps_get_argument_count | |
138 | * | |
139 | * PARAMETERS: op_type - Type associated with the AML opcode | |
140 | * | |
141 | * RETURN: Argument count | |
142 | * | |
143 | * DESCRIPTION: Obtain the number of expected arguments for an AML opcode | |
144 | * | |
145 | ******************************************************************************/ | |
146 | ||
147 | u8 acpi_ps_get_argument_count(u32 op_type) | |
148 | { | |
149 | ||
150 | if (op_type <= AML_TYPE_EXEC_6A_0T_1R) { | |
151 | return (acpi_gbl_argument_count[op_type]); | |
152 | } | |
153 | ||
154 | return (0); | |
155 | } | |
156 | ||
157 | /* | |
158 | * This table is directly indexed by the opcodes It returns | |
159 | * an index into the opcode table (acpi_gbl_aml_op_info) | |
160 | */ | |
161 | const u8 acpi_gbl_short_op_index[256] = { | |
162 | /* 0 1 2 3 4 5 6 7 */ | |
163 | /* 8 9 A B C D E F */ | |
164 | /* 0x00 */ 0x00, 0x01, _UNK, _UNK, _UNK, _UNK, 0x02, _UNK, | |
165 | /* 0x08 */ 0x03, _UNK, 0x04, 0x05, 0x06, 0x07, 0x6E, _UNK, | |
166 | /* 0x10 */ 0x08, 0x09, 0x0a, 0x6F, 0x0b, _UNK, _UNK, _UNK, | |
167 | /* 0x18 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
168 | /* 0x20 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
169 | /* 0x28 */ _UNK, _UNK, _UNK, _UNK, _UNK, 0x63, _PFX, _PFX, | |
170 | /* 0x30 */ 0x67, 0x66, 0x68, 0x65, 0x69, 0x64, 0x6A, 0x7D, | |
171 | /* 0x38 */ 0x7F, 0x80, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
172 | /* 0x40 */ _UNK, _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, | |
173 | /* 0x48 */ _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, | |
174 | /* 0x50 */ _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, _ASC, | |
175 | /* 0x58 */ _ASC, _ASC, _ASC, _UNK, _PFX, _UNK, _PFX, _ASC, | |
176 | /* 0x60 */ 0x0c, 0x0d, 0x0e, 0x0f, 0x10, 0x11, 0x12, 0x13, | |
177 | /* 0x68 */ 0x14, 0x15, 0x16, 0x17, 0x18, 0x19, 0x1a, _UNK, | |
178 | /* 0x70 */ 0x1b, 0x1c, 0x1d, 0x1e, 0x1f, 0x20, 0x21, 0x22, | |
179 | /* 0x78 */ 0x23, 0x24, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2a, | |
180 | /* 0x80 */ 0x2b, 0x2c, 0x2d, 0x2e, 0x70, 0x71, 0x2f, 0x30, | |
181 | /* 0x88 */ 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x72, | |
182 | /* 0x90 */ 0x38, 0x39, 0x3a, 0x3b, 0x3c, 0x3d, 0x73, 0x74, | |
183 | /* 0x98 */ 0x75, 0x76, _UNK, _UNK, 0x77, 0x78, 0x79, 0x7A, | |
184 | /* 0xA0 */ 0x3e, 0x3f, 0x40, 0x41, 0x42, 0x43, 0x60, 0x61, | |
185 | /* 0xA8 */ 0x62, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
186 | /* 0xB0 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
187 | /* 0xB8 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
188 | /* 0xC0 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
189 | /* 0xC8 */ _UNK, _UNK, _UNK, _UNK, 0x44, _UNK, _UNK, _UNK, | |
190 | /* 0xD0 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
191 | /* 0xD8 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
192 | /* 0xE0 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
193 | /* 0xE8 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
194 | /* 0xF0 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
195 | /* 0xF8 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, 0x45, | |
196 | }; | |
197 | ||
198 | /* | |
199 | * This table is indexed by the second opcode of the extended opcode | |
200 | * pair. It returns an index into the opcode table (acpi_gbl_aml_op_info) | |
201 | */ | |
202 | const u8 acpi_gbl_long_op_index[NUM_EXTENDED_OPCODE] = { | |
203 | /* 0 1 2 3 4 5 6 7 */ | |
204 | /* 8 9 A B C D E F */ | |
205 | /* 0x00 */ _UNK, 0x46, 0x47, _UNK, _UNK, _UNK, _UNK, _UNK, | |
206 | /* 0x08 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
207 | /* 0x10 */ _UNK, _UNK, 0x48, 0x49, _UNK, _UNK, _UNK, _UNK, | |
208 | /* 0x18 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, 0x7B, | |
209 | /* 0x20 */ 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f, 0x50, 0x51, | |
210 | /* 0x28 */ 0x52, 0x53, 0x54, _UNK, _UNK, _UNK, _UNK, _UNK, | |
211 | /* 0x30 */ 0x55, 0x56, 0x57, 0x7e, _UNK, _UNK, _UNK, _UNK, | |
212 | /* 0x38 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
213 | /* 0x40 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
214 | /* 0x48 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
215 | /* 0x50 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
216 | /* 0x58 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
217 | /* 0x60 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
218 | /* 0x68 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
219 | /* 0x70 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
220 | /* 0x78 */ _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, _UNK, | |
221 | /* 0x80 */ 0x58, 0x59, 0x5a, 0x5b, 0x5c, 0x5d, 0x5e, 0x5f, | |
222 | /* 0x88 */ 0x7C, | |
223 | }; |