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
= ACPI_ADD_PTR(void, aml
, info
->aml_offset
);
109 ACPI_ADD_PTR(void, resource
, info
->resource_offset
);
111 switch (info
->opcode
) {
112 case ACPI_RSC_INITGET
:
114 * Get the resource type and the initial (minimum) length
116 ACPI_MEMSET(resource
, 0, INIT_RESOURCE_LENGTH(info
));
117 resource
->type
= INIT_RESOURCE_TYPE(info
);
118 resource
->length
= INIT_RESOURCE_LENGTH(info
);
121 case ACPI_RSC_INITSET
:
124 case ACPI_RSC_FLAGINIT
:
129 case ACPI_RSC_1BITFLAG
:
131 * Mask and shift the flag bit
133 ACPI_SET8(destination
) = (u8
)
134 ((ACPI_GET8(source
) >> info
->value
) & 0x01);
137 case ACPI_RSC_2BITFLAG
:
139 * Mask and shift the flag bits
141 ACPI_SET8(destination
) = (u8
)
142 ((ACPI_GET8(source
) >> info
->value
) & 0x03);
147 item_count
= ACPI_GET8(source
);
148 ACPI_SET8(destination
) = (u8
) item_count
;
150 resource
->length
= resource
->length
+
151 (info
->value
* (item_count
- 1));
154 case ACPI_RSC_COUNT16
:
156 item_count
= aml_resource_length
;
157 ACPI_SET16(destination
) = item_count
;
159 resource
->length
= resource
->length
+
160 (info
->value
* (item_count
- 1));
163 case ACPI_RSC_LENGTH
:
165 resource
->length
= resource
->length
+ info
->value
;
169 case ACPI_RSC_MOVE16
:
170 case ACPI_RSC_MOVE32
:
171 case ACPI_RSC_MOVE64
:
173 * Raw data move. Use the Info value field unless item_count has
174 * been previously initialized via a COUNT opcode
177 item_count
= info
->value
;
179 acpi_rs_move_data(destination
, source
, item_count
,
185 ACPI_MEMSET(destination
, info
->aml_offset
, info
->value
);
190 target
= ACPI_ADD_PTR(char, resource
, info
->value
);
191 ACPI_MEMCPY(destination
, source
, ACPI_GET16(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 ACPI_ADD_PTR(char, resource
,
221 info
->aml_offset
+ (item_count
* 4));
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(ACPI_GET8(source
),
236 resource
->length
+= (item_count
- 1);
239 target
= ACPI_ADD_PTR(char, resource
, info
->value
);
240 ACPI_SET8(target
) = (u8
) item_count
;
243 case ACPI_RSC_BITMASK16
:
245 * 16-bit encoded bitmask (IRQ macro)
247 ACPI_MOVE_16_TO_16(&temp16
, source
);
250 acpi_rs_decode_bitmask(temp16
, destination
);
252 resource
->length
+= (item_count
- 1);
255 target
= ACPI_ADD_PTR(char, resource
, info
->value
);
256 ACPI_SET8(target
) = (u8
) item_count
;
259 case ACPI_RSC_EXIT_NE
:
261 * Control - Exit conversion if not equal
263 switch (info
->resource_offset
) {
264 case ACPI_RSC_COMPARE_AML_LENGTH
:
265 if (aml_resource_length
!= info
->value
) {
270 case ACPI_RSC_COMPARE_VALUE
:
271 if (ACPI_GET8(source
) != info
->value
) {
278 ("*** Invalid conversion sub-opcode\n");
279 return_ACPI_STATUS(AE_BAD_PARAMETER
);
285 acpi_os_printf("*** Invalid conversion opcode\n");
286 return_ACPI_STATUS(AE_BAD_PARAMETER
);
295 /* Round the resource struct length up to the next 32-bit boundary */
297 resource
->length
= ACPI_ROUND_UP_to_32_bITS(resource
->length
);
299 return_ACPI_STATUS(AE_OK
);
302 /*******************************************************************************
304 * FUNCTION: acpi_rs_convert_resource_to_aml
306 * PARAMETERS: Resource - Pointer to the resource descriptor
307 * Aml - Where the AML descriptor is returned
308 * Info - Pointer to appropriate conversion table
312 * DESCRIPTION: Convert an internal resource descriptor to the corresponding
313 * external AML resource descriptor.
315 ******************************************************************************/
318 acpi_rs_convert_resource_to_aml(struct acpi_resource
*resource
,
319 union aml_resource
*aml
,
320 struct acpi_rsconvert_info
*info
)
324 acpi_rsdesc_size aml_length
= 0;
329 ACPI_FUNCTION_TRACE("rs_convert_resource_to_aml");
331 /* Validate the Resource pointer, must be 32-bit aligned */
333 if (((acpi_native_uint
) resource
) & 0x3) {
335 ("**** SET: Misaligned resource pointer: %p Type %2.2X Len %X\n",
336 resource
, resource
->type
, resource
->length
);
340 * First table entry must be ACPI_RSC_INITxxx and must contain the
341 * table length (# of table entries)
343 count
= INIT_TABLE_LENGTH(info
);
347 * Source is the internal resource descriptor,
348 * destination is the external AML byte stream buffer
350 source
= ACPI_ADD_PTR(void, resource
, info
->resource_offset
);
351 destination
= ACPI_ADD_PTR(void, aml
, info
->aml_offset
);
353 switch (info
->opcode
) {
354 case ACPI_RSC_INITSET
:
356 ACPI_MEMSET(aml
, 0, INIT_RESOURCE_LENGTH(info
));
357 aml_length
= INIT_RESOURCE_LENGTH(info
);
358 acpi_rs_set_resource_header(INIT_RESOURCE_TYPE(info
),
362 case ACPI_RSC_INITGET
:
365 case ACPI_RSC_FLAGINIT
:
367 * Clear the flag byte
369 ACPI_SET8(destination
) = 0;
372 case ACPI_RSC_1BITFLAG
:
374 * Mask and shift the flag bit
376 ACPI_SET8(destination
) |= (u8
)
377 ((ACPI_GET8(source
) & 0x01) << info
->value
);
380 case ACPI_RSC_2BITFLAG
:
382 * Mask and shift the flag bits
384 ACPI_SET8(destination
) |= (u8
)
385 ((ACPI_GET8(source
) & 0x03) << info
->value
);
390 item_count
= ACPI_GET8(source
);
391 ACPI_SET8(destination
) = (u8
) item_count
;
395 (info
->value
* (item_count
- 1)));
398 case ACPI_RSC_COUNT16
:
400 item_count
= ACPI_GET16(source
);
401 aml_length
= (u16
) (aml_length
+ item_count
);
402 acpi_rs_set_resource_length(aml_length
, aml
);
405 case ACPI_RSC_LENGTH
:
407 acpi_rs_set_resource_length(info
->value
, aml
);
411 case ACPI_RSC_MOVE16
:
412 case ACPI_RSC_MOVE32
:
413 case ACPI_RSC_MOVE64
:
416 item_count
= info
->value
;
418 acpi_rs_move_data(destination
, source
, item_count
,
422 case ACPI_RSC_ADDRESS
:
424 /* Set the Resource Type, General Flags, and Type-Specific Flags */
426 acpi_rs_set_address_common(aml
, resource
);
429 case ACPI_RSC_SOURCEX
:
431 * Optional resource_source (Index and String)
434 acpi_rs_set_resource_source(aml
,
437 acpi_rs_set_resource_length(aml_length
, aml
);
440 case ACPI_RSC_SOURCE
:
442 * Optional resource_source (Index and String). This is the more
443 * complicated case used by the Interrupt() macro
446 acpi_rs_set_resource_source(aml
, info
->value
,
448 acpi_rs_set_resource_length(aml_length
, aml
);
451 case ACPI_RSC_BITMASK
:
453 * 8-bit encoded bitmask (DMA macro)
455 ACPI_SET8(destination
) = (u8
)
456 acpi_rs_encode_bitmask(source
,
457 *ACPI_ADD_PTR(u8
, resource
,
461 case ACPI_RSC_BITMASK16
:
463 * 16-bit encoded bitmask (IRQ macro)
465 temp16
= acpi_rs_encode_bitmask(source
,
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 if (*ACPI_ADD_PTR(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
);