1 | // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 |
2 | /****************************************************************************** |
3 | * |
4 | * Module Name: dsargs - Support for execution of dynamic arguments for static |
5 | * objects (regions, fields, buffer fields, etc.) |
6 | * |
7 | * Copyright (C) 2000 - 2023, Intel Corp. |
8 | * |
9 | *****************************************************************************/ |
10 | |
11 | #include <acpi/acpi.h> |
12 | #include "accommon.h" |
13 | #include "acparser.h" |
14 | #include "amlcode.h" |
15 | #include "acdispat.h" |
16 | #include "acnamesp.h" |
17 | |
18 | #define _COMPONENT ACPI_DISPATCHER |
19 | ACPI_MODULE_NAME("dsargs" ) |
20 | |
21 | /* Local prototypes */ |
22 | static acpi_status |
23 | acpi_ds_execute_arguments(struct acpi_namespace_node *node, |
24 | struct acpi_namespace_node *scope_node, |
25 | u32 aml_length, u8 *aml_start); |
26 | |
27 | /******************************************************************************* |
28 | * |
29 | * FUNCTION: acpi_ds_execute_arguments |
30 | * |
31 | * PARAMETERS: node - Object NS node |
32 | * scope_node - Parent NS node |
33 | * aml_length - Length of executable AML |
34 | * aml_start - Pointer to the AML |
35 | * |
36 | * RETURN: Status. |
37 | * |
38 | * DESCRIPTION: Late (deferred) execution of region or field arguments |
39 | * |
40 | ******************************************************************************/ |
41 | |
42 | static acpi_status |
43 | acpi_ds_execute_arguments(struct acpi_namespace_node *node, |
44 | struct acpi_namespace_node *scope_node, |
45 | u32 aml_length, u8 *aml_start) |
46 | { |
47 | acpi_status status; |
48 | union acpi_parse_object *op; |
49 | struct acpi_walk_state *walk_state; |
50 | |
51 | ACPI_FUNCTION_TRACE_PTR(ds_execute_arguments, aml_start); |
52 | |
53 | /* Allocate a new parser op to be the root of the parsed tree */ |
54 | |
55 | op = acpi_ps_alloc_op(AML_INT_EVAL_SUBTREE_OP, aml: aml_start); |
56 | if (!op) { |
57 | return_ACPI_STATUS(AE_NO_MEMORY); |
58 | } |
59 | |
60 | /* Save the Node for use in acpi_ps_parse_aml */ |
61 | |
62 | op->common.node = scope_node; |
63 | |
64 | /* Create and initialize a new parser state */ |
65 | |
66 | walk_state = acpi_ds_create_walk_state(owner_id: 0, NULL, NULL, NULL); |
67 | if (!walk_state) { |
68 | status = AE_NO_MEMORY; |
69 | goto cleanup; |
70 | } |
71 | |
72 | status = acpi_ds_init_aml_walk(walk_state, op, NULL, aml_start, |
73 | aml_length, NULL, pass_number: ACPI_IMODE_LOAD_PASS1); |
74 | if (ACPI_FAILURE(status)) { |
75 | acpi_ds_delete_walk_state(walk_state); |
76 | goto cleanup; |
77 | } |
78 | |
79 | /* Mark this parse as a deferred opcode */ |
80 | |
81 | walk_state->parse_flags = ACPI_PARSE_DEFERRED_OP; |
82 | walk_state->deferred_node = node; |
83 | |
84 | /* Pass1: Parse the entire declaration */ |
85 | |
86 | status = acpi_ps_parse_aml(walk_state); |
87 | if (ACPI_FAILURE(status)) { |
88 | goto cleanup; |
89 | } |
90 | |
91 | /* Get and init the Op created above */ |
92 | |
93 | op->common.node = node; |
94 | acpi_ps_delete_parse_tree(root: op); |
95 | |
96 | /* Evaluate the deferred arguments */ |
97 | |
98 | op = acpi_ps_alloc_op(AML_INT_EVAL_SUBTREE_OP, aml: aml_start); |
99 | if (!op) { |
100 | return_ACPI_STATUS(AE_NO_MEMORY); |
101 | } |
102 | |
103 | op->common.node = scope_node; |
104 | |
105 | /* Create and initialize a new parser state */ |
106 | |
107 | walk_state = acpi_ds_create_walk_state(owner_id: 0, NULL, NULL, NULL); |
108 | if (!walk_state) { |
109 | status = AE_NO_MEMORY; |
110 | goto cleanup; |
111 | } |
112 | |
113 | /* Execute the opcode and arguments */ |
114 | |
115 | status = acpi_ds_init_aml_walk(walk_state, op, NULL, aml_start, |
116 | aml_length, NULL, pass_number: ACPI_IMODE_EXECUTE); |
117 | if (ACPI_FAILURE(status)) { |
118 | acpi_ds_delete_walk_state(walk_state); |
119 | goto cleanup; |
120 | } |
121 | |
122 | /* Mark this execution as a deferred opcode */ |
123 | |
124 | walk_state->deferred_node = node; |
125 | status = acpi_ps_parse_aml(walk_state); |
126 | |
127 | cleanup: |
128 | acpi_ps_delete_parse_tree(root: op); |
129 | return_ACPI_STATUS(status); |
130 | } |
131 | |
132 | /******************************************************************************* |
133 | * |
134 | * FUNCTION: acpi_ds_get_buffer_field_arguments |
135 | * |
136 | * PARAMETERS: obj_desc - A valid buffer_field object |
137 | * |
138 | * RETURN: Status. |
139 | * |
140 | * DESCRIPTION: Get buffer_field Buffer and Index. This implements the late |
141 | * evaluation of these field attributes. |
142 | * |
143 | ******************************************************************************/ |
144 | |
145 | acpi_status |
146 | acpi_ds_get_buffer_field_arguments(union acpi_operand_object *obj_desc) |
147 | { |
148 | union acpi_operand_object *; |
149 | struct acpi_namespace_node *node; |
150 | acpi_status status; |
151 | |
152 | ACPI_FUNCTION_TRACE_PTR(ds_get_buffer_field_arguments, obj_desc); |
153 | |
154 | if (obj_desc->common.flags & AOPOBJ_DATA_VALID) { |
155 | return_ACPI_STATUS(AE_OK); |
156 | } |
157 | |
158 | /* Get the AML pointer (method object) and buffer_field node */ |
159 | |
160 | extra_desc = acpi_ns_get_secondary_object(obj_desc); |
161 | node = obj_desc->buffer_field.node; |
162 | |
163 | ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname |
164 | (ACPI_TYPE_BUFFER_FIELD, node, NULL)); |
165 | |
166 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] BufferField Arg Init\n" , |
167 | acpi_ut_get_node_name(node))); |
168 | |
169 | /* Execute the AML code for the term_arg arguments */ |
170 | |
171 | status = acpi_ds_execute_arguments(node, scope_node: node->parent, |
172 | aml_length: extra_desc->extra.aml_length, |
173 | aml_start: extra_desc->extra.aml_start); |
174 | return_ACPI_STATUS(status); |
175 | } |
176 | |
177 | /******************************************************************************* |
178 | * |
179 | * FUNCTION: acpi_ds_get_bank_field_arguments |
180 | * |
181 | * PARAMETERS: obj_desc - A valid bank_field object |
182 | * |
183 | * RETURN: Status. |
184 | * |
185 | * DESCRIPTION: Get bank_field bank_value. This implements the late |
186 | * evaluation of these field attributes. |
187 | * |
188 | ******************************************************************************/ |
189 | |
190 | acpi_status |
191 | acpi_ds_get_bank_field_arguments(union acpi_operand_object *obj_desc) |
192 | { |
193 | union acpi_operand_object *; |
194 | struct acpi_namespace_node *node; |
195 | acpi_status status; |
196 | |
197 | ACPI_FUNCTION_TRACE_PTR(ds_get_bank_field_arguments, obj_desc); |
198 | |
199 | if (obj_desc->common.flags & AOPOBJ_DATA_VALID) { |
200 | return_ACPI_STATUS(AE_OK); |
201 | } |
202 | |
203 | /* Get the AML pointer (method object) and bank_field node */ |
204 | |
205 | extra_desc = acpi_ns_get_secondary_object(obj_desc); |
206 | node = obj_desc->bank_field.node; |
207 | |
208 | ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname |
209 | (ACPI_TYPE_LOCAL_BANK_FIELD, node, NULL)); |
210 | |
211 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "[%4.4s] BankField Arg Init\n" , |
212 | acpi_ut_get_node_name(node))); |
213 | |
214 | /* Execute the AML code for the term_arg arguments */ |
215 | |
216 | status = acpi_ds_execute_arguments(node, scope_node: node->parent, |
217 | aml_length: extra_desc->extra.aml_length, |
218 | aml_start: extra_desc->extra.aml_start); |
219 | if (ACPI_FAILURE(status)) { |
220 | return_ACPI_STATUS(status); |
221 | } |
222 | |
223 | status = acpi_ut_add_address_range(space_id: obj_desc->region.space_id, |
224 | address: obj_desc->region.address, |
225 | length: obj_desc->region.length, region_node: node); |
226 | return_ACPI_STATUS(status); |
227 | } |
228 | |
229 | /******************************************************************************* |
230 | * |
231 | * FUNCTION: acpi_ds_get_buffer_arguments |
232 | * |
233 | * PARAMETERS: obj_desc - A valid Buffer object |
234 | * |
235 | * RETURN: Status. |
236 | * |
237 | * DESCRIPTION: Get Buffer length and initializer byte list. This implements |
238 | * the late evaluation of these attributes. |
239 | * |
240 | ******************************************************************************/ |
241 | |
242 | acpi_status acpi_ds_get_buffer_arguments(union acpi_operand_object *obj_desc) |
243 | { |
244 | struct acpi_namespace_node *node; |
245 | acpi_status status; |
246 | |
247 | ACPI_FUNCTION_TRACE_PTR(ds_get_buffer_arguments, obj_desc); |
248 | |
249 | if (obj_desc->common.flags & AOPOBJ_DATA_VALID) { |
250 | return_ACPI_STATUS(AE_OK); |
251 | } |
252 | |
253 | /* Get the Buffer node */ |
254 | |
255 | node = obj_desc->buffer.node; |
256 | if (!node) { |
257 | ACPI_ERROR((AE_INFO, |
258 | "No pointer back to namespace node in buffer object %p" , |
259 | obj_desc)); |
260 | return_ACPI_STATUS(AE_AML_INTERNAL); |
261 | } |
262 | |
263 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Buffer Arg Init\n" )); |
264 | |
265 | /* Execute the AML code for the term_arg arguments */ |
266 | |
267 | status = acpi_ds_execute_arguments(node, scope_node: node, |
268 | aml_length: obj_desc->buffer.aml_length, |
269 | aml_start: obj_desc->buffer.aml_start); |
270 | return_ACPI_STATUS(status); |
271 | } |
272 | |
273 | /******************************************************************************* |
274 | * |
275 | * FUNCTION: acpi_ds_get_package_arguments |
276 | * |
277 | * PARAMETERS: obj_desc - A valid Package object |
278 | * |
279 | * RETURN: Status. |
280 | * |
281 | * DESCRIPTION: Get Package length and initializer byte list. This implements |
282 | * the late evaluation of these attributes. |
283 | * |
284 | ******************************************************************************/ |
285 | |
286 | acpi_status acpi_ds_get_package_arguments(union acpi_operand_object *obj_desc) |
287 | { |
288 | struct acpi_namespace_node *node; |
289 | acpi_status status; |
290 | |
291 | ACPI_FUNCTION_TRACE_PTR(ds_get_package_arguments, obj_desc); |
292 | |
293 | if (obj_desc->common.flags & AOPOBJ_DATA_VALID) { |
294 | return_ACPI_STATUS(AE_OK); |
295 | } |
296 | |
297 | /* Get the Package node */ |
298 | |
299 | node = obj_desc->package.node; |
300 | if (!node) { |
301 | ACPI_ERROR((AE_INFO, |
302 | "No pointer back to namespace node in package %p" , |
303 | obj_desc)); |
304 | return_ACPI_STATUS(AE_AML_INTERNAL); |
305 | } |
306 | |
307 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Package Argument Init, AML Ptr: %p\n" , |
308 | obj_desc->package.aml_start)); |
309 | |
310 | /* Execute the AML code for the term_arg arguments */ |
311 | |
312 | status = acpi_ds_execute_arguments(node, scope_node: node, |
313 | aml_length: obj_desc->package.aml_length, |
314 | aml_start: obj_desc->package.aml_start); |
315 | |
316 | return_ACPI_STATUS(status); |
317 | } |
318 | |
319 | /******************************************************************************* |
320 | * |
321 | * FUNCTION: acpi_ds_get_region_arguments |
322 | * |
323 | * PARAMETERS: obj_desc - A valid region object |
324 | * |
325 | * RETURN: Status. |
326 | * |
327 | * DESCRIPTION: Get region address and length. This implements the late |
328 | * evaluation of these region attributes. |
329 | * |
330 | ******************************************************************************/ |
331 | |
332 | acpi_status acpi_ds_get_region_arguments(union acpi_operand_object *obj_desc) |
333 | { |
334 | struct acpi_namespace_node *node; |
335 | acpi_status status; |
336 | union acpi_operand_object *; |
337 | |
338 | ACPI_FUNCTION_TRACE_PTR(ds_get_region_arguments, obj_desc); |
339 | |
340 | if (obj_desc->region.flags & AOPOBJ_DATA_VALID) { |
341 | return_ACPI_STATUS(AE_OK); |
342 | } |
343 | |
344 | extra_desc = acpi_ns_get_secondary_object(obj_desc); |
345 | if (!extra_desc) { |
346 | return_ACPI_STATUS(AE_NOT_EXIST); |
347 | } |
348 | |
349 | /* Get the Region node */ |
350 | |
351 | node = obj_desc->region.node; |
352 | |
353 | ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname |
354 | (ACPI_TYPE_REGION, node, NULL)); |
355 | |
356 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
357 | "[%4.4s] OpRegion Arg Init at AML %p\n" , |
358 | acpi_ut_get_node_name(node), |
359 | extra_desc->extra.aml_start)); |
360 | |
361 | /* Execute the argument AML */ |
362 | |
363 | status = acpi_ds_execute_arguments(node, scope_node: extra_desc->extra.scope_node, |
364 | aml_length: extra_desc->extra.aml_length, |
365 | aml_start: extra_desc->extra.aml_start); |
366 | if (ACPI_FAILURE(status)) { |
367 | return_ACPI_STATUS(status); |
368 | } |
369 | |
370 | status = acpi_ut_add_address_range(space_id: obj_desc->region.space_id, |
371 | address: obj_desc->region.address, |
372 | length: obj_desc->region.length, region_node: node); |
373 | return_ACPI_STATUS(status); |
374 | } |
375 | |