xref: /titanic_50/usr/src/uts/intel/io/acpica/tables/tbfadt.c (revision f38cb554a534c6df738be3f4d23327e69888e634)
1 /******************************************************************************
2  *
3  * Module Name: tbfadt   - FADT table utilities
4  *
5  *****************************************************************************/
6 
7 /*
8  * Copyright (C) 2000 - 2011, Intel Corp.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
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.
25  *
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.
29  *
30  * NO WARRANTY
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.
42  */
43 
44 #define __TBFADT_C__
45 
46 #include "acpi.h"
47 #include "accommon.h"
48 #include "actables.h"
49 
50 #define _COMPONENT          ACPI_TABLES
51         ACPI_MODULE_NAME    ("tbfadt")
52 
53 /* Local prototypes */
54 
55 static ACPI_INLINE void
56 AcpiTbInitGenericAddress (
57     ACPI_GENERIC_ADDRESS    *GenericAddress,
58     UINT8                   SpaceId,
59     UINT8                   ByteWidth,
60     UINT64                  Address);
61 
62 static void
63 AcpiTbConvertFadt (
64     void);
65 
66 static void
67 AcpiTbValidateFadt (
68     void);
69 
70 static void
71 AcpiTbSetupFadtRegisters (
72     void);
73 
74 
75 /* Table for conversion of FADT to common internal format and FADT validation */
76 
77 typedef struct acpi_fadt_info
78 {
79     char                    *Name;
80     UINT8                   Address64;
81     UINT8                   Address32;
82     UINT8                   Length;
83     UINT8                   DefaultLength;
84     UINT8                   Type;
85 
86 } ACPI_FADT_INFO;
87 
88 #define ACPI_FADT_REQUIRED          1
89 #define ACPI_FADT_SEPARATE_LENGTH   2
90 
91 static ACPI_FADT_INFO     FadtInfoTable[] =
92 {
93     {"Pm1aEventBlock",
94         ACPI_FADT_OFFSET (XPm1aEventBlock),
95         ACPI_FADT_OFFSET (Pm1aEventBlock),
96         ACPI_FADT_OFFSET (Pm1EventLength),
97         ACPI_PM1_REGISTER_WIDTH * 2,        /* Enable + Status register */
98         ACPI_FADT_REQUIRED},
99 
100     {"Pm1bEventBlock",
101         ACPI_FADT_OFFSET (XPm1bEventBlock),
102         ACPI_FADT_OFFSET (Pm1bEventBlock),
103         ACPI_FADT_OFFSET (Pm1EventLength),
104         ACPI_PM1_REGISTER_WIDTH * 2,        /* Enable + Status register */
105         0},
106 
107     {"Pm1aControlBlock",
108         ACPI_FADT_OFFSET (XPm1aControlBlock),
109         ACPI_FADT_OFFSET (Pm1aControlBlock),
110         ACPI_FADT_OFFSET (Pm1ControlLength),
111         ACPI_PM1_REGISTER_WIDTH,
112         ACPI_FADT_REQUIRED},
113 
114     {"Pm1bControlBlock",
115         ACPI_FADT_OFFSET (XPm1bControlBlock),
116         ACPI_FADT_OFFSET (Pm1bControlBlock),
117         ACPI_FADT_OFFSET (Pm1ControlLength),
118         ACPI_PM1_REGISTER_WIDTH,
119         0},
120 
121     {"Pm2ControlBlock",
122         ACPI_FADT_OFFSET (XPm2ControlBlock),
123         ACPI_FADT_OFFSET (Pm2ControlBlock),
124         ACPI_FADT_OFFSET (Pm2ControlLength),
125         ACPI_PM2_REGISTER_WIDTH,
126         ACPI_FADT_SEPARATE_LENGTH},
127 
128     {"PmTimerBlock",
129         ACPI_FADT_OFFSET (XPmTimerBlock),
130         ACPI_FADT_OFFSET (PmTimerBlock),
131         ACPI_FADT_OFFSET (PmTimerLength),
132         ACPI_PM_TIMER_WIDTH,
133         ACPI_FADT_REQUIRED},
134 
135     {"Gpe0Block",
136         ACPI_FADT_OFFSET (XGpe0Block),
137         ACPI_FADT_OFFSET (Gpe0Block),
138         ACPI_FADT_OFFSET (Gpe0BlockLength),
139         0,
140         ACPI_FADT_SEPARATE_LENGTH},
141 
142     {"Gpe1Block",
143         ACPI_FADT_OFFSET (XGpe1Block),
144         ACPI_FADT_OFFSET (Gpe1Block),
145         ACPI_FADT_OFFSET (Gpe1BlockLength),
146         0,
147         ACPI_FADT_SEPARATE_LENGTH}
148 };
149 
150 #define ACPI_FADT_INFO_ENTRIES \
151             (sizeof (FadtInfoTable) / sizeof (ACPI_FADT_INFO))
152 
153 
154 /* Table used to split Event Blocks into separate status/enable registers */
155 
156 typedef struct acpi_fadt_pm_info
157 {
158     ACPI_GENERIC_ADDRESS    *Target;
159     UINT8                   Source;
160     UINT8                   RegisterNum;
161 
162 } ACPI_FADT_PM_INFO;
163 
164 static ACPI_FADT_PM_INFO    FadtPmInfoTable[] =
165 {
166     {&AcpiGbl_XPm1aStatus,
167         ACPI_FADT_OFFSET (XPm1aEventBlock),
168         0},
169 
170     {&AcpiGbl_XPm1aEnable,
171         ACPI_FADT_OFFSET (XPm1aEventBlock),
172         1},
173 
174     {&AcpiGbl_XPm1bStatus,
175         ACPI_FADT_OFFSET (XPm1bEventBlock),
176         0},
177 
178     {&AcpiGbl_XPm1bEnable,
179         ACPI_FADT_OFFSET (XPm1bEventBlock),
180         1}
181 };
182 
183 #define ACPI_FADT_PM_INFO_ENTRIES \
184             (sizeof (FadtPmInfoTable) / sizeof (ACPI_FADT_PM_INFO))
185 
186 
187 /*******************************************************************************
188  *
189  * FUNCTION:    AcpiTbInitGenericAddress
190  *
191  * PARAMETERS:  GenericAddress      - GAS struct to be initialized
192  *              SpaceId             - ACPI Space ID for this register
193  *              ByteWidth           - Width of this register, in bytes
194  *              Address             - Address of the register
195  *
196  * RETURN:      None
197  *
198  * DESCRIPTION: Initialize a Generic Address Structure (GAS)
199  *              See the ACPI specification for a full description and
200  *              definition of this structure.
201  *
202  ******************************************************************************/
203 
204 static ACPI_INLINE void
205 AcpiTbInitGenericAddress (
206     ACPI_GENERIC_ADDRESS    *GenericAddress,
207     UINT8                   SpaceId,
208     UINT8                   ByteWidth,
209     UINT64                  Address)
210 {
211 
212     /*
213      * The 64-bit Address field is non-aligned in the byte packed
214      * GAS struct.
215      */
216     ACPI_MOVE_64_TO_64 (&GenericAddress->Address, &Address);
217 
218     /* All other fields are byte-wide */
219 
220     GenericAddress->SpaceId = SpaceId;
221     GenericAddress->BitWidth = (UINT8) ACPI_MUL_8 (ByteWidth);
222     GenericAddress->BitOffset = 0;
223     GenericAddress->AccessWidth = 0; /* Access width ANY */
224 }
225 
226 
227 /*******************************************************************************
228  *
229  * FUNCTION:    AcpiTbParseFadt
230  *
231  * PARAMETERS:  TableIndex          - Index for the FADT
232  *
233  * RETURN:      None
234  *
235  * DESCRIPTION: Initialize the FADT, DSDT and FACS tables
236  *              (FADT contains the addresses of the DSDT and FACS)
237  *
238  ******************************************************************************/
239 
240 void
241 AcpiTbParseFadt (
242     UINT32                  TableIndex)
243 {
244     UINT32                  Length;
245     ACPI_TABLE_HEADER       *Table;
246 
247 
248     /*
249      * The FADT has multiple versions with different lengths,
250      * and it contains pointers to both the DSDT and FACS tables.
251      *
252      * Get a local copy of the FADT and convert it to a common format
253      * Map entire FADT, assumed to be smaller than one page.
254      */
255     Length = AcpiGbl_RootTableList.Tables[TableIndex].Length;
256 
257     Table = AcpiOsMapMemory (
258                 AcpiGbl_RootTableList.Tables[TableIndex].Address, Length);
259     if (!Table)
260     {
261         return;
262     }
263 
264     /*
265      * Validate the FADT checksum before we copy the table. Ignore
266      * checksum error as we want to try to get the DSDT and FACS.
267      */
268     (void) AcpiTbVerifyChecksum (Table, Length);
269 
270     /* Create a local copy of the FADT in common ACPI 2.0+ format */
271 
272     AcpiTbCreateLocalFadt (Table, Length);
273 
274     /* All done with the real FADT, unmap it */
275 
276     AcpiOsUnmapMemory (Table, Length);
277 
278     /* Obtain the DSDT and FACS tables via their addresses within the FADT */
279 
280     AcpiTbInstallTable ((ACPI_PHYSICAL_ADDRESS) AcpiGbl_FADT.XDsdt,
281         ACPI_SIG_DSDT, ACPI_TABLE_INDEX_DSDT);
282 
283     AcpiTbInstallTable ((ACPI_PHYSICAL_ADDRESS) AcpiGbl_FADT.XFacs,
284         ACPI_SIG_FACS, ACPI_TABLE_INDEX_FACS);
285 }
286 
287 
288 /*******************************************************************************
289  *
290  * FUNCTION:    AcpiTbCreateLocalFadt
291  *
292  * PARAMETERS:  Table               - Pointer to BIOS FADT
293  *              Length              - Length of the table
294  *
295  * RETURN:      None
296  *
297  * DESCRIPTION: Get a local copy of the FADT and convert it to a common format.
298  *              Performs validation on some important FADT fields.
299  *
300  * NOTE:        We create a local copy of the FADT regardless of the version.
301  *
302  ******************************************************************************/
303 
304 void
305 AcpiTbCreateLocalFadt (
306     ACPI_TABLE_HEADER       *Table,
307     UINT32                  Length)
308 {
309 
310     /*
311      * Check if the FADT is larger than the largest table that we expect
312      * (the ACPI 2.0/3.0 version). If so, truncate the table, and issue
313      * a warning.
314      */
315     if (Length > sizeof (ACPI_TABLE_FADT))
316     {
317         ACPI_WARNING ((AE_INFO,
318             "FADT (revision %u) is longer than ACPI 2.0 version, "
319             "truncating length %u to %u",
320             Table->Revision, Length, (UINT32) sizeof (ACPI_TABLE_FADT)));
321     }
322 
323     /* Clear the entire local FADT */
324 
325     ACPI_MEMSET (&AcpiGbl_FADT, 0, sizeof (ACPI_TABLE_FADT));
326 
327     /* Copy the original FADT, up to sizeof (ACPI_TABLE_FADT) */
328 
329     ACPI_MEMCPY (&AcpiGbl_FADT, Table,
330         ACPI_MIN (Length, sizeof (ACPI_TABLE_FADT)));
331 
332     /* Convert the local copy of the FADT to the common internal format */
333 
334     AcpiTbConvertFadt ();
335 
336     /* Validate FADT values now, before we make any changes */
337 
338     AcpiTbValidateFadt ();
339 
340     /* Initialize the global ACPI register structures */
341 
342     AcpiTbSetupFadtRegisters ();
343 }
344 
345 
346 /*******************************************************************************
347  *
348  * FUNCTION:    AcpiTbConvertFadt
349  *
350  * PARAMETERS:  None, uses AcpiGbl_FADT
351  *
352  * RETURN:      None
353  *
354  * DESCRIPTION: Converts all versions of the FADT to a common internal format.
355  *              Expand 32-bit addresses to 64-bit as necessary.
356  *
357  * NOTE:        AcpiGbl_FADT must be of size (ACPI_TABLE_FADT),
358  *              and must contain a copy of the actual FADT.
359  *
360  * Notes on 64-bit register addresses:
361  *
362  * After this FADT conversion, later ACPICA code will only use the 64-bit "X"
363  * fields of the FADT for all ACPI register addresses.
364  *
365  * The 64-bit "X" fields are optional extensions to the original 32-bit FADT
366  * V1.0 fields. Even if they are present in the FADT, they are optional and
367  * are unused if the BIOS sets them to zero. Therefore, we must copy/expand
368  * 32-bit V1.0 fields if the corresponding X field is zero.
369  *
370  * For ACPI 1.0 FADTs, all 32-bit address fields are expanded to the
371  * corresponding "X" fields in the internal FADT.
372  *
373  * For ACPI 2.0+ FADTs, all valid (non-zero) 32-bit address fields are expanded
374  * to the corresponding 64-bit X fields. For compatibility with other ACPI
375  * implementations, we ignore the 64-bit field if the 32-bit field is valid,
376  * regardless of whether the host OS is 32-bit or 64-bit.
377  *
378  ******************************************************************************/
379 
380 static void
381 AcpiTbConvertFadt (
382     void)
383 {
384     ACPI_GENERIC_ADDRESS    *Address64;
385     UINT32                  Address32;
386     UINT32                  i;
387 
388 
389     /* Update the local FADT table header length */
390 
391     AcpiGbl_FADT.Header.Length = sizeof (ACPI_TABLE_FADT);
392 
393     /*
394      * Expand the 32-bit FACS and DSDT addresses to 64-bit as necessary.
395      * Later code will always use the X 64-bit field.
396      */
397     if (!AcpiGbl_FADT.XFacs)
398     {
399         AcpiGbl_FADT.XFacs = (UINT64) AcpiGbl_FADT.Facs;
400     }
401     if (!AcpiGbl_FADT.XDsdt)
402     {
403         AcpiGbl_FADT.XDsdt = (UINT64) AcpiGbl_FADT.Dsdt;
404     }
405 
406     /*
407      * For ACPI 1.0 FADTs (revision 1 or 2), ensure that reserved fields which
408      * should be zero are indeed zero. This will workaround BIOSs that
409      * inadvertently place values in these fields.
410      *
411      * The ACPI 1.0 reserved fields that will be zeroed are the bytes located
412      * at offset 45, 55, 95, and the word located at offset 109, 110.
413      *
414      * Note: The FADT revision value is unreliable. Only the length can be
415      * trusted.
416      */
417     if (AcpiGbl_FADT.Header.Length <= ACPI_FADT_V2_SIZE)
418     {
419         AcpiGbl_FADT.PreferredProfile = 0;
420         AcpiGbl_FADT.PstateControl = 0;
421         AcpiGbl_FADT.CstControl = 0;
422         AcpiGbl_FADT.BootFlags = 0;
423     }
424 
425     /*
426      * Expand the ACPI 1.0 32-bit addresses to the ACPI 2.0 64-bit "X"
427      * generic address structures as necessary. Later code will always use
428      * the 64-bit address structures.
429      *
430      * March 2009:
431      * We now always use the 32-bit address if it is valid (non-null). This
432      * is not in accordance with the ACPI specification which states that
433      * the 64-bit address supersedes the 32-bit version, but we do this for
434      * compatibility with other ACPI implementations. Most notably, in the
435      * case where both the 32 and 64 versions are non-null, we use the 32-bit
436      * version. This is the only address that is guaranteed to have been
437      * tested by the BIOS manufacturer.
438      */
439     for (i = 0; i < ACPI_FADT_INFO_ENTRIES; i++)
440     {
441         Address32 = *ACPI_ADD_PTR (UINT32,
442             &AcpiGbl_FADT, FadtInfoTable[i].Address32);
443 
444         Address64 = ACPI_ADD_PTR (ACPI_GENERIC_ADDRESS,
445             &AcpiGbl_FADT, FadtInfoTable[i].Address64);
446 
447         /*
448          * If both 32- and 64-bit addresses are valid (non-zero),
449          * they must match.
450          */
451         if (Address64->Address && Address32 &&
452            (Address64->Address != (UINT64) Address32))
453         {
454             ACPI_ERROR ((AE_INFO,
455                 "32/64X address mismatch in %s: 0x%8.8X/0x%8.8X%8.8X, using 32",
456                 FadtInfoTable[i].Name, Address32,
457                 ACPI_FORMAT_UINT64 (Address64->Address)));
458         }
459 
460         /* Always use 32-bit address if it is valid (non-null) */
461 
462         if (Address32)
463         {
464             /*
465              * Copy the 32-bit address to the 64-bit GAS structure. The
466              * Space ID is always I/O for 32-bit legacy address fields
467              */
468             AcpiTbInitGenericAddress (Address64, ACPI_ADR_SPACE_SYSTEM_IO,
469                 *ACPI_ADD_PTR (UINT8, &AcpiGbl_FADT, FadtInfoTable[i].Length),
470                 (UINT64) Address32);
471         }
472     }
473 }
474 
475 
476 /*******************************************************************************
477  *
478  * FUNCTION:    AcpiTbValidateFadt
479  *
480  * PARAMETERS:  Table           - Pointer to the FADT to be validated
481  *
482  * RETURN:      None
483  *
484  * DESCRIPTION: Validate various important fields within the FADT. If a problem
485  *              is found, issue a message, but no status is returned.
486  *              Used by both the table manager and the disassembler.
487  *
488  * Possible additional checks:
489  * (AcpiGbl_FADT.Pm1EventLength >= 4)
490  * (AcpiGbl_FADT.Pm1ControlLength >= 2)
491  * (AcpiGbl_FADT.PmTimerLength >= 4)
492  * Gpe block lengths must be multiple of 2
493  *
494  ******************************************************************************/
495 
496 static void
497 AcpiTbValidateFadt (
498     void)
499 {
500     char                    *Name;
501     ACPI_GENERIC_ADDRESS    *Address64;
502     UINT8                   Length;
503     UINT32                  i;
504 
505 
506     /*
507      * Check for FACS and DSDT address mismatches. An address mismatch between
508      * the 32-bit and 64-bit address fields (FIRMWARE_CTRL/X_FIRMWARE_CTRL and
509      * DSDT/X_DSDT) would indicate the presence of two FACS or two DSDT tables.
510      */
511     if (AcpiGbl_FADT.Facs &&
512         (AcpiGbl_FADT.XFacs != (UINT64) AcpiGbl_FADT.Facs))
513     {
514         ACPI_WARNING ((AE_INFO,
515             "32/64X FACS address mismatch in FADT - "
516             "0x%8.8X/0x%8.8X%8.8X, using 32",
517             AcpiGbl_FADT.Facs, ACPI_FORMAT_UINT64 (AcpiGbl_FADT.XFacs)));
518 
519         AcpiGbl_FADT.XFacs = (UINT64) AcpiGbl_FADT.Facs;
520     }
521 
522     if (AcpiGbl_FADT.Dsdt &&
523         (AcpiGbl_FADT.XDsdt != (UINT64) AcpiGbl_FADT.Dsdt))
524     {
525         ACPI_WARNING ((AE_INFO,
526             "32/64X DSDT address mismatch in FADT - "
527             "0x%8.8X/0x%8.8X%8.8X, using 32",
528             AcpiGbl_FADT.Dsdt, ACPI_FORMAT_UINT64 (AcpiGbl_FADT.XDsdt)));
529 
530         AcpiGbl_FADT.XDsdt = (UINT64) AcpiGbl_FADT.Dsdt;
531     }
532 
533     /* Examine all of the 64-bit extended address fields (X fields) */
534 
535     for (i = 0; i < ACPI_FADT_INFO_ENTRIES; i++)
536     {
537         /*
538          * Generate pointer to the 64-bit address, get the register
539          * length (width) and the register name
540          */
541         Address64 = ACPI_ADD_PTR (ACPI_GENERIC_ADDRESS,
542                         &AcpiGbl_FADT, FadtInfoTable[i].Address64);
543         Length = *ACPI_ADD_PTR (UINT8,
544                         &AcpiGbl_FADT, FadtInfoTable[i].Length);
545         Name = FadtInfoTable[i].Name;
546 
547         /*
548          * For each extended field, check for length mismatch between the
549          * legacy length field and the corresponding 64-bit X length field.
550          */
551         if (Address64->Address &&
552            (Address64->BitWidth != ACPI_MUL_8 (Length)))
553         {
554             ACPI_WARNING ((AE_INFO,
555                 "32/64X length mismatch in %s: %u/%u",
556                 Name, ACPI_MUL_8 (Length), Address64->BitWidth));
557         }
558 
559         if (FadtInfoTable[i].Type & ACPI_FADT_REQUIRED)
560         {
561             /*
562              * Field is required (PM1aEvent, PM1aControl, PmTimer).
563              * Both the address and length must be non-zero.
564              */
565             if (!Address64->Address || !Length)
566             {
567                 ACPI_ERROR ((AE_INFO,
568                     "Required field %s has zero address and/or length:"
569                     " 0x%8.8X%8.8X/0x%X",
570                     Name, ACPI_FORMAT_UINT64 (Address64->Address), Length));
571             }
572         }
573         else if (FadtInfoTable[i].Type & ACPI_FADT_SEPARATE_LENGTH)
574         {
575             /*
576              * Field is optional (PM2Control, GPE0, GPE1) AND has its own
577              * length field. If present, both the address and length must
578              * be valid.
579              */
580             if ((Address64->Address && !Length) ||
581                 (!Address64->Address && Length))
582             {
583                 ACPI_WARNING ((AE_INFO,
584                     "Optional field %s has zero address or length: "
585                     "0x%8.8X%8.8X/0x%X",
586                     Name, ACPI_FORMAT_UINT64 (Address64->Address), Length));
587             }
588         }
589     }
590 }
591 
592 
593 /*******************************************************************************
594  *
595  * FUNCTION:    AcpiTbSetupFadtRegisters
596  *
597  * PARAMETERS:  None, uses AcpiGbl_FADT.
598  *
599  * RETURN:      None
600  *
601  * DESCRIPTION: Initialize global ACPI PM1 register definitions. Optionally,
602  *              force FADT register definitions to their default lengths.
603  *
604  ******************************************************************************/
605 
606 static void
607 AcpiTbSetupFadtRegisters (
608     void)
609 {
610     ACPI_GENERIC_ADDRESS    *Target64;
611     ACPI_GENERIC_ADDRESS    *Source64;
612     UINT8                   Pm1RegisterByteWidth;
613     UINT32                  i;
614 
615 
616     /*
617      * Optionally check all register lengths against the default values and
618      * update them if they are incorrect.
619      */
620     if (AcpiGbl_UseDefaultRegisterWidths)
621     {
622         for (i = 0; i < ACPI_FADT_INFO_ENTRIES; i++)
623         {
624             Target64 = ACPI_ADD_PTR (ACPI_GENERIC_ADDRESS, &AcpiGbl_FADT,
625                 FadtInfoTable[i].Address64);
626 
627             /*
628              * If a valid register (Address != 0) and the (DefaultLength > 0)
629              * (Not a GPE register), then check the width against the default.
630              */
631             if ((Target64->Address) &&
632                 (FadtInfoTable[i].DefaultLength > 0) &&
633                 (FadtInfoTable[i].DefaultLength != Target64->BitWidth))
634             {
635                 ACPI_WARNING ((AE_INFO,
636                     "Invalid length for %s: %u, using default %u",
637                     FadtInfoTable[i].Name, Target64->BitWidth,
638                     FadtInfoTable[i].DefaultLength));
639 
640                 /* Incorrect size, set width to the default */
641 
642                 Target64->BitWidth = FadtInfoTable[i].DefaultLength;
643             }
644         }
645     }
646 
647     /*
648      * Get the length of the individual PM1 registers (enable and status).
649      * Each register is defined to be (event block length / 2). Extra divide
650      * by 8 converts bits to bytes.
651      */
652     Pm1RegisterByteWidth = (UINT8)
653         ACPI_DIV_16 (AcpiGbl_FADT.XPm1aEventBlock.BitWidth);
654 
655     /*
656      * Calculate separate GAS structs for the PM1x (A/B) Status and Enable
657      * registers. These addresses do not appear (directly) in the FADT, so it
658      * is useful to pre-calculate them from the PM1 Event Block definitions.
659      *
660      * The PM event blocks are split into two register blocks, first is the
661      * PM Status Register block, followed immediately by the PM Enable
662      * Register block. Each is of length (Pm1EventLength/2)
663      *
664      * Note: The PM1A event block is required by the ACPI specification.
665      * However, the PM1B event block is optional and is rarely, if ever,
666      * used.
667      */
668 
669     for (i = 0; i < ACPI_FADT_PM_INFO_ENTRIES; i++)
670     {
671         Source64 = ACPI_ADD_PTR (ACPI_GENERIC_ADDRESS, &AcpiGbl_FADT,
672             FadtPmInfoTable[i].Source);
673 
674         if (Source64->Address)
675         {
676             AcpiTbInitGenericAddress (FadtPmInfoTable[i].Target,
677                 Source64->SpaceId, Pm1RegisterByteWidth,
678                 Source64->Address +
679                     (FadtPmInfoTable[i].RegisterNum * Pm1RegisterByteWidth));
680         }
681     }
682 }
683 
684