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()
165 		if (region_obj->region.space_id == ACPI_ADR_SPACE_PLATFORM_COMM) {  in acpi_ev_address_space_dispatch()
171 			ctx->length = (u16)region_obj->region.length;  in acpi_ev_address_space_dispatch()
172 			ctx->subspace_id = (u8)region_obj->region.address;  in acpi_ev_address_space_dispatch()
176 		 * We must exit the interpreter because the region setup will  in acpi_ev_address_space_dispatch()
178 		 * for this region)  in acpi_ev_address_space_dispatch()
189 		/* Check for failure of the Region Setup */  in acpi_ev_address_space_dispatch()
193 					"During region initialization: [%s]",  in acpi_ev_address_space_dispatch()
195 								region.  in acpi_ev_address_space_dispatch()
200 		/* Region initialization may have been completed by region_setup */  in acpi_ev_address_space_dispatch()
202 		if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE)) {  in acpi_ev_address_space_dispatch()
203 			region_obj->region.flags |= AOPOBJ_SETUP_COMPLETE;  in acpi_ev_address_space_dispatch()
207 			 * the handler for this particular region  in acpi_ev_address_space_dispatch()
219 	address = (region_obj->region.address + region_offset);  in acpi_ev_address_space_dispatch()
223 			  &region_obj->region.handler->address_space, handler,  in acpi_ev_address_space_dispatch()
225 			  acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
257 	if ((region_obj->region.space_id == ACPI_ADR_SPACE_GSBUS ||  in acpi_ev_address_space_dispatch()
258 	     region_obj->region.space_id == ACPI_ADR_SPACE_GPIO) &&  in acpi_ev_address_space_dispatch()
275 		if (region_obj->region.space_id == ACPI_ADR_SPACE_GPIO) {  in acpi_ev_address_space_dispatch()
292 				acpi_ut_get_region_name(region_obj->region.  in acpi_ev_address_space_dispatch()
299 		if ((region_obj->region.space_id == ACPI_ADR_SPACE_EC) &&  in acpi_ev_address_space_dispatch()
323  * PARAMETERS:  region_obj          - Region Object
324  *              acpi_ns_is_locked   - Namespace Region Already Locked?
328  * DESCRIPTION: Break the association between the handler and the region
354 	/* Get the address handler from the region object */  in acpi_ev_detach_region()
356 	handler_obj = region_obj->region.handler;  in acpi_ev_detach_region()
359 		/* This region has no handler, all done */  in acpi_ev_detach_region()
364 	/* Find this region in the handler's list */  in acpi_ev_detach_region()
372 		/* Is this the correct Region? */  in acpi_ev_detach_region()
376 					  "Removing Region %p from address handler %p\n",  in acpi_ev_detach_region()
381 			*last_obj_ptr = obj_desc->region.next;  in acpi_ev_detach_region()
382 			obj_desc->region.next = NULL;	/* Must clear field */  in acpi_ev_detach_region()
392 			/* Now stop region accesses by executing the _REG method */  in acpi_ev_detach_region()
399 						"from region _REG, [%s]",  in acpi_ev_detach_region()
401 						(region_obj->region.space_id)));  in acpi_ev_detach_region()
413 			 * If the region has been activated, call the setup handler with  in acpi_ev_detach_region()
416 			if (region_obj->region.flags & AOPOBJ_SETUP_COMPLETE) {  in acpi_ev_detach_region()
436 							"from region handler - deactivate, [%s]",  in acpi_ev_detach_region()
438 							(region_obj->region.  in acpi_ev_detach_region()
442 				region_obj->region.flags &=  in acpi_ev_detach_region()
447 			 * Remove handler reference in the region  in acpi_ev_detach_region()
449 			 * NOTE: this doesn't mean that the region goes away, the region  in acpi_ev_detach_region()
452 			 * If the region is on the handler's list, this must be the  in acpi_ev_detach_region()
453 			 * region's handler  in acpi_ev_detach_region()
455 			region_obj->region.handler = NULL;  in acpi_ev_detach_region()
463 		last_obj_ptr = &obj_desc->region.next;  in acpi_ev_detach_region()
464 		obj_desc = obj_desc->region.next;  in acpi_ev_detach_region()
470 				    "Circular handler list in region object %p",  in acpi_ev_detach_region()
476 	/* If we get here, the region was not in the handler's region list */  in acpi_ev_detach_region()
479 			  "Cannot remove region %p from address handler %p\n",  in acpi_ev_detach_region()
490  *              region_obj          - Region Object
491  *              acpi_ns_is_locked   - Namespace Region Already Locked?
495  * DESCRIPTION: Create the association between the handler and the region
508 	/* Install the region's handler */  in acpi_ev_attach_region()
510 	if (region_obj->region.handler) {  in acpi_ev_attach_region()
515 			  "Adding Region [%4.4s] %p to address handler %p [%s]\n",  in acpi_ev_attach_region()
516 			  acpi_ut_get_node_name(region_obj->region.node),  in acpi_ev_attach_region()
518 			  acpi_ut_get_region_name(region_obj->region.  in acpi_ev_attach_region()
521 	/* Link this region to the front of the handler's list */  in acpi_ev_attach_region()
523 	region_obj->region.next = handler_obj->address_space.region_list;  in acpi_ev_attach_region()
525 	region_obj->region.handler = handler_obj;  in acpi_ev_attach_region()
535  * PARAMETERS:  region_obj          - Region object
540  * DESCRIPTION: Execute _REG method for a region
559 	    region_obj->region.handler == NULL) {  in acpi_ev_execute_reg_method()
569 	 * Find any "_REG" method associated with this region definition.  in acpi_ev_execute_reg_method()
573 	node = region_obj->region.node->parent;  in acpi_ev_execute_reg_method()
580 		 * region definition. This will be executed when the handler is  in acpi_ev_execute_reg_method()
614 	 *  Operation region space ID Same value as region_obj->Region.space_id  in acpi_ev_execute_reg_method()
621 	    acpi_ut_create_integer_object((u64)region_obj->region.space_id);  in acpi_ev_execute_reg_method()
717 	 * no region.  in acpi_ev_execute_reg_methods()
737  * DESCRIPTION: Run _REG method for region objects of the requested spaceID
777 	/* Object is a Region */  in acpi_ev_reg_run()
779 	if (obj_desc->region.space_id != info->space_id) {  in acpi_ev_reg_run()
781 		/* This region is for a different address space, just ignore it */  in acpi_ev_reg_run()
801  *              device. This is a _REG method that has no corresponding region
806  *              an actual Operation Region with the correct address space ID.
840 	 * Execute the _REG method only if there is no Operation Region in  in acpi_ev_execute_orphan_reg_method()
850 		    (next_node->object->region.space_id == space_id)) {  in acpi_ev_execute_orphan_reg_method()