drivers/acpi/resources/rsxface.c

   1 /*******************************************************************************
   2  *
   3  * Module Name: rsxface - Public interfaces to the ACPI subsystem
   4  *              $Revision: 8 $
   5  *
   6  ******************************************************************************/
   7
   8 /*
   9  *  Copyright (C) 2000 R. Byron Moore
  10  *
  11  *  This program is free software; you can redistribute it and/or modify
  12  *  it under the terms of the GNU General Public License as published by
  13  *  the Free Software Foundation; either version 2 of the License, or
  14  *  (at your option) any later version.
  15  *
  16  *  This program is distributed in the hope that it will be useful,
  17  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  *  GNU General Public License for more details.
  20  *
  21  *  You should have received a copy of the GNU General Public License
  22  *  along with this program; if not, write to the Free Software
  23  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  24  */
  25
  26
  27 #include "acpi.h"
  28 #include "acinterp.h"
  29 #include "acnamesp.h"
  30 #include "acresrc.h"
  31
  32 #define _COMPONENT          RESOURCE_MANAGER
  33          MODULE_NAME         ("rsxface")
  34
  35
  36 /*******************************************************************************
  37  *
  38  * FUNCTION:    Acpi_get_irq_routing_table
  39  *
  40  * PARAMETERS:  Device_handle   - a handle to the Bus device we are querying
  41  *              Ret_buffer      - a pointer to a buffer to receive the
  42  *                                current resources for the device
  43  *
  44  * RETURN:      Status          - the status of the call
  45  *
  46  * DESCRIPTION: This function is called to get the IRQ routing table for a
  47  *              specific bus.  The caller must first acquire a handle for the
  48  *              desired bus.  The routine table is placed in the buffer pointed
  49  *              to by the Ret_buffer variable parameter.
  50  *
  51  *              If the function fails an appropriate status will be returned
  52  *              and the value of Ret_buffer is undefined.
  53  *
  54  *              This function attempts to execute the _PRT method contained in
  55  *              the object indicated by the passed Device_handle.
  56  *
  57  ******************************************************************************/
  58
  59 ACPI_STATUS
  60 acpi_get_irq_routing_table (
  61         ACPI_HANDLE             device_handle,
  62         ACPI_BUFFER             *ret_buffer)
  63 {
  64         ACPI_STATUS             status;
  65
  66
  67         /*
  68          *  Must have a valid handle and buffer, So we have to have a handle
  69          *  and a return buffer structure, and if there is a non-zero buffer length
  70          *  we also need a valid pointer in the buffer. If it's a zero buffer length,
  71          *  we'll be returning the needed buffer size, so keep going.
  72          */
  73         if ((!device_handle)        ||
  74                 (!ret_buffer)           ||
  75                 ((!ret_buffer->pointer) && (ret_buffer->length)))
  76         {
  77                 return (AE_BAD_PARAMETER);
  78         }
  79
  80         status = acpi_rs_get_prt_method_data (device_handle, ret_buffer);
  81
  82         return (status);
  83 }
  84
  85
  86 /*******************************************************************************
  87  *
  88  * FUNCTION:    Acpi_get_current_resources
  89  *
  90  * PARAMETERS:  Device_handle   - a handle to the device object for the
  91  *                                device we are querying
  92  *              Ret_buffer      - a pointer to a buffer to receive the
  93  *                                current resources for the device
  94  *
  95  * RETURN:      Status          - the status of the call
  96  *
  97  * DESCRIPTION: This function is called to get the current resources for a
  98  *              specific device.  The caller must first acquire a handle for
  99  *              the desired device.  The resource data is placed in the buffer
 100  *              pointed to by the Ret_buffer variable parameter.
 101  *
 102  *              If the function fails an appropriate status will be returned
 103  *              and the value of Ret_buffer is undefined.
 104  *
 105  *              This function attempts to execute the _CRS method contained in
 106  *              the object indicated by the passed Device_handle.
 107  *
 108  ******************************************************************************/
 109
 110 ACPI_STATUS
 111 acpi_get_current_resources (
 112         ACPI_HANDLE             device_handle,
 113         ACPI_BUFFER             *ret_buffer)
 114 {
 115         ACPI_STATUS             status;
 116
 117
 118         /*
 119          *  Must have a valid handle and buffer, So we have to have a handle
 120          *  and a return buffer structure, and if there is a non-zero buffer length
 121          *  we also need a valid pointer in the buffer. If it's a zero buffer length,
 122          *  we'll be returning the needed buffer size, so keep going.
 123          */
 124         if ((!device_handle)        ||
 125                 (!ret_buffer)           ||
 126                 ((ret_buffer->length) && (!ret_buffer->pointer)))
 127         {
 128                 return (AE_BAD_PARAMETER);
 129         }
 130
 131         status = acpi_rs_get_crs_method_data (device_handle, ret_buffer);
 132
 133         return (status);
 134 }
 135
 136
 137 /*******************************************************************************
 138  *
 139  * FUNCTION:    Acpi_get_possible_resources
 140  *
 141  * PARAMETERS:  Device_handle   - a handle to the device object for the
 142  *                                device we are querying
 143  *              Ret_buffer      - a pointer to a buffer to receive the
 144  *                                resources for the device
 145  *
 146  * RETURN:      Status          - the status of the call
 147  *
 148  * DESCRIPTION: This function is called to get a list of the possible resources
 149  *              for a specific device.  The caller must first acquire a handle
 150  *              for the desired device.  The resource data is placed in the
 151  *              buffer pointed to by the Ret_buffer variable.
 152  *
 153  *              If the function fails an appropriate status will be returned
 154  *              and the value of Ret_buffer is undefined.
 155  *
 156  ******************************************************************************/
 157
 158 ACPI_STATUS
 159 acpi_get_possible_resources (
 160         ACPI_HANDLE             device_handle,
 161         ACPI_BUFFER             *ret_buffer)
 162 {
 163         ACPI_STATUS             status;
 164
 165
 166         /*
 167          *  Must have a valid handle and buffer, So we have to have a handle
 168          *  and a return buffer structure, and if there is a non-zero buffer length
 169          *  we also need a valid pointer in the buffer. If it's a zero buffer length,
 170          *  we'll be returning the needed buffer size, so keep going.
 171          */
 172         if ((!device_handle)        ||
 173                 (!ret_buffer)           ||
 174                 ((ret_buffer->length) && (!ret_buffer->pointer)))
 175         {
 176                 return (AE_BAD_PARAMETER);
 177    }
 178
 179         status = acpi_rs_get_prs_method_data (device_handle, ret_buffer);
 180
 181         return (status);
 182 }
 183
 184
 185 /*******************************************************************************
 186  *
 187  * FUNCTION:    Acpi_set_current_resources
 188  *
 189  * PARAMETERS:  Device_handle   - a handle to the device object for the
 190  *                                device we are changing the resources of
 191  *              In_buffer       - a pointer to a buffer containing the
 192  *                                resources to be set for the device
 193  *
 194  * RETURN:      Status          - the status of the call
 195  *
 196  * DESCRIPTION: This function is called to set the current resources for a
 197  *              specific device.  The caller must first acquire a handle for
 198  *              the desired device.  The resource data is passed to the routine
 199  *              the buffer pointed to by the In_buffer variable.
 200  *
 201  ******************************************************************************/
 202
 203 ACPI_STATUS
 204 acpi_set_current_resources (
 205         ACPI_HANDLE             device_handle,
 206         ACPI_BUFFER             *in_buffer)
 207 {
 208         ACPI_STATUS             status;
 209
 210
 211         /*
 212          *  Must have a valid handle and buffer
 213          */
 214         if ((!device_handle)      ||
 215                 (!in_buffer)          ||
 216                 (!in_buffer->pointer) ||
 217                 (!in_buffer->length))
 218         {
 219                 return (AE_BAD_PARAMETER);
 220         }
 221
 222         status = acpi_rs_set_srs_method_data (device_handle, in_buffer);
 223
 224         return (status);
 225 }