1 /*******************************************************************************
3 * Module Name: rsmisc - Miscellaneous resource descriptors
5 ******************************************************************************/
8 * Copyright (C) 2000 - 2005, 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/acresrc.h>
47 #define _COMPONENT ACPI_RESOURCES
48 ACPI_MODULE_NAME("rsmisc")
50 #define INIT_RESOURCE_TYPE(i) i->resource_offset
51 #define INIT_RESOURCE_LENGTH(i) i->aml_offset
52 #define INIT_TABLE_LENGTH(i) i->value
53 #define COMPARE_OPCODE(i) i->resource_offset
54 #define COMPARE_TARGET(i) i->aml_offset
55 #define COMPARE_VALUE(i) i->value
56 /*******************************************************************************
58 * FUNCTION: acpi_rs_convert_aml_to_resource
60 * PARAMETERS: Resource - Pointer to the resource descriptor
61 * Aml - Where the AML descriptor is returned
62 * Info - Pointer to appropriate conversion table
66 * DESCRIPTION: Convert an external AML resource descriptor to the corresponding
67 * internal resource descriptor
69 ******************************************************************************/
71 acpi_rs_convert_aml_to_resource(struct acpi_resource
*resource
,
72 union aml_resource
*aml
,
73 struct acpi_rsconvert_info
*info
)
75 acpi_rs_length aml_resource_length
;
80 u8 flags_mode
= FALSE
;
84 ACPI_FUNCTION_TRACE("rs_get_resource");
86 if (((acpi_native_uint
) resource
) & 0x3) {
88 ("**** GET: Misaligned resource pointer: %p Type %2.2X Len %X\n",
89 resource
, resource
->type
, resource
->length
);
92 /* Extract the resource Length field (does not include header length) */
94 aml_resource_length
= acpi_ut_get_resource_length(aml
);
97 * First table entry must be ACPI_RSC_INITxxx and must contain the
98 * table length (# of table entries)
100 count
= INIT_TABLE_LENGTH(info
);
104 * Source is the external AML byte stream buffer,
105 * destination is the internal resource descriptor
107 source
= ((u8
*) aml
) + info
->aml_offset
;
108 destination
= ((u8
*) resource
) + info
->resource_offset
;
110 switch (info
->opcode
) {
111 case ACPI_RSC_INITGET
:
113 * Get the resource type and the initial (minimum) length
115 ACPI_MEMSET(resource
, 0, INIT_RESOURCE_LENGTH(info
));
116 resource
->type
= INIT_RESOURCE_TYPE(info
);
117 resource
->length
= INIT_RESOURCE_LENGTH(info
);
120 case ACPI_RSC_INITSET
:
123 case ACPI_RSC_FLAGINIT
:
128 case ACPI_RSC_1BITFLAG
:
130 * Mask and shift the flag bit
132 *((u8
*) destination
) = (u8
)
133 ((*((u8
*) source
) >> info
->value
) & 0x01);
136 case ACPI_RSC_2BITFLAG
:
138 * Mask and shift the flag bits
140 *((u8
*) destination
) = (u8
)
141 ((*((u8
*) source
) >> info
->value
) & 0x03);
146 item_count
= *((u8
*) source
);
147 *((u8
*) destination
) = (u8
) item_count
;
149 resource
->length
= resource
->length
+
150 (info
->value
* (item_count
- 1));
153 case ACPI_RSC_COUNT16
:
155 item_count
= aml_resource_length
;
156 *((u16
*) destination
) = item_count
;
158 resource
->length
= resource
->length
+
159 (info
->value
* (item_count
- 1));
162 case ACPI_RSC_LENGTH
:
164 resource
->length
= resource
->length
+ info
->value
;
168 case ACPI_RSC_MOVE16
:
169 case ACPI_RSC_MOVE32
:
170 case ACPI_RSC_MOVE64
:
172 * Raw data move. Use the Info value field unless item_count has
173 * been previously initialized via a COUNT opcode
176 item_count
= info
->value
;
178 acpi_rs_move_data(destination
, source
, item_count
,
184 ACPI_MEMSET(destination
, info
->aml_offset
, info
->value
);
189 target
= ((char *)resource
) + info
->value
;
190 ACPI_MEMCPY(destination
, source
,
191 *(ACPI_CAST_PTR(u16
, target
)));
194 case ACPI_RSC_ADDRESS
:
196 * Common handler for address descriptor flags
198 if (!acpi_rs_get_address_common(resource
, aml
)) {
200 (AE_AML_INVALID_RESOURCE_TYPE
);
204 case ACPI_RSC_SOURCE
:
206 * Optional resource_source (Index and String)
209 acpi_rs_get_resource_source(aml_resource_length
,
211 destination
, aml
, NULL
);
214 case ACPI_RSC_SOURCEX
:
216 * Optional resource_source (Index and String). This is the more
217 * complicated case used by the Interrupt() macro
220 ((char *)resource
) + info
->aml_offset
+
224 acpi_rs_get_resource_source(aml_resource_length
,
225 (acpi_rs_length
) (((item_count
- 1) * sizeof(u32
)) + info
->value
), destination
, aml
, target
);
228 case ACPI_RSC_BITMASK
:
230 * 8-bit encoded bitmask (DMA macro)
233 acpi_rs_decode_bitmask(*((u8
*) source
),
237 resource
->length
+ (item_count
- 1);
240 target
= ((char *)resource
) + info
->value
;
241 *((u8
*) target
) = (u8
) item_count
;
244 case ACPI_RSC_BITMASK16
:
246 * 16-bit encoded bitmask (IRQ macro)
248 ACPI_MOVE_16_TO_16(&temp16
, source
);
251 acpi_rs_decode_bitmask(temp16
, destination
);
254 resource
->length
+ (item_count
- 1);
257 target
= ((char *)resource
) + info
->value
;
258 *((u8
*) target
) = (u8
) item_count
;
261 case ACPI_RSC_EXIT_NE
:
263 * Control - Exit conversion if not equal
265 switch (info
->resource_offset
) {
266 case ACPI_RSC_COMPARE_AML_LENGTH
:
267 if (aml_resource_length
!= info
->value
) {
272 case ACPI_RSC_COMPARE_VALUE
:
273 if (*((u8
*) source
) != info
->value
) {
280 ("*** Invalid conversion sub-opcode\n");
281 return_ACPI_STATUS(AE_BAD_PARAMETER
);
287 acpi_os_printf("*** Invalid conversion opcode\n");
288 return_ACPI_STATUS(AE_BAD_PARAMETER
);
297 /* Round the resource struct length up to the next 32-bit boundary */
299 resource
->length
= ACPI_ROUND_UP_to_32_bITS(resource
->length
);
301 return_ACPI_STATUS(AE_OK
);
304 /*******************************************************************************
306 * FUNCTION: acpi_rs_convert_resource_to_aml
308 * PARAMETERS: Resource - Pointer to the resource descriptor
309 * Aml - Where the AML descriptor is returned
310 * Info - Pointer to appropriate conversion table
314 * DESCRIPTION: Convert an internal resource descriptor to the corresponding
315 * external AML resource descriptor.
317 ******************************************************************************/
320 acpi_rs_convert_resource_to_aml(struct acpi_resource
*resource
,
321 union aml_resource
*aml
,
322 struct acpi_rsconvert_info
*info
)
326 acpi_rsdesc_size aml_length
= 0;
331 ACPI_FUNCTION_TRACE("rs_convert_resource_to_aml");
333 /* Validate the Resource pointer, must be 32-bit aligned */
335 if (((acpi_native_uint
) resource
) & 0x3) {
337 ("**** SET: Misaligned resource pointer: %p Type %2.2X Len %X\n",
338 resource
, resource
->type
, resource
->length
);
342 * First table entry must be ACPI_RSC_INITxxx and must contain the
343 * table length (# of table entries)
345 count
= INIT_TABLE_LENGTH(info
);
349 * Source is the internal resource descriptor,
350 * destination is the external AML byte stream buffer
352 source
= ((u8
*) resource
) + info
->resource_offset
;
353 destination
= ((u8
*) aml
) + info
->aml_offset
;
355 switch (info
->opcode
) {
356 case ACPI_RSC_INITSET
:
358 ACPI_MEMSET(aml
, 0, INIT_RESOURCE_LENGTH(info
));
359 aml_length
= INIT_RESOURCE_LENGTH(info
);
360 acpi_rs_set_resource_header(INIT_RESOURCE_TYPE(info
),
364 case ACPI_RSC_INITGET
:
367 case ACPI_RSC_FLAGINIT
:
369 * Clear the flag byte
371 *((u8
*) destination
) = 0;
374 case ACPI_RSC_1BITFLAG
:
376 * Mask and shift the flag bit
378 *((u8
*) destination
) |= (u8
)
379 ((*((u8
*) source
) & 0x01) << info
->value
);
382 case ACPI_RSC_2BITFLAG
:
384 * Mask and shift the flag bits
386 *((u8
*) destination
) |= (u8
)
387 ((*((u8
*) source
) & 0x03) << info
->value
);
392 item_count
= *((u8
*) source
);
393 *((u8
*) destination
) = (u8
) item_count
;
395 aml_length
= (u16
) (aml_length
+
396 (info
->value
* (item_count
- 1)));
399 case ACPI_RSC_COUNT16
:
401 item_count
= *((u16
*) source
);
402 aml_length
= (u16
) (aml_length
+ item_count
);
403 acpi_rs_set_resource_length(aml_length
, aml
);
406 case ACPI_RSC_LENGTH
:
408 acpi_rs_set_resource_length(info
->value
, aml
);
412 case ACPI_RSC_MOVE16
:
413 case ACPI_RSC_MOVE32
:
414 case ACPI_RSC_MOVE64
:
417 item_count
= info
->value
;
419 acpi_rs_move_data(destination
, source
, item_count
,
423 case ACPI_RSC_ADDRESS
:
425 /* Set the Resource Type, General Flags, and Type-Specific Flags */
427 acpi_rs_set_address_common(aml
, resource
);
430 case ACPI_RSC_SOURCEX
:
432 * Optional resource_source (Index and String)
435 acpi_rs_set_resource_source(aml
,
438 acpi_rs_set_resource_length(aml_length
, aml
);
441 case ACPI_RSC_SOURCE
:
443 * Optional resource_source (Index and String). This is the more
444 * complicated case used by the Interrupt() macro
447 acpi_rs_set_resource_source(aml
, info
->value
,
449 acpi_rs_set_resource_length(aml_length
, aml
);
452 case ACPI_RSC_BITMASK
:
454 * 8-bit encoded bitmask (DMA macro)
456 *((u8
*) destination
) = (u8
)
457 acpi_rs_encode_bitmask(source
,
458 *(((u8
*) resource
) +
462 case ACPI_RSC_BITMASK16
:
464 * 16-bit encoded bitmask (IRQ macro)
467 acpi_rs_encode_bitmask(source
,
468 *(((u8
*) resource
) +
470 ACPI_MOVE_16_TO_16(destination
, &temp16
);
473 case ACPI_RSC_EXIT_LE
:
475 * Control - Exit conversion if less than or equal
477 if (item_count
<= info
->value
) {
482 case ACPI_RSC_EXIT_NE
:
484 * Control - Exit conversion if not equal
486 switch (COMPARE_OPCODE(info
)) {
487 case ACPI_RSC_COMPARE_VALUE
:
489 ((u8
*) (((u8
*) resource
) +
490 COMPARE_TARGET(info
))) !=
491 COMPARE_VALUE(info
)) {
498 ("*** Invalid conversion sub-opcode\n");
499 return_ACPI_STATUS(AE_BAD_PARAMETER
);
505 acpi_os_printf("*** Invalid conversion opcode\n");
506 return_ACPI_STATUS(AE_BAD_PARAMETER
);
514 return_ACPI_STATUS(AE_OK
);
518 /* Previous resource validations */
520 if (aml
->ext_address64
.revision_iD
!= AML_RESOURCE_EXTENDED_ADDRESS_REVISION
) {
521 return_ACPI_STATUS(AE_SUPPORT
);
524 if (resource
->data
.start_dpf
.performance_robustness
>= 3) {
525 return_ACPI_STATUS(AE_AML_BAD_RESOURCE_VALUE
);
528 if (((aml
->irq
.flags
& 0x09) == 0x00) || ((aml
->irq
.flags
& 0x09) == 0x09)) {
530 * Only [active_high, edge_sensitive] or [active_low, level_sensitive]
531 * polarity/trigger interrupts are allowed (ACPI spec, section
532 * "IRQ Format"), so 0x00 and 0x09 are illegal.
534 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
535 "Invalid interrupt polarity/trigger in resource list, %X\n",
537 return_ACPI_STATUS(AE_BAD_DATA
);
540 resource
->data
.extended_irq
.interrupt_count
= temp8
;
542 /* Must have at least one IRQ */
544 return_ACPI_STATUS(AE_AML_BAD_RESOURCE_LENGTH
);
547 if (resource
->data
.dma
.transfer
== 0x03) {
548 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
549 "Invalid DMA.Transfer preference (3)\n"));
550 return_ACPI_STATUS(AE_BAD_DATA
);