4  * Module Name: evregion - Operation Region support
40  *              an installed default region handler.
81  * PARAMETERS:  region_obj          - Internal region object
84  *              region_offset       - Where in the region to read or write
91  * DESCRIPTION: Dispatch an address space or operation region access to
94  * NOTE: During early initialization, we always install the default region
96  * region address spaces are always available as per the ACPI specification.
126 	/* Ensure that there is a handler associated with this region */  in acpi_ev_address_space_dispatch()
128 	handler_desc = region_obj->region.handler;  in acpi_ev_address_space_dispatch()
131 			    "No handler for Region [%4.4s] (%p) [%s]",  in acpi_ev_address_space_dispatch()
132 			    acpi_ut_get_node_name(region_obj->region.node),  in acpi_ev_address_space_dispatch()
134 			    acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
145 	 * It may be the case that the region has never been initialized.  in acpi_ev_address_space_dispatch()
148 	if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {  in acpi_ev_address_space_dispatch()
150 		/* This region has not been initialized yet, do it */  in acpi_ev_address_space_dispatch()
158 				    "No init routine for region(%p) [%s]",  in acpi_ev_address_space_dispatch()
160 				    acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
166 		 * We must exit the interpreter because the region setup will  in acpi_ev_address_space_dispatch()
168 		 * for this region)  in acpi_ev_address_space_dispatch()
179 		/* Check for failure of the Region Setup */  in acpi_ev_address_space_dispatch()
183 					"During region initialization: [%s]",  in acpi_ev_address_space_dispatch()
185 								region.  in acpi_ev_address_space_dispatch()
190 		/* Region initialization may have been completed by region_setup */  in acpi_ev_address_space_dispatch()
192 		if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {  in acpi_ev_address_space_dispatch()
193 			region_obj->region.flags |= AOPOBJ_SETUP_COMPLETE;  in acpi_ev_address_space_dispatch()
197 			 * the handler for this particular region  in acpi_ev_address_space_dispatch()
209 	address = (region_obj->region.address + region_offset);  in acpi_ev_address_space_dispatch()
213 			  &region_obj->region.handler->address_space, handler,  in acpi_ev_address_space_dispatch()
215 			  acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
247 	if ((region_obj->region.space_id == ACPI_ADR_SPACE_GSBUS ||  in acpi_ev_address_space_dispatch()
248 	     region_obj->region.space_id == ACPI_ADR_SPACE_GPIO) &&  in acpi_ev_address_space_dispatch()
265 		if (region_obj->region.space_id == ACPI_ADR_SPACE_GPIO) {  in acpi_ev_address_space_dispatch()
282 				acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
289 		if ((region_obj->region.space_id == ACPI_ADR_SPACE_EC) &&  in acpi_ev_address_space_dispatch()
313  * PARAMETERS:  region_obj          - Region Object
314  *              acpi_ns_is_locked   - Namespace Region Already Locked?
318  * DESCRIPTION: Break the association between the handler and the region
344 	/* Get the address handler from the region object */  in acpi_ev_detach_region()
346 	handler_obj = region_obj->region.handler;  in acpi_ev_detach_region()
349 		/* This region has no handler, all done */  in acpi_ev_detach_region()
354 	/* Find this region in the handler's list */  in acpi_ev_detach_region()
362 		/* Is this the correct Region? */  in acpi_ev_detach_region()
366 					  "Removing Region %p from address handler %p\n",  in acpi_ev_detach_region()
371 			*last_obj_ptr = obj_desc->region.next;  in acpi_ev_detach_region()
372 			obj_desc->region.next = NULL;	/* Must clear field */  in acpi_ev_detach_region()
382 			/* Now stop region accesses by executing the _REG method */  in acpi_ev_detach_region()
389 						"from region _REG, [%s]",  in acpi_ev_detach_region()
391 						(region_obj->region.space_id)));  in acpi_ev_detach_region()
403 			 * If the region has been activated, call the setup handler with  in acpi_ev_detach_region()
406 			if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {  in acpi_ev_detach_region()
426 							"from region handler - deactivate, [%s]",  in acpi_ev_detach_region()
428 							(region_obj->region.  in acpi_ev_detach_region()
432 				region_obj->region.flags &=  in acpi_ev_detach_region()
437 			 * Remove handler reference in the region  in acpi_ev_detach_region()
439 			 * NOTE: this doesn't mean that the region goes away, the region  in acpi_ev_detach_region()
442 			 * If the region is on the handler's list, this must be the  in acpi_ev_detach_region()
443 			 * region's handler  in acpi_ev_detach_region()
445 			region_obj->region.handler = NULL;  in acpi_ev_detach_region()
453 		last_obj_ptr = &obj_desc->region.next;  in acpi_ev_detach_region()
454 		obj_desc = obj_desc->region.next;  in acpi_ev_detach_region()
460 				    "Circular handler list in region object %p",  in acpi_ev_detach_region()
466 	/* If we get here, the region was not in the handler's region list */  in acpi_ev_detach_region()
469 			  "Cannot remove region %p from address handler %p\n",  in acpi_ev_detach_region()
480  *              region_obj          - Region Object
481  *              acpi_ns_is_locked   - Namespace Region Already Locked?
485  * DESCRIPTION: Create the association between the handler and the region
498 	/* Install the region's handler */  in acpi_ev_attach_region()
500 	if (region_obj->region.handler) {  in acpi_ev_attach_region()
505 			  "Adding Region [%4.4s] %p to address handler %p [%s]\n",  in acpi_ev_attach_region()
506 			  acpi_ut_get_node_name(region_obj->region.node),  in acpi_ev_attach_region()
508 			  acpi_ut_get_region_name(region_obj->region.  in acpi_ev_attach_region()
511 	/* Link this region to the front of the handler's list */  in acpi_ev_attach_region()
513 	region_obj->region.next = handler_obj->address_space.region_list;  in acpi_ev_attach_region()
515 	region_obj->region.handler = handler_obj;  in acpi_ev_attach_region()
525  * PARAMETERS:  region_obj          - Region object
530  * DESCRIPTION: Execute _REG method for a region
549 	    region_obj->region.handler == NULL) {  in acpi_ev_execute_reg_method()
559 	 * Find any "_REG" method associated with this region definition.  in acpi_ev_execute_reg_method()
563 	node = region_obj->region.node->parent;  in acpi_ev_execute_reg_method()
570 		 * region definition. This will be executed when the handler is  in acpi_ev_execute_reg_method()
604 	 *  Operation region space ID Same value as region_obj->Region.space_id  in acpi_ev_execute_reg_method()
611 	    acpi_ut_create_integer_object((u64)region_obj->region.space_id);  in acpi_ev_execute_reg_method()
707 	 * no region.  in acpi_ev_execute_reg_methods()
727  * DESCRIPTION: Run _REG method for region objects of the requested spaceID
767 	/* Object is a Region */  in acpi_ev_reg_run()
769 	if (obj_desc->region.space_id != info->space_id) {  in acpi_ev_reg_run()
771 		/* This region is for a different address space, just ignore it */  in acpi_ev_reg_run()
791  *              device. This is a _REG method that has no corresponding region
796  *              an actual Operation Region with the correct address space ID.
830 	 * Execute the _REG method only if there is no Operation Region in  in acpi_ev_execute_orphan_reg_method()
840 		    (next_node->object->region.space_id == space_id)) {  in acpi_ev_execute_orphan_reg_method()