1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /******************************************************************************
4 * Module Name: exregion - ACPI default op_region (address space) handlers
6 * Copyright (C) 2000 - 2018, Intel Corp.
8 *****************************************************************************/
10 #include <acpi/acpi.h>
14 #define _COMPONENT ACPI_EXECUTER
15 ACPI_MODULE_NAME("exregion")
17 /*******************************************************************************
19 * FUNCTION: acpi_ex_system_memory_space_handler
21 * PARAMETERS: function - Read or Write operation
22 * address - Where in the space to read or write
23 * bit_width - Field width in bits (8, 16, or 32)
24 * value - Pointer to in or out value
25 * handler_context - Pointer to Handler's context
26 * region_context - Pointer to context specific to the
31 * DESCRIPTION: Handler for the System Memory address space (Op Region)
33 ******************************************************************************/
35 acpi_ex_system_memory_space_handler(u32 function
,
36 acpi_physical_address address
,
39 void *handler_context
, void *region_context
)
41 acpi_status status
= AE_OK
;
42 void *logical_addr_ptr
= NULL
;
43 struct acpi_mem_space_context
*mem_info
= region_context
;
46 acpi_size page_boundary_map_length
;
47 #ifdef ACPI_MISALIGNMENT_NOT_SUPPORTED
51 ACPI_FUNCTION_TRACE(ex_system_memory_space_handler
);
53 /* Validate and translate the bit width */
78 ACPI_ERROR((AE_INFO
, "Invalid SystemMemory width %u",
80 return_ACPI_STATUS(AE_AML_OPERAND_VALUE
);
83 #ifdef ACPI_MISALIGNMENT_NOT_SUPPORTED
85 * Hardware does not support non-aligned data transfers, we must verify
88 (void)acpi_ut_short_divide((u64
) address
, length
, NULL
, &remainder
);
90 return_ACPI_STATUS(AE_AML_ALIGNMENT
);
95 * Does the request fit into the cached memory mapping?
96 * Is 1) Address below the current mapping? OR
97 * 2) Address beyond the current mapping?
99 if ((address
< mem_info
->mapped_physical_address
) ||
100 (((u64
) address
+ length
) > ((u64
)
101 mem_info
->mapped_physical_address
+
102 mem_info
->mapped_length
))) {
104 * The request cannot be resolved by the current memory mapping;
105 * Delete the existing mapping and create a new one.
107 if (mem_info
->mapped_length
) {
109 /* Valid mapping, delete it */
111 acpi_os_unmap_memory(mem_info
->mapped_logical_address
,
112 mem_info
->mapped_length
);
116 * October 2009: Attempt to map from the requested address to the
117 * end of the region. However, we will never map more than one
118 * page, nor will we cross a page boundary.
120 map_length
= (acpi_size
)
121 ((mem_info
->address
+ mem_info
->length
) - address
);
124 * If mapping the entire remaining portion of the region will cross
125 * a page boundary, just map up to the page boundary, do not cross.
126 * On some systems, crossing a page boundary while mapping regions
127 * can cause warnings if the pages have different attributes
128 * due to resource management.
130 * This has the added benefit of constraining a single mapping to
131 * one page, which is similar to the original code that used a 4k
134 page_boundary_map_length
= (acpi_size
)
135 (ACPI_ROUND_UP(address
, ACPI_DEFAULT_PAGE_SIZE
) - address
);
136 if (page_boundary_map_length
== 0) {
137 page_boundary_map_length
= ACPI_DEFAULT_PAGE_SIZE
;
140 if (map_length
> page_boundary_map_length
) {
141 map_length
= page_boundary_map_length
;
144 /* Create a new mapping starting at the address given */
146 mem_info
->mapped_logical_address
=
147 acpi_os_map_memory(address
, map_length
);
148 if (!mem_info
->mapped_logical_address
) {
150 "Could not map memory at 0x%8.8X%8.8X, size %u",
151 ACPI_FORMAT_UINT64(address
),
153 mem_info
->mapped_length
= 0;
154 return_ACPI_STATUS(AE_NO_MEMORY
);
157 /* Save the physical address and mapping size */
159 mem_info
->mapped_physical_address
= address
;
160 mem_info
->mapped_length
= map_length
;
164 * Generate a logical pointer corresponding to the address we want to
167 logical_addr_ptr
= mem_info
->mapped_logical_address
+
168 ((u64
) address
- (u64
) mem_info
->mapped_physical_address
);
170 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
171 "System-Memory (width %u) R/W %u Address=%8.8X%8.8X\n",
172 bit_width
, function
, ACPI_FORMAT_UINT64(address
)));
175 * Perform the memory read or write
177 * Note: For machines that do not support non-aligned transfers, the target
178 * address was checked for alignment above. We do not attempt to break the
179 * transfer up into smaller (byte-size) chunks because the AML specifically
180 * asked for a transfer width that the hardware may require.
189 *value
= (u64
)ACPI_GET8(logical_addr_ptr
);
194 *value
= (u64
)ACPI_GET16(logical_addr_ptr
);
199 *value
= (u64
)ACPI_GET32(logical_addr_ptr
);
204 *value
= (u64
)ACPI_GET64(logical_addr_ptr
);
209 /* bit_width was already validated */
220 ACPI_SET8(logical_addr_ptr
, *value
);
225 ACPI_SET16(logical_addr_ptr
, *value
);
230 ACPI_SET32(logical_addr_ptr
, *value
);
235 ACPI_SET64(logical_addr_ptr
, *value
);
240 /* bit_width was already validated */
248 status
= AE_BAD_PARAMETER
;
252 return_ACPI_STATUS(status
);
255 /*******************************************************************************
257 * FUNCTION: acpi_ex_system_io_space_handler
259 * PARAMETERS: function - Read or Write operation
260 * address - Where in the space to read or write
261 * bit_width - Field width in bits (8, 16, or 32)
262 * value - Pointer to in or out value
263 * handler_context - Pointer to Handler's context
264 * region_context - Pointer to context specific to the
269 * DESCRIPTION: Handler for the System IO address space (Op Region)
271 ******************************************************************************/
274 acpi_ex_system_io_space_handler(u32 function
,
275 acpi_physical_address address
,
278 void *handler_context
, void *region_context
)
280 acpi_status status
= AE_OK
;
283 ACPI_FUNCTION_TRACE(ex_system_io_space_handler
);
285 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
286 "System-IO (width %u) R/W %u Address=%8.8X%8.8X\n",
287 bit_width
, function
, ACPI_FORMAT_UINT64(address
)));
289 /* Decode the function parameter */
294 status
= acpi_hw_read_port((acpi_io_address
)address
,
295 &value32
, bit_width
);
301 status
= acpi_hw_write_port((acpi_io_address
)address
,
302 (u32
)*value
, bit_width
);
307 status
= AE_BAD_PARAMETER
;
311 return_ACPI_STATUS(status
);
314 /*******************************************************************************
316 * FUNCTION: acpi_ex_pci_config_space_handler
318 * PARAMETERS: function - Read or Write operation
319 * address - Where in the space to read or write
320 * bit_width - Field width in bits (8, 16, or 32)
321 * value - Pointer to in or out value
322 * handler_context - Pointer to Handler's context
323 * region_context - Pointer to context specific to the
328 * DESCRIPTION: Handler for the PCI Config address space (Op Region)
330 ******************************************************************************/
333 acpi_ex_pci_config_space_handler(u32 function
,
334 acpi_physical_address address
,
337 void *handler_context
, void *region_context
)
339 acpi_status status
= AE_OK
;
340 struct acpi_pci_id
*pci_id
;
343 ACPI_FUNCTION_TRACE(ex_pci_config_space_handler
);
346 * The arguments to acpi_os(Read|Write)pci_configuration are:
348 * pci_segment is the PCI bus segment range 0-31
349 * pci_bus is the PCI bus number range 0-255
350 * pci_device is the PCI device number range 0-31
351 * pci_function is the PCI device function number
352 * pci_register is the Config space register range 0-255 bytes
354 * value - input value for write, output address for read
357 pci_id
= (struct acpi_pci_id
*)region_context
;
358 pci_register
= (u16
) (u32
) address
;
360 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
361 "Pci-Config %u (%u) Seg(%04x) Bus(%04x) "
362 "Dev(%04x) Func(%04x) Reg(%04x)\n",
363 function
, bit_width
, pci_id
->segment
, pci_id
->bus
,
364 pci_id
->device
, pci_id
->function
, pci_register
));
371 acpi_os_read_pci_configuration(pci_id
, pci_register
, value
,
378 acpi_os_write_pci_configuration(pci_id
, pci_register
,
384 status
= AE_BAD_PARAMETER
;
388 return_ACPI_STATUS(status
);
391 /*******************************************************************************
393 * FUNCTION: acpi_ex_cmos_space_handler
395 * PARAMETERS: function - Read or Write operation
396 * address - Where in the space to read or write
397 * bit_width - Field width in bits (8, 16, or 32)
398 * value - Pointer to in or out value
399 * handler_context - Pointer to Handler's context
400 * region_context - Pointer to context specific to the
405 * DESCRIPTION: Handler for the CMOS address space (Op Region)
407 ******************************************************************************/
410 acpi_ex_cmos_space_handler(u32 function
,
411 acpi_physical_address address
,
414 void *handler_context
, void *region_context
)
416 acpi_status status
= AE_OK
;
418 ACPI_FUNCTION_TRACE(ex_cmos_space_handler
);
420 return_ACPI_STATUS(status
);
423 /*******************************************************************************
425 * FUNCTION: acpi_ex_pci_bar_space_handler
427 * PARAMETERS: function - Read or Write operation
428 * address - Where in the space to read or write
429 * bit_width - Field width in bits (8, 16, or 32)
430 * value - Pointer to in or out value
431 * handler_context - Pointer to Handler's context
432 * region_context - Pointer to context specific to the
437 * DESCRIPTION: Handler for the PCI bar_target address space (Op Region)
439 ******************************************************************************/
442 acpi_ex_pci_bar_space_handler(u32 function
,
443 acpi_physical_address address
,
446 void *handler_context
, void *region_context
)
448 acpi_status status
= AE_OK
;
450 ACPI_FUNCTION_TRACE(ex_pci_bar_space_handler
);
452 return_ACPI_STATUS(status
);
455 /*******************************************************************************
457 * FUNCTION: acpi_ex_data_table_space_handler
459 * PARAMETERS: function - Read or Write operation
460 * address - Where in the space to read or write
461 * bit_width - Field width in bits (8, 16, or 32)
462 * value - Pointer to in or out value
463 * handler_context - Pointer to Handler's context
464 * region_context - Pointer to context specific to the
469 * DESCRIPTION: Handler for the Data Table address space (Op Region)
471 ******************************************************************************/
474 acpi_ex_data_table_space_handler(u32 function
,
475 acpi_physical_address address
,
478 void *handler_context
, void *region_context
)
480 ACPI_FUNCTION_TRACE(ex_data_table_space_handler
);
483 * Perform the memory read or write. The bit_width was already
489 memcpy(ACPI_CAST_PTR(char, value
),
490 ACPI_PHYSADDR_TO_PTR(address
), ACPI_DIV_8(bit_width
));
495 memcpy(ACPI_PHYSADDR_TO_PTR(address
),
496 ACPI_CAST_PTR(char, value
), ACPI_DIV_8(bit_width
));
501 return_ACPI_STATUS(AE_BAD_PARAMETER
);
504 return_ACPI_STATUS(AE_OK
);