2 /*******************************************************************************
4 * Module Name: hwregs - Read/write access functions for the various ACPI
5 * control and status registers.
8 ******************************************************************************/
10 /******************************************************************************
14 * Some or all of this work - Copyright (c) 1999 - 2003, Intel Corp.
15 * All rights reserved.
19 * 2.1. This is your license from Intel Corp. under its intellectual property
20 * rights. You may have additional license terms from the party that provided
21 * you this software, covering your right to use that party's intellectual
24 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
25 * copy of the source code appearing in this file ("Covered Code") an
26 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
27 * base code distributed originally by Intel ("Original Intel Code") to copy,
28 * make derivatives, distribute, use and display any portion of the Covered
29 * Code in any form, with the right to sublicense such rights; and
31 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
32 * license (with the right to sublicense), under only those claims of Intel
33 * patents that are infringed by the Original Intel Code, to make, use, sell,
34 * offer to sell, and import the Covered Code and derivative works thereof
35 * solely to the minimum extent necessary to exercise the above copyright
36 * license, and in no event shall the patent license extend to any additions
37 * to or modifications of the Original Intel Code. No other license or right
38 * is granted directly or by implication, estoppel or otherwise;
40 * The above copyright and patent license is granted only if the following
45 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
46 * Redistribution of source code of any substantial portion of the Covered
47 * Code or modification with rights to further distribute source must include
48 * the above Copyright Notice, the above License, this list of Conditions,
49 * and the following Disclaimer and Export Compliance provision. In addition,
50 * Licensee must cause all Covered Code to which Licensee contributes to
51 * contain a file documenting the changes Licensee made to create that Covered
52 * Code and the date of any change. Licensee must include in that file the
53 * documentation of any changes made by any predecessor Licensee. Licensee
54 * must include a prominent statement that the modification is derived,
55 * directly or indirectly, from Original Intel Code.
57 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
58 * Redistribution of source code of any substantial portion of the Covered
59 * Code or modification without rights to further distribute source must
60 * include the following Disclaimer and Export Compliance provision in the
61 * documentation and/or other materials provided with distribution. In
62 * addition, Licensee may not authorize further sublicense of source of any
63 * portion of the Covered Code, and must include terms to the effect that the
64 * license from Licensee to its licensee is limited to the intellectual
65 * property embodied in the software Licensee provides to its licensee, and
66 * not to intellectual property embodied in modifications its licensee may
69 * 3.3. Redistribution of Executable. Redistribution in executable form of any
70 * substantial portion of the Covered Code or modification must reproduce the
71 * above Copyright Notice, and the following Disclaimer and Export Compliance
72 * provision in the documentation and/or other materials provided with the
75 * 3.4. Intel retains all right, title, and interest in and to the Original
78 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
79 * Intel shall be used in advertising or otherwise to promote the sale, use or
80 * other dealings in products derived from or relating to the Covered Code
81 * without prior written authorization from Intel.
83 * 4. Disclaimer and Export Compliance
85 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
86 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
87 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
88 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
89 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
90 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
93 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
94 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
95 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
96 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
97 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
98 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
99 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
102 * 4.3. Licensee shall not export, either directly or indirectly, any of this
103 * software or system incorporating such software without first obtaining any
104 * required license or other approval from the U. S. Department of Commerce or
105 * any other agency or department of the United States Government. In the
106 * event Licensee exports any such software from the United States or
107 * re-exports any such software from a foreign destination, Licensee shall
108 * ensure that the distribution and export/re-export of the software is in
109 * compliance with all laws, regulations, orders, or other restrictions of the
110 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
111 * any of its subsidiaries will export/re-export any technical data, process,
112 * software, or service, directly or indirectly, to any country for which the
113 * United States government or any agency thereof requires an export license,
114 * other governmental approval, or letter of assurance, without first obtaining
115 * such license, approval or letter.
117 *****************************************************************************/
122 #include "acnamesp.h"
123 #include "acevents.h"
125 #define _COMPONENT ACPI_HARDWARE
126 ACPI_MODULE_NAME ("hwregs")
129 /*******************************************************************************
131 * FUNCTION: AcpiHwClearAcpiStatus
133 * PARAMETERS: Flags - Lock the hardware or not
137 * DESCRIPTION: Clears all fixed and general purpose status bits
139 ******************************************************************************/
142 AcpiHwClearAcpiStatus (
148 ACPI_FUNCTION_TRACE ("HwClearAcpiStatus");
151 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "About to write %04X to %04X\n",
152 ACPI_BITMASK_ALL_FIXED_STATUS,
153 (UINT16) ACPI_GET_ADDRESS (AcpiGbl_FADT->XPm1aEvtBlk.Address)));
155 if (Flags & ACPI_MTX_LOCK)
157 Status = AcpiUtAcquireMutex (ACPI_MTX_HARDWARE);
158 if (ACPI_FAILURE (Status))
160 return_ACPI_STATUS (Status);
164 Status = AcpiHwRegisterWrite (ACPI_MTX_DO_NOT_LOCK, ACPI_REGISTER_PM1_STATUS,
165 ACPI_BITMASK_ALL_FIXED_STATUS);
166 if (ACPI_FAILURE (Status))
171 /* Clear the fixed events */
173 if (ACPI_VALID_ADDRESS (AcpiGbl_FADT->XPm1bEvtBlk.Address))
175 Status = AcpiHwLowLevelWrite (16, ACPI_BITMASK_ALL_FIXED_STATUS,
176 &AcpiGbl_FADT->XPm1bEvtBlk);
177 if (ACPI_FAILURE (Status))
183 /* Clear the GPE Bits in all GPE registers in all GPE blocks */
185 Status = AcpiEvWalkGpeList (AcpiHwClearGpeBlock);
188 if (Flags & ACPI_MTX_LOCK)
190 (void) AcpiUtReleaseMutex (ACPI_MTX_HARDWARE);
192 return_ACPI_STATUS (Status);
196 /*******************************************************************************
198 * FUNCTION: AcpiGetSleepTypeData
200 * PARAMETERS: SleepState - Numeric sleep state
201 * *SleepTypeA - Where SLP_TYPa is returned
202 * *SleepTypeB - Where SLP_TYPb is returned
204 * RETURN: Status - ACPI status
206 * DESCRIPTION: Obtain the SLP_TYPa and SLP_TYPb values for the requested sleep
209 ******************************************************************************/
212 AcpiGetSleepTypeData (
217 ACPI_STATUS Status = AE_OK;
218 ACPI_OPERAND_OBJECT *ObjDesc;
221 ACPI_FUNCTION_TRACE ("AcpiGetSleepTypeData");
225 * Validate parameters
227 if ((SleepState > ACPI_S_STATES_MAX) ||
228 !SleepTypeA || !SleepTypeB)
230 return_ACPI_STATUS (AE_BAD_PARAMETER);
234 * Evaluate the namespace object containing the values for this state
236 Status = AcpiNsEvaluateByName ((char *) AcpiGbl_DbSleepStates[SleepState],
238 if (ACPI_FAILURE (Status))
240 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%s while evaluating SleepState [%s]\n",
241 AcpiFormatException (Status), AcpiGbl_DbSleepStates[SleepState]));
243 return_ACPI_STATUS (Status);
246 /* Must have a return object */
250 ACPI_REPORT_ERROR (("Missing Sleep State object\n"));
251 Status = AE_NOT_EXIST;
254 /* It must be of type Package */
256 else if (ACPI_GET_OBJECT_TYPE (ObjDesc) != ACPI_TYPE_PACKAGE)
258 ACPI_REPORT_ERROR (("Sleep State object not a Package\n"));
259 Status = AE_AML_OPERAND_TYPE;
262 /* The package must have at least two elements */
264 else if (ObjDesc->Package.Count < 2)
266 ACPI_REPORT_ERROR (("Sleep State package does not have at least two elements\n"));
267 Status = AE_AML_NO_OPERAND;
270 /* The first two elements must both be of type Integer */
272 else if ((ACPI_GET_OBJECT_TYPE (ObjDesc->Package.Elements[0]) != ACPI_TYPE_INTEGER) ||
273 (ACPI_GET_OBJECT_TYPE (ObjDesc->Package.Elements[1]) != ACPI_TYPE_INTEGER))
275 ACPI_REPORT_ERROR (("Sleep State package elements are not both Integers (%s, %s)\n",
276 AcpiUtGetObjectTypeName (ObjDesc->Package.Elements[0]),
277 AcpiUtGetObjectTypeName (ObjDesc->Package.Elements[1])));
278 Status = AE_AML_OPERAND_TYPE;
283 * Valid _Sx_ package size, type, and value
285 *SleepTypeA = (UINT8) (ObjDesc->Package.Elements[0])->Integer.Value;
286 *SleepTypeB = (UINT8) (ObjDesc->Package.Elements[1])->Integer.Value;
289 if (ACPI_FAILURE (Status))
291 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "While evaluating SleepState [%s], bad Sleep object %p type %s\n",
292 AcpiGbl_DbSleepStates[SleepState], ObjDesc, AcpiUtGetObjectTypeName (ObjDesc)));
295 AcpiUtRemoveReference (ObjDesc);
296 return_ACPI_STATUS (Status);
300 /*******************************************************************************
302 * FUNCTION: AcpiHwGetRegisterBitMask
304 * PARAMETERS: RegisterId - Index of ACPI Register to access
306 * RETURN: The bit mask to be used when accessing the register
308 * DESCRIPTION: Map RegisterId into a register bit mask.
310 ******************************************************************************/
312 ACPI_BIT_REGISTER_INFO *
313 AcpiHwGetBitRegisterInfo (
316 ACPI_FUNCTION_NAME ("HwGetBitRegisterInfo");
319 if (RegisterId > ACPI_BITREG_MAX)
321 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Invalid BitRegister ID: %X\n", RegisterId));
325 return (&AcpiGbl_BitRegisterInfo[RegisterId]);
329 /*******************************************************************************
331 * FUNCTION: AcpiGetRegister
333 * PARAMETERS: RegisterId - ID of ACPI BitRegister to access
334 * ReturnValue - Value that was read from the register
335 * Flags - Lock the hardware or not
337 * RETURN: Value is read from specified Register. Value returned is
338 * normalized to bit0 (is shifted all the way right)
340 * DESCRIPTION: ACPI BitRegister read function.
342 ******************************************************************************/
350 UINT32 RegisterValue = 0;
351 ACPI_BIT_REGISTER_INFO *BitRegInfo;
355 ACPI_FUNCTION_TRACE ("AcpiGetRegister");
358 /* Get the info structure corresponding to the requested ACPI Register */
360 BitRegInfo = AcpiHwGetBitRegisterInfo (RegisterId);
363 return_ACPI_STATUS (AE_BAD_PARAMETER);
366 if (Flags & ACPI_MTX_LOCK)
368 Status = AcpiUtAcquireMutex (ACPI_MTX_HARDWARE);
369 if (ACPI_FAILURE (Status))
371 return_ACPI_STATUS (Status);
375 Status = AcpiHwRegisterRead (ACPI_MTX_DO_NOT_LOCK,
376 BitRegInfo->ParentRegister, &RegisterValue);
378 if (Flags & ACPI_MTX_LOCK)
380 (void) AcpiUtReleaseMutex (ACPI_MTX_HARDWARE);
383 if (ACPI_SUCCESS (Status))
385 /* Normalize the value that was read */
387 RegisterValue = ((RegisterValue & BitRegInfo->AccessBitMask)
388 >> BitRegInfo->BitPosition);
390 *ReturnValue = RegisterValue;
392 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "Read value %8.8X register %X\n",
393 RegisterValue, BitRegInfo->ParentRegister));
396 return_ACPI_STATUS (Status);
400 /*******************************************************************************
402 * FUNCTION: AcpiSetRegister
404 * PARAMETERS: RegisterId - ID of ACPI BitRegister to access
405 * Value - (only used on write) value to write to the
406 * Register, NOT pre-normalized to the bit pos.
407 * Flags - Lock the hardware or not
411 * DESCRIPTION: ACPI Bit Register write function.
413 ******************************************************************************/
421 UINT32 RegisterValue = 0;
422 ACPI_BIT_REGISTER_INFO *BitRegInfo;
426 ACPI_FUNCTION_TRACE_U32 ("AcpiSetRegister", RegisterId);
429 /* Get the info structure corresponding to the requested ACPI Register */
431 BitRegInfo = AcpiHwGetBitRegisterInfo (RegisterId);
434 ACPI_REPORT_ERROR (("Bad ACPI HW RegisterId: %X\n", RegisterId));
435 return_ACPI_STATUS (AE_BAD_PARAMETER);
438 if (Flags & ACPI_MTX_LOCK)
440 Status = AcpiUtAcquireMutex (ACPI_MTX_HARDWARE);
441 if (ACPI_FAILURE (Status))
443 return_ACPI_STATUS (Status);
447 /* Always do a register read first so we can insert the new bits */
449 Status = AcpiHwRegisterRead (ACPI_MTX_DO_NOT_LOCK,
450 BitRegInfo->ParentRegister, &RegisterValue);
451 if (ACPI_FAILURE (Status))
457 * Decode the Register ID
458 * Register ID = [Register block ID] | [bit ID]
460 * Check bit ID to fine locate Register offset.
461 * Check Mask to determine Register offset, and then read-write.
463 switch (BitRegInfo->ParentRegister)
465 case ACPI_REGISTER_PM1_STATUS:
468 * Status Registers are different from the rest. Clear by
469 * writing 1, and writing 0 has no effect. So, the only relevant
470 * information is the single bit we're interested in, all others should
471 * be written as 0 so they will be left unchanged.
473 Value = ACPI_REGISTER_PREPARE_BITS (Value,
474 BitRegInfo->BitPosition, BitRegInfo->AccessBitMask);
477 Status = AcpiHwRegisterWrite (ACPI_MTX_DO_NOT_LOCK,
478 ACPI_REGISTER_PM1_STATUS, (UINT16) Value);
484 case ACPI_REGISTER_PM1_ENABLE:
486 ACPI_REGISTER_INSERT_VALUE (RegisterValue, BitRegInfo->BitPosition,
487 BitRegInfo->AccessBitMask, Value);
489 Status = AcpiHwRegisterWrite (ACPI_MTX_DO_NOT_LOCK,
490 ACPI_REGISTER_PM1_ENABLE, (UINT16) RegisterValue);
494 case ACPI_REGISTER_PM1_CONTROL:
497 * Write the PM1 Control register.
498 * Note that at this level, the fact that there are actually TWO
499 * registers (A and B - and B may not exist) is abstracted.
501 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "PM1 control: Read %X\n", RegisterValue));
503 ACPI_REGISTER_INSERT_VALUE (RegisterValue, BitRegInfo->BitPosition,
504 BitRegInfo->AccessBitMask, Value);
506 Status = AcpiHwRegisterWrite (ACPI_MTX_DO_NOT_LOCK,
507 ACPI_REGISTER_PM1_CONTROL, (UINT16) RegisterValue);
511 case ACPI_REGISTER_PM2_CONTROL:
513 Status = AcpiHwRegisterRead (ACPI_MTX_DO_NOT_LOCK,
514 ACPI_REGISTER_PM2_CONTROL, &RegisterValue);
515 if (ACPI_FAILURE (Status))
520 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "PM2 control: Read %X from %8.8X%8.8X\n",
522 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (AcpiGbl_FADT->XPm2CntBlk.Address))));
524 ACPI_REGISTER_INSERT_VALUE (RegisterValue, BitRegInfo->BitPosition,
525 BitRegInfo->AccessBitMask, Value);
527 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "About to write %4.4X to %8.8X%8.8X\n",
529 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (AcpiGbl_FADT->XPm2CntBlk.Address))));
531 Status = AcpiHwRegisterWrite (ACPI_MTX_DO_NOT_LOCK,
532 ACPI_REGISTER_PM2_CONTROL, (UINT8) (RegisterValue));
543 if (Flags & ACPI_MTX_LOCK)
545 (void) AcpiUtReleaseMutex (ACPI_MTX_HARDWARE);
548 /* Normalize the value that was read */
550 ACPI_DEBUG_EXEC (RegisterValue = ((RegisterValue & BitRegInfo->AccessBitMask) >> BitRegInfo->BitPosition));
552 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "Set bits: %8.8X actual %8.8X register %X\n",
553 Value, RegisterValue, BitRegInfo->ParentRegister));
554 return_ACPI_STATUS (Status);
558 /******************************************************************************
560 * FUNCTION: AcpiHwRegisterRead
562 * PARAMETERS: UseLock - Mutex hw access.
563 * RegisterId - RegisterID + Offset.
565 * RETURN: Value read or written.
567 * DESCRIPTION: Acpi register read function. Registers are read at the
570 ******************************************************************************/
583 ACPI_FUNCTION_TRACE ("HwRegisterRead");
586 if (ACPI_MTX_LOCK == UseLock)
588 Status = AcpiUtAcquireMutex (ACPI_MTX_HARDWARE);
589 if (ACPI_FAILURE (Status))
591 return_ACPI_STATUS (Status);
597 case ACPI_REGISTER_PM1_STATUS: /* 16-bit access */
599 Status = AcpiHwLowLevelRead (16, &Value1, &AcpiGbl_FADT->XPm1aEvtBlk);
600 if (ACPI_FAILURE (Status))
605 /* PM1B is optional */
607 Status = AcpiHwLowLevelRead (16, &Value2, &AcpiGbl_FADT->XPm1bEvtBlk);
612 case ACPI_REGISTER_PM1_ENABLE: /* 16-bit access */
614 Status = AcpiHwLowLevelRead (16, &Value1, &AcpiGbl_XPm1aEnable);
615 if (ACPI_FAILURE (Status))
620 /* PM1B is optional */
622 Status = AcpiHwLowLevelRead (16, &Value2, &AcpiGbl_XPm1bEnable);
627 case ACPI_REGISTER_PM1_CONTROL: /* 16-bit access */
629 Status = AcpiHwLowLevelRead (16, &Value1, &AcpiGbl_FADT->XPm1aCntBlk);
630 if (ACPI_FAILURE (Status))
635 Status = AcpiHwLowLevelRead (16, &Value2, &AcpiGbl_FADT->XPm1bCntBlk);
640 case ACPI_REGISTER_PM2_CONTROL: /* 8-bit access */
642 Status = AcpiHwLowLevelRead (8, &Value1, &AcpiGbl_FADT->XPm2CntBlk);
646 case ACPI_REGISTER_PM_TIMER: /* 32-bit access */
648 Status = AcpiHwLowLevelRead (32, &Value1, &AcpiGbl_FADT->XPmTmrBlk);
651 case ACPI_REGISTER_SMI_COMMAND_BLOCK: /* 8-bit access */
653 Status = AcpiOsReadPort (AcpiGbl_FADT->SmiCmd, &Value1, 8);
657 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Unknown Register ID: %X\n", RegisterId));
658 Status = AE_BAD_PARAMETER;
663 if (ACPI_MTX_LOCK == UseLock)
665 (void) AcpiUtReleaseMutex (ACPI_MTX_HARDWARE);
668 if (ACPI_SUCCESS (Status))
670 *ReturnValue = Value1;
673 return_ACPI_STATUS (Status);
677 /******************************************************************************
679 * FUNCTION: AcpiHwRegisterWrite
681 * PARAMETERS: UseLock - Mutex hw access.
682 * RegisterId - RegisterID + Offset.
684 * RETURN: Value read or written.
686 * DESCRIPTION: Acpi register Write function. Registers are written at the
689 ******************************************************************************/
692 AcpiHwRegisterWrite (
700 ACPI_FUNCTION_TRACE ("HwRegisterWrite");
703 if (ACPI_MTX_LOCK == UseLock)
705 Status = AcpiUtAcquireMutex (ACPI_MTX_HARDWARE);
706 if (ACPI_FAILURE (Status))
708 return_ACPI_STATUS (Status);
714 case ACPI_REGISTER_PM1_STATUS: /* 16-bit access */
716 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_FADT->XPm1aEvtBlk);
717 if (ACPI_FAILURE (Status))
722 /* PM1B is optional */
724 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_FADT->XPm1bEvtBlk);
728 case ACPI_REGISTER_PM1_ENABLE: /* 16-bit access*/
730 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_XPm1aEnable);
731 if (ACPI_FAILURE (Status))
736 /* PM1B is optional */
738 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_XPm1bEnable);
742 case ACPI_REGISTER_PM1_CONTROL: /* 16-bit access */
744 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_FADT->XPm1aCntBlk);
745 if (ACPI_FAILURE (Status))
750 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_FADT->XPm1bCntBlk);
754 case ACPI_REGISTER_PM1A_CONTROL: /* 16-bit access */
756 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_FADT->XPm1aCntBlk);
760 case ACPI_REGISTER_PM1B_CONTROL: /* 16-bit access */
762 Status = AcpiHwLowLevelWrite (16, Value, &AcpiGbl_FADT->XPm1bCntBlk);
766 case ACPI_REGISTER_PM2_CONTROL: /* 8-bit access */
768 Status = AcpiHwLowLevelWrite (8, Value, &AcpiGbl_FADT->XPm2CntBlk);
772 case ACPI_REGISTER_PM_TIMER: /* 32-bit access */
774 Status = AcpiHwLowLevelWrite (32, Value, &AcpiGbl_FADT->XPmTmrBlk);
778 case ACPI_REGISTER_SMI_COMMAND_BLOCK: /* 8-bit access */
780 /* SMI_CMD is currently always in IO space */
782 Status = AcpiOsWritePort (AcpiGbl_FADT->SmiCmd, Value, 8);
787 Status = AE_BAD_PARAMETER;
792 if (ACPI_MTX_LOCK == UseLock)
794 (void) AcpiUtReleaseMutex (ACPI_MTX_HARDWARE);
797 return_ACPI_STATUS (Status);
801 /******************************************************************************
803 * FUNCTION: AcpiHwLowLevelRead
805 * PARAMETERS: Width - 8, 16, or 32
806 * Value - Where the value is returned
807 * Register - GAS register structure
811 * DESCRIPTION: Read from either memory, IO, or PCI config space.
813 ******************************************************************************/
819 ACPI_GENERIC_ADDRESS *Reg)
826 ACPI_FUNCTION_NAME ("HwLowLevelRead");
830 * Must have a valid pointer to a GAS structure, and
831 * a non-zero address within. However, don't return an error
832 * because the PM1A/B code must not fail if B isn't present.
835 (!ACPI_VALID_ADDRESS (Reg->Address)))
842 * Three address spaces supported:
843 * Memory, IO, or PCI_Config.
845 switch (Reg->AddressSpaceId)
847 case ACPI_ADR_SPACE_SYSTEM_MEMORY:
849 Status = AcpiOsReadMemory (
850 (ACPI_PHYSICAL_ADDRESS) ACPI_GET_ADDRESS (Reg->Address),
855 case ACPI_ADR_SPACE_SYSTEM_IO:
857 Status = AcpiOsReadPort ((ACPI_IO_ADDRESS) ACPI_GET_ADDRESS (Reg->Address),
862 case ACPI_ADR_SPACE_PCI_CONFIG:
866 PciId.Device = ACPI_PCI_DEVICE (ACPI_GET_ADDRESS (Reg->Address));
867 PciId.Function = ACPI_PCI_FUNCTION (ACPI_GET_ADDRESS (Reg->Address));
868 PciRegister = (UINT16) ACPI_PCI_REGISTER (ACPI_GET_ADDRESS (Reg->Address));
870 Status = AcpiOsReadPciConfiguration (&PciId, PciRegister,
876 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR,
877 "Unsupported address space: %X\n", Reg->AddressSpaceId));
878 return (AE_BAD_PARAMETER);
881 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "Read: %8.8X width %2d from %8.8X%8.8X (%s)\n",
883 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Reg->Address)),
884 AcpiUtGetRegionName (Reg->AddressSpaceId)));
890 /******************************************************************************
892 * FUNCTION: AcpiHwLowLevelWrite
894 * PARAMETERS: Width - 8, 16, or 32
895 * Value - To be written
896 * Register - GAS register structure
900 * DESCRIPTION: Write to either memory, IO, or PCI config space.
902 ******************************************************************************/
905 AcpiHwLowLevelWrite (
908 ACPI_GENERIC_ADDRESS *Reg)
915 ACPI_FUNCTION_NAME ("HwLowLevelWrite");
919 * Must have a valid pointer to a GAS structure, and
920 * a non-zero address within. However, don't return an error
921 * because the PM1A/B code must not fail if B isn't present.
924 (!ACPI_VALID_ADDRESS (Reg->Address)))
930 * Three address spaces supported:
931 * Memory, IO, or PCI_Config.
933 switch (Reg->AddressSpaceId)
935 case ACPI_ADR_SPACE_SYSTEM_MEMORY:
937 Status = AcpiOsWriteMemory (
938 (ACPI_PHYSICAL_ADDRESS) ACPI_GET_ADDRESS (Reg->Address),
943 case ACPI_ADR_SPACE_SYSTEM_IO:
945 Status = AcpiOsWritePort ((ACPI_IO_ADDRESS) ACPI_GET_ADDRESS (Reg->Address),
950 case ACPI_ADR_SPACE_PCI_CONFIG:
954 PciId.Device = ACPI_PCI_DEVICE (ACPI_GET_ADDRESS (Reg->Address));
955 PciId.Function = ACPI_PCI_FUNCTION (ACPI_GET_ADDRESS (Reg->Address));
956 PciRegister = (UINT16) ACPI_PCI_REGISTER (ACPI_GET_ADDRESS (Reg->Address));
958 Status = AcpiOsWritePciConfiguration (&PciId, PciRegister,
959 (ACPI_INTEGER) Value, Width);
964 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR,
965 "Unsupported address space: %X\n", Reg->AddressSpaceId));
966 return (AE_BAD_PARAMETER);
969 ACPI_DEBUG_PRINT ((ACPI_DB_IO, "Wrote: %8.8X width %2d to %8.8X%8.8X (%s)\n",
971 ACPI_FORMAT_UINT64 (ACPI_GET_ADDRESS (Reg->Address)),
972 AcpiUtGetRegionName (Reg->AddressSpaceId)));