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->type = 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->type = 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: Resource - 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 *resource,
217 u8 ** output_buffer, acpi_size * bytes_consumed)
219 u8 *buffer = *output_buffer;
223 ACPI_FUNCTION_TRACE("rs_io_stream");
225 /* The Descriptor Type field is static */
227 *buffer = ACPI_RDESC_TYPE_IO_PORT | 0x07;
230 /* Io Information Byte */
232 temp8 = (u8) (resource->data.io.io_decode & 0x01);
237 /* Set the Range minimum base address */
239 temp16 = (u16) resource->data.io.min_base_address;
241 ACPI_MOVE_16_TO_16(buffer, &temp16);
244 /* Set the Range maximum base address */
246 temp16 = (u16) resource->data.io.max_base_address;
248 ACPI_MOVE_16_TO_16(buffer, &temp16);
251 /* Set the base alignment */
253 temp8 = (u8) resource->data.io.alignment;
258 /* Set the range length */
260 temp8 = (u8) resource->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: Resource - 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 *resource,
289 u8 ** output_buffer, acpi_size * bytes_consumed)
291 u8 *buffer = *output_buffer;
295 ACPI_FUNCTION_TRACE("rs_fixed_io_stream");
297 /* The Descriptor Type field is static */
299 *buffer = ACPI_RDESC_TYPE_FIXED_IO_PORT | 0x03;
302 /* Set the Range base address */
304 temp16 = (u16) resource->data.fixed_io.base_address;
306 ACPI_MOVE_16_TO_16(buffer, &temp16);
309 /* Set the range length */
311 temp8 = (u8) resource->data.fixed_io.range_length;
316 /* Return the number of bytes consumed in this operation */
318 *bytes_consumed = ACPI_PTR_DIFF(buffer, *output_buffer);
319 return_ACPI_STATUS(AE_OK);
322 /*******************************************************************************
324 * FUNCTION: acpi_rs_dma_resource
326 * PARAMETERS: byte_stream_buffer - Pointer to the resource input byte
328 * bytes_consumed - Pointer to where the number of bytes
329 * consumed the byte_stream_buffer is
331 * output_buffer - Pointer to the return data buffer
332 * structure_size - Pointer to where the number of bytes
333 * in the return data struct is returned
337 * DESCRIPTION: Take the resource byte stream and fill out the appropriate
338 * structure pointed to by the output_buffer. Return the
339 * number of bytes consumed from the byte stream.
341 ******************************************************************************/
344 acpi_rs_dma_resource(u8 * byte_stream_buffer,
345 acpi_size * bytes_consumed,
346 u8 ** output_buffer, acpi_size * structure_size)
348 u8 *buffer = byte_stream_buffer;
349 struct acpi_resource *output_struct = (void *)*output_buffer;
353 acpi_size struct_size = ACPI_SIZEOF_RESOURCE(struct acpi_resource_dma);
355 ACPI_FUNCTION_TRACE("rs_dma_resource");
357 /* The number of bytes consumed are Constant */
360 output_struct->type = ACPI_RSTYPE_DMA;
362 /* Point to the 8-bits of Byte 1 */
367 /* Decode the DMA channel bits */
369 for (i = 0, index = 0; index < 8; index++) {
370 if ((temp8 >> index) & 0x01) {
371 output_struct->data.dma.channels[i] = index;
376 /* Zero DMA channels is valid */
378 output_struct->data.dma.number_of_channels = i;
380 /* Calculate the structure size based upon the number of interrupts */
382 struct_size += ((acpi_size) i - 1) * 4;
385 /* Point to Byte 2 */
390 /* Check for transfer preference (Bits[1:0]) */
392 output_struct->data.dma.transfer = temp8 & 0x03;
394 if (0x03 == output_struct->data.dma.transfer) {
395 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
396 "Invalid DMA.Transfer preference (3)\n"));
397 return_ACPI_STATUS(AE_BAD_DATA);
400 /* Get bus master preference (Bit[2]) */
402 output_struct->data.dma.bus_master = (temp8 >> 2) & 0x01;
404 /* Get channel speed support (Bits[6:5]) */
406 output_struct->data.dma.type = (temp8 >> 5) & 0x03;
408 /* Set the Length parameter */
410 output_struct->length = (u32) struct_size;
412 /* Return the final size of the structure */
414 *structure_size = struct_size;
415 return_ACPI_STATUS(AE_OK);
418 /*******************************************************************************
420 * FUNCTION: acpi_rs_dma_stream
422 * PARAMETERS: Resource - Pointer to the resource linked list
423 * output_buffer - Pointer to the user's return buffer
424 * bytes_consumed - Pointer to where the number of bytes
425 * used in the output_buffer is returned
429 * DESCRIPTION: Take the linked list resource structure and fills in the
430 * the appropriate bytes in a byte stream
432 ******************************************************************************/
435 acpi_rs_dma_stream(struct acpi_resource *resource,
436 u8 ** output_buffer, acpi_size * bytes_consumed)
438 u8 *buffer = *output_buffer;
443 ACPI_FUNCTION_TRACE("rs_dma_stream");
445 /* The Descriptor Type field is static */
447 *buffer = ACPI_RDESC_TYPE_DMA_FORMAT | 0x02;
451 /* Loop through all of the Channels and set the mask bits */
453 for (index = 0; index < resource->data.dma.number_of_channels; index++) {
454 temp16 = (u16) resource->data.dma.channels[index];
455 temp8 |= 0x1 << temp16;
461 /* Set the DMA Info */
463 temp8 = (u8) ((resource->data.dma.type & 0x03) << 5);
464 temp8 |= ((resource->data.dma.bus_master & 0x01) << 2);
465 temp8 |= (resource->data.dma.transfer & 0x03);
470 /* Return the number of bytes consumed in this operation */
472 *bytes_consumed = ACPI_PTR_DIFF(buffer, *output_buffer);
473 return_ACPI_STATUS(AE_OK);