4  * Module Name: evregion - Operation Region support
39  *              an installed default region handler.
80  * PARAMETERS:  region_obj          - Internal region object
83  *              region_offset       - Where in the region to read or write
90  * DESCRIPTION: Dispatch an address space or operation region access to
93  * NOTE: During early initialization, we always install the default region
95  * region address spaces are always available as per the ACPI specification.
123 	/* Ensure that there is a handler associated with this region */  in acpi_ev_address_space_dispatch()
125 	handler_desc = region_obj->region.handler;  in acpi_ev_address_space_dispatch()
128 			    "No handler for Region [%4.4s] (%p) [%s]",  in acpi_ev_address_space_dispatch()
129 			    acpi_ut_get_node_name(region_obj->region.node),  in acpi_ev_address_space_dispatch()
131 			    acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
140 	 * It may be the case that the region has never been initialized.  in acpi_ev_address_space_dispatch()
143 	if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {  in acpi_ev_address_space_dispatch()
145 		/* This region has not been initialized yet, do it */  in acpi_ev_address_space_dispatch()
153 				    "No init routine for region(%p) [%s]",  in acpi_ev_address_space_dispatch()
155 				    acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
161 		 * We must exit the interpreter because the region setup will  in acpi_ev_address_space_dispatch()
163 		 * for this region)  in acpi_ev_address_space_dispatch()
174 		/* Check for failure of the Region Setup */  in acpi_ev_address_space_dispatch()
178 					"During region initialization: [%s]",  in acpi_ev_address_space_dispatch()
180 								region.  in acpi_ev_address_space_dispatch()
185 		/* Region initialization may have been completed by region_setup */  in acpi_ev_address_space_dispatch()
187 		if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {  in acpi_ev_address_space_dispatch()
188 			region_obj->region.flags |= AOPOBJ_SETUP_COMPLETE;  in acpi_ev_address_space_dispatch()
192 			 * the handler for this particular region  in acpi_ev_address_space_dispatch()
204 	address = (region_obj->region.address + region_offset);  in acpi_ev_address_space_dispatch()
220 	if ((region_obj->region.space_id == ACPI_ADR_SPACE_GSBUS) &&  in acpi_ev_address_space_dispatch()
229 	if ((region_obj->region.space_id == ACPI_ADR_SPACE_GPIO) &&  in acpi_ev_address_space_dispatch()
243 			  &region_obj->region.handler->address_space, handler,  in acpi_ev_address_space_dispatch()
245 			  acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
265 				acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
272 		if ((region_obj->region.space_id == ACPI_ADR_SPACE_EC) &&  in acpi_ev_address_space_dispatch()
295  * PARAMETERS:  region_obj          - Region Object
296  *              acpi_ns_is_locked   - Namespace Region Already Locked?
300  * DESCRIPTION: Break the association between the handler and the region
326 	/* Get the address handler from the region object */  in acpi_ev_detach_region()
328 	handler_obj = region_obj->region.handler;  in acpi_ev_detach_region()
331 		/* This region has no handler, all done */  in acpi_ev_detach_region()
336 	/* Find this region in the handler's list */  in acpi_ev_detach_region()
344 		/* Is this the correct Region? */  in acpi_ev_detach_region()
348 					  "Removing Region %p from address handler %p\n",  in acpi_ev_detach_region()
353 			*last_obj_ptr = obj_desc->region.next;  in acpi_ev_detach_region()
354 			obj_desc->region.next = NULL;	/* Must clear field */  in acpi_ev_detach_region()
364 			/* Now stop region accesses by executing the _REG method */  in acpi_ev_detach_region()
371 						"from region _REG, [%s]",  in acpi_ev_detach_region()
373 						(region_obj->region.space_id)));  in acpi_ev_detach_region()
385 			 * If the region has been activated, call the setup handler with  in acpi_ev_detach_region()
388 			if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {  in acpi_ev_detach_region()
408 							"from region handler - deactivate, [%s]",  in acpi_ev_detach_region()
410 							(region_obj->region.  in acpi_ev_detach_region()
414 				region_obj->region.flags &=  in acpi_ev_detach_region()
419 			 * Remove handler reference in the region  in acpi_ev_detach_region()
421 			 * NOTE: this doesn't mean that the region goes away, the region  in acpi_ev_detach_region()
424 			 * If the region is on the handler's list, this must be the  in acpi_ev_detach_region()
425 			 * region's handler  in acpi_ev_detach_region()
427 			region_obj->region.handler = NULL;  in acpi_ev_detach_region()
435 		last_obj_ptr = &obj_desc->region.next;  in acpi_ev_detach_region()
436 		obj_desc = obj_desc->region.next;  in acpi_ev_detach_region()
442 				    "Circular handler list in region object %p",  in acpi_ev_detach_region()
448 	/* If we get here, the region was not in the handler's region list */  in acpi_ev_detach_region()
451 			  "Cannot remove region %p from address handler %p\n",  in acpi_ev_detach_region()
462  *              region_obj          - Region Object
463  *              acpi_ns_is_locked   - Namespace Region Already Locked?
467  * DESCRIPTION: Create the association between the handler and the region
480 	/* Install the region's handler */  in acpi_ev_attach_region()
482 	if (region_obj->region.handler) {  in acpi_ev_attach_region()
487 			  "Adding Region [%4.4s] %p to address handler %p [%s]\n",  in acpi_ev_attach_region()
488 			  acpi_ut_get_node_name(region_obj->region.node),  in acpi_ev_attach_region()
490 			  acpi_ut_get_region_name(region_obj->region.  in acpi_ev_attach_region()
493 	/* Link this region to the front of the handler's list */  in acpi_ev_attach_region()
495 	region_obj->region.next = handler_obj->address_space.region_list;  in acpi_ev_attach_region()
497 	region_obj->region.handler = handler_obj;  in acpi_ev_attach_region()
507  * PARAMETERS:  region_obj          - Region object
512  * DESCRIPTION: Execute _REG method for a region
531 	    region_obj->region.handler == NULL) {  in acpi_ev_execute_reg_method()
541 	 * Find any "_REG" method associated with this region definition.  in acpi_ev_execute_reg_method()
545 	node = region_obj->region.node->parent;  in acpi_ev_execute_reg_method()
552 		 * region definition. This will be executed when the handler is  in acpi_ev_execute_reg_method()
586 	 *  Operation region space ID Same value as region_obj->Region.space_id  in acpi_ev_execute_reg_method()
593 	    acpi_ut_create_integer_object((u64)region_obj->region.space_id);  in acpi_ev_execute_reg_method()
687 	/* Special case for EC: handle "orphan" _REG methods with no region */  in acpi_ev_execute_reg_methods()
707  * DESCRIPTION: Run _REG method for region objects of the requested spaceID
747 	/* Object is a Region */  in acpi_ev_reg_run()
749 	if (obj_desc->region.space_id != info->space_id) {  in acpi_ev_reg_run()
751 		/* This region is for a different address space, just ignore it */  in acpi_ev_reg_run()
770  *              device. This is a _REG method that has no corresponding region
773  *              specification: "The availability of the region space can be
813 	 * Execute the _REG method only if there is no Operation Region in  in acpi_ev_orphan_ec_reg_method()
823 		    (next_node->object->region.space_id == ACPI_ADR_SPACE_EC)) {  in acpi_ev_orphan_ec_reg_method()