1 /*******************************************************************************
3 * Module Name: rsio - IO and DMA 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("rsio")
50 /*******************************************************************************
52 * FUNCTION: acpi_rs_io_resource
54 * PARAMETERS: byte_stream_buffer - Pointer to the resource input byte
56 * bytes_consumed - Pointer to where the number of bytes
57 * consumed the byte_stream_buffer is
59 * output_buffer - Pointer to the return data buffer
60 * structure_size - Pointer to where the number of bytes
61 * in the return data struct is returned
65 * DESCRIPTION: Take the resource byte stream and fill out the appropriate
66 * structure pointed to by the output_buffer. Return the
67 * number of bytes consumed from the byte stream.
69 ******************************************************************************/
71 acpi_rs_io_resource(u8 * byte_stream_buffer,
72 acpi_size * bytes_consumed,
73 u8 ** output_buffer, acpi_size * structure_size)
75 u8 *buffer = byte_stream_buffer;
76 struct acpi_resource *output_struct = (void *)*output_buffer;
79 acpi_size struct_size = ACPI_SIZEOF_RESOURCE(struct acpi_resource_io);
81 ACPI_FUNCTION_TRACE("rs_io_resource");
83 /* The number of bytes consumed are Constant */
87 output_struct->id = ACPI_RSTYPE_IO;
94 output_struct->data.io.io_decode = temp8 & 0x01;
96 /* Check min_base Address */
99 ACPI_MOVE_16_TO_16(&temp16, buffer);
101 output_struct->data.io.min_base_address = temp16;
103 /* Check max_base Address */
106 ACPI_MOVE_16_TO_16(&temp16, buffer);
108 output_struct->data.io.max_base_address = temp16;
110 /* Check Base alignment */
115 output_struct->data.io.alignment = temp8;
117 /* Check range_length */
122 output_struct->data.io.range_length = temp8;
124 /* Set the Length parameter */
126 output_struct->length = (u32) struct_size;
128 /* Return the final size of the structure */
130 *structure_size = struct_size;
131 return_ACPI_STATUS(AE_OK);
134 /*******************************************************************************
136 * FUNCTION: acpi_rs_fixed_io_resource
138 * PARAMETERS: byte_stream_buffer - Pointer to the resource input byte
140 * bytes_consumed - Pointer to where the number of bytes
141 * consumed the byte_stream_buffer is
143 * output_buffer - Pointer to the return data buffer
144 * structure_size - Pointer to where the number of bytes
145 * in the return data struct is returned
149 * DESCRIPTION: Take the resource byte stream and fill out the appropriate
150 * structure pointed to by the output_buffer. Return the
151 * number of bytes consumed from the byte stream.
153 ******************************************************************************/
156 acpi_rs_fixed_io_resource(u8 * byte_stream_buffer,
157 acpi_size * bytes_consumed,
158 u8 ** output_buffer, acpi_size * structure_size)
160 u8 *buffer = byte_stream_buffer;
161 struct acpi_resource *output_struct = (void *)*output_buffer;
164 acpi_size struct_size =
165 ACPI_SIZEOF_RESOURCE(struct acpi_resource_fixed_io);
167 ACPI_FUNCTION_TRACE("rs_fixed_io_resource");
169 /* The number of bytes consumed are Constant */
173 output_struct->id = ACPI_RSTYPE_FIXED_IO;
175 /* Check Range Base Address */
178 ACPI_MOVE_16_TO_16(&temp16, buffer);
180 output_struct->data.fixed_io.base_address = temp16;
182 /* Check range_length */
187 output_struct->data.fixed_io.range_length = temp8;
189 /* Set the Length parameter */
191 output_struct->length = (u32) struct_size;
193 /* Return the final size of the structure */
195 *structure_size = struct_size;
196 return_ACPI_STATUS(AE_OK);
199 /*******************************************************************************
201 * FUNCTION: acpi_rs_io_stream
203 * PARAMETERS: linked_list - Pointer to the resource linked list
204 * output_buffer - Pointer to the user's return buffer
205 * bytes_consumed - Pointer to where the number of bytes
206 * used in the output_buffer is returned
210 * DESCRIPTION: Take the linked list resource structure and fills in the
211 * the appropriate bytes in a byte stream
213 ******************************************************************************/
216 acpi_rs_io_stream(struct acpi_resource *linked_list,
217 u8 ** output_buffer, acpi_size * bytes_consumed)
219 u8 *buffer = *output_buffer;
223 ACPI_FUNCTION_TRACE("rs_io_stream");
225 /* The descriptor field is static */
230 /* Io Information Byte */
232 temp8 = (u8) (linked_list->data.io.io_decode & 0x01);
237 /* Set the Range minimum base address */
239 temp16 = (u16) linked_list->data.io.min_base_address;
241 ACPI_MOVE_16_TO_16(buffer, &temp16);
244 /* Set the Range maximum base address */
246 temp16 = (u16) linked_list->data.io.max_base_address;
248 ACPI_MOVE_16_TO_16(buffer, &temp16);
251 /* Set the base alignment */
253 temp8 = (u8) linked_list->data.io.alignment;
258 /* Set the range length */
260 temp8 = (u8) linked_list->data.io.range_length;
265 /* Return the number of bytes consumed in this operation */
267 *bytes_consumed = ACPI_PTR_DIFF(buffer, *output_buffer);
268 return_ACPI_STATUS(AE_OK);
271 /*******************************************************************************
273 * FUNCTION: acpi_rs_fixed_io_stream
275 * PARAMETERS: linked_list - Pointer to the resource linked list
276 * output_buffer - Pointer to the user's return buffer
277 * bytes_consumed - Pointer to where the number of bytes
278 * used in the output_buffer is returned
282 * DESCRIPTION: Take the linked list resource structure and fills in the
283 * the appropriate bytes in a byte stream
285 ******************************************************************************/
288 acpi_rs_fixed_io_stream(struct acpi_resource *linked_list,
289 u8 ** output_buffer, acpi_size * bytes_consumed)
291 u8 *buffer = *output_buffer;
295 ACPI_FUNCTION_TRACE("rs_fixed_io_stream");
297 /* The descriptor field is static */
303 /* Set the Range base address */
305 temp16 = (u16) linked_list->data.fixed_io.base_address;
307 ACPI_MOVE_16_TO_16(buffer, &temp16);
310 /* Set the range length */
312 temp8 = (u8) linked_list->data.fixed_io.range_length;
317 /* Return the number of bytes consumed in this operation */
319 *bytes_consumed = ACPI_PTR_DIFF(buffer, *output_buffer);
320 return_ACPI_STATUS(AE_OK);
323 /*******************************************************************************
325 * FUNCTION: acpi_rs_dma_resource
327 * PARAMETERS: byte_stream_buffer - Pointer to the resource input byte
329 * bytes_consumed - Pointer to where the number of bytes
330 * consumed the byte_stream_buffer is
332 * output_buffer - Pointer to the return data buffer
333 * structure_size - Pointer to where the number of bytes
334 * in the return data struct is returned
338 * DESCRIPTION: Take the resource byte stream and fill out the appropriate
339 * structure pointed to by the output_buffer. Return the
340 * number of bytes consumed from the byte stream.
342 ******************************************************************************/
345 acpi_rs_dma_resource(u8 * byte_stream_buffer,
346 acpi_size * bytes_consumed,
347 u8 ** output_buffer, acpi_size * structure_size)
349 u8 *buffer = byte_stream_buffer;
350 struct acpi_resource *output_struct = (void *)*output_buffer;
354 acpi_size struct_size = ACPI_SIZEOF_RESOURCE(struct acpi_resource_dma);
356 ACPI_FUNCTION_TRACE("rs_dma_resource");
358 /* The number of bytes consumed are Constant */
361 output_struct->id = ACPI_RSTYPE_DMA;
363 /* Point to the 8-bits of Byte 1 */
368 /* Decode the DMA channel bits */
370 for (i = 0, index = 0; index < 8; index++) {
371 if ((temp8 >> index) & 0x01) {
372 output_struct->data.dma.channels[i] = index;
377 /* Zero DMA channels is valid */
379 output_struct->data.dma.number_of_channels = i;
381 /* Calculate the structure size based upon the number of interrupts */
383 struct_size += ((acpi_size) i - 1) * 4;
386 /* Point to Byte 2 */
391 /* Check for transfer preference (Bits[1:0]) */
393 output_struct->data.dma.transfer = temp8 & 0x03;
395 if (0x03 == output_struct->data.dma.transfer) {
396 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
397 "Invalid DMA.Transfer preference (3)\n"));
398 return_ACPI_STATUS(AE_BAD_DATA);
401 /* Get bus master preference (Bit[2]) */
403 output_struct->data.dma.bus_master = (temp8 >> 2) & 0x01;
405 /* Get channel speed support (Bits[6:5]) */
407 output_struct->data.dma.type = (temp8 >> 5) & 0x03;
409 /* Set the Length parameter */
411 output_struct->length = (u32) struct_size;
413 /* Return the final size of the structure */
415 *structure_size = struct_size;
416 return_ACPI_STATUS(AE_OK);
419 /*******************************************************************************
421 * FUNCTION: acpi_rs_dma_stream
423 * PARAMETERS: linked_list - Pointer to the resource linked list
424 * output_buffer - Pointer to the user's return buffer
425 * bytes_consumed - Pointer to where the number of bytes
426 * used in the output_buffer is returned
430 * DESCRIPTION: Take the linked list resource structure and fills in the
431 * the appropriate bytes in a byte stream
433 ******************************************************************************/
436 acpi_rs_dma_stream(struct acpi_resource *linked_list,
437 u8 ** output_buffer, acpi_size * bytes_consumed)
439 u8 *buffer = *output_buffer;
444 ACPI_FUNCTION_TRACE("rs_dma_stream");
446 /* The descriptor field is static */
452 /* Loop through all of the Channels and set the mask bits */
455 index < linked_list->data.dma.number_of_channels; index++) {
456 temp16 = (u16) linked_list->data.dma.channels[index];
457 temp8 |= 0x1 << temp16;
463 /* Set the DMA Info */
465 temp8 = (u8) ((linked_list->data.dma.type & 0x03) << 5);
466 temp8 |= ((linked_list->data.dma.bus_master & 0x01) << 2);
467 temp8 |= (linked_list->data.dma.transfer & 0x03);
472 /* Return the number of bytes consumed in this operation */
474 *bytes_consumed = ACPI_PTR_DIFF(buffer, *output_buffer);
475 return_ACPI_STATUS(AE_OK);