Loading...
1// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2/******************************************************************************
3 *
4 * Module Name: evrgnini- ACPI address_space (op_region) init
5 *
6 * Copyright (C) 2000 - 2023, Intel Corp.
7 *
8 *****************************************************************************/
9
10#include <acpi/acpi.h>
11#include "accommon.h"
12#include "acevents.h"
13#include "acnamesp.h"
14#include "acinterp.h"
15
16#define _COMPONENT ACPI_EVENTS
17ACPI_MODULE_NAME("evrgnini")
18
19/*******************************************************************************
20 *
21 * FUNCTION: acpi_ev_system_memory_region_setup
22 *
23 * PARAMETERS: handle - Region we are interested in
24 * function - Start or stop
25 * handler_context - Address space handler context
26 * region_context - Region specific context
27 *
28 * RETURN: Status
29 *
30 * DESCRIPTION: Setup a system_memory operation region
31 *
32 ******************************************************************************/
33acpi_status
34acpi_ev_system_memory_region_setup(acpi_handle handle,
35 u32 function,
36 void *handler_context, void **region_context)
37{
38 union acpi_operand_object *region_desc =
39 (union acpi_operand_object *)handle;
40 struct acpi_mem_space_context *local_region_context;
41 struct acpi_mem_mapping *mm;
42
43 ACPI_FUNCTION_TRACE(ev_system_memory_region_setup);
44
45 if (function == ACPI_REGION_DEACTIVATE) {
46 if (*region_context) {
47 local_region_context =
48 (struct acpi_mem_space_context *)*region_context;
49
50 /* Delete memory mappings if present */
51
52 while (local_region_context->first_mm) {
53 mm = local_region_context->first_mm;
54 local_region_context->first_mm = mm->next_mm;
55 acpi_os_unmap_memory(mm->logical_address,
56 mm->length);
57 ACPI_FREE(mm);
58 }
59 ACPI_FREE(local_region_context);
60 *region_context = NULL;
61 }
62 return_ACPI_STATUS(AE_OK);
63 }
64
65 /* Create a new context */
66
67 local_region_context =
68 ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_mem_space_context));
69 if (!(local_region_context)) {
70 return_ACPI_STATUS(AE_NO_MEMORY);
71 }
72
73 /* Save the region length and address for use in the handler */
74
75 local_region_context->length = region_desc->region.length;
76 local_region_context->address = region_desc->region.address;
77
78 *region_context = local_region_context;
79 return_ACPI_STATUS(AE_OK);
80}
81
82/*******************************************************************************
83 *
84 * FUNCTION: acpi_ev_io_space_region_setup
85 *
86 * PARAMETERS: handle - Region we are interested in
87 * function - Start or stop
88 * handler_context - Address space handler context
89 * region_context - Region specific context
90 *
91 * RETURN: Status
92 *
93 * DESCRIPTION: Setup a IO operation region
94 *
95 ******************************************************************************/
96
97acpi_status
98acpi_ev_io_space_region_setup(acpi_handle handle,
99 u32 function,
100 void *handler_context, void **region_context)
101{
102 ACPI_FUNCTION_TRACE(ev_io_space_region_setup);
103
104 if (function == ACPI_REGION_DEACTIVATE) {
105 *region_context = NULL;
106 } else {
107 *region_context = handler_context;
108 }
109
110 return_ACPI_STATUS(AE_OK);
111}
112
113/*******************************************************************************
114 *
115 * FUNCTION: acpi_ev_pci_config_region_setup
116 *
117 * PARAMETERS: handle - Region we are interested in
118 * function - Start or stop
119 * handler_context - Address space handler context
120 * region_context - Region specific context
121 *
122 * RETURN: Status
123 *
124 * DESCRIPTION: Setup a PCI_Config operation region
125 *
126 * MUTEX: Assumes namespace is not locked
127 *
128 ******************************************************************************/
129
130acpi_status
131acpi_ev_pci_config_region_setup(acpi_handle handle,
132 u32 function,
133 void *handler_context, void **region_context)
134{
135 acpi_status status = AE_OK;
136 u64 pci_value;
137 struct acpi_pci_id *pci_id = *region_context;
138 union acpi_operand_object *handler_obj;
139 struct acpi_namespace_node *parent_node;
140 struct acpi_namespace_node *pci_root_node;
141 struct acpi_namespace_node *pci_device_node;
142 union acpi_operand_object *region_obj =
143 (union acpi_operand_object *)handle;
144
145 ACPI_FUNCTION_TRACE(ev_pci_config_region_setup);
146
147 handler_obj = region_obj->region.handler;
148 if (!handler_obj) {
149 /*
150 * No installed handler. This shouldn't happen because the dispatch
151 * routine checks before we get here, but we check again just in case.
152 */
153 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
154 "Attempting to init a region %p, with no handler\n",
155 region_obj));
156 return_ACPI_STATUS(AE_NOT_EXIST);
157 }
158
159 *region_context = NULL;
160 if (function == ACPI_REGION_DEACTIVATE) {
161 if (pci_id) {
162 ACPI_FREE(pci_id);
163 }
164 return_ACPI_STATUS(status);
165 }
166
167 parent_node = region_obj->region.node->parent;
168
169 /*
170 * Get the _SEG and _BBN values from the device upon which the handler
171 * is installed.
172 *
173 * We need to get the _SEG and _BBN objects relative to the PCI BUS device.
174 * This is the device the handler has been registered to handle.
175 */
176
177 /*
178 * If the address_space.Node is still pointing to the root, we need
179 * to scan upward for a PCI Root bridge and re-associate the op_region
180 * handlers with that device.
181 */
182 if (handler_obj->address_space.node == acpi_gbl_root_node) {
183
184 /* Start search from the parent object */
185
186 pci_root_node = parent_node;
187 while (pci_root_node != acpi_gbl_root_node) {
188
189 /* Get the _HID/_CID in order to detect a root_bridge */
190
191 if (acpi_ev_is_pci_root_bridge(pci_root_node)) {
192
193 /* Install a handler for this PCI root bridge */
194
195 status = acpi_install_address_space_handler((acpi_handle)pci_root_node, ACPI_ADR_SPACE_PCI_CONFIG, ACPI_DEFAULT_HANDLER, NULL, NULL);
196 if (ACPI_FAILURE(status)) {
197 if (status == AE_SAME_HANDLER) {
198 /*
199 * It is OK if the handler is already installed on the
200 * root bridge. Still need to return a context object
201 * for the new PCI_Config operation region, however.
202 */
203 } else {
204 ACPI_EXCEPTION((AE_INFO, status,
205 "Could not install PciConfig handler "
206 "for Root Bridge %4.4s",
207 acpi_ut_get_node_name
208 (pci_root_node)));
209 }
210 }
211 break;
212 }
213
214 pci_root_node = pci_root_node->parent;
215 }
216
217 /* PCI root bridge not found, use namespace root node */
218 } else {
219 pci_root_node = handler_obj->address_space.node;
220 }
221
222 /*
223 * If this region is now initialized, we are done.
224 * (install_address_space_handler could have initialized it)
225 */
226 if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {
227 return_ACPI_STATUS(AE_OK);
228 }
229
230 /* Region is still not initialized. Create a new context */
231
232 pci_id = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_pci_id));
233 if (!pci_id) {
234 return_ACPI_STATUS(AE_NO_MEMORY);
235 }
236
237 /*
238 * For PCI_Config space access, we need the segment, bus, device and
239 * function numbers. Acquire them here.
240 *
241 * Find the parent device object. (This allows the operation region to be
242 * within a subscope under the device, such as a control method.)
243 */
244 pci_device_node = region_obj->region.node;
245 while (pci_device_node && (pci_device_node->type != ACPI_TYPE_DEVICE)) {
246 pci_device_node = pci_device_node->parent;
247 }
248
249 if (!pci_device_node) {
250 ACPI_FREE(pci_id);
251 return_ACPI_STATUS(AE_AML_OPERAND_TYPE);
252 }
253
254 /*
255 * Get the PCI device and function numbers from the _ADR object
256 * contained in the parent's scope.
257 */
258 status = acpi_ut_evaluate_numeric_object(METHOD_NAME__ADR,
259 pci_device_node, &pci_value);
260
261 /*
262 * The default is zero, and since the allocation above zeroed the data,
263 * just do nothing on failure.
264 */
265 if (ACPI_SUCCESS(status)) {
266 pci_id->device = ACPI_HIWORD(ACPI_LODWORD(pci_value));
267 pci_id->function = ACPI_LOWORD(ACPI_LODWORD(pci_value));
268 }
269
270 /* The PCI segment number comes from the _SEG method */
271
272 status = acpi_ut_evaluate_numeric_object(METHOD_NAME__SEG,
273 pci_root_node, &pci_value);
274 if (ACPI_SUCCESS(status)) {
275 pci_id->segment = ACPI_LOWORD(pci_value);
276 }
277
278 /* The PCI bus number comes from the _BBN method */
279
280 status = acpi_ut_evaluate_numeric_object(METHOD_NAME__BBN,
281 pci_root_node, &pci_value);
282 if (ACPI_SUCCESS(status)) {
283 pci_id->bus = ACPI_LOWORD(pci_value);
284 }
285
286 /* Complete/update the PCI ID for this device */
287
288 status =
289 acpi_hw_derive_pci_id(pci_id, pci_root_node,
290 region_obj->region.node);
291 if (ACPI_FAILURE(status)) {
292 ACPI_FREE(pci_id);
293 return_ACPI_STATUS(status);
294 }
295
296 *region_context = pci_id;
297 return_ACPI_STATUS(AE_OK);
298}
299
300/*******************************************************************************
301 *
302 * FUNCTION: acpi_ev_is_pci_root_bridge
303 *
304 * PARAMETERS: node - Device node being examined
305 *
306 * RETURN: TRUE if device is a PCI/PCI-Express Root Bridge
307 *
308 * DESCRIPTION: Determine if the input device represents a PCI Root Bridge by
309 * examining the _HID and _CID for the device.
310 *
311 ******************************************************************************/
312
313u8 acpi_ev_is_pci_root_bridge(struct acpi_namespace_node *node)
314{
315 acpi_status status;
316 struct acpi_pnp_device_id *hid;
317 struct acpi_pnp_device_id_list *cid;
318 u32 i;
319 u8 match;
320
321 /* Get the _HID and check for a PCI Root Bridge */
322
323 status = acpi_ut_execute_HID(node, &hid);
324 if (ACPI_FAILURE(status)) {
325 return (FALSE);
326 }
327
328 match = acpi_ut_is_pci_root_bridge(hid->string);
329 ACPI_FREE(hid);
330
331 if (match) {
332 return (TRUE);
333 }
334
335 /* The _HID did not match. Get the _CID and check for a PCI Root Bridge */
336
337 status = acpi_ut_execute_CID(node, &cid);
338 if (ACPI_FAILURE(status)) {
339 return (FALSE);
340 }
341
342 /* Check all _CIDs in the returned list */
343
344 for (i = 0; i < cid->count; i++) {
345 if (acpi_ut_is_pci_root_bridge(cid->ids[i].string)) {
346 ACPI_FREE(cid);
347 return (TRUE);
348 }
349 }
350
351 ACPI_FREE(cid);
352 return (FALSE);
353}
354
355/*******************************************************************************
356 *
357 * FUNCTION: acpi_ev_pci_bar_region_setup
358 *
359 * PARAMETERS: handle - Region we are interested in
360 * function - Start or stop
361 * handler_context - Address space handler context
362 * region_context - Region specific context
363 *
364 * RETURN: Status
365 *
366 * DESCRIPTION: Setup a pci_BAR operation region
367 *
368 * MUTEX: Assumes namespace is not locked
369 *
370 ******************************************************************************/
371
372acpi_status
373acpi_ev_pci_bar_region_setup(acpi_handle handle,
374 u32 function,
375 void *handler_context, void **region_context)
376{
377 ACPI_FUNCTION_TRACE(ev_pci_bar_region_setup);
378
379 return_ACPI_STATUS(AE_OK);
380}
381
382/*******************************************************************************
383 *
384 * FUNCTION: acpi_ev_cmos_region_setup
385 *
386 * PARAMETERS: handle - Region we are interested in
387 * function - Start or stop
388 * handler_context - Address space handler context
389 * region_context - Region specific context
390 *
391 * RETURN: Status
392 *
393 * DESCRIPTION: Setup a CMOS operation region
394 *
395 * MUTEX: Assumes namespace is not locked
396 *
397 ******************************************************************************/
398
399acpi_status
400acpi_ev_cmos_region_setup(acpi_handle handle,
401 u32 function,
402 void *handler_context, void **region_context)
403{
404 ACPI_FUNCTION_TRACE(ev_cmos_region_setup);
405
406 return_ACPI_STATUS(AE_OK);
407}
408
409/*******************************************************************************
410 *
411 * FUNCTION: acpi_ev_data_table_region_setup
412 *
413 * PARAMETERS: handle - Region we are interested in
414 * function - Start or stop
415 * handler_context - Address space handler context
416 * region_context - Region specific context
417 *
418 * RETURN: Status
419 *
420 * DESCRIPTION: Setup a data_table_region
421 *
422 * MUTEX: Assumes namespace is not locked
423 *
424 ******************************************************************************/
425
426acpi_status
427acpi_ev_data_table_region_setup(acpi_handle handle,
428 u32 function,
429 void *handler_context, void **region_context)
430{
431 union acpi_operand_object *region_desc =
432 (union acpi_operand_object *)handle;
433 struct acpi_data_table_mapping *local_region_context;
434
435 ACPI_FUNCTION_TRACE(ev_data_table_region_setup);
436
437 if (function == ACPI_REGION_DEACTIVATE) {
438 if (*region_context) {
439 ACPI_FREE(*region_context);
440 *region_context = NULL;
441 }
442 return_ACPI_STATUS(AE_OK);
443 }
444
445 /* Create a new context */
446
447 local_region_context =
448 ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_data_table_mapping));
449 if (!(local_region_context)) {
450 return_ACPI_STATUS(AE_NO_MEMORY);
451 }
452
453 /* Save the data table pointer for use in the handler */
454
455 local_region_context->pointer = region_desc->region.pointer;
456
457 *region_context = local_region_context;
458 return_ACPI_STATUS(AE_OK);
459}
460
461/*******************************************************************************
462 *
463 * FUNCTION: acpi_ev_default_region_setup
464 *
465 * PARAMETERS: handle - Region we are interested in
466 * function - Start or stop
467 * handler_context - Address space handler context
468 * region_context - Region specific context
469 *
470 * RETURN: Status
471 *
472 * DESCRIPTION: Default region initialization
473 *
474 ******************************************************************************/
475
476acpi_status
477acpi_ev_default_region_setup(acpi_handle handle,
478 u32 function,
479 void *handler_context, void **region_context)
480{
481 ACPI_FUNCTION_TRACE(ev_default_region_setup);
482
483 if (function == ACPI_REGION_DEACTIVATE) {
484 *region_context = NULL;
485 } else {
486 *region_context = handler_context;
487 }
488
489 return_ACPI_STATUS(AE_OK);
490}
491
492/*******************************************************************************
493 *
494 * FUNCTION: acpi_ev_initialize_region
495 *
496 * PARAMETERS: region_obj - Region we are initializing
497 *
498 * RETURN: Status
499 *
500 * DESCRIPTION: Initializes the region, finds any _REG methods and saves them
501 * for execution at a later time
502 *
503 * Get the appropriate address space handler for a newly
504 * created region.
505 *
506 * This also performs address space specific initialization. For
507 * example, PCI regions must have an _ADR object that contains
508 * a PCI address in the scope of the definition. This address is
509 * required to perform an access to PCI config space.
510 *
511 * MUTEX: Interpreter should be unlocked, because we may run the _REG
512 * method for this region.
513 *
514 * NOTE: Possible incompliance:
515 * There is a behavior conflict in automatic _REG execution:
516 * 1. When the interpreter is evaluating a method, we can only
517 * automatically run _REG for the following case:
518 * operation_region (OPR1, 0x80, 0x1000010, 0x4)
519 * 2. When the interpreter is loading a table, we can also
520 * automatically run _REG for the following case:
521 * operation_region (OPR1, 0x80, 0x1000010, 0x4)
522 * Though this may not be compliant to the de-facto standard, the
523 * logic is kept in order not to trigger regressions. And keeping
524 * this logic should be taken care by the caller of this function.
525 *
526 ******************************************************************************/
527
528acpi_status acpi_ev_initialize_region(union acpi_operand_object *region_obj)
529{
530 union acpi_operand_object *handler_obj;
531 union acpi_operand_object *obj_desc;
532 acpi_adr_space_type space_id;
533 struct acpi_namespace_node *node;
534
535 ACPI_FUNCTION_TRACE(ev_initialize_region);
536
537 if (!region_obj) {
538 return_ACPI_STATUS(AE_BAD_PARAMETER);
539 }
540
541 if (region_obj->common.flags & AOPOBJ_OBJECT_INITIALIZED) {
542 return_ACPI_STATUS(AE_OK);
543 }
544
545 region_obj->common.flags |= AOPOBJ_OBJECT_INITIALIZED;
546
547 node = region_obj->region.node->parent;
548 space_id = region_obj->region.space_id;
549
550 /*
551 * The following loop depends upon the root Node having no parent
552 * ie: acpi_gbl_root_node->Parent being set to NULL
553 */
554 while (node) {
555
556 /* Check to see if a handler exists */
557
558 handler_obj = NULL;
559 obj_desc = acpi_ns_get_attached_object(node);
560 if (obj_desc) {
561
562 /* Can only be a handler if the object exists */
563
564 switch (node->type) {
565 case ACPI_TYPE_DEVICE:
566 case ACPI_TYPE_PROCESSOR:
567 case ACPI_TYPE_THERMAL:
568
569 handler_obj = obj_desc->common_notify.handler;
570 break;
571
572 default:
573
574 /* Ignore other objects */
575
576 break;
577 }
578
579 handler_obj =
580 acpi_ev_find_region_handler(space_id, handler_obj);
581 if (handler_obj) {
582
583 /* Found correct handler */
584
585 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
586 "Found handler %p for region %p in obj %p\n",
587 handler_obj, region_obj,
588 obj_desc));
589
590 (void)acpi_ev_attach_region(handler_obj,
591 region_obj, FALSE);
592
593 /*
594 * Tell all users that this region is usable by
595 * running the _REG method
596 */
597 acpi_ex_exit_interpreter();
598 (void)acpi_ev_execute_reg_method(region_obj,
599 ACPI_REG_CONNECT);
600 acpi_ex_enter_interpreter();
601 return_ACPI_STATUS(AE_OK);
602 }
603 }
604
605 /* This node does not have the handler we need; Pop up one level */
606
607 node = node->parent;
608 }
609
610 /*
611 * If we get here, there is no handler for this region. This is not
612 * fatal because many regions get created before a handler is installed
613 * for said region.
614 */
615 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
616 "No handler for RegionType %s(%X) (RegionObj %p)\n",
617 acpi_ut_get_region_name(space_id), space_id,
618 region_obj));
619
620 return_ACPI_STATUS(AE_OK);
621}
1/******************************************************************************
2 *
3 * Module Name: evrgnini- ACPI address_space (op_region) init
4 *
5 *****************************************************************************/
6
7/*
8 * Copyright (C) 2000 - 2011, Intel Corp.
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 "acevents.h"
47#include "acnamesp.h"
48
49#define _COMPONENT ACPI_EVENTS
50ACPI_MODULE_NAME("evrgnini")
51
52/* Local prototypes */
53static u8 acpi_ev_is_pci_root_bridge(struct acpi_namespace_node *node);
54
55/*******************************************************************************
56 *
57 * FUNCTION: acpi_ev_system_memory_region_setup
58 *
59 * PARAMETERS: Handle - Region we are interested in
60 * Function - Start or stop
61 * handler_context - Address space handler context
62 * region_context - Region specific context
63 *
64 * RETURN: Status
65 *
66 * DESCRIPTION: Setup a system_memory operation region
67 *
68 ******************************************************************************/
69
70acpi_status
71acpi_ev_system_memory_region_setup(acpi_handle handle,
72 u32 function,
73 void *handler_context, void **region_context)
74{
75 union acpi_operand_object *region_desc =
76 (union acpi_operand_object *)handle;
77 struct acpi_mem_space_context *local_region_context;
78
79 ACPI_FUNCTION_TRACE(ev_system_memory_region_setup);
80
81 if (function == ACPI_REGION_DEACTIVATE) {
82 if (*region_context) {
83 local_region_context =
84 (struct acpi_mem_space_context *)*region_context;
85
86 /* Delete a cached mapping if present */
87
88 if (local_region_context->mapped_length) {
89 acpi_os_unmap_memory(local_region_context->
90 mapped_logical_address,
91 local_region_context->
92 mapped_length);
93 }
94 ACPI_FREE(local_region_context);
95 *region_context = NULL;
96 }
97 return_ACPI_STATUS(AE_OK);
98 }
99
100 /* Create a new context */
101
102 local_region_context =
103 ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_mem_space_context));
104 if (!(local_region_context)) {
105 return_ACPI_STATUS(AE_NO_MEMORY);
106 }
107
108 /* Save the region length and address for use in the handler */
109
110 local_region_context->length = region_desc->region.length;
111 local_region_context->address = region_desc->region.address;
112
113 *region_context = local_region_context;
114 return_ACPI_STATUS(AE_OK);
115}
116
117/*******************************************************************************
118 *
119 * FUNCTION: acpi_ev_io_space_region_setup
120 *
121 * PARAMETERS: Handle - Region we are interested in
122 * Function - Start or stop
123 * handler_context - Address space handler context
124 * region_context - Region specific context
125 *
126 * RETURN: Status
127 *
128 * DESCRIPTION: Setup a IO operation region
129 *
130 ******************************************************************************/
131
132acpi_status
133acpi_ev_io_space_region_setup(acpi_handle handle,
134 u32 function,
135 void *handler_context, void **region_context)
136{
137 ACPI_FUNCTION_TRACE(ev_io_space_region_setup);
138
139 if (function == ACPI_REGION_DEACTIVATE) {
140 *region_context = NULL;
141 } else {
142 *region_context = handler_context;
143 }
144
145 return_ACPI_STATUS(AE_OK);
146}
147
148/*******************************************************************************
149 *
150 * FUNCTION: acpi_ev_pci_config_region_setup
151 *
152 * PARAMETERS: Handle - Region we are interested in
153 * Function - Start or stop
154 * handler_context - Address space handler context
155 * region_context - Region specific context
156 *
157 * RETURN: Status
158 *
159 * DESCRIPTION: Setup a PCI_Config operation region
160 *
161 * MUTEX: Assumes namespace is not locked
162 *
163 ******************************************************************************/
164
165acpi_status
166acpi_ev_pci_config_region_setup(acpi_handle handle,
167 u32 function,
168 void *handler_context, void **region_context)
169{
170 acpi_status status = AE_OK;
171 u64 pci_value;
172 struct acpi_pci_id *pci_id = *region_context;
173 union acpi_operand_object *handler_obj;
174 struct acpi_namespace_node *parent_node;
175 struct acpi_namespace_node *pci_root_node;
176 struct acpi_namespace_node *pci_device_node;
177 union acpi_operand_object *region_obj =
178 (union acpi_operand_object *)handle;
179
180 ACPI_FUNCTION_TRACE(ev_pci_config_region_setup);
181
182 handler_obj = region_obj->region.handler;
183 if (!handler_obj) {
184 /*
185 * No installed handler. This shouldn't happen because the dispatch
186 * routine checks before we get here, but we check again just in case.
187 */
188 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
189 "Attempting to init a region %p, with no handler\n",
190 region_obj));
191 return_ACPI_STATUS(AE_NOT_EXIST);
192 }
193
194 *region_context = NULL;
195 if (function == ACPI_REGION_DEACTIVATE) {
196 if (pci_id) {
197 ACPI_FREE(pci_id);
198 }
199 return_ACPI_STATUS(status);
200 }
201
202 parent_node = region_obj->region.node->parent;
203
204 /*
205 * Get the _SEG and _BBN values from the device upon which the handler
206 * is installed.
207 *
208 * We need to get the _SEG and _BBN objects relative to the PCI BUS device.
209 * This is the device the handler has been registered to handle.
210 */
211
212 /*
213 * If the address_space.Node is still pointing to the root, we need
214 * to scan upward for a PCI Root bridge and re-associate the op_region
215 * handlers with that device.
216 */
217 if (handler_obj->address_space.node == acpi_gbl_root_node) {
218
219 /* Start search from the parent object */
220
221 pci_root_node = parent_node;
222 while (pci_root_node != acpi_gbl_root_node) {
223
224 /* Get the _HID/_CID in order to detect a root_bridge */
225
226 if (acpi_ev_is_pci_root_bridge(pci_root_node)) {
227
228 /* Install a handler for this PCI root bridge */
229
230 status =
231 acpi_install_address_space_handler((acpi_handle) pci_root_node, ACPI_ADR_SPACE_PCI_CONFIG, ACPI_DEFAULT_HANDLER, NULL, NULL);
232 if (ACPI_FAILURE(status)) {
233 if (status == AE_SAME_HANDLER) {
234 /*
235 * It is OK if the handler is already installed on the
236 * root bridge. Still need to return a context object
237 * for the new PCI_Config operation region, however.
238 */
239 status = AE_OK;
240 } else {
241 ACPI_EXCEPTION((AE_INFO, status,
242 "Could not install PciConfig handler "
243 "for Root Bridge %4.4s",
244 acpi_ut_get_node_name
245 (pci_root_node)));
246 }
247 }
248 break;
249 }
250
251 pci_root_node = pci_root_node->parent;
252 }
253
254 /* PCI root bridge not found, use namespace root node */
255 } else {
256 pci_root_node = handler_obj->address_space.node;
257 }
258
259 /*
260 * If this region is now initialized, we are done.
261 * (install_address_space_handler could have initialized it)
262 */
263 if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {
264 return_ACPI_STATUS(AE_OK);
265 }
266
267 /* Region is still not initialized. Create a new context */
268
269 pci_id = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_pci_id));
270 if (!pci_id) {
271 return_ACPI_STATUS(AE_NO_MEMORY);
272 }
273
274 /*
275 * For PCI_Config space access, we need the segment, bus, device and
276 * function numbers. Acquire them here.
277 *
278 * Find the parent device object. (This allows the operation region to be
279 * within a subscope under the device, such as a control method.)
280 */
281 pci_device_node = region_obj->region.node;
282 while (pci_device_node && (pci_device_node->type != ACPI_TYPE_DEVICE)) {
283 pci_device_node = pci_device_node->parent;
284 }
285
286 if (!pci_device_node) {
287 ACPI_FREE(pci_id);
288 return_ACPI_STATUS(AE_AML_OPERAND_TYPE);
289 }
290
291 /*
292 * Get the PCI device and function numbers from the _ADR object
293 * contained in the parent's scope.
294 */
295 status = acpi_ut_evaluate_numeric_object(METHOD_NAME__ADR,
296 pci_device_node, &pci_value);
297
298 /*
299 * The default is zero, and since the allocation above zeroed the data,
300 * just do nothing on failure.
301 */
302 if (ACPI_SUCCESS(status)) {
303 pci_id->device = ACPI_HIWORD(ACPI_LODWORD(pci_value));
304 pci_id->function = ACPI_LOWORD(ACPI_LODWORD(pci_value));
305 }
306
307 /* The PCI segment number comes from the _SEG method */
308
309 status = acpi_ut_evaluate_numeric_object(METHOD_NAME__SEG,
310 pci_root_node, &pci_value);
311 if (ACPI_SUCCESS(status)) {
312 pci_id->segment = ACPI_LOWORD(pci_value);
313 }
314
315 /* The PCI bus number comes from the _BBN method */
316
317 status = acpi_ut_evaluate_numeric_object(METHOD_NAME__BBN,
318 pci_root_node, &pci_value);
319 if (ACPI_SUCCESS(status)) {
320 pci_id->bus = ACPI_LOWORD(pci_value);
321 }
322
323 /* Complete/update the PCI ID for this device */
324
325 status =
326 acpi_hw_derive_pci_id(pci_id, pci_root_node,
327 region_obj->region.node);
328 if (ACPI_FAILURE(status)) {
329 ACPI_FREE(pci_id);
330 return_ACPI_STATUS(status);
331 }
332
333 *region_context = pci_id;
334 return_ACPI_STATUS(AE_OK);
335}
336
337/*******************************************************************************
338 *
339 * FUNCTION: acpi_ev_is_pci_root_bridge
340 *
341 * PARAMETERS: Node - Device node being examined
342 *
343 * RETURN: TRUE if device is a PCI/PCI-Express Root Bridge
344 *
345 * DESCRIPTION: Determine if the input device represents a PCI Root Bridge by
346 * examining the _HID and _CID for the device.
347 *
348 ******************************************************************************/
349
350static u8 acpi_ev_is_pci_root_bridge(struct acpi_namespace_node *node)
351{
352 acpi_status status;
353 struct acpica_device_id *hid;
354 struct acpica_device_id_list *cid;
355 u32 i;
356 u8 match;
357
358 /* Get the _HID and check for a PCI Root Bridge */
359
360 status = acpi_ut_execute_HID(node, &hid);
361 if (ACPI_FAILURE(status)) {
362 return (FALSE);
363 }
364
365 match = acpi_ut_is_pci_root_bridge(hid->string);
366 ACPI_FREE(hid);
367
368 if (match) {
369 return (TRUE);
370 }
371
372 /* The _HID did not match. Get the _CID and check for a PCI Root Bridge */
373
374 status = acpi_ut_execute_CID(node, &cid);
375 if (ACPI_FAILURE(status)) {
376 return (FALSE);
377 }
378
379 /* Check all _CIDs in the returned list */
380
381 for (i = 0; i < cid->count; i++) {
382 if (acpi_ut_is_pci_root_bridge(cid->ids[i].string)) {
383 ACPI_FREE(cid);
384 return (TRUE);
385 }
386 }
387
388 ACPI_FREE(cid);
389 return (FALSE);
390}
391
392/*******************************************************************************
393 *
394 * FUNCTION: acpi_ev_pci_bar_region_setup
395 *
396 * PARAMETERS: Handle - Region we are interested in
397 * Function - Start or stop
398 * handler_context - Address space handler context
399 * region_context - Region specific context
400 *
401 * RETURN: Status
402 *
403 * DESCRIPTION: Setup a pci_bAR operation region
404 *
405 * MUTEX: Assumes namespace is not locked
406 *
407 ******************************************************************************/
408
409acpi_status
410acpi_ev_pci_bar_region_setup(acpi_handle handle,
411 u32 function,
412 void *handler_context, void **region_context)
413{
414 ACPI_FUNCTION_TRACE(ev_pci_bar_region_setup);
415
416 return_ACPI_STATUS(AE_OK);
417}
418
419/*******************************************************************************
420 *
421 * FUNCTION: acpi_ev_cmos_region_setup
422 *
423 * PARAMETERS: Handle - Region we are interested in
424 * Function - Start or stop
425 * handler_context - Address space handler context
426 * region_context - Region specific context
427 *
428 * RETURN: Status
429 *
430 * DESCRIPTION: Setup a CMOS operation region
431 *
432 * MUTEX: Assumes namespace is not locked
433 *
434 ******************************************************************************/
435
436acpi_status
437acpi_ev_cmos_region_setup(acpi_handle handle,
438 u32 function,
439 void *handler_context, void **region_context)
440{
441 ACPI_FUNCTION_TRACE(ev_cmos_region_setup);
442
443 return_ACPI_STATUS(AE_OK);
444}
445
446/*******************************************************************************
447 *
448 * FUNCTION: acpi_ev_default_region_setup
449 *
450 * PARAMETERS: Handle - Region we are interested in
451 * Function - Start or stop
452 * handler_context - Address space handler context
453 * region_context - Region specific context
454 *
455 * RETURN: Status
456 *
457 * DESCRIPTION: Default region initialization
458 *
459 ******************************************************************************/
460
461acpi_status
462acpi_ev_default_region_setup(acpi_handle handle,
463 u32 function,
464 void *handler_context, void **region_context)
465{
466 ACPI_FUNCTION_TRACE(ev_default_region_setup);
467
468 if (function == ACPI_REGION_DEACTIVATE) {
469 *region_context = NULL;
470 } else {
471 *region_context = handler_context;
472 }
473
474 return_ACPI_STATUS(AE_OK);
475}
476
477/*******************************************************************************
478 *
479 * FUNCTION: acpi_ev_initialize_region
480 *
481 * PARAMETERS: region_obj - Region we are initializing
482 * acpi_ns_locked - Is namespace locked?
483 *
484 * RETURN: Status
485 *
486 * DESCRIPTION: Initializes the region, finds any _REG methods and saves them
487 * for execution at a later time
488 *
489 * Get the appropriate address space handler for a newly
490 * created region.
491 *
492 * This also performs address space specific initialization. For
493 * example, PCI regions must have an _ADR object that contains
494 * a PCI address in the scope of the definition. This address is
495 * required to perform an access to PCI config space.
496 *
497 * MUTEX: Interpreter should be unlocked, because we may run the _REG
498 * method for this region.
499 *
500 ******************************************************************************/
501
502acpi_status
503acpi_ev_initialize_region(union acpi_operand_object *region_obj,
504 u8 acpi_ns_locked)
505{
506 union acpi_operand_object *handler_obj;
507 union acpi_operand_object *obj_desc;
508 acpi_adr_space_type space_id;
509 struct acpi_namespace_node *node;
510 acpi_status status;
511 struct acpi_namespace_node *method_node;
512 acpi_name *reg_name_ptr = (acpi_name *) METHOD_NAME__REG;
513 union acpi_operand_object *region_obj2;
514
515 ACPI_FUNCTION_TRACE_U32(ev_initialize_region, acpi_ns_locked);
516
517 if (!region_obj) {
518 return_ACPI_STATUS(AE_BAD_PARAMETER);
519 }
520
521 if (region_obj->common.flags & AOPOBJ_OBJECT_INITIALIZED) {
522 return_ACPI_STATUS(AE_OK);
523 }
524
525 region_obj2 = acpi_ns_get_secondary_object(region_obj);
526 if (!region_obj2) {
527 return_ACPI_STATUS(AE_NOT_EXIST);
528 }
529
530 node = region_obj->region.node->parent;
531 space_id = region_obj->region.space_id;
532
533 /* Setup defaults */
534
535 region_obj->region.handler = NULL;
536 region_obj2->extra.method_REG = NULL;
537 region_obj->common.flags &= ~(AOPOBJ_SETUP_COMPLETE);
538 region_obj->common.flags |= AOPOBJ_OBJECT_INITIALIZED;
539
540 /* Find any "_REG" method associated with this region definition */
541
542 status =
543 acpi_ns_search_one_scope(*reg_name_ptr, node, ACPI_TYPE_METHOD,
544 &method_node);
545 if (ACPI_SUCCESS(status)) {
546 /*
547 * The _REG method is optional and there can be only one per region
548 * definition. This will be executed when the handler is attached
549 * or removed
550 */
551 region_obj2->extra.method_REG = method_node;
552 }
553
554 /*
555 * The following loop depends upon the root Node having no parent
556 * ie: acpi_gbl_root_node->parent_entry being set to NULL
557 */
558 while (node) {
559
560 /* Check to see if a handler exists */
561
562 handler_obj = NULL;
563 obj_desc = acpi_ns_get_attached_object(node);
564 if (obj_desc) {
565
566 /* Can only be a handler if the object exists */
567
568 switch (node->type) {
569 case ACPI_TYPE_DEVICE:
570
571 handler_obj = obj_desc->device.handler;
572 break;
573
574 case ACPI_TYPE_PROCESSOR:
575
576 handler_obj = obj_desc->processor.handler;
577 break;
578
579 case ACPI_TYPE_THERMAL:
580
581 handler_obj = obj_desc->thermal_zone.handler;
582 break;
583
584 case ACPI_TYPE_METHOD:
585 /*
586 * If we are executing module level code, the original
587 * Node's object was replaced by this Method object and we
588 * saved the handler in the method object.
589 *
590 * See acpi_ns_exec_module_code
591 */
592 if (obj_desc->method.
593 info_flags & ACPI_METHOD_MODULE_LEVEL) {
594 handler_obj =
595 obj_desc->method.dispatch.handler;
596 }
597 break;
598
599 default:
600 /* Ignore other objects */
601 break;
602 }
603
604 while (handler_obj) {
605
606 /* Is this handler of the correct type? */
607
608 if (handler_obj->address_space.space_id ==
609 space_id) {
610
611 /* Found correct handler */
612
613 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
614 "Found handler %p for region %p in obj %p\n",
615 handler_obj,
616 region_obj,
617 obj_desc));
618
619 status =
620 acpi_ev_attach_region(handler_obj,
621 region_obj,
622 acpi_ns_locked);
623
624 /*
625 * Tell all users that this region is usable by
626 * running the _REG method
627 */
628 if (acpi_ns_locked) {
629 status =
630 acpi_ut_release_mutex
631 (ACPI_MTX_NAMESPACE);
632 if (ACPI_FAILURE(status)) {
633 return_ACPI_STATUS
634 (status);
635 }
636 }
637
638 status =
639 acpi_ev_execute_reg_method
640 (region_obj, ACPI_REG_CONNECT);
641
642 if (acpi_ns_locked) {
643 status =
644 acpi_ut_acquire_mutex
645 (ACPI_MTX_NAMESPACE);
646 if (ACPI_FAILURE(status)) {
647 return_ACPI_STATUS
648 (status);
649 }
650 }
651
652 return_ACPI_STATUS(AE_OK);
653 }
654
655 /* Try next handler in the list */
656
657 handler_obj = handler_obj->address_space.next;
658 }
659 }
660
661 /* This node does not have the handler we need; Pop up one level */
662
663 node = node->parent;
664 }
665
666 /* If we get here, there is no handler for this region */
667
668 ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
669 "No handler for RegionType %s(%X) (RegionObj %p)\n",
670 acpi_ut_get_region_name(space_id), space_id,
671 region_obj));
672
673 return_ACPI_STATUS(AE_NOT_EXIST);
674}