1 /******************************************************************************
3 * Module Name: exregion - ACPI default op_region (address space) handlers
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2015, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
44 #include <acpi/acpi.h>
48 #define _COMPONENT ACPI_EXECUTER
49 ACPI_MODULE_NAME("exregion")
51 /*******************************************************************************
53 * FUNCTION: acpi_ex_system_memory_space_handler
55 * PARAMETERS: function - Read or Write operation
56 * address - Where in the space to read or write
57 * bit_width - Field width in bits (8, 16, or 32)
58 * value - Pointer to in or out value
59 * handler_context - Pointer to Handler's context
60 * region_context - Pointer to context specific to the
65 * DESCRIPTION: Handler for the System Memory address space (Op Region)
67 ******************************************************************************/
69 acpi_ex_system_memory_space_handler(u32 function
,
70 acpi_physical_address address
,
73 void *handler_context
, void *region_context
)
75 acpi_status status
= AE_OK
;
76 void *logical_addr_ptr
= NULL
;
77 struct acpi_mem_space_context
*mem_info
= region_context
;
80 acpi_size page_boundary_map_length
;
81 #ifdef ACPI_MISALIGNMENT_NOT_SUPPORTED
85 ACPI_FUNCTION_TRACE(ex_system_memory_space_handler
);
87 /* Validate and translate the bit width */
112 ACPI_ERROR((AE_INFO
, "Invalid SystemMemory width %u",
114 return_ACPI_STATUS(AE_AML_OPERAND_VALUE
);
117 #ifdef ACPI_MISALIGNMENT_NOT_SUPPORTED
119 * Hardware does not support non-aligned data transfers, we must verify
122 (void)acpi_ut_short_divide((u64
) address
, length
, NULL
, &remainder
);
123 if (remainder
!= 0) {
124 return_ACPI_STATUS(AE_AML_ALIGNMENT
);
129 * Does the request fit into the cached memory mapping?
130 * Is 1) Address below the current mapping? OR
131 * 2) Address beyond the current mapping?
133 if ((address
< mem_info
->mapped_physical_address
) ||
134 (((u64
) address
+ length
) > ((u64
)
135 mem_info
->mapped_physical_address
+
136 mem_info
->mapped_length
))) {
138 * The request cannot be resolved by the current memory mapping;
139 * Delete the existing mapping and create a new one.
141 if (mem_info
->mapped_length
) {
143 /* Valid mapping, delete it */
145 acpi_os_unmap_memory(mem_info
->mapped_logical_address
,
146 mem_info
->mapped_length
);
150 * October 2009: Attempt to map from the requested address to the
151 * end of the region. However, we will never map more than one
152 * page, nor will we cross a page boundary.
154 map_length
= (acpi_size
)
155 ((mem_info
->address
+ mem_info
->length
) - address
);
158 * If mapping the entire remaining portion of the region will cross
159 * a page boundary, just map up to the page boundary, do not cross.
160 * On some systems, crossing a page boundary while mapping regions
161 * can cause warnings if the pages have different attributes
162 * due to resource management.
164 * This has the added benefit of constraining a single mapping to
165 * one page, which is similar to the original code that used a 4k
168 page_boundary_map_length
= (acpi_size
)
169 (ACPI_ROUND_UP(address
, ACPI_DEFAULT_PAGE_SIZE
) - address
);
170 if (page_boundary_map_length
== 0) {
171 page_boundary_map_length
= ACPI_DEFAULT_PAGE_SIZE
;
174 if (map_length
> page_boundary_map_length
) {
175 map_length
= page_boundary_map_length
;
178 /* Create a new mapping starting at the address given */
180 mem_info
->mapped_logical_address
=
181 acpi_os_map_memory(address
, map_length
);
182 if (!mem_info
->mapped_logical_address
) {
184 "Could not map memory at 0x%8.8X%8.8X, size %u",
185 ACPI_FORMAT_UINT64(address
),
187 mem_info
->mapped_length
= 0;
188 return_ACPI_STATUS(AE_NO_MEMORY
);
191 /* Save the physical address and mapping size */
193 mem_info
->mapped_physical_address
= address
;
194 mem_info
->mapped_length
= map_length
;
198 * Generate a logical pointer corresponding to the address we want to
201 logical_addr_ptr
= mem_info
->mapped_logical_address
+
202 ((u64
) address
- (u64
) mem_info
->mapped_physical_address
);
204 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
205 "System-Memory (width %u) R/W %u Address=%8.8X%8.8X\n",
206 bit_width
, function
, ACPI_FORMAT_UINT64(address
)));
209 * Perform the memory read or write
211 * Note: For machines that do not support non-aligned transfers, the target
212 * address was checked for alignment above. We do not attempt to break the
213 * transfer up into smaller (byte-size) chunks because the AML specifically
214 * asked for a transfer width that the hardware may require.
223 *value
= (u64
)ACPI_GET8(logical_addr_ptr
);
228 *value
= (u64
)ACPI_GET16(logical_addr_ptr
);
233 *value
= (u64
)ACPI_GET32(logical_addr_ptr
);
238 *value
= (u64
)ACPI_GET64(logical_addr_ptr
);
243 /* bit_width was already validated */
254 ACPI_SET8(logical_addr_ptr
, *value
);
259 ACPI_SET16(logical_addr_ptr
, *value
);
264 ACPI_SET32(logical_addr_ptr
, *value
);
269 ACPI_SET64(logical_addr_ptr
, *value
);
274 /* bit_width was already validated */
282 status
= AE_BAD_PARAMETER
;
286 return_ACPI_STATUS(status
);
289 /*******************************************************************************
291 * FUNCTION: acpi_ex_system_io_space_handler
293 * PARAMETERS: function - Read or Write operation
294 * address - Where in the space to read or write
295 * bit_width - Field width in bits (8, 16, or 32)
296 * value - Pointer to in or out value
297 * handler_context - Pointer to Handler's context
298 * region_context - Pointer to context specific to the
303 * DESCRIPTION: Handler for the System IO address space (Op Region)
305 ******************************************************************************/
308 acpi_ex_system_io_space_handler(u32 function
,
309 acpi_physical_address address
,
312 void *handler_context
, void *region_context
)
314 acpi_status status
= AE_OK
;
317 ACPI_FUNCTION_TRACE(ex_system_io_space_handler
);
319 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
320 "System-IO (width %u) R/W %u Address=%8.8X%8.8X\n",
321 bit_width
, function
, ACPI_FORMAT_UINT64(address
)));
323 /* Decode the function parameter */
328 status
= acpi_hw_read_port((acpi_io_address
) address
,
329 &value32
, bit_width
);
335 status
= acpi_hw_write_port((acpi_io_address
) address
,
336 (u32
) * value
, bit_width
);
341 status
= AE_BAD_PARAMETER
;
345 return_ACPI_STATUS(status
);
348 /*******************************************************************************
350 * FUNCTION: acpi_ex_pci_config_space_handler
352 * PARAMETERS: function - Read or Write operation
353 * address - Where in the space to read or write
354 * bit_width - Field width in bits (8, 16, or 32)
355 * value - Pointer to in or out value
356 * handler_context - Pointer to Handler's context
357 * region_context - Pointer to context specific to the
362 * DESCRIPTION: Handler for the PCI Config address space (Op Region)
364 ******************************************************************************/
367 acpi_ex_pci_config_space_handler(u32 function
,
368 acpi_physical_address address
,
371 void *handler_context
, void *region_context
)
373 acpi_status status
= AE_OK
;
374 struct acpi_pci_id
*pci_id
;
377 ACPI_FUNCTION_TRACE(ex_pci_config_space_handler
);
380 * The arguments to acpi_os(Read|Write)pci_configuration are:
382 * pci_segment is the PCI bus segment range 0-31
383 * pci_bus is the PCI bus number range 0-255
384 * pci_device is the PCI device number range 0-31
385 * pci_function is the PCI device function number
386 * pci_register is the Config space register range 0-255 bytes
388 * value - input value for write, output address for read
391 pci_id
= (struct acpi_pci_id
*)region_context
;
392 pci_register
= (u16
) (u32
) address
;
394 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
395 "Pci-Config %u (%u) Seg(%04x) Bus(%04x) Dev(%04x) Func(%04x) Reg(%04x)\n",
396 function
, bit_width
, pci_id
->segment
, pci_id
->bus
,
397 pci_id
->device
, pci_id
->function
, pci_register
));
403 status
= acpi_os_read_pci_configuration(pci_id
, pci_register
,
409 status
= acpi_os_write_pci_configuration(pci_id
, pci_register
,
415 status
= AE_BAD_PARAMETER
;
419 return_ACPI_STATUS(status
);
422 /*******************************************************************************
424 * FUNCTION: acpi_ex_cmos_space_handler
426 * PARAMETERS: function - Read or Write operation
427 * address - Where in the space to read or write
428 * bit_width - Field width in bits (8, 16, or 32)
429 * value - Pointer to in or out value
430 * handler_context - Pointer to Handler's context
431 * region_context - Pointer to context specific to the
436 * DESCRIPTION: Handler for the CMOS address space (Op Region)
438 ******************************************************************************/
441 acpi_ex_cmos_space_handler(u32 function
,
442 acpi_physical_address address
,
445 void *handler_context
, void *region_context
)
447 acpi_status status
= AE_OK
;
449 ACPI_FUNCTION_TRACE(ex_cmos_space_handler
);
451 return_ACPI_STATUS(status
);
454 /*******************************************************************************
456 * FUNCTION: acpi_ex_pci_bar_space_handler
458 * PARAMETERS: function - Read or Write operation
459 * address - Where in the space to read or write
460 * bit_width - Field width in bits (8, 16, or 32)
461 * value - Pointer to in or out value
462 * handler_context - Pointer to Handler's context
463 * region_context - Pointer to context specific to the
468 * DESCRIPTION: Handler for the PCI bar_target address space (Op Region)
470 ******************************************************************************/
473 acpi_ex_pci_bar_space_handler(u32 function
,
474 acpi_physical_address address
,
477 void *handler_context
, void *region_context
)
479 acpi_status status
= AE_OK
;
481 ACPI_FUNCTION_TRACE(ex_pci_bar_space_handler
);
483 return_ACPI_STATUS(status
);
486 /*******************************************************************************
488 * FUNCTION: acpi_ex_data_table_space_handler
490 * PARAMETERS: function - Read or Write operation
491 * address - Where in the space to read or write
492 * bit_width - Field width in bits (8, 16, or 32)
493 * value - Pointer to in or out value
494 * handler_context - Pointer to Handler's context
495 * region_context - Pointer to context specific to the
500 * DESCRIPTION: Handler for the Data Table address space (Op Region)
502 ******************************************************************************/
505 acpi_ex_data_table_space_handler(u32 function
,
506 acpi_physical_address address
,
509 void *handler_context
, void *region_context
)
511 ACPI_FUNCTION_TRACE(ex_data_table_space_handler
);
514 * Perform the memory read or write. The bit_width was already
520 memcpy(ACPI_CAST_PTR(char, value
),
521 ACPI_PHYSADDR_TO_PTR(address
), ACPI_DIV_8(bit_width
));
526 memcpy(ACPI_PHYSADDR_TO_PTR(address
),
527 ACPI_CAST_PTR(char, value
), ACPI_DIV_8(bit_width
));
532 return_ACPI_STATUS(AE_BAD_PARAMETER
);
535 return_ACPI_STATUS(AE_OK
);