1 /******************************************************************************
3 * Module Name: tbrsdt - ACPI RSDT table utilities
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2006, R. Byron Moore
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>
45 #include <acpi/actables.h>
47 #define _COMPONENT ACPI_TABLES
48 ACPI_MODULE_NAME("tbrsdt")
50 /*******************************************************************************
52 * FUNCTION: acpi_tb_verify_rsdp
54 * PARAMETERS: Address - RSDP (Pointer to RSDT)
58 * DESCRIPTION: Load and validate the RSDP (ptr) and RSDT (table)
60 ******************************************************************************/
61 acpi_status
acpi_tb_verify_rsdp(struct acpi_pointer
*address
)
63 struct acpi_table_desc table_info
;
65 struct rsdp_descriptor
*rsdp
;
67 ACPI_FUNCTION_TRACE(tb_verify_rsdp
);
69 switch (address
->pointer_type
) {
70 case ACPI_LOGICAL_POINTER
:
72 rsdp
= address
->pointer
.logical
;
75 case ACPI_PHYSICAL_POINTER
:
77 * Obtain access to the RSDP structure
79 status
= acpi_os_map_memory(address
->pointer
.physical
,
80 sizeof(struct rsdp_descriptor
),
81 ACPI_CAST_PTR(void, &rsdp
));
82 if (ACPI_FAILURE(status
)) {
83 return_ACPI_STATUS(status
);
88 return_ACPI_STATUS(AE_BAD_PARAMETER
);
91 /* Verify RSDP signature and checksum */
93 status
= acpi_tb_validate_rsdp(rsdp
);
94 if (ACPI_FAILURE(status
)) {
98 /* RSDP is ok. Init the table info */
100 table_info
.pointer
= ACPI_CAST_PTR(struct acpi_table_header
, rsdp
);
101 table_info
.length
= sizeof(struct rsdp_descriptor
);
103 if (address
->pointer_type
== ACPI_PHYSICAL_POINTER
) {
104 table_info
.allocation
= ACPI_MEM_MAPPED
;
106 table_info
.allocation
= ACPI_MEM_NOT_ALLOCATED
;
109 /* Save the table pointers and allocation info */
111 status
= acpi_tb_init_table_descriptor(ACPI_TABLE_ID_RSDP
, &table_info
);
112 if (ACPI_FAILURE(status
)) {
116 /* Save the RSDP in a global for easy access */
119 ACPI_CAST_PTR(struct rsdp_descriptor
, table_info
.pointer
);
120 return_ACPI_STATUS(status
);
125 if (acpi_gbl_table_flags
& ACPI_PHYSICAL_POINTER
) {
126 acpi_os_unmap_memory(rsdp
, sizeof(struct rsdp_descriptor
));
128 return_ACPI_STATUS(status
);
131 /*******************************************************************************
133 * FUNCTION: acpi_tb_get_rsdt_address
135 * PARAMETERS: out_address - Where the address is returned
137 * RETURN: None, Address
139 * DESCRIPTION: Extract the address of either the RSDT or XSDT, depending on the
140 * version of the RSDP and whether the XSDT pointer is valid
142 ******************************************************************************/
144 void acpi_tb_get_rsdt_address(struct acpi_pointer
*out_address
)
147 ACPI_FUNCTION_ENTRY();
149 out_address
->pointer_type
=
150 acpi_gbl_table_flags
| ACPI_LOGICAL_ADDRESSING
;
152 /* Use XSDT if it is present */
154 if ((acpi_gbl_RSDP
->revision
>= 2) &&
155 acpi_gbl_RSDP
->xsdt_physical_address
) {
156 out_address
->pointer
.value
=
157 acpi_gbl_RSDP
->xsdt_physical_address
;
158 acpi_gbl_root_table_type
= ACPI_TABLE_TYPE_XSDT
;
160 /* No XSDT, use the RSDT */
162 out_address
->pointer
.value
=
163 acpi_gbl_RSDP
->rsdt_physical_address
;
164 acpi_gbl_root_table_type
= ACPI_TABLE_TYPE_RSDT
;
168 /*******************************************************************************
170 * FUNCTION: acpi_tb_validate_rsdt
172 * PARAMETERS: table_ptr - Addressable pointer to the RSDT.
176 * DESCRIPTION: Validate signature for the RSDT or XSDT
178 ******************************************************************************/
180 acpi_status
acpi_tb_validate_rsdt(struct acpi_table_header
*table_ptr
)
184 ACPI_FUNCTION_ENTRY();
186 /* Search for appropriate signature, RSDT or XSDT */
188 if (acpi_gbl_root_table_type
== ACPI_TABLE_TYPE_RSDT
) {
189 signature
= RSDT_SIG
;
191 signature
= XSDT_SIG
;
194 if (!ACPI_COMPARE_NAME(table_ptr
->signature
, signature
)) {
196 /* Invalid RSDT or XSDT signature */
199 "Invalid signature where RSDP indicates RSDT/XSDT should be located. RSDP:"));
201 ACPI_DUMP_BUFFER(acpi_gbl_RSDP
, 20);
204 "RSDT/XSDT signature at %X is invalid",
205 acpi_gbl_RSDP
->rsdt_physical_address
));
207 if (acpi_gbl_root_table_type
== ACPI_TABLE_TYPE_RSDT
) {
208 ACPI_ERROR((AE_INFO
, "Looking for RSDT"));
210 ACPI_ERROR((AE_INFO
, "Looking for XSDT"));
213 ACPI_DUMP_BUFFER((char *)table_ptr
, 48);
214 return (AE_BAD_SIGNATURE
);
220 /*******************************************************************************
222 * FUNCTION: acpi_tb_get_table_rsdt
228 * DESCRIPTION: Load and validate the RSDP (ptr) and RSDT (table)
230 ******************************************************************************/
232 acpi_status
acpi_tb_get_table_rsdt(void)
234 struct acpi_table_desc table_info
;
236 struct acpi_pointer address
;
238 ACPI_FUNCTION_TRACE(tb_get_table_rsdt
);
240 /* Get the RSDT/XSDT via the RSDP */
242 acpi_tb_get_rsdt_address(&address
);
244 table_info
.type
= ACPI_TABLE_ID_XSDT
;
245 status
= acpi_tb_get_table(&address
, &table_info
);
246 if (ACPI_FAILURE(status
)) {
247 ACPI_EXCEPTION((AE_INFO
, status
,
248 "Could not get the RSDT/XSDT"));
249 return_ACPI_STATUS(status
);
252 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
253 "RSDP located at %p, points to RSDT physical=%8.8X%8.8X\n",
255 ACPI_FORMAT_UINT64(address
.pointer
.value
)));
257 /* Check the RSDT or XSDT signature */
259 status
= acpi_tb_validate_rsdt(table_info
.pointer
);
260 if (ACPI_FAILURE(status
)) {
261 return_ACPI_STATUS(status
);
264 /* Get the number of tables defined in the RSDT or XSDT */
266 acpi_gbl_rsdt_table_count
= acpi_tb_get_table_count(acpi_gbl_RSDP
,
269 /* Convert and/or copy to an XSDT structure */
271 status
= acpi_tb_convert_to_xsdt(&table_info
);
272 if (ACPI_FAILURE(status
)) {
273 return_ACPI_STATUS(status
);
276 /* Save the table pointers and allocation info */
278 status
= acpi_tb_init_table_descriptor(ACPI_TABLE_ID_XSDT
, &table_info
);
279 if (ACPI_FAILURE(status
)) {
280 return_ACPI_STATUS(status
);
284 ACPI_CAST_PTR(struct xsdt_descriptor
, table_info
.pointer
);
286 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "XSDT located at %p\n", acpi_gbl_XSDT
));
287 return_ACPI_STATUS(status
);