1/******************************************************************************
2 *
3 * Module Name: evregion - Operation Region support
4 *
5 *****************************************************************************/
6
7/*
8 * Copyright (C) 2000 - 2014, 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#include "acinterp.h"
49
50#define _COMPONENT          ACPI_EVENTS
51ACPI_MODULE_NAME("evregion")
52
53extern u8 acpi_gbl_default_address_spaces[];
54
55/* Local prototypes */
56
57static void
58acpi_ev_orphan_ec_reg_method(struct acpi_namespace_node *ec_device_node);
59
60static acpi_status
61acpi_ev_reg_run(acpi_handle obj_handle,
62		u32 level, void *context, void **return_value);
63
64/*******************************************************************************
65 *
66 * FUNCTION:    acpi_ev_initialize_op_regions
67 *
68 * PARAMETERS:  None
69 *
70 * RETURN:      Status
71 *
72 * DESCRIPTION: Execute _REG methods for all Operation Regions that have
73 *              an installed default region handler.
74 *
75 ******************************************************************************/
76
77acpi_status acpi_ev_initialize_op_regions(void)
78{
79	acpi_status status;
80	u32 i;
81
82	ACPI_FUNCTION_TRACE(ev_initialize_op_regions);
83
84	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
85	if (ACPI_FAILURE(status)) {
86		return_ACPI_STATUS(status);
87	}
88
89	/* Run the _REG methods for op_regions in each default address space */
90
91	for (i = 0; i < ACPI_NUM_DEFAULT_SPACES; i++) {
92		/*
93		 * Make sure the installed handler is the DEFAULT handler. If not the
94		 * default, the _REG methods will have already been run (when the
95		 * handler was installed)
96		 */
97		if (acpi_ev_has_default_handler(acpi_gbl_root_node,
98						acpi_gbl_default_address_spaces
99						[i])) {
100			status =
101			    acpi_ev_execute_reg_methods(acpi_gbl_root_node,
102							acpi_gbl_default_address_spaces
103							[i]);
104		}
105	}
106
107	acpi_gbl_reg_methods_executed = TRUE;
108
109	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
110	return_ACPI_STATUS(status);
111}
112
113/*******************************************************************************
114 *
115 * FUNCTION:    acpi_ev_address_space_dispatch
116 *
117 * PARAMETERS:  region_obj          - Internal region object
118 *              field_obj           - Corresponding field. Can be NULL.
119 *              function            - Read or Write operation
120 *              region_offset       - Where in the region to read or write
121 *              bit_width           - Field width in bits (8, 16, 32, or 64)
122 *              value               - Pointer to in or out value, must be
123 *                                    a full 64-bit integer
124 *
125 * RETURN:      Status
126 *
127 * DESCRIPTION: Dispatch an address space or operation region access to
128 *              a previously installed handler.
129 *
130 ******************************************************************************/
131
132acpi_status
133acpi_ev_address_space_dispatch(union acpi_operand_object *region_obj,
134			       union acpi_operand_object *field_obj,
135			       u32 function,
136			       u32 region_offset, u32 bit_width, u64 *value)
137{
138	acpi_status status;
139	acpi_adr_space_handler handler;
140	acpi_adr_space_setup region_setup;
141	union acpi_operand_object *handler_desc;
142	union acpi_operand_object *region_obj2;
143	void *region_context = NULL;
144	struct acpi_connection_info *context;
145	acpi_physical_address address;
146
147	ACPI_FUNCTION_TRACE(ev_address_space_dispatch);
148
149	region_obj2 = acpi_ns_get_secondary_object(region_obj);
150	if (!region_obj2) {
151		return_ACPI_STATUS(AE_NOT_EXIST);
152	}
153
154	/* Ensure that there is a handler associated with this region */
155
156	handler_desc = region_obj->region.handler;
157	if (!handler_desc) {
158		ACPI_ERROR((AE_INFO,
159			    "No handler for Region [%4.4s] (%p) [%s]",
160			    acpi_ut_get_node_name(region_obj->region.node),
161			    region_obj,
162			    acpi_ut_get_region_name(region_obj->region.
163						    space_id)));
164
165		return_ACPI_STATUS(AE_NOT_EXIST);
166	}
167
168	context = handler_desc->address_space.context;
169
170	/*
171	 * It may be the case that the region has never been initialized.
172	 * Some types of regions require special init code
173	 */
174	if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {
175
176		/* This region has not been initialized yet, do it */
177
178		region_setup = handler_desc->address_space.setup;
179		if (!region_setup) {
180
181			/* No initialization routine, exit with error */
182
183			ACPI_ERROR((AE_INFO,
184				    "No init routine for region(%p) [%s]",
185				    region_obj,
186				    acpi_ut_get_region_name(region_obj->region.
187							    space_id)));
188			return_ACPI_STATUS(AE_NOT_EXIST);
189		}
190
191		/*
192		 * We must exit the interpreter because the region setup will
193		 * potentially execute control methods (for example, the _REG method
194		 * for this region)
195		 */
196		acpi_ex_exit_interpreter();
197
198		status = region_setup(region_obj, ACPI_REGION_ACTIVATE,
199				      context, &region_context);
200
201		/* Re-enter the interpreter */
202
203		acpi_ex_enter_interpreter();
204
205		/* Check for failure of the Region Setup */
206
207		if (ACPI_FAILURE(status)) {
208			ACPI_EXCEPTION((AE_INFO, status,
209					"During region initialization: [%s]",
210					acpi_ut_get_region_name(region_obj->
211								region.
212								space_id)));
213			return_ACPI_STATUS(status);
214		}
215
216		/* Region initialization may have been completed by region_setup */
217
218		if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {
219			region_obj->region.flags |= AOPOBJ_SETUP_COMPLETE;
220
221			/*
222			 * Save the returned context for use in all accesses to
223			 * the handler for this particular region
224			 */
225			if (!(region_obj2->extra.region_context)) {
226				region_obj2->extra.region_context =
227				    region_context;
228			}
229		}
230	}
231
232	/* We have everything we need, we can invoke the address space handler */
233
234	handler = handler_desc->address_space.handler;
235	address = (region_obj->region.address + region_offset);
236
237	/*
238	 * Special handling for generic_serial_bus and general_purpose_io:
239	 * There are three extra parameters that must be passed to the
240	 * handler via the context:
241	 *   1) Connection buffer, a resource template from Connection() op
242	 *   2) Length of the above buffer
243	 *   3) Actual access length from the access_as() op
244	 *
245	 * In addition, for general_purpose_io, the Address and bit_width fields
246	 * are defined as follows:
247	 *   1) Address is the pin number index of the field (bit offset from
248	 *      the previous Connection)
249	 *   2) bit_width is the actual bit length of the field (number of pins)
250	 */
251	if ((region_obj->region.space_id == ACPI_ADR_SPACE_GSBUS) &&
252	    context && field_obj) {
253
254		/* Get the Connection (resource_template) buffer */
255
256		context->connection = field_obj->field.resource_buffer;
257		context->length = field_obj->field.resource_length;
258		context->access_length = field_obj->field.access_length;
259	}
260	if ((region_obj->region.space_id == ACPI_ADR_SPACE_GPIO) &&
261	    context && field_obj) {
262
263		/* Get the Connection (resource_template) buffer */
264
265		context->connection = field_obj->field.resource_buffer;
266		context->length = field_obj->field.resource_length;
267		context->access_length = field_obj->field.access_length;
268		address = field_obj->field.pin_number_index;
269		bit_width = field_obj->field.bit_length;
270	}
271
272	ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
273			  "Handler %p (@%p) Address %8.8X%8.8X [%s]\n",
274			  &region_obj->region.handler->address_space, handler,
275			  ACPI_FORMAT_NATIVE_UINT(address),
276			  acpi_ut_get_region_name(region_obj->region.
277						  space_id)));
278
279	if (!(handler_desc->address_space.handler_flags &
280	      ACPI_ADDR_HANDLER_DEFAULT_INSTALLED)) {
281		/*
282		 * For handlers other than the default (supplied) handlers, we must
283		 * exit the interpreter because the handler *might* block -- we don't
284		 * know what it will do, so we can't hold the lock on the intepreter.
285		 */
286		acpi_ex_exit_interpreter();
287	}
288
289	/* Call the handler */
290
291	status = handler(function, address, bit_width, value, context,
292			 region_obj2->extra.region_context);
293
294	if (ACPI_FAILURE(status)) {
295		ACPI_EXCEPTION((AE_INFO, status, "Returned by Handler for [%s]",
296				acpi_ut_get_region_name(region_obj->region.
297							space_id)));
298	}
299
300	if (!(handler_desc->address_space.handler_flags &
301	      ACPI_ADDR_HANDLER_DEFAULT_INSTALLED)) {
302		/*
303		 * We just returned from a non-default handler, we must re-enter the
304		 * interpreter
305		 */
306		acpi_ex_enter_interpreter();
307	}
308
309	return_ACPI_STATUS(status);
310}
311
312/*******************************************************************************
313 *
314 * FUNCTION:    acpi_ev_detach_region
315 *
316 * PARAMETERS:  region_obj          - Region Object
317 *              acpi_ns_is_locked   - Namespace Region Already Locked?
318 *
319 * RETURN:      None
320 *
321 * DESCRIPTION: Break the association between the handler and the region
322 *              this is a two way association.
323 *
324 ******************************************************************************/
325
326void
327acpi_ev_detach_region(union acpi_operand_object *region_obj,
328		      u8 acpi_ns_is_locked)
329{
330	union acpi_operand_object *handler_obj;
331	union acpi_operand_object *obj_desc;
332	union acpi_operand_object *start_desc;
333	union acpi_operand_object **last_obj_ptr;
334	acpi_adr_space_setup region_setup;
335	void **region_context;
336	union acpi_operand_object *region_obj2;
337	acpi_status status;
338
339	ACPI_FUNCTION_TRACE(ev_detach_region);
340
341	region_obj2 = acpi_ns_get_secondary_object(region_obj);
342	if (!region_obj2) {
343		return_VOID;
344	}
345	region_context = &region_obj2->extra.region_context;
346
347	/* Get the address handler from the region object */
348
349	handler_obj = region_obj->region.handler;
350	if (!handler_obj) {
351
352		/* This region has no handler, all done */
353
354		return_VOID;
355	}
356
357	/* Find this region in the handler's list */
358
359	obj_desc = handler_obj->address_space.region_list;
360	start_desc = obj_desc;
361	last_obj_ptr = &handler_obj->address_space.region_list;
362
363	while (obj_desc) {
364
365		/* Is this the correct Region? */
366
367		if (obj_desc == region_obj) {
368			ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
369					  "Removing Region %p from address handler %p\n",
370					  region_obj, handler_obj));
371
372			/* This is it, remove it from the handler's list */
373
374			*last_obj_ptr = obj_desc->region.next;
375			obj_desc->region.next = NULL;	/* Must clear field */
376
377			if (acpi_ns_is_locked) {
378				status =
379				    acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
380				if (ACPI_FAILURE(status)) {
381					return_VOID;
382				}
383			}
384
385			/* Now stop region accesses by executing the _REG method */
386
387			status =
388			    acpi_ev_execute_reg_method(region_obj,
389						       ACPI_REG_DISCONNECT);
390			if (ACPI_FAILURE(status)) {
391				ACPI_EXCEPTION((AE_INFO, status,
392						"from region _REG, [%s]",
393						acpi_ut_get_region_name
394						(region_obj->region.space_id)));
395			}
396
397			if (acpi_ns_is_locked) {
398				status =
399				    acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
400				if (ACPI_FAILURE(status)) {
401					return_VOID;
402				}
403			}
404
405			/*
406			 * If the region has been activated, call the setup handler with
407			 * the deactivate notification
408			 */
409			if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {
410				region_setup = handler_obj->address_space.setup;
411				status =
412				    region_setup(region_obj,
413						 ACPI_REGION_DEACTIVATE,
414						 handler_obj->address_space.
415						 context, region_context);
416
417				/*
418				 * region_context should have been released by the deactivate
419				 * operation. We don't need access to it anymore here.
420				 */
421				if (region_context) {
422					*region_context = NULL;
423				}
424
425				/* Init routine may fail, Just ignore errors */
426
427				if (ACPI_FAILURE(status)) {
428					ACPI_EXCEPTION((AE_INFO, status,
429							"from region handler - deactivate, [%s]",
430							acpi_ut_get_region_name
431							(region_obj->region.
432							 space_id)));
433				}
434
435				region_obj->region.flags &=
436				    ~(AOPOBJ_SETUP_COMPLETE);
437			}
438
439			/*
440			 * Remove handler reference in the region
441			 *
442			 * NOTE: this doesn't mean that the region goes away, the region
443			 * is just inaccessible as indicated to the _REG method
444			 *
445			 * If the region is on the handler's list, this must be the
446			 * region's handler
447			 */
448			region_obj->region.handler = NULL;
449			acpi_ut_remove_reference(handler_obj);
450
451			return_VOID;
452		}
453
454		/* Walk the linked list of handlers */
455
456		last_obj_ptr = &obj_desc->region.next;
457		obj_desc = obj_desc->region.next;
458
459		/* Prevent infinite loop if list is corrupted */
460
461		if (obj_desc == start_desc) {
462			ACPI_ERROR((AE_INFO,
463				    "Circular handler list in region object %p",
464				    region_obj));
465			return_VOID;
466		}
467	}
468
469	/* If we get here, the region was not in the handler's region list */
470
471	ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
472			  "Cannot remove region %p from address handler %p\n",
473			  region_obj, handler_obj));
474
475	return_VOID;
476}
477
478/*******************************************************************************
479 *
480 * FUNCTION:    acpi_ev_attach_region
481 *
482 * PARAMETERS:  handler_obj         - Handler Object
483 *              region_obj          - Region Object
484 *              acpi_ns_is_locked   - Namespace Region Already Locked?
485 *
486 * RETURN:      None
487 *
488 * DESCRIPTION: Create the association between the handler and the region
489 *              this is a two way association.
490 *
491 ******************************************************************************/
492
493acpi_status
494acpi_ev_attach_region(union acpi_operand_object *handler_obj,
495		      union acpi_operand_object *region_obj,
496		      u8 acpi_ns_is_locked)
497{
498
499	ACPI_FUNCTION_TRACE(ev_attach_region);
500
501	ACPI_DEBUG_PRINT((ACPI_DB_OPREGION,
502			  "Adding Region [%4.4s] %p to address handler %p [%s]\n",
503			  acpi_ut_get_node_name(region_obj->region.node),
504			  region_obj, handler_obj,
505			  acpi_ut_get_region_name(region_obj->region.
506						  space_id)));
507
508	/* Link this region to the front of the handler's list */
509
510	region_obj->region.next = handler_obj->address_space.region_list;
511	handler_obj->address_space.region_list = region_obj;
512
513	/* Install the region's handler */
514
515	if (region_obj->region.handler) {
516		return_ACPI_STATUS(AE_ALREADY_EXISTS);
517	}
518
519	region_obj->region.handler = handler_obj;
520	acpi_ut_add_reference(handler_obj);
521
522	return_ACPI_STATUS(AE_OK);
523}
524
525/*******************************************************************************
526 *
527 * FUNCTION:    acpi_ev_execute_reg_method
528 *
529 * PARAMETERS:  region_obj          - Region object
530 *              function            - Passed to _REG: On (1) or Off (0)
531 *
532 * RETURN:      Status
533 *
534 * DESCRIPTION: Execute _REG method for a region
535 *
536 ******************************************************************************/
537
538acpi_status
539acpi_ev_execute_reg_method(union acpi_operand_object *region_obj, u32 function)
540{
541	struct acpi_evaluate_info *info;
542	union acpi_operand_object *args[3];
543	union acpi_operand_object *region_obj2;
544	acpi_status status;
545
546	ACPI_FUNCTION_TRACE(ev_execute_reg_method);
547
548	region_obj2 = acpi_ns_get_secondary_object(region_obj);
549	if (!region_obj2) {
550		return_ACPI_STATUS(AE_NOT_EXIST);
551	}
552
553	if (region_obj2->extra.method_REG == NULL) {
554		return_ACPI_STATUS(AE_OK);
555	}
556
557	/* Allocate and initialize the evaluation information block */
558
559	info = ACPI_ALLOCATE_ZEROED(sizeof(struct acpi_evaluate_info));
560	if (!info) {
561		return_ACPI_STATUS(AE_NO_MEMORY);
562	}
563
564	info->prefix_node = region_obj2->extra.method_REG;
565	info->relative_pathname = NULL;
566	info->parameters = args;
567	info->flags = ACPI_IGNORE_RETURN_VALUE;
568
569	/*
570	 * The _REG method has two arguments:
571	 *
572	 * arg0 - Integer:
573	 *  Operation region space ID Same value as region_obj->Region.space_id
574	 *
575	 * arg1 - Integer:
576	 *  connection status 1 for connecting the handler, 0 for disconnecting
577	 *  the handler (Passed as a parameter)
578	 */
579	args[0] =
580	    acpi_ut_create_integer_object((u64)region_obj->region.space_id);
581	if (!args[0]) {
582		status = AE_NO_MEMORY;
583		goto cleanup1;
584	}
585
586	args[1] = acpi_ut_create_integer_object((u64)function);
587	if (!args[1]) {
588		status = AE_NO_MEMORY;
589		goto cleanup2;
590	}
591
592	args[2] = NULL;		/* Terminate list */
593
594	/* Execute the method, no return value */
595
596	ACPI_DEBUG_EXEC(acpi_ut_display_init_pathname
597			(ACPI_TYPE_METHOD, info->prefix_node, NULL));
598
599	status = acpi_ns_evaluate(info);
600	acpi_ut_remove_reference(args[1]);
601
602cleanup2:
603	acpi_ut_remove_reference(args[0]);
604
605cleanup1:
606	ACPI_FREE(info);
607	return_ACPI_STATUS(status);
608}
609
610/*******************************************************************************
611 *
612 * FUNCTION:    acpi_ev_execute_reg_methods
613 *
614 * PARAMETERS:  node            - Namespace node for the device
615 *              space_id        - The address space ID
616 *
617 * RETURN:      Status
618 *
619 * DESCRIPTION: Run all _REG methods for the input Space ID;
620 *              Note: assumes namespace is locked, or system init time.
621 *
622 ******************************************************************************/
623
624acpi_status
625acpi_ev_execute_reg_methods(struct acpi_namespace_node *node,
626			    acpi_adr_space_type space_id)
627{
628	acpi_status status;
629
630	ACPI_FUNCTION_TRACE(ev_execute_reg_methods);
631
632	/*
633	 * Run all _REG methods for all Operation Regions for this space ID. This
634	 * is a separate walk in order to handle any interdependencies between
635	 * regions and _REG methods. (i.e. handlers must be installed for all
636	 * regions of this Space ID before we can run any _REG methods)
637	 */
638	status = acpi_ns_walk_namespace(ACPI_TYPE_ANY, node, ACPI_UINT32_MAX,
639					ACPI_NS_WALK_UNLOCK, acpi_ev_reg_run,
640					NULL, &space_id, NULL);
641
642	/* Special case for EC: handle "orphan" _REG methods with no region */
643
644	if (space_id == ACPI_ADR_SPACE_EC) {
645		acpi_ev_orphan_ec_reg_method(node);
646	}
647
648	return_ACPI_STATUS(status);
649}
650
651/*******************************************************************************
652 *
653 * FUNCTION:    acpi_ev_reg_run
654 *
655 * PARAMETERS:  walk_namespace callback
656 *
657 * DESCRIPTION: Run _REG method for region objects of the requested spaceID
658 *
659 ******************************************************************************/
660
661static acpi_status
662acpi_ev_reg_run(acpi_handle obj_handle,
663		u32 level, void *context, void **return_value)
664{
665	union acpi_operand_object *obj_desc;
666	struct acpi_namespace_node *node;
667	acpi_adr_space_type space_id;
668	acpi_status status;
669
670	space_id = *ACPI_CAST_PTR(acpi_adr_space_type, context);
671
672	/* Convert and validate the device handle */
673
674	node = acpi_ns_validate_handle(obj_handle);
675	if (!node) {
676		return (AE_BAD_PARAMETER);
677	}
678
679	/*
680	 * We only care about regions.and objects that are allowed to have address
681	 * space handlers
682	 */
683	if ((node->type != ACPI_TYPE_REGION) && (node != acpi_gbl_root_node)) {
684		return (AE_OK);
685	}
686
687	/* Check for an existing internal object */
688
689	obj_desc = acpi_ns_get_attached_object(node);
690	if (!obj_desc) {
691
692		/* No object, just exit */
693
694		return (AE_OK);
695	}
696
697	/* Object is a Region */
698
699	if (obj_desc->region.space_id != space_id) {
700
701		/* This region is for a different address space, just ignore it */
702
703		return (AE_OK);
704	}
705
706	status = acpi_ev_execute_reg_method(obj_desc, ACPI_REG_CONNECT);
707	return (status);
708}
709
710/*******************************************************************************
711 *
712 * FUNCTION:    acpi_ev_orphan_ec_reg_method
713 *
714 * PARAMETERS:  ec_device_node      - Namespace node for an EC device
715 *
716 * RETURN:      None
717 *
718 * DESCRIPTION: Execute an "orphan" _REG method that appears under the EC
719 *              device. This is a _REG method that has no corresponding region
720 *              within the EC device scope. The orphan _REG method appears to
721 *              have been enabled by the description of the ECDT in the ACPI
722 *              specification: "The availability of the region space can be
723 *              detected by providing a _REG method object underneath the
724 *              Embedded Controller device."
725 *
726 *              To quickly access the EC device, we use the ec_device_node used
727 *              during EC handler installation. Otherwise, we would need to
728 *              perform a time consuming namespace walk, executing _HID
729 *              methods to find the EC device.
730 *
731 *  MUTEX:      Assumes the namespace is locked
732 *
733 ******************************************************************************/
734
735static void
736acpi_ev_orphan_ec_reg_method(struct acpi_namespace_node *ec_device_node)
737{
738	acpi_handle reg_method;
739	struct acpi_namespace_node *next_node;
740	acpi_status status;
741	struct acpi_object_list args;
742	union acpi_object objects[2];
743
744	ACPI_FUNCTION_TRACE(ev_orphan_ec_reg_method);
745
746	if (!ec_device_node) {
747		return_VOID;
748	}
749
750	/* Namespace is currently locked, must release */
751
752	(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
753
754	/* Get a handle to a _REG method immediately under the EC device */
755
756	status = acpi_get_handle(ec_device_node, METHOD_NAME__REG, &reg_method);
757	if (ACPI_FAILURE(status)) {
758		goto exit;	/* There is no _REG method present */
759	}
760
761	/*
762	 * Execute the _REG method only if there is no Operation Region in
763	 * this scope with the Embedded Controller space ID. Otherwise, it
764	 * will already have been executed. Note, this allows for Regions
765	 * with other space IDs to be present; but the code below will then
766	 * execute the _REG method with the embedded_control space_ID argument.
767	 */
768	next_node = acpi_ns_get_next_node(ec_device_node, NULL);
769	while (next_node) {
770		if ((next_node->type == ACPI_TYPE_REGION) &&
771		    (next_node->object) &&
772		    (next_node->object->region.space_id == ACPI_ADR_SPACE_EC)) {
773			goto exit;	/* Do not execute the _REG */
774		}
775
776		next_node = acpi_ns_get_next_node(ec_device_node, next_node);
777	}
778
779	/* Evaluate the _REG(embedded_control,Connect) method */
780
781	args.count = 2;
782	args.pointer = objects;
783	objects[0].type = ACPI_TYPE_INTEGER;
784	objects[0].integer.value = ACPI_ADR_SPACE_EC;
785	objects[1].type = ACPI_TYPE_INTEGER;
786	objects[1].integer.value = ACPI_REG_CONNECT;
787
788	status = acpi_evaluate_object(reg_method, NULL, &args, NULL);
789
790exit:
791	/* We ignore all errors from above, don't care */
792
793	status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
794	return_VOID;
795}
796