1 /*******************************************************************************
3 * Module Name: rsmisc - Miscellaneous resource descriptors
5 ******************************************************************************/
8 * Copyright (C) 2000 - 2007, 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")
49 #define INIT_RESOURCE_TYPE(i) i->resource_offset
50 #define INIT_RESOURCE_LENGTH(i) i->aml_offset
51 #define INIT_TABLE_LENGTH(i) i->value
52 #define COMPARE_OPCODE(i) i->resource_offset
53 #define COMPARE_TARGET(i) i->aml_offset
54 #define COMPARE_VALUE(i) i->value
55 /*******************************************************************************
57 * FUNCTION: acpi_rs_convert_aml_to_resource
59 * PARAMETERS: Resource - Pointer to the resource descriptor
60 * Aml - Where the AML descriptor is returned
61 * Info - Pointer to appropriate conversion table
65 * DESCRIPTION: Convert an external AML resource descriptor to the corresponding
66 * internal resource descriptor
68 ******************************************************************************/
70 acpi_rs_convert_aml_to_resource(struct acpi_resource *resource,
71 union aml_resource *aml,
72 struct acpi_rsconvert_info *info)
74 acpi_rs_length aml_resource_length;
79 u8 flags_mode = FALSE;
83 ACPI_FUNCTION_TRACE(rs_convert_aml_to_resource);
85 if (((acpi_native_uint) resource) & 0x3) {
87 /* Each internal resource struct is expected to be 32-bit aligned */
89 ACPI_WARNING((AE_INFO,
90 "Misaligned resource pointer (get): %p Type %2.2X Len %X",
91 resource, resource->type, resource->length));
94 /* Extract the resource Length field (does not include header length) */
96 aml_resource_length = acpi_ut_get_resource_length(aml);
99 * First table entry must be ACPI_RSC_INITxxx and must contain the
100 * table length (# of table entries)
102 count = INIT_TABLE_LENGTH(info);
106 * Source is the external AML byte stream buffer,
107 * destination is the internal resource descriptor
109 source = ACPI_ADD_PTR(void, aml, info->aml_offset);
111 ACPI_ADD_PTR(void, resource, info->resource_offset);
113 switch (info->opcode) {
114 case ACPI_RSC_INITGET:
116 * Get the resource type and the initial (minimum) length
118 ACPI_MEMSET(resource, 0, INIT_RESOURCE_LENGTH(info));
119 resource->type = INIT_RESOURCE_TYPE(info);
120 resource->length = INIT_RESOURCE_LENGTH(info);
123 case ACPI_RSC_INITSET:
126 case ACPI_RSC_FLAGINIT:
131 case ACPI_RSC_1BITFLAG:
133 * Mask and shift the flag bit
135 ACPI_SET8(destination) = (u8)
136 ((ACPI_GET8(source) >> info->value) & 0x01);
139 case ACPI_RSC_2BITFLAG:
141 * Mask and shift the flag bits
143 ACPI_SET8(destination) = (u8)
144 ((ACPI_GET8(source) >> info->value) & 0x03);
149 item_count = ACPI_GET8(source);
150 ACPI_SET8(destination) = (u8) item_count;
152 resource->length = resource->length +
153 (info->value * (item_count - 1));
156 case ACPI_RSC_COUNT16:
158 item_count = aml_resource_length;
159 ACPI_SET16(destination) = item_count;
161 resource->length = resource->length +
162 (info->value * (item_count - 1));
165 case ACPI_RSC_LENGTH:
167 resource->length = resource->length + info->value;
171 case ACPI_RSC_MOVE16:
172 case ACPI_RSC_MOVE32:
173 case ACPI_RSC_MOVE64:
175 * Raw data move. Use the Info value field unless item_count has
176 * been previously initialized via a COUNT opcode
179 item_count = info->value;
181 acpi_rs_move_data(destination, source, item_count,
187 ACPI_MEMSET(destination, info->aml_offset, info->value);
192 target = ACPI_ADD_PTR(char, resource, info->value);
193 ACPI_MEMCPY(destination, source, ACPI_GET16(target));
196 case ACPI_RSC_ADDRESS:
198 * Common handler for address descriptor flags
200 if (!acpi_rs_get_address_common(resource, aml)) {
202 (AE_AML_INVALID_RESOURCE_TYPE);
206 case ACPI_RSC_SOURCE:
208 * Optional resource_source (Index and String)
211 acpi_rs_get_resource_source(aml_resource_length,
213 destination, aml, NULL);
216 case ACPI_RSC_SOURCEX:
218 * Optional resource_source (Index and String). This is the more
219 * complicated case used by the Interrupt() macro
222 ACPI_ADD_PTR(char, resource,
223 info->aml_offset + (item_count * 4));
226 acpi_rs_get_resource_source(aml_resource_length,
227 (acpi_rs_length) (((item_count - 1) * sizeof(u32)) + info->value), destination, aml, target);
230 case ACPI_RSC_BITMASK:
232 * 8-bit encoded bitmask (DMA macro)
235 acpi_rs_decode_bitmask(ACPI_GET8(source),
238 resource->length += (item_count - 1);
241 target = ACPI_ADD_PTR(char, resource, info->value);
242 ACPI_SET8(target) = (u8) item_count;
245 case ACPI_RSC_BITMASK16:
247 * 16-bit encoded bitmask (IRQ macro)
249 ACPI_MOVE_16_TO_16(&temp16, source);
252 acpi_rs_decode_bitmask(temp16, destination);
254 resource->length += (item_count - 1);
257 target = ACPI_ADD_PTR(char, resource, info->value);
258 ACPI_SET8(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 (ACPI_GET8(source) != info->value) {
281 "Invalid conversion sub-opcode"));
282 return_ACPI_STATUS(AE_BAD_PARAMETER);
288 ACPI_ERROR((AE_INFO, "Invalid conversion opcode"));
289 return_ACPI_STATUS(AE_BAD_PARAMETER);
299 /* Round the resource struct length up to the next boundary (32 or 64) */
302 (u32) ACPI_ROUND_UP_TO_NATIVE_WORD(resource->length);
304 return_ACPI_STATUS(AE_OK);
307 /*******************************************************************************
309 * FUNCTION: acpi_rs_convert_resource_to_aml
311 * PARAMETERS: Resource - Pointer to the resource descriptor
312 * Aml - Where the AML descriptor is returned
313 * Info - Pointer to appropriate conversion table
317 * DESCRIPTION: Convert an internal resource descriptor to the corresponding
318 * external AML resource descriptor.
320 ******************************************************************************/
323 acpi_rs_convert_resource_to_aml(struct acpi_resource *resource,
324 union aml_resource *aml,
325 struct acpi_rsconvert_info *info)
329 acpi_rsdesc_size aml_length = 0;
334 ACPI_FUNCTION_TRACE(rs_convert_resource_to_aml);
337 * First table entry must be ACPI_RSC_INITxxx and must contain the
338 * table length (# of table entries)
340 count = INIT_TABLE_LENGTH(info);
344 * Source is the internal resource descriptor,
345 * destination is the external AML byte stream buffer
347 source = ACPI_ADD_PTR(void, resource, info->resource_offset);
348 destination = ACPI_ADD_PTR(void, aml, info->aml_offset);
350 switch (info->opcode) {
351 case ACPI_RSC_INITSET:
353 ACPI_MEMSET(aml, 0, INIT_RESOURCE_LENGTH(info));
354 aml_length = INIT_RESOURCE_LENGTH(info);
355 acpi_rs_set_resource_header(INIT_RESOURCE_TYPE(info),
359 case ACPI_RSC_INITGET:
362 case ACPI_RSC_FLAGINIT:
364 * Clear the flag byte
366 ACPI_SET8(destination) = 0;
369 case ACPI_RSC_1BITFLAG:
371 * Mask and shift the flag bit
373 ACPI_SET8(destination) |= (u8)
374 ((ACPI_GET8(source) & 0x01) << info->value);
377 case ACPI_RSC_2BITFLAG:
379 * Mask and shift the flag bits
381 ACPI_SET8(destination) |= (u8)
382 ((ACPI_GET8(source) & 0x03) << info->value);
387 item_count = ACPI_GET8(source);
388 ACPI_SET8(destination) = (u8) item_count;
392 (info->value * (item_count - 1)));
395 case ACPI_RSC_COUNT16:
397 item_count = ACPI_GET16(source);
398 aml_length = (u16) (aml_length + item_count);
399 acpi_rs_set_resource_length(aml_length, aml);
402 case ACPI_RSC_LENGTH:
404 acpi_rs_set_resource_length(info->value, aml);
408 case ACPI_RSC_MOVE16:
409 case ACPI_RSC_MOVE32:
410 case ACPI_RSC_MOVE64:
413 item_count = info->value;
415 acpi_rs_move_data(destination, source, item_count,
419 case ACPI_RSC_ADDRESS:
421 /* Set the Resource Type, General Flags, and Type-Specific Flags */
423 acpi_rs_set_address_common(aml, resource);
426 case ACPI_RSC_SOURCEX:
428 * Optional resource_source (Index and String)
431 acpi_rs_set_resource_source(aml, (acpi_rs_length)
433 acpi_rs_set_resource_length(aml_length, aml);
436 case ACPI_RSC_SOURCE:
438 * Optional resource_source (Index and String). This is the more
439 * complicated case used by the Interrupt() macro
442 acpi_rs_set_resource_source(aml, info->value,
444 acpi_rs_set_resource_length(aml_length, aml);
447 case ACPI_RSC_BITMASK:
449 * 8-bit encoded bitmask (DMA macro)
451 ACPI_SET8(destination) = (u8)
452 acpi_rs_encode_bitmask(source,
453 *ACPI_ADD_PTR(u8, resource,
457 case ACPI_RSC_BITMASK16:
459 * 16-bit encoded bitmask (IRQ macro)
461 temp16 = acpi_rs_encode_bitmask(source,
466 ACPI_MOVE_16_TO_16(destination, &temp16);
469 case ACPI_RSC_EXIT_LE:
471 * Control - Exit conversion if less than or equal
473 if (item_count <= info->value) {
478 case ACPI_RSC_EXIT_NE:
480 * Control - Exit conversion if not equal
482 switch (COMPARE_OPCODE(info)) {
483 case ACPI_RSC_COMPARE_VALUE:
485 if (*ACPI_ADD_PTR(u8, resource,
486 COMPARE_TARGET(info)) !=
487 COMPARE_VALUE(info)) {
495 "Invalid conversion sub-opcode"));
496 return_ACPI_STATUS(AE_BAD_PARAMETER);
502 ACPI_ERROR((AE_INFO, "Invalid conversion opcode"));
503 return_ACPI_STATUS(AE_BAD_PARAMETER);
511 return_ACPI_STATUS(AE_OK);
515 /* Previous resource validations */
517 if (aml->ext_address64.revision_iD != AML_RESOURCE_EXTENDED_ADDRESS_REVISION) {
518 return_ACPI_STATUS(AE_SUPPORT);
521 if (resource->data.start_dpf.performance_robustness >= 3) {
522 return_ACPI_STATUS(AE_AML_BAD_RESOURCE_VALUE);
525 if (((aml->irq.flags & 0x09) == 0x00) || ((aml->irq.flags & 0x09) == 0x09)) {
527 * Only [active_high, edge_sensitive] or [active_low, level_sensitive]
528 * polarity/trigger interrupts are allowed (ACPI spec, section
529 * "IRQ Format"), so 0x00 and 0x09 are illegal.
532 "Invalid interrupt polarity/trigger in resource list, %X",
534 return_ACPI_STATUS(AE_BAD_DATA);
537 resource->data.extended_irq.interrupt_count = temp8;
540 /* Must have at least one IRQ */
542 return_ACPI_STATUS(AE_AML_BAD_RESOURCE_LENGTH);
545 if (resource->data.dma.transfer == 0x03) {
546 ACPI_ERROR((AE_INFO, "Invalid DMA.Transfer preference (3)"));
547 return_ACPI_STATUS(AE_BAD_DATA);