Home | History | Annotate | Line # | Download | only in hardware
hwvalid.c revision 1.1.1.2.8.2
      1  1.1.1.2.8.2  jruoho 
      2  1.1.1.2.8.2  jruoho /******************************************************************************
      3  1.1.1.2.8.2  jruoho  *
      4  1.1.1.2.8.2  jruoho  * Module Name: hwvalid - I/O request validation
      5  1.1.1.2.8.2  jruoho  *
      6  1.1.1.2.8.2  jruoho  *****************************************************************************/
      7  1.1.1.2.8.2  jruoho 
      8  1.1.1.2.8.2  jruoho /*
      9  1.1.1.2.8.2  jruoho  * Copyright (C) 2000 - 2011, Intel Corp.
     10  1.1.1.2.8.2  jruoho  * All rights reserved.
     11  1.1.1.2.8.2  jruoho  *
     12  1.1.1.2.8.2  jruoho  * Redistribution and use in source and binary forms, with or without
     13  1.1.1.2.8.2  jruoho  * modification, are permitted provided that the following conditions
     14  1.1.1.2.8.2  jruoho  * are met:
     15  1.1.1.2.8.2  jruoho  * 1. Redistributions of source code must retain the above copyright
     16  1.1.1.2.8.2  jruoho  *    notice, this list of conditions, and the following disclaimer,
     17  1.1.1.2.8.2  jruoho  *    without modification.
     18  1.1.1.2.8.2  jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     19  1.1.1.2.8.2  jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     20  1.1.1.2.8.2  jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     21  1.1.1.2.8.2  jruoho  *    including a substantially similar Disclaimer requirement for further
     22  1.1.1.2.8.2  jruoho  *    binary redistribution.
     23  1.1.1.2.8.2  jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     24  1.1.1.2.8.2  jruoho  *    of any contributors may be used to endorse or promote products derived
     25  1.1.1.2.8.2  jruoho  *    from this software without specific prior written permission.
     26  1.1.1.2.8.2  jruoho  *
     27  1.1.1.2.8.2  jruoho  * Alternatively, this software may be distributed under the terms of the
     28  1.1.1.2.8.2  jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     29  1.1.1.2.8.2  jruoho  * Software Foundation.
     30  1.1.1.2.8.2  jruoho  *
     31  1.1.1.2.8.2  jruoho  * NO WARRANTY
     32  1.1.1.2.8.2  jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     33  1.1.1.2.8.2  jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     34  1.1.1.2.8.2  jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     35  1.1.1.2.8.2  jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     36  1.1.1.2.8.2  jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     37  1.1.1.2.8.2  jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     38  1.1.1.2.8.2  jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     39  1.1.1.2.8.2  jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     40  1.1.1.2.8.2  jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     41  1.1.1.2.8.2  jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     42  1.1.1.2.8.2  jruoho  * POSSIBILITY OF SUCH DAMAGES.
     43  1.1.1.2.8.2  jruoho  */
     44  1.1.1.2.8.2  jruoho 
     45  1.1.1.2.8.2  jruoho #define __HWVALID_C__
     46  1.1.1.2.8.2  jruoho 
     47  1.1.1.2.8.2  jruoho #include "acpi.h"
     48  1.1.1.2.8.2  jruoho #include "accommon.h"
     49  1.1.1.2.8.2  jruoho 
     50  1.1.1.2.8.2  jruoho #define _COMPONENT          ACPI_HARDWARE
     51  1.1.1.2.8.2  jruoho         ACPI_MODULE_NAME    ("hwvalid")
     52  1.1.1.2.8.2  jruoho 
     53  1.1.1.2.8.2  jruoho /* Local prototypes */
     54  1.1.1.2.8.2  jruoho 
     55  1.1.1.2.8.2  jruoho static ACPI_STATUS
     56  1.1.1.2.8.2  jruoho AcpiHwValidateIoRequest (
     57  1.1.1.2.8.2  jruoho     ACPI_IO_ADDRESS         Address,
     58  1.1.1.2.8.2  jruoho     UINT32                  BitWidth);
     59  1.1.1.2.8.2  jruoho 
     60  1.1.1.2.8.2  jruoho 
     61  1.1.1.2.8.2  jruoho /*
     62  1.1.1.2.8.2  jruoho  * Protected I/O ports. Some ports are always illegal, and some are
     63  1.1.1.2.8.2  jruoho  * conditionally illegal. This table must remain ordered by port address.
     64  1.1.1.2.8.2  jruoho  *
     65  1.1.1.2.8.2  jruoho  * The table is used to implement the Microsoft port access rules that
     66  1.1.1.2.8.2  jruoho  * first appeared in Windows XP. Some ports are always illegal, and some
     67  1.1.1.2.8.2  jruoho  * ports are only illegal if the BIOS calls _OSI with a WinXP string or
     68  1.1.1.2.8.2  jruoho  * later (meaning that the BIOS itelf is post-XP.)
     69  1.1.1.2.8.2  jruoho  *
     70  1.1.1.2.8.2  jruoho  * This provides ACPICA with the desired port protections and
     71  1.1.1.2.8.2  jruoho  * Microsoft compatibility.
     72  1.1.1.2.8.2  jruoho  *
     73  1.1.1.2.8.2  jruoho  * Description of port entries:
     74  1.1.1.2.8.2  jruoho  *  DMA:   DMA controller
     75  1.1.1.2.8.2  jruoho  *  PIC0:  Programmable Interrupt Controller (8259A)
     76  1.1.1.2.8.2  jruoho  *  PIT1:  System Timer 1
     77  1.1.1.2.8.2  jruoho  *  PIT2:  System Timer 2 failsafe
     78  1.1.1.2.8.2  jruoho  *  RTC:   Real-time clock
     79  1.1.1.2.8.2  jruoho  *  CMOS:  Extended CMOS
     80  1.1.1.2.8.2  jruoho  *  DMA1:  DMA 1 page registers
     81  1.1.1.2.8.2  jruoho  *  DMA1L: DMA 1 Ch 0 low page
     82  1.1.1.2.8.2  jruoho  *  DMA2:  DMA 2 page registers
     83  1.1.1.2.8.2  jruoho  *  DMA2L: DMA 2 low page refresh
     84  1.1.1.2.8.2  jruoho  *  ARBC:  Arbitration control
     85  1.1.1.2.8.2  jruoho  *  SETUP: Reserved system board setup
     86  1.1.1.2.8.2  jruoho  *  POS:   POS channel select
     87  1.1.1.2.8.2  jruoho  *  PIC1:  Cascaded PIC
     88  1.1.1.2.8.2  jruoho  *  IDMA:  ISA DMA
     89  1.1.1.2.8.2  jruoho  *  ELCR:  PIC edge/level registers
     90  1.1.1.2.8.2  jruoho  *  PCI:   PCI configuration space
     91  1.1.1.2.8.2  jruoho  */
     92  1.1.1.2.8.2  jruoho static const ACPI_PORT_INFO     AcpiProtectedPorts[] =
     93  1.1.1.2.8.2  jruoho {
     94  1.1.1.2.8.2  jruoho     {"DMA",     0x0000, 0x000F, ACPI_OSI_WIN_XP},
     95  1.1.1.2.8.2  jruoho     {"PIC0",    0x0020, 0x0021, ACPI_ALWAYS_ILLEGAL},
     96  1.1.1.2.8.2  jruoho     {"PIT1",    0x0040, 0x0043, ACPI_OSI_WIN_XP},
     97  1.1.1.2.8.2  jruoho     {"PIT2",    0x0048, 0x004B, ACPI_OSI_WIN_XP},
     98  1.1.1.2.8.2  jruoho     {"RTC",     0x0070, 0x0071, ACPI_OSI_WIN_XP},
     99  1.1.1.2.8.2  jruoho     {"CMOS",    0x0074, 0x0076, ACPI_OSI_WIN_XP},
    100  1.1.1.2.8.2  jruoho     {"DMA1",    0x0081, 0x0083, ACPI_OSI_WIN_XP},
    101  1.1.1.2.8.2  jruoho     {"DMA1L",   0x0087, 0x0087, ACPI_OSI_WIN_XP},
    102  1.1.1.2.8.2  jruoho     {"DMA2",    0x0089, 0x008B, ACPI_OSI_WIN_XP},
    103  1.1.1.2.8.2  jruoho     {"DMA2L",   0x008F, 0x008F, ACPI_OSI_WIN_XP},
    104  1.1.1.2.8.2  jruoho     {"ARBC",    0x0090, 0x0091, ACPI_OSI_WIN_XP},
    105  1.1.1.2.8.2  jruoho     {"SETUP",   0x0093, 0x0094, ACPI_OSI_WIN_XP},
    106  1.1.1.2.8.2  jruoho     {"POS",     0x0096, 0x0097, ACPI_OSI_WIN_XP},
    107  1.1.1.2.8.2  jruoho     {"PIC1",    0x00A0, 0x00A1, ACPI_ALWAYS_ILLEGAL},
    108  1.1.1.2.8.2  jruoho     {"IDMA",    0x00C0, 0x00DF, ACPI_OSI_WIN_XP},
    109  1.1.1.2.8.2  jruoho     {"ELCR",    0x04D0, 0x04D1, ACPI_ALWAYS_ILLEGAL},
    110  1.1.1.2.8.2  jruoho     {"PCI",     0x0CF8, 0x0CFF, ACPI_OSI_WIN_XP}
    111  1.1.1.2.8.2  jruoho };
    112  1.1.1.2.8.2  jruoho 
    113  1.1.1.2.8.2  jruoho #define ACPI_PORT_INFO_ENTRIES  ACPI_ARRAY_LENGTH (AcpiProtectedPorts)
    114  1.1.1.2.8.2  jruoho 
    115  1.1.1.2.8.2  jruoho 
    116  1.1.1.2.8.2  jruoho /******************************************************************************
    117  1.1.1.2.8.2  jruoho  *
    118  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiHwValidateIoRequest
    119  1.1.1.2.8.2  jruoho  *
    120  1.1.1.2.8.2  jruoho  * PARAMETERS:  Address             Address of I/O port/register
    121  1.1.1.2.8.2  jruoho  *              BitWidth            Number of bits (8,16,32)
    122  1.1.1.2.8.2  jruoho  *
    123  1.1.1.2.8.2  jruoho  * RETURN:      Status
    124  1.1.1.2.8.2  jruoho  *
    125  1.1.1.2.8.2  jruoho  * DESCRIPTION: Validates an I/O request (address/length). Certain ports are
    126  1.1.1.2.8.2  jruoho  *              always illegal and some ports are only illegal depending on
    127  1.1.1.2.8.2  jruoho  *              the requests the BIOS AML code makes to the predefined
    128  1.1.1.2.8.2  jruoho  *              _OSI method.
    129  1.1.1.2.8.2  jruoho  *
    130  1.1.1.2.8.2  jruoho  ******************************************************************************/
    131  1.1.1.2.8.2  jruoho 
    132  1.1.1.2.8.2  jruoho static ACPI_STATUS
    133  1.1.1.2.8.2  jruoho AcpiHwValidateIoRequest (
    134  1.1.1.2.8.2  jruoho     ACPI_IO_ADDRESS         Address,
    135  1.1.1.2.8.2  jruoho     UINT32                  BitWidth)
    136  1.1.1.2.8.2  jruoho {
    137  1.1.1.2.8.2  jruoho     UINT32                  i;
    138  1.1.1.2.8.2  jruoho     UINT32                  ByteWidth;
    139  1.1.1.2.8.2  jruoho     ACPI_IO_ADDRESS         LastAddress;
    140  1.1.1.2.8.2  jruoho     const ACPI_PORT_INFO    *PortInfo;
    141  1.1.1.2.8.2  jruoho 
    142  1.1.1.2.8.2  jruoho 
    143  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (HwValidateIoRequest);
    144  1.1.1.2.8.2  jruoho 
    145  1.1.1.2.8.2  jruoho 
    146  1.1.1.2.8.2  jruoho     /* Supported widths are 8/16/32 */
    147  1.1.1.2.8.2  jruoho 
    148  1.1.1.2.8.2  jruoho     if ((BitWidth != 8) &&
    149  1.1.1.2.8.2  jruoho         (BitWidth != 16) &&
    150  1.1.1.2.8.2  jruoho         (BitWidth != 32))
    151  1.1.1.2.8.2  jruoho     {
    152  1.1.1.2.8.2  jruoho         return (AE_BAD_PARAMETER);
    153  1.1.1.2.8.2  jruoho     }
    154  1.1.1.2.8.2  jruoho 
    155  1.1.1.2.8.2  jruoho     PortInfo = AcpiProtectedPorts;
    156  1.1.1.2.8.2  jruoho     ByteWidth = ACPI_DIV_8 (BitWidth);
    157  1.1.1.2.8.2  jruoho     LastAddress = Address + ByteWidth - 1;
    158  1.1.1.2.8.2  jruoho 
    159  1.1.1.2.8.2  jruoho     ACPI_DEBUG_PRINT ((ACPI_DB_IO, "Address %p LastAddress %p Length %X",
    160  1.1.1.2.8.2  jruoho         ACPI_CAST_PTR (void, Address), ACPI_CAST_PTR (void, LastAddress),
    161  1.1.1.2.8.2  jruoho         ByteWidth));
    162  1.1.1.2.8.2  jruoho 
    163  1.1.1.2.8.2  jruoho     /* Maximum 16-bit address in I/O space */
    164  1.1.1.2.8.2  jruoho 
    165  1.1.1.2.8.2  jruoho     if (LastAddress > ACPI_UINT16_MAX)
    166  1.1.1.2.8.2  jruoho     {
    167  1.1.1.2.8.2  jruoho         ACPI_ERROR ((AE_INFO,
    168  1.1.1.2.8.2  jruoho             "Illegal I/O port address/length above 64K: %p/0x%X",
    169  1.1.1.2.8.2  jruoho             ACPI_CAST_PTR (void, Address), ByteWidth));
    170  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_LIMIT);
    171  1.1.1.2.8.2  jruoho     }
    172  1.1.1.2.8.2  jruoho 
    173  1.1.1.2.8.2  jruoho     /* Exit if requested address is not within the protected port table */
    174  1.1.1.2.8.2  jruoho 
    175  1.1.1.2.8.2  jruoho     if (Address > AcpiProtectedPorts[ACPI_PORT_INFO_ENTRIES - 1].End)
    176  1.1.1.2.8.2  jruoho     {
    177  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_OK);
    178  1.1.1.2.8.2  jruoho     }
    179  1.1.1.2.8.2  jruoho 
    180  1.1.1.2.8.2  jruoho     /* Check request against the list of protected I/O ports */
    181  1.1.1.2.8.2  jruoho 
    182  1.1.1.2.8.2  jruoho     for (i = 0; i < ACPI_PORT_INFO_ENTRIES; i++, PortInfo++)
    183  1.1.1.2.8.2  jruoho     {
    184  1.1.1.2.8.2  jruoho         /*
    185  1.1.1.2.8.2  jruoho          * Check if the requested address range will write to a reserved
    186  1.1.1.2.8.2  jruoho          * port. Four cases to consider:
    187  1.1.1.2.8.2  jruoho          *
    188  1.1.1.2.8.2  jruoho          * 1) Address range is contained completely in the port address range
    189  1.1.1.2.8.2  jruoho          * 2) Address range overlaps port range at the port range start
    190  1.1.1.2.8.2  jruoho          * 3) Address range overlaps port range at the port range end
    191  1.1.1.2.8.2  jruoho          * 4) Address range completely encompasses the port range
    192  1.1.1.2.8.2  jruoho          */
    193  1.1.1.2.8.2  jruoho         if ((Address <= PortInfo->End) && (LastAddress >= PortInfo->Start))
    194  1.1.1.2.8.2  jruoho         {
    195  1.1.1.2.8.2  jruoho             /* Port illegality may depend on the _OSI calls made by the BIOS */
    196  1.1.1.2.8.2  jruoho 
    197  1.1.1.2.8.2  jruoho             if (AcpiGbl_OsiData >= PortInfo->OsiDependency)
    198  1.1.1.2.8.2  jruoho             {
    199  1.1.1.2.8.2  jruoho                 ACPI_DEBUG_PRINT ((ACPI_DB_IO,
    200  1.1.1.2.8.2  jruoho                     "Denied AML access to port 0x%p/%X (%s 0x%.4X-0x%.4X)",
    201  1.1.1.2.8.2  jruoho                     ACPI_CAST_PTR (void, Address), ByteWidth, PortInfo->Name,
    202  1.1.1.2.8.2  jruoho                     PortInfo->Start, PortInfo->End));
    203  1.1.1.2.8.2  jruoho 
    204  1.1.1.2.8.2  jruoho                 return_ACPI_STATUS (AE_AML_ILLEGAL_ADDRESS);
    205  1.1.1.2.8.2  jruoho             }
    206  1.1.1.2.8.2  jruoho         }
    207  1.1.1.2.8.2  jruoho 
    208  1.1.1.2.8.2  jruoho         /* Finished if address range ends before the end of this port */
    209  1.1.1.2.8.2  jruoho 
    210  1.1.1.2.8.2  jruoho         if (LastAddress <= PortInfo->End)
    211  1.1.1.2.8.2  jruoho         {
    212  1.1.1.2.8.2  jruoho             break;
    213  1.1.1.2.8.2  jruoho         }
    214  1.1.1.2.8.2  jruoho     }
    215  1.1.1.2.8.2  jruoho 
    216  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (AE_OK);
    217  1.1.1.2.8.2  jruoho }
    218  1.1.1.2.8.2  jruoho 
    219  1.1.1.2.8.2  jruoho 
    220  1.1.1.2.8.2  jruoho /******************************************************************************
    221  1.1.1.2.8.2  jruoho  *
    222  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiHwReadPort
    223  1.1.1.2.8.2  jruoho  *
    224  1.1.1.2.8.2  jruoho  * PARAMETERS:  Address             Address of I/O port/register to read
    225  1.1.1.2.8.2  jruoho  *              Value               Where value is placed
    226  1.1.1.2.8.2  jruoho  *              Width               Number of bits
    227  1.1.1.2.8.2  jruoho  *
    228  1.1.1.2.8.2  jruoho  * RETURN:      Status and value read from port
    229  1.1.1.2.8.2  jruoho  *
    230  1.1.1.2.8.2  jruoho  * DESCRIPTION: Read data from an I/O port or register. This is a front-end
    231  1.1.1.2.8.2  jruoho  *              to AcpiOsReadPort that performs validation on both the port
    232  1.1.1.2.8.2  jruoho  *              address and the length.
    233  1.1.1.2.8.2  jruoho  *
    234  1.1.1.2.8.2  jruoho  *****************************************************************************/
    235  1.1.1.2.8.2  jruoho 
    236  1.1.1.2.8.2  jruoho ACPI_STATUS
    237  1.1.1.2.8.2  jruoho AcpiHwReadPort (
    238  1.1.1.2.8.2  jruoho     ACPI_IO_ADDRESS         Address,
    239  1.1.1.2.8.2  jruoho     UINT32                  *Value,
    240  1.1.1.2.8.2  jruoho     UINT32                  Width)
    241  1.1.1.2.8.2  jruoho {
    242  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    243  1.1.1.2.8.2  jruoho     UINT32                  OneByte;
    244  1.1.1.2.8.2  jruoho     UINT32                  i;
    245  1.1.1.2.8.2  jruoho 
    246  1.1.1.2.8.2  jruoho 
    247  1.1.1.2.8.2  jruoho     /* Truncate address to 16 bits if requested */
    248  1.1.1.2.8.2  jruoho 
    249  1.1.1.2.8.2  jruoho     if (AcpiGbl_TruncateIoAddresses)
    250  1.1.1.2.8.2  jruoho     {
    251  1.1.1.2.8.2  jruoho         Address &= ACPI_UINT16_MAX;
    252  1.1.1.2.8.2  jruoho     }
    253  1.1.1.2.8.2  jruoho 
    254  1.1.1.2.8.2  jruoho     /* Validate the entire request and perform the I/O */
    255  1.1.1.2.8.2  jruoho 
    256  1.1.1.2.8.2  jruoho     Status = AcpiHwValidateIoRequest (Address, Width);
    257  1.1.1.2.8.2  jruoho     if (ACPI_SUCCESS (Status))
    258  1.1.1.2.8.2  jruoho     {
    259  1.1.1.2.8.2  jruoho         Status = AcpiOsReadPort (Address, Value, Width);
    260  1.1.1.2.8.2  jruoho         return (Status);
    261  1.1.1.2.8.2  jruoho     }
    262  1.1.1.2.8.2  jruoho 
    263  1.1.1.2.8.2  jruoho     if (Status != AE_AML_ILLEGAL_ADDRESS)
    264  1.1.1.2.8.2  jruoho     {
    265  1.1.1.2.8.2  jruoho         return (Status);
    266  1.1.1.2.8.2  jruoho     }
    267  1.1.1.2.8.2  jruoho 
    268  1.1.1.2.8.2  jruoho     /*
    269  1.1.1.2.8.2  jruoho      * There has been a protection violation within the request. Fall
    270  1.1.1.2.8.2  jruoho      * back to byte granularity port I/O and ignore the failing bytes.
    271  1.1.1.2.8.2  jruoho      * This provides Windows compatibility.
    272  1.1.1.2.8.2  jruoho      */
    273  1.1.1.2.8.2  jruoho     for (i = 0, *Value = 0; i < Width; i += 8)
    274  1.1.1.2.8.2  jruoho     {
    275  1.1.1.2.8.2  jruoho         /* Validate and read one byte */
    276  1.1.1.2.8.2  jruoho 
    277  1.1.1.2.8.2  jruoho         if (AcpiHwValidateIoRequest (Address, 8) == AE_OK)
    278  1.1.1.2.8.2  jruoho         {
    279  1.1.1.2.8.2  jruoho             Status = AcpiOsReadPort (Address, &OneByte, 8);
    280  1.1.1.2.8.2  jruoho             if (ACPI_FAILURE (Status))
    281  1.1.1.2.8.2  jruoho             {
    282  1.1.1.2.8.2  jruoho                 return (Status);
    283  1.1.1.2.8.2  jruoho             }
    284  1.1.1.2.8.2  jruoho 
    285  1.1.1.2.8.2  jruoho             *Value |= (OneByte << i);
    286  1.1.1.2.8.2  jruoho         }
    287  1.1.1.2.8.2  jruoho 
    288  1.1.1.2.8.2  jruoho         Address++;
    289  1.1.1.2.8.2  jruoho     }
    290  1.1.1.2.8.2  jruoho 
    291  1.1.1.2.8.2  jruoho     return (AE_OK);
    292  1.1.1.2.8.2  jruoho }
    293  1.1.1.2.8.2  jruoho 
    294  1.1.1.2.8.2  jruoho 
    295  1.1.1.2.8.2  jruoho /******************************************************************************
    296  1.1.1.2.8.2  jruoho  *
    297  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiHwWritePort
    298  1.1.1.2.8.2  jruoho  *
    299  1.1.1.2.8.2  jruoho  * PARAMETERS:  Address             Address of I/O port/register to write
    300  1.1.1.2.8.2  jruoho  *              Value               Value to write
    301  1.1.1.2.8.2  jruoho  *              Width               Number of bits
    302  1.1.1.2.8.2  jruoho  *
    303  1.1.1.2.8.2  jruoho  * RETURN:      Status
    304  1.1.1.2.8.2  jruoho  *
    305  1.1.1.2.8.2  jruoho  * DESCRIPTION: Write data to an I/O port or register. This is a front-end
    306  1.1.1.2.8.2  jruoho  *              to AcpiOsWritePort that performs validation on both the port
    307  1.1.1.2.8.2  jruoho  *              address and the length.
    308  1.1.1.2.8.2  jruoho  *
    309  1.1.1.2.8.2  jruoho  *****************************************************************************/
    310  1.1.1.2.8.2  jruoho 
    311  1.1.1.2.8.2  jruoho ACPI_STATUS
    312  1.1.1.2.8.2  jruoho AcpiHwWritePort (
    313  1.1.1.2.8.2  jruoho     ACPI_IO_ADDRESS         Address,
    314  1.1.1.2.8.2  jruoho     UINT32                  Value,
    315  1.1.1.2.8.2  jruoho     UINT32                  Width)
    316  1.1.1.2.8.2  jruoho {
    317  1.1.1.2.8.2  jruoho     ACPI_STATUS             Status;
    318  1.1.1.2.8.2  jruoho     UINT32                  i;
    319  1.1.1.2.8.2  jruoho 
    320  1.1.1.2.8.2  jruoho 
    321  1.1.1.2.8.2  jruoho     /* Truncate address to 16 bits if requested */
    322  1.1.1.2.8.2  jruoho 
    323  1.1.1.2.8.2  jruoho     if (AcpiGbl_TruncateIoAddresses)
    324  1.1.1.2.8.2  jruoho     {
    325  1.1.1.2.8.2  jruoho         Address &= ACPI_UINT16_MAX;
    326  1.1.1.2.8.2  jruoho     }
    327  1.1.1.2.8.2  jruoho 
    328  1.1.1.2.8.2  jruoho     /* Validate the entire request and perform the I/O */
    329  1.1.1.2.8.2  jruoho 
    330  1.1.1.2.8.2  jruoho     Status = AcpiHwValidateIoRequest (Address, Width);
    331  1.1.1.2.8.2  jruoho     if (ACPI_SUCCESS (Status))
    332  1.1.1.2.8.2  jruoho     {
    333  1.1.1.2.8.2  jruoho         Status = AcpiOsWritePort (Address, Value, Width);
    334  1.1.1.2.8.2  jruoho         return (Status);
    335  1.1.1.2.8.2  jruoho     }
    336  1.1.1.2.8.2  jruoho 
    337  1.1.1.2.8.2  jruoho     if (Status != AE_AML_ILLEGAL_ADDRESS)
    338  1.1.1.2.8.2  jruoho     {
    339  1.1.1.2.8.2  jruoho         return (Status);
    340  1.1.1.2.8.2  jruoho     }
    341  1.1.1.2.8.2  jruoho 
    342  1.1.1.2.8.2  jruoho     /*
    343  1.1.1.2.8.2  jruoho      * There has been a protection violation within the request. Fall
    344  1.1.1.2.8.2  jruoho      * back to byte granularity port I/O and ignore the failing bytes.
    345  1.1.1.2.8.2  jruoho      * This provides Windows compatibility.
    346  1.1.1.2.8.2  jruoho      */
    347  1.1.1.2.8.2  jruoho     for (i = 0; i < Width; i += 8)
    348  1.1.1.2.8.2  jruoho     {
    349  1.1.1.2.8.2  jruoho         /* Validate and write one byte */
    350  1.1.1.2.8.2  jruoho 
    351  1.1.1.2.8.2  jruoho         if (AcpiHwValidateIoRequest (Address, 8) == AE_OK)
    352  1.1.1.2.8.2  jruoho         {
    353  1.1.1.2.8.2  jruoho             Status = AcpiOsWritePort (Address, (Value >> i) & 0xFF, 8);
    354  1.1.1.2.8.2  jruoho             if (ACPI_FAILURE (Status))
    355  1.1.1.2.8.2  jruoho             {
    356  1.1.1.2.8.2  jruoho                 return (Status);
    357  1.1.1.2.8.2  jruoho             }
    358  1.1.1.2.8.2  jruoho         }
    359  1.1.1.2.8.2  jruoho 
    360  1.1.1.2.8.2  jruoho         Address++;
    361  1.1.1.2.8.2  jruoho     }
    362  1.1.1.2.8.2  jruoho 
    363  1.1.1.2.8.2  jruoho     return (AE_OK);
    364  1.1.1.2.8.2  jruoho }
    365  1.1.1.2.8.2  jruoho 
    366  1.1.1.2.8.2  jruoho 
    367