1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
|
/* $NoKeywords:$ */
/**
* @file
*
* Agesa structures and definitions
*
* Contains AMD AGESA core interface
*
* @xrefitem bom "File Content Label" "Release Content"
* @e project: AGESA
* @e sub-project: Include
* @e \$Revision: 47417 $ @e \$Date: 2011-02-18 12:48:20 -0700 (Fri, 18 Feb 2011) $
*/
/*
*****************************************************************************
*
* Copyright (c) 2011, Advanced Micro Devices, Inc.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of Advanced Micro Devices, Inc. nor the names of
* its contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* ***************************************************************************
*
*/
#ifndef _AGESA_H_
#define _AGESA_H_
#include "Porting.h"
#include "AMD.h"
//
//
// AGESA Types and Definitions
//
//
// AGESA BASIC CALLOUTS
#define AGESA_MEM_RELEASE 0x00028000
// AGESA ADVANCED CALLOUTS, Processor
#define AGESA_CHECK_UMA 0x00028100
#define AGESA_DO_RESET 0x00028101
#define AGESA_ALLOCATE_BUFFER 0x00028102
#define AGESA_DEALLOCATE_BUFFER 0x00028103
#define AGESA_LOCATE_BUFFER 0x00028104
#define AGESA_RUNFUNC_ONAP 0x00028105
// AGESA ADVANCED CALLOUTS, HyperTransport
// AGESA ADVANCED CALLOUTS, Memory
#define AGESA_READ_SPD 0x00028140
#define AGESA_HOOKBEFORE_DRAM_INIT 0x00028141
#define AGESA_HOOKBEFORE_DQS_TRAINING 0x00028142
#define AGESA_READ_SPD_RECOVERY 0x00028143
#define AGESA_HOOKBEFORE_EXIT_SELF_REF 0x00028144
#define AGESA_HOOKBEFORE_DRAM_INIT_RECOVERY 0x00028145
// AGESA IDS CALLOUTS
#define AGESA_GET_IDS_INIT_DATA 0x00028200
// AGESA GNB CALLOUTS
#define AGESA_GNB_PCIE_SLOT_RESET 0x00028301
//------------------------------------------------------------------------
//
// HyperTransport Interface
//-----------------------------------------------------------------------------
// HT DEFINITIONS AND MACROS
//
//-----------------------------------------------------------------------------
// Width equates for call backs
#define HT_WIDTH_8_BITS 8 ///< Specifies 8 bit, or up to 8 bit widths.
#define HT_WIDTH_16_BITS 16 ///< Specifies 16 bit, or up to 16 bit widths.
#define HT_WIDTH_4_BITS 4
#define HT_WIDTH_2_BITS 2
#define HT_WIDTH_NO_LIMIT HT_WIDTH_16_BITS
// Frequency Limit equates for call backs which take a frequency supported mask.
#define HT_FREQUENCY_LIMIT_200M 1 ///< Specifies a limit of no more than 200 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_400M 7 ///< Specifies a limit of no more than 400 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_600M 0x1F ///< Specifies a limit of no more than 600 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_800M 0x3F ///< Specifies a limit of no more than 800 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_1000M 0x7F ///< Specifies a limit of no more than 1000 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_HT1_ONLY 0x7F ///< Specifies a limit of no more than 1000 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_1200M 0xFF ///< Specifies a limit of no more than 1200 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_1400M 0x1FF ///< Specifies a limit of no more than 1400 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_1600M 0x3FF ///< Specifies a limit of no more than 1600 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_1800M 0x7FF ///< Specifies a limit of no more than 1800 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_2000M 0xFFF ///< Specifies a limit of no more than 2000 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_2200M 0x1FFF ///< Specifies a limit of no more than 2200 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_2400M 0x3FFF ///< Specifies a limit of no more than 2400 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_2600M 0x7FFF ///< Specifies a limit of no more than 2600 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_2800M 0x27FFF ///< Specifies a limit of no more than 2800 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_3000M 0x67FFF ///< Specifies a limit of no more than 3000 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_3200M 0xE7FFF ///< Specifies a limit of no more than 3200 MHz HT frequency.
#define HT_FREQUENCY_LIMIT_3600M 0x1E7FFF
#define HT_FREQUENCY_LIMIT_MAX HT_FREQUENCY_LIMIT_3600M
#define HT_FREQUENCY_NO_LIMIT 0xFFFFFFFF ///< Specifies a no limit of HT frequency.
// Unit ID Clumping special values
#define HT_CLUMPING_DISABLE 0x00000000
#define HT_CLUMPING_NO_LIMIT 0xFFFFFFFF
#define HT_LIST_TERMINAL 0xFF ///< End of list.
#define HT_LIST_MATCH_ANY 0xFE ///< Match Any value, used for Sockets, Links, IO Chain Depth.
#define HT_LIST_MATCH_INTERNAL_LINK 0xFD ///< Match all of the internal links.
// Event Notify definitions
// Event definitions.
// Coherent subfunction events
#define HT_EVENT_COH_EVENTS 0x10001000
#define HT_EVENT_COH_NO_TOPOLOGY 0x10011000 ///< See ::HT_EVENT_DATA_COH_NO_TOPOLOGY.
#define HT_EVENT_COH_OBSOLETE000 0x10021000 // No longer used.
#define HT_EVENT_COH_PROCESSOR_TYPE_MIX 0x10031000 ///< See ::HT_EVENT_DATA_COH_PROCESSOR_TYPE_MIX.
#define HT_EVENT_COH_NODE_DISCOVERED 0x10041000 ///< See ::HT_EVENT_COH_NODE_DISCOVERED.
#define HT_EVENT_COH_MPCAP_MISMATCH 0x10051000 ///< See ::HT_EVENT_COH_MPCAP_MISMATCH.
// Non-coherent subfunction events
#define HT_EVENT_NCOH_EVENTS 0x10002000
#define HT_EVENT_NCOH_BUID_EXCEED 0x10012000 ///< See ::HT_EVENT_DATA_NCOH_BUID_EXCEED
#define HT_EVENT_NCOH_OBSOLETE000 0x10022000 // No longer used.
#define HT_EVENT_NCOH_BUS_MAX_EXCEED 0x10032000 ///< See ::HT_EVENT_DATA_NCOH_BUS_MAX_EXCEED.
#define HT_EVENT_NCOH_CFG_MAP_EXCEED 0x10042000 ///< See ::HT_EVENT_DATA_NCOH_CFG_MAP_EXCEED.
#define HT_EVENT_NCOH_DEVICE_FAILED 0x10052000 ///< See ::HT_EVENT_DATA_NCOH_DEVICE_FAILED
#define HT_EVENT_NCOH_AUTO_DEPTH 0x10062000 ///< See ::HT_EVENT_NCOH_AUTO_DEPTH
// Optimization subfunction events
#define HT_EVENT_OPT_EVENTS 0x10003000
#define HT_EVENT_OPT_REQUIRED_CAP_RETRY 0x10013000 ///< See ::HT_EVENT_DATA_OPT_REQUIRED_CAP.
#define HT_EVENT_OPT_REQUIRED_CAP_GEN3 0x10023000 ///< See ::HT_EVENT_DATA_OPT_REQUIRED_CAP.
#define HT_EVENT_OPT_UNUSED_LINKS 0x10033000 ///< See ::HT_EVENT_DATA_OPT_UNUSED_LINKS.
#define HT_EVENT_OPT_LINK_PAIR_EXCEED 0x10043000 ///< See ::HT_EVENT_DATA_OPT_LINK_PAIR_EXCEED.
// HW Fault events
#define HT_EVENT_HW_EVENTS 0x10004000
#define HT_EVENT_HW_SYNCFLOOD 0x10014000 ///< See ::HT_EVENT_DATA_HW_SYNCFLOOD.
#define HT_EVENT_HW_HTCRC 0x10024000 ///< See ::HT_EVENT_DATA_HW_HT_CRC.
// The Recovery HT component uses 0x10005000 for events.
// For consistency, we avoid that range here.
#define HT_MAX_NC_BUIDS 32
//----------------------------------------------------------------------------
// HT TYPEDEFS, STRUCTURES, ENUMS
//
//----------------------------------------------------------------------------
/// Specify the state redundant links are to be left in after match.
///
/// After matching a link for IGNORE_LINK or SKIP_REGANG, the link may be left alone,
/// or powered off.
typedef enum {
MATCHED, ///< The link matches the requested customization.
///< When used with IGNORE_LINK,
///< this will generally require other software to initialize the link.
///< When used with SKIP_REGANG,
///< the two unganged links will be available for distribution.
POWERED_OFF, ///< Power the link off. Support may vary based on processor model.
///< Power Off is only supported for coherent links.
///< Link power off may occur at a warm reset rather than immediately.
///< When used with SKIP_REGANG, the paired sublink is powered off, not the matching link.
UNMATCHED, ///< The link should be processed according to normal defaults.
///< Effectively, the link does not match the requested customization.
///< This can be used to exclude links from a following match any.
MaxFinalLinkState ///< Not a final link state, use for limit checking.
} FINAL_LINK_STATE;
/// Swap a device from its current id to a new one.
typedef struct {
IN UINT8 FromId; ///< The device responding to FromId,
IN UINT8 ToId; ///< will be moved to ToId.
} BUID_SWAP_ITEM;
/// Each Non-coherent chain may have a list of device swaps. After performing the swaps,
/// the final in order list of device ids is provided. (There can be more swaps than devices.)
/// The unused entries in both are filled with 0xFF.
typedef struct {
IN BUID_SWAP_ITEM Swaps[HT_MAX_NC_BUIDS]; ///< The BUID Swaps to perform
IN UINT8 FinalIds[HT_MAX_NC_BUIDS]; ///< The ordered final BUIDs, resulting from the swaps
} BUID_SWAP_LIST;
/// Control Manual Initialization of Non-Coherent Chains
///
/// This interface is checked every time a non-coherent chain is
/// processed. BUID assignment may be controlled explicitly on a
/// non-coherent chain. Provide a swap list. Swaps controls the
/// BUID assignment and FinalIds provides the device to device
/// Linking. Device orientation can be detected automatically, or
/// explicitly. See interface documentation for more details.
///
/// If a manual swap list is not supplied,
/// automatic non-coherent init assigns BUIDs starting at 1 and incrementing sequentially
/// based on each device's unit count.
typedef struct {
// Match fields
IN UINT8 Socket; ///< The Socket on which this chain is located
IN UINT8 Link; ///< The Link on the host for this chain
// Override fields
IN BUID_SWAP_LIST SwapList; ///< The swap list
} MANUAL_BUID_SWAP_LIST;
/// Override options for DEVICE_CAP_OVERRIDE.
///
/// Specify which override actions should be performed. For Checks, 1 means to check the item
/// and 0 means to skip the check. For the override options, 1 means to apply the override and
/// 0 means to ignore the override.
typedef struct {
IN UINT32 IsCheckDevVenId:1; ///< Check Match on Device/Vendor id
IN UINT32 IsCheckRevision:1; ///< Check Match on device Revision
IN UINT32 IsOverrideWidthIn:1; ///< Override Width In
IN UINT32 IsOverrideWidthOut:1; ///< Override Width Out
IN UINT32 IsOverrideFreq:1; ///< Override Frequency
IN UINT32 IsOverrideClumping:1; ///< Override Clumping
IN UINT32 IsDoCallout:1; ///< Make the optional callout
} DEVICE_CAP_OVERRIDE_OPTIONS;
/// Override capabilities of a device.
///
/// This interface is checked once for every Link on every IO device.
/// Provide the width and frequency capability if needed for this device.
/// This is used along with device capabilities, the limit interfaces, and northbridge
/// limits to compute the default settings. The components of the device's PCI config
/// address are provided, so its settings can be consulted if need be.
/// The optional callout is a catch all.
typedef struct {
// Match fields
IN UINT8 HostSocket; ///< The Socket on which this chain is located.
IN UINT8 HostLink; ///< The Link on the host for this chain.
IN UINT8 Depth; ///< The Depth in the I/O chain from the Host.
IN UINT32 DevVenId; ///< The Device's PCI Vendor + Device ID (offset 0x00).
IN UINT8 Revision; ///< The Device's PCI Revision field (offset 0x08).
IN UINT8 Link; ///< The Device's Link number (0 or 1).
IN DEVICE_CAP_OVERRIDE_OPTIONS Options; ///< The options for this device override.
// Override fields
IN UINT8 LinkWidthIn; ///< modify to change the Link Width In.
IN UINT8 LinkWidthOut; ///< modify to change the Link Width Out.
IN UINT32 FreqCap; ///< modify to change the Link's frequency capability.
IN UINT32 Clumping; ///< modify to change Unit ID clumping support.
IN CALLOUT_ENTRY Callout; ///< optional call for really complex cases, or NULL.
} DEVICE_CAP_OVERRIDE;
/// Callout param struct for override capabilities of a device.
///
/// If the optional callout is implemented this param struct is passed to it.
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
// Match fields
IN UINT8 HostSocket; ///< The Socket on which this chain is located.
IN UINT8 HostLink; ///< The Link on the host for this chain.
IN UINT8 Depth; ///< The Depth in the I/O chain from the Host.
IN UINT32 DevVenId; ///< The Device's PCI Vendor + Device ID (offset 0x00).
IN UINT8 Revision; ///< The Device's PCI Revision field (offset 0x08).
IN UINT8 Link; ///< The Device's Link number (0 or 1).
IN PCI_ADDR PciAddress; ///< The Device's PCI Address.
// Override fields
OUT UINT8 *LinkWidthIn; ///< modify to change the Link Width In.
OUT UINT8 *LinkWidthOut; ///< modify to change the Link Width Out.
OUT UINT32 *FreqCap; ///< modify to change the Link's frequency capability.
OUT UINT32 *Clumping; ///< modify to change Unit ID clumping support.
} DEVICE_CAP_CALLOUT_PARAMS;
/// Limits for CPU to CPU Links.
///
/// For each coherent connection this interface is checked once.
/// Provide the frequency and width if needed for this Link (usually based on board
/// restriction). This is used with CPU device capabilities and northbridge limits
/// to compute the default settings.
typedef struct {
// Match fields
IN UINT8 SocketA; ///< One Socket on which this Link is located
IN UINT8 LinkA; ///< The Link on this Node
IN UINT8 SocketB; ///< The other Socket on which this Link is located
IN UINT8 LinkB; ///< The Link on that Node
// Limit fields
IN UINT8 ABLinkWidthLimit; ///< modify to change the Link Width A->B
IN UINT8 BALinkWidthLimit; ///< modify to change the Link Width B-<A
IN UINT32 PcbFreqCap; ///< modify to change the Link's frequency capability
} CPU_TO_CPU_PCB_LIMITS;
/// Get limits for non-coherent Links.
///
/// For each non-coherent connection this interface is checked once.
/// Provide the frequency and width if needed for this Link (usually based on board
/// restriction). This is used with device capabilities, device overrides, and northbridge limits
/// to compute the default settings.
///
typedef struct {
// Match fields
IN UINT8 HostSocket; ///< The Socket on which this Link is located
IN UINT8 HostLink; ///< The Link about to be initialized
IN UINT8 Depth; ///< The Depth in the I/O chain from the Host
// Limit fields
IN UINT8 DownstreamLinkWidthLimit; ///< modify to change the Link Width going away from processor
IN UINT8 UpstreamLinkWidthLimit; ///< modify to change the Link Width moving toward processor
IN UINT32 PcbFreqCap; ///< modify to change the Link's frequency capability
} IO_PCB_LIMITS;
/// Manually control bus number assignment.
///
/// This interface is checked every time a non-coherent chain is processed.
/// If a system can not use the auto Bus numbering feature for non-coherent chain bus
/// assignments, this interface can provide explicit control. For each chain, provide
/// the bus number range to use.
typedef struct {
// Match fields
IN UINT8 Socket; ///< The Socket on which this chain is located
IN UINT8 Link; ///< The Link on the host for this chain
// Override fields
IN UINT8 SecBus; ///< Secondary Bus number for this non-coherent chain
IN UINT8 SubBus; ///< Subordinate Bus number
} OVERRIDE_BUS_NUMBERS;
/// Ignore a Link.
///
/// This interface is checked every time a coherent Link is found and then every
/// time a non-coherent Link from a CPU is found.
/// Any coherent or non-coherent Link from a CPU can be ignored and not used
/// for discovery or initialization. Useful for connection based systems.
/// (Note: not checked for IO device to IO Device Links.)
/// (Note: not usable for internal links (MCM processors).)
typedef struct {
// Match fields
IN UINT8 Socket; ///< The Socket on which this Link is located
IN UINT8 Link; ///< The Link about to be initialized
// Customization fields
IN FINAL_LINK_STATE LinkState; ///< The link may be left unitialized, or powered off.
} IGNORE_LINK;
/// Skip reganging of subLinks.
///
/// This interface is checked whenever two subLinks are both connected to the same CPUs.
/// Normally, unganged sublinks between the same two CPUs are reganged.
/// Provide a matching structure to leave the Links unganged.
typedef struct {
// Match fields
IN UINT8 SocketA; ///< One Socket on which this Link is located
IN UINT8 LinkA; ///< The Link on this Node
IN UINT8 SocketB; ///< The other Socket on which this Link is located
IN UINT8 LinkB; ///< The Link on that Node
// Customization fields
IN FINAL_LINK_STATE LinkState; ///< The paired sublink may be active, or powered off.
} SKIP_REGANG;
/// The System Socket layout, which sockets are physically connected.
///
/// The hardware method for Socket naming is preferred. Use this software method only
/// if required.
typedef struct {
IN UINT8 CurrentSocket; ///< The socket from which this connection originates.
IN UINT8 CurrentLink; ///< The Link from the source socket connects to another socket.
IN UINT8 TargetSocket; ///< The target socket which is connected on that link.
} SYSTEM_PHYSICAL_SOCKET_MAP;
//----------------------------------------------------------------------------
///
/// This is the input structure for AmdHtInitialize.
///
typedef struct {
// Basic level customization
IN UINT8 AutoBusStart; ///< For automatic bus number assignment, starting bus number - usually zero.
///< @BldCfgItem{BLDCFG_STARTING_BUSNUM}
IN UINT8 AutoBusMax; ///< For automatic bus number assignment, do not assign above max.
///< @BldCfgItem{BLDCFG_MAXIMUM_BUSNUM}
IN UINT8 AutoBusIncrement; ///< For automatic bus number assignment, each chain gets this many busses.
///< @BldCfgItem{BLDCFG_ALLOCATED_BUSNUMS}
// Advanced Level Customization
IN MANUAL_BUID_SWAP_LIST *ManualBuidSwapList; ///< Provide Manual Swap List, if any.
///< @BldCfgItem{BLDCFG_BUID_SWAP_LIST}
IN DEVICE_CAP_OVERRIDE *DeviceCapOverrideList; ///< Provide Device Overrides, if any.
///< @BldCfgItem{BLDCFG_HTDEVICE_CAPABILITIES_OVERRIDE_LIST}
IN CPU_TO_CPU_PCB_LIMITS *CpuToCpuPcbLimitsList; ///< Provide CPU PCB Limits, if any.
///< @BldCfgItem{BLDCFG_HTFABRIC_LIMITS_LIST}.
///< @n @e Examples: See @ref FrequencyLimitExamples "Frequency Limit Examples".
IN IO_PCB_LIMITS *IoPcbLimitsList; ///< Provide IO PCB Limits, if any.
///< @BldCfgItem{BLDCFG_HTCHAIN_LIMITS_LIST}.
///< @n @e Examples: See @ref FrequencyLimitExamples "Frequency Limit Examples".
IN OVERRIDE_BUS_NUMBERS *OverrideBusNumbersList; ///< Provide manual Bus Number assignment, if any.
///< Use either auto bus numbering or override bus
///< numbers, not both.
///< @BldCfgItem{BLDCFG_BUS_NUMBERS_LIST}
IN IGNORE_LINK *IgnoreLinkList; ///< Provide links to ignore, if any.
///< @BldCfgItem{BLDCFG_IGNORE_LINK_LIST}
IN SKIP_REGANG *SkipRegangList; ///< Provide links to remain unganged, if any.
///< @BldCfgItem{BLDCFG_LINK_SKIP_REGANG_LIST}
///< @n @e Examples: See @ref PerfPerWattHt "Performance-per-watt Optimization".
// Expert Level Customization
IN UINT8 **Topolist; ///< Use this topology list in addition to the built in, if not NULL.
///< @BldCfgItem{BLDCFG_ADDITIONAL_TOPOLOGIES_LIST}
IN SYSTEM_PHYSICAL_SOCKET_MAP *SystemPhysicalSocketMap;
///< The hardware socket naming method is preferred,
///< If it can't be used, this provides a software method.
///< @BldCfgItem{BLDCFG_SYSTEM_PHYSICAL_SOCKET_MAP}
} AMD_HT_INTERFACE;
//-----------------------------------------------------------------------------
//
// HT Recovery Interface
//
/*-----------------------------------------------------------------------------
* HT Recovery DEFINITIONS AND MACROS
*
*-----------------------------------------------------------------------------
*/
// BBHT subfunction events
#define HT_EVENT_BB_EVENTS 0x10005000
#define HT_EVENT_BB_BUID_EXCEED 0x10015000
#define HT_EVENT_BB_DEVICE_FAILED 0x10055000
#define HT_EVENT_BB_AUTO_DEPTH 0x10065000
/*----------------------------------------------------------------------------
* HT Recovery TYPEDEFS, STRUCTURES, ENUMS
*
*----------------------------------------------------------------------------
*/
/// The Interface structure to Recovery HT.
typedef struct {
IN MANUAL_BUID_SWAP_LIST *ManualBuidSwapList; ///< Option to manually control SB link init
///< @BldCfgItem{BLDCFG_BUID_SWAP_LIST}
OUT UINT32 Depth; ///< If auto init was used this is set to the depth of the chain,
///< else, for manual init unmodified.
} AMD_HT_RESET_INTERFACE;
/*----------------------------------------------------------------------------
* CPU Feature related info
*----------------------------------------------------------------------------
*/
/// Build Configuration values for BLDCFG_PLATFORM_C1E_MODE
typedef enum {
C1eModeDisabled = 0, ///< Disabled
C1eModeHardware = 1, ///< Hardware method
C1eModeMsgBased = 2, ///< Message-based method
C1eModeSoftwareDeprecated = 3, ///< Deprecated software SMI method.
///< Refer to "Addendum\Examples\C1eSMMHandler.asm" for
///< example host BIOS SMM Handler implementation
C1eModeHardwareSoftwareDeprecated = 4, ///< Hardware or deprecated software SMI method
MaxC1eMode = 5 ///< Not a valid value, used for verifying input
} PLATFORM_C1E_MODES;
/// Build Configuration values for BLDCFG_PLATFORM_CSTATE_MODE
typedef enum {
CStateModeDisabled = 0, ///< Disabled
CStateModeC6 = 1, ///< C6 State
MaxCStateMode = 2 ///< Not a valid value, used for verifying input
} PLATFORM_CSTATE_MODES;
/// Build Configuration values for BLDCFG_PLATFORM_CPB_MODE
typedef enum {
CpbModeAuto = 0, ///< Auto
CpbModeDisabled = 1, ///< Disabled
MaxCpbMode = 2 ///< Not a valid value, used for verifying input
} PLATFORM_CPB_MODES;
/*----------------------------------------------------------------------------
* GNB PCIe configuration info
*----------------------------------------------------------------------------
*/
// Event definitions
#define GNB_EVENT_INVALID_CONFIGURATION 0x20010000 // User configuration invalid
#define GNB_EVENT_INVALID_PCIE_TOPOLOGY_CONFIGURATION 0x20010001 // Requested lane allocation for PCIe port can not be supported
#define GNB_EVENT_INVALID_PCIE_PORT_CONFIGURATION 0x20010002 // Requested incorrect PCIe port device address
#define GNB_EVENT_INVALID_DDI_LINK_CONFIGURATION 0x20010003 // Incorrect parameter in DDI link configuration
#define GNB_EVENT_INVALID_LINK_WIDTH_CONFIGURATION 0x20010004 // Invalid with for PCIe port or DDI link
#define GNB_EVENT_INVALID_LANES_CONFIGURATION 0x20010005 // Lane double subscribe lanes
#define GNB_EVENT_INVALID_DDI_TOPOLOGY_CONFIGURATION 0x20010006 // Requested lane allocation for DDI link(s) can not be supported
#define GNB_EVENT_LINK_TRAINING_FAIL 0x20020000 // PCIe Link training fail
#define GNB_EVENT_BROKEN_LANE_RECOVERY 0x20030000 // Broken lane workaround applied to recover link training
#define GNB_EVENT_GEN2_SUPPORT_RECOVERY 0x20040000 // Scale back to GEN1 to recover link training
#define DESCRIPTOR_TERMINATE_LIST 0x80000000ull
/// PCIe port misc extended controls
typedef struct {
IN UINT8 LinkComplianceMode :1; ///< Force port into compliance mode (device will not be trained, port output compliance pattern)
IN UINT8 LinkSafeMode :2; /**< Safe mode PCIe capability. (Parameter may limit PCIe speed requested through PCIe_PORT_DATA::LinkSpeedCapability)
* @li @b 0 - port can advertize muximum supported capability
* @li @b 1 - port limit advertized capability and speed to PCIe Gen1
*/
} PCIe_PORT_MISC_CONTROL;
/// PCIe port configuration data
typedef struct {
IN UINT8 PortPresent; ///< Enable PCIe port for initialization.
IN UINT8 ChannelType; /**< Channel type.
* @li @b 0 - "lowLoss",
* @li @b 1 - "highLoss",
* @li @b 2 - "mob0db",
* @li @b 3 - "mob3db",
* @li @b 4 - "extnd6db"
* @li @b 5 - "extnd8db"
*/
IN UINT8 DeviceNumber; /**< PCI Device number for port.
* @li @b 0 - Native port device number
* @li @b N - Port device number (See available configurations @ref F12LaneConfigurations "Family 0x12", @ref F14LaneConfigurations "Family 0x14")
*/
IN UINT8 FunctionNumber; ///< Reserved for future use
IN UINT8 LinkSpeedCapability; /**< PCIe link speed/
* @li @b 0 - Maximum supported by silicon
* @li @b 1 - Gen1
* @li @b 2 - Gen2
* @li @b 3 - Gen3
*/
IN UINT8 LinkAspm; /**< ASPM control. (see AgesaPcieLinkAspm for additional option to control ASPM)
* @li @b 0 - Disabled
* @li @b 1 - L0s only
* @li @b 2 - L1 only
* @li @b 3 - L0s and L1
*/
IN UINT8 LinkHotplug; /**< Hotplug control.
* @li @b 0 - Disabled
* @li @b 1 - Basic
* @li @b 2 - Server
* @li @b 3 - Enhanced
*/
IN UINT8 ResetId; /**< Arbitrary number greater than 0 assigned by platform firmware for GPIO
* identification which control reset for given port.
* Each port with unique GPIO should have unique ResetId assigned.
* All ports use same GPIO to control reset should have same ResetId assigned.
* see AgesaPcieSlotResetContol.
*/
IN PCIe_PORT_MISC_CONTROL MiscControls; ///< Misc extended controls
} PCIe_PORT_DATA;
/// DDI channel lane mapping
typedef struct { ///< Structure that discribe lane mapping
IN UINT8 Lane0 :2; /**< Lane 0 mapping
* @li @b 0 - Map to lane 0
* @li @b 1 - Map to lane 1
* @li @b 2 - Map to lane 2
* @li @b 2 - Map to lane 3
*/
IN UINT8 Lane1 :2; ///< Lane 1 mapping (see "Lane 0 mapping")
IN UINT8 Lane2 :2; ///< Lane 2 mapping (see "Lane 0 mapping")
IN UINT8 Lane3 :2; ///< Lane 3 mapping (see "Lane 0 mapping")
} CHANNEL_MAPPING; ///< Lane mapping
/// Common Channel Mapping
typedef union {
IN UINT8 ChannelMappingValue; ///< Raw lane mapping
IN CHANNEL_MAPPING ChannelMapping; ///< Channel mapping
} CONN_CHANNEL_MAPPING;
/// DDI Configuration data
typedef struct {
IN UINT8 ConnectorType; /**< Display Connector Type
* @li @b 0 - DP
* @li @b 1 - eDP
* @li @b 2 - Single Link DVI-D
* @li @b 3 - Dual Link DVI-D (see @ref F12DualLinkDviDescription "Family 0x12 Dual Link DVI connector description")
* @li @b 4 - HDMI
* @li @b 5 - Travis DP-to-VGA
* @li @b 6 - Travis DP-to-LVDS
* @li @b 7 - Hudson-2 NutMeg DP-to-VGA
* @li @b 8 - Single Link DVI-I
* @li @b 9 - Native CRT (Family 0x14)
* @li @b 10 - Native LVDS (Family 0x14)
* @li @b 11 - Auto detect LCD panel connector type. VBIOS is able to auto detect the LVDS connector type: native LVDS, eDP or Travis-LVDS
* The auto detection method only support panel with EDID.
*/
IN UINT8 AuxIndex; /**< Indicates which AUX or DDC Line is used
* @li @b 0 - AUX1
* @li @b 1 - AUX2
* @li @b 2 - AUX3
* @li @b 3 - AUX4
* @li @b 4 - AUX5
* @li @b 5 - AUX6
*/
IN UINT8 HdpIndex; /**< Indicates which HDP pin is used
* @li @b 0 - HDP1
* @li @b 1 - HDP2
* @li @b 2 - HDP3
* @li @b 3 - HDP4
* @li @b 4 - HDP5
* @li @b 5 - HDP6
*/
IN CONN_CHANNEL_MAPPING Mapping[2]; /**< Set specific mapping of lanes to connector pins
* @li Mapping[0] define mapping for group of 4 lanes starting at PCIe_ENGINE_DATA.StartLane
* @li Mapping[1] define mapping for group of 4 lanes ending at PCIe_ENGINE_DATA.EndLane (only applicable for Dual DDI link)
* if Mapping[x] set to 0 than default mapping assumed
*/
} PCIe_DDI_DATA;
/// Engine Configuration
typedef struct {
IN UINT8 EngineType; /**< Engine type
* @li @b 0 - Ignore engine configuration
* @li @b 1 - PCIe port
* @li @b 2 - DDI
*/
IN UINT16 StartLane; /**< Start Lane ID (in reversed configuration StartLane > EndLane)
* See lane description for @ref F12PcieLaneDescription "Family 0x12"
* @ref F14PcieLaneDescription "Family 0x14".
* See lane configurations for @ref F12LaneConfigurations "Family 0x12"
* @ref F14LaneConfigurations "Family 0x14".
*/
IN UINT16 EndLane; /**< End lane ID (in reversed configuration StartLane > EndLane)
* See lane description for @ref F12PcieLaneDescription "Family 0x12",
* @ref F14PcieLaneDescription "Family 0x14".
* See lane configurations for @ref F12LaneConfigurations "Family 0x12"
* @ref F14LaneConfigurations "Family 0x14".
*/
} PCIe_ENGINE_DATA;
/// PCIe port descriptor
typedef struct {
IN UINT32 Flags; /**< Descriptor flags
* @li @b Bit31 - last descriptor in complex
*/
IN PCIe_ENGINE_DATA EngineData; ///< Engine data
IN PCIe_PORT_DATA Port; ///< PCIe port specific configuration info
} PCIe_PORT_DESCRIPTOR;
/// DDI descriptor
typedef struct {
IN UINT32 Flags; /**< Descriptor flags
* @li @b Bit31 - last descriptor in complex
*/
IN PCIe_ENGINE_DATA EngineData; ///< Engine data
IN PCIe_DDI_DATA Ddi; ///< DDI port specific configuration info
} PCIe_DDI_DESCRIPTOR;
/// PCIe Complex descriptor
typedef struct {
IN UINT32 Flags; /**< Descriptor flags
* @li @b Bit31 - last descriptor in topology
*/
IN UINT32 SocketId; ///< Socket Id
IN CONST PCIe_PORT_DESCRIPTOR *PciePortList; ///< Pointer to array of PCIe port descriptors or NULL (Last element of array must be terminated with DESCRIPTOR_TERMINATE_LIST).
IN CONST PCIe_DDI_DESCRIPTOR *DdiLinkList; ///< Pointer to array DDI link descriptors (Last element of array must be terminated with DESCRIPTOR_TERMINATE_LIST).
IN VOID *Reserved; ///< Reserved for future use
} PCIe_COMPLEX_DESCRIPTOR;
/// Action to control PCIe slot reset
typedef enum {
AssertSlotReset, ///< Assert slot reset
DeassertSlotReset ///< Deassert slot reset
} PCIE_RESET_CONTROL;
///Slot Reset Info
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN UINT8 ResetId; ///< Slot reset ID as specified in PCIe_PORT_DESCRIPTOR
IN UINT8 ResetControl; ///< Reset control as in PCIE_RESET_CONTROL
} PCIe_SLOT_RESET_INFO;
/// Engine descriptor type
typedef enum {
PcieUnusedEngine = 0, ///< Unused descriptor
PciePortEngine = 1, ///< PCIe port
PcieDdiEngine = 2, ///< DDI
MaxPcieEngine ///< Max engine type for boundary check.
} PCIE_ENGINE_TYPE;
/// PCIe link capability/speed
typedef enum {
PcieGenMaxSupported, ///< Maximum supported
PcieGen1 = 1, ///< Gen1
PcieGen2, ///< Gen2
MaxPcieGen ///< Max Gen for boundary check
} PCIE_LINK_SPEED_CAP;
/// PCIe PSPP Power policy
typedef enum {
PsppDisabled, ///< PSPP disabled
PsppPerformance = 1, ///< Performance
PsppBalanceHigh, ///< Balance-High
PsppBalanceLow, ///< Balance-Low
PsppPowerSaving, ///< Power Saving
MaxPspp ///< Max Pspp for boundary check
} PCIE_PSPP_POLICY;
/// DDI display connector type
typedef enum {
ConnectorTypeDP, ///< DP
ConnectorTypeEDP, ///< eDP
ConnectorTypeSingleLinkDVI, ///< Single Link DVI-D
ConnectorTypeDualLinkDVI, ///< Dual Link DVI-D
ConnectorTypeHDMI, ///< HDMI
ConnectorTypeTravisDpToVga, ///< Travis DP-to-VGA
ConnectorTypeTravisDpToLvds, ///< Travis DP-to-LVDS
ConnectorTypeNutmegDpToVga, ///< Hudson-2 NutMeg DP-to-VGA
ConnectorTypeSingleLinkDviI, ///< Single Link DVI-I
ConnectorTypeCrt, ///< CRT (VGA)
ConnectorTypeLvds, ///< LVDS
ConnectorTypeAutoDetect, ///< VBIOS auto detect connector type (native LVDS, eDP or Travis-LVDS)
MaxConnectorType ///< Not valid value, used to verify input
} PCIE_CONNECTOR_TYPE;
/// PCIe link channel type
typedef enum {
ChannelTypeLowLoss, ///< Low Loss
ChannelTypeHighLoss, ///< High Loss
ChannelTypeMob0db, ///< Mobile 0dB
ChannelTypeMob3db, ///< Mobile 3dB
ChannelTypeExt6db, ///< Extended 6dB
ChannelTypeExt8db, ///< Extended 8dB
MaxChannelType ///< Not valid value, used to verify input
} PCIE_CHANNEL_TYPE;
/// PCIe link ASPM
typedef enum {
AspmDisabled, ///< Disabled
AspmL0s, ///< PCIe L0s link state
AspmL1, ///< PCIe L1 link state
AspmL0sL1, ///< PCIe L0s & L1 link state
MaxAspm ///< Not valid value, used to verify input
} PCIE_ASPM_TYPE;
/// PCIe link hotplug support
typedef enum {
HotplugDisabled, ///< Hotplug disable
HotplugBasic, ///< Basic Hotplug
HotplugServer, ///< Server Hotplug
HotplugEnhanced, ///< Enhanced
HotplugInboard, ///< Inboard
MaxHotplug ///< Not valid value, used to verify input
} PCIE_HOTPLUG_TYPE;
/// PCIe link initialization
typedef enum {
PortDisabled, ///< Disable
PortEnabled ///< Enable
} PCIE_PORT_ENABLE;
/// DDI Aux channel
typedef enum {
Aux1, ///< Aux1
Aux2, ///< Aux2
Aux3, ///< Aux3
Aux4, ///< Aux4
Aux5, ///< Aux5
Aux6, ///< Aux6
MaxAux ///< Not valid value, used to verify input
} PCIE_AUX_TYPE;
/// DDI Hdp Index
typedef enum {
Hdp1, ///< Hdp1
Hdp2, ///< Hdp2
Hdp3, ///< Hdp3
Hdp4, ///< Hdp4
Hdp5, ///< Hdp5
Hdp6, ///< Hdp6
MaxHdp ///< Not valid value, used to verify input
} PCIE_HDP_TYPE;
// Macro for statically initialization of various structures
#define PCIE_ENGINE_DATA_INITIALIZER(mType, mStartLane, mEndLane) {mType, mStartLane, mEndLane}
#define PCIE_PORT_DATA_INITIALIZER(mPortPresent, mChannelType, mDevAddress, mHotplug, mMaxLinkSpeed, mMaxLinkCap, mAspm, mResetId) \
{mPortPresent, mChannelType, mDevAddress, 0, mMaxLinkSpeed, mAspm, mHotplug, mResetId, {0, mMaxLinkCap} }
#define PCIE_DDI_DATA_INITIALIZER(mConnectorType, mAuxIndex, mHpdIndex ) \
{mConnectorType, mAuxIndex, mHpdIndex, {{0}, {0}}}
#define PCIE_DDI_DATA_INITIALIZER_V1(mConnectorType, mAuxIndex, mHpdIndex, mMapping0, mMapping1) \
{mConnectorType, mAuxIndex, mHpdIndex, {mMapping0, mMapping1}}
/*----------------------------------------------------------------------------
* GNB configuration info
*----------------------------------------------------------------------------
*/
/// LVDS Misc Control Field
typedef struct {
IN UINT8 FpdiMode:1; ///< This item configures LVDS 888bit panel mode
///< @li FALSE = LVDS 888 panel in LDI mode
///< @li TRUE = LVDS 888 panel in FPDI mode
///< @BldCfgItem{BLDCFG_LVDS_MISC_888_FPDI_MODE}
IN UINT8 DlChSwap:1; ///< This item configures LVDS panel lower and upper link mapping
///< @li FALSE = Lower link and upper link not swap
///< @li TRUE = Lower link and upper link are swapped
///< @BldCfgItem{BLDCFG_LVDS_MISC_DL_CH_SWAP}
IN UINT8 VsyncActiveLow:1; ///< This item configures polarity of frame pulse encoded in lvds data stream
///< @li FALSE = Active high Frame Pulse/Vsync
///< @li TRUE = Active low Frame Pulse/Vsync
///< @BldCfgItem{BLDCFG_LVDS_MISC_VSYNC_ACTIVE_LOW}
IN UINT8 HsyncActiveLow:1; ///< This item configures polarity of line pulse encoded in lvds data
///< @li FALSE = Active high Line Pulse
///< @li TRUE = Active low Line Pulse / Hsync
///< @BldCfgItem{BLDCFG_LVDS_MISC_HSYNC_ACTIVE_LOW}
IN UINT8 BLONActiveLow:1; ///< This item configures polarity of signal sent to digital BLON output pin
///< @li FALSE = Not inverted(active high)
///< @li TRUE = Inverted (active low)
///< @BldCfgItem{BLDCFG_LVDS_MISC_BLON_ACTIVE_LOW}
IN UINT8 Reserved:3; ///< Reserved
} LVDS_MISC_CONTROL_FIELD;
/// LVDS Misc Control
typedef union _LVDS_MISC_CONTROL {
IN LVDS_MISC_CONTROL_FIELD Field; ///< LVDS_MISC_CONTROL_FIELD
IN UINT8 Value; ///< LVDS Misc Control Value
} LVDS_MISC_CONTROL;
/// Configuration settings for GNB.
typedef struct {
IN UINT8 Gnb3dStereoPinIndex; ///< 3D Stereo Pin ID.
///< @li 0 = Stereo 3D is disabled (default).
///< @li 1 = Use processor pin HPD1.
///< @li 2 = Use processor pin HPD2
///< @li 3 = Use processor pin HPD3
///< @li 4 = Use processor pin HPD4
///< @li 5 = Use processor pin HPD5
///< @li 6 = Use processor pin HPD6
///< @BldCfgItem{BLDCFG_STEREO_3D_PINOUT}
IN UINT16 LvdsSpreadSpectrum; ///< Spread spectrum value in 0.01 %
///< BldCfgItem{BLDCFG_GFX_LVDS_SPREAD_SPECTRUM}
IN UINT16 LvdsSpreadSpectrumRate; ///< Spread spectrum frequency used by SS hardware logic in unit of 10Hz, 0 - default frequency 40kHz
///< BldCfgItem{BLDCFG_GFX_LVDS_SPREAD_SPECTRUM_RATE}
IN LVDS_MISC_CONTROL LvdsMiscControl;///< This item configures LVDS swap/Hsync/Vsync/BLON
IN UINT16 PcieRefClkSpreadSpectrum; ///< Spread spectrum value in 0.01 %
///< @BldCfgItem{BLDCFG_PCIE_REFCLK_SPREAD_SPECTRUM}
} GNB_ENV_CONFIGURATION;
/// GNB configuration info
typedef struct {
IN PCIe_COMPLEX_DESCRIPTOR *PcieComplexList; /**< Pointer to array of structures describe PCIe topology on each processor package or NULL.
* Last element of array must be terminated with DESCRIPTOR_TERMINATE_LIST
* Example of topology definition for single socket system:
* @code
* PCIe_PORT_DESCRIPTOR PortList [] = {
* // Initialize Port descriptor (PCIe port, Lanes 8:15, PCI Device Number 2, ...)
* {
* 0, //Descriptor flags
* PCIE_ENGINE_DATA_INITIALIZER (PciePortEngine, 8, 15),
* PCIE_PORT_DATA_INITIALIZER (PortEnabled, ChannelTypeExt6db, 2, HotplugDisabled, PcieGenMaxSupported, PcieGenMaxSupported, AspmDisabled, 0)
* },
* // Initialize Port descriptor (PCIe port, Lanes 16:19, PCI Device Number 3, ...)
* {
* 0, //Descriptor flags
* PCIE_ENGINE_DATA_INITIALIZER (PciePortEngine, 16, 19),
* PCIE_PORT_DATA_INITIALIZER (PortEnabled, ChannelTypeExt6db, 3, HotplugDisabled, PcieGenMaxSupported, PcieGenMaxSupported, AspmDisabled, 0)
* },
* // Initialize Port descriptor (PCIe port, Lanes 4, PCI Device Number 4, ...)
* {
* DESCRIPTOR_TERMINATE_LIST, //Descriptor flags !!!IMPORTANT!!! Terminate last element of array
* PCIE_ENGINE_DATA_INITIALIZER (PciePortEngine, 4, 4),
* PCIE_PORT_DATA_INITIALIZER (PortEnabled, ChannelTypeExt6db, 4, HotplugDisabled, PcieGenMaxSupported, PcieGenMaxSupported, AspmDisabled, 0)
* }
* };
* PCIe_PORT_DESCRIPTOR DdiList [] = {
* // Initialize Ddi descriptor (DDI interface Lanes 24:27, Display Port Connector, ...)
* {
* 0, //Descriptor flags
* PCIE_ENGINE_DATA_INITIALIZER (PcieDdiEngine, 24, 27),
* PCIE_DDI_DATA_INITIALIZER (ConnectorTypeDP, Aux1, Hdp1)
* },
* // Initialize Ddi descriptor (DDI interface Lanes 28:31, HDMI, ...)
* {
* DESCRIPTOR_TERMINATE_LIST, //Descriptor flags !!!IMPORTANT!!! Terminate last element of array
* PCIE_ENGINE_DATA_INITIALIZER (PcieDdiEngine, 28, 31),
* PCIE_DDI_DATA_INITIALIZER (ConnectorTypeHDMI, Aux2, Hdp2)
* }
* };
* PCIe_COMPLEX_DESCRIPTOR PlatformTopology = {
* DESCRIPTOR_TERMINATE_LIST, //Descriptor flags !!!IMPORTANT!!! Terminate complexes list
* 0, //Socket ID
* &PortList[0],
* &DdiList[0],
* }
* @endcode
*/
IN UINT8 PsppPolicy; /**< PSPP (PCIe Speed Power Policy)
* @li @b 0 - Disabled
* @li @b 1 - Performance
* @li @b 2 - Balance-High
* @li @b 3 - Balance-Low
* @li @b 4 - Power Saving
*/
} GNB_CONFIGURATION;
//
// MEMORY-SPECIFIC DATA STRUCTURES
//
//
//
//
// AGESA MAXIMIUM VALUES
//
// These Max values are used to define array sizes and associated loop
// counts in the code. They reflect the maximum values that AGESA
// currently supports and does not necessarily reflect the hardware
// capabilities of configuration.
//
#define MAX_SOCKETS_SUPPORTED 8 ///< Max number of sockets in system
#define MAX_CHANNELS_PER_SOCKET 4 ///< Max Channels per sockets
#define MAX_DIMMS_PER_CHANNEL 4 ///< Max DIMMs on a memory channel (independent of platform)
#define NUMBER_OF_DELAY_TABLES 9 ///< Number of tables defined in CH_DEF_STRUCT.
///< Eg: UINT16 *RcvEnDlys;
///< UINT8 *WrDqsDlys;
///< UINT8 *RdDqsDlys;
///< UINT8 *WrDatDlys;
///< UINT8 *RdDqsMinDlys;
///< UINT8 *RdDqsMaxDlys;
///< UINT8 *WrDatMinDlys;
///< UINT8 *WrDatMaxDlys;
#define NUMBER_OF_FAILURE_MASK_TABLES 1 ///< Number of failure mask tables
#define MAX_PLATFORM_TYPES 16 ///< Platform types per system
#define MCT_TRNG_KEEPOUT_START 0x00004000 ///< base [39:8]
#define MCT_TRNG_KEEPOUT_END 0x00007FFF ///< base [39:8]
#define UMA_ATTRIBUTE_INTERLEAVE 0x80000000 ///< Uma Region is interleaved
#define UMA_ATTRIBUTE_ON_DCT0 0x40000000 ///< UMA resides on memory that belongs to DCT0
#define UMA_ATTRIBUTE_ON_DCT1 0x20000000 ///< UMA resides on memory that belongs to DCT1
typedef UINT8 PSO_TABLE; ///< Platform Configuration Table
// AGESA DEFINITIONS
//
// Many of these are derived from the platform and hardware specific definitions
/// EccSymbolSize override value
#define ECCSYMBOLSIZE_USE_BKDG 0 ///< Use BKDG Recommended Value
#define ECCSYMBOLSIZE_FORCE_X4 4 ///< Force to x4
#define ECCSYMBOLSIZE_FORCE_X8 8 ///< Force to x8
/// CPU Package Type
#define PT_L1 0 ///< L1 Package type
#define PT_M2 1 ///< AM Package type
#define PT_S1 2 ///< S1 Package type
/// Structures use to pass system Logical CPU-ID
typedef struct {
IN OUT UINT64 Family; ///< Indicates logical ID Family
IN OUT UINT64 Revision; ///< Indicates logical ID Family
} CPU_LOGICAL_ID;
/// Build Configuration values for BLDCFG_AMD_PLATFORM_TYPE
typedef enum {
AMD_PLATFORM_SERVER = 0x8000, ///< Server
AMD_PLATFORM_DESKTOP = 0x10000, ///< Desktop
AMD_PLATFORM_MOBILE = 0x20000, ///< Mobile
} AMD_PLATFORM_TYPE;
/// Dram technology type
typedef enum {
DDR2_TECHNOLOGY, ///< DDR2 technology
DDR3_TECHNOLOGY ///< DDR3 technology
} TECHNOLOGY_TYPE;
/// Build Configuration values for BLDCFG_MEMORY_BUS_FREQUENCY_LIMIT & BLDCFG_MEMORY_CLOCK_SELECT
typedef enum {
DDR400_FREQUENCY = 200, ///< DDR 400
DDR533_FREQUENCY = 266, ///< DDR 533
DDR667_FREQUENCY = 333, ///< DDR 667
DDR800_FREQUENCY = 400, ///< DDR 800
DDR1066_FREQUENCY = 533, ///< DDR 1066
DDR1333_FREQUENCY = 667, ///< DDR 1333
DDR1600_FREQUENCY = 800, ///< DDR 1600
DDR1866_FREQUENCY = 933, ///< DDR 1866
UNSUPPORTED_DDR_FREQUENCY ///< Highest limit of DDR frequency
} MEMORY_BUS_SPEED;
/// Build Configuration values for BLDCFG_MEMORY_QUADRANK_TYPE
typedef enum {
QUADRANK_REGISTERED, ///< Quadrank registered DIMM
QUADRANK_UNBUFFERED ///< Quadrank unbuffered DIMM
} QUANDRANK_TYPE;
/// Build Configuration values for BLDCFG_TIMING_MODE_SELECT
typedef enum {
TIMING_MODE_AUTO, ///< Use best rate possible
TIMING_MODE_LIMITED, ///< Set user top limit
TIMING_MODE_SPECIFIC ///< Set user specified speed
} USER_MEMORY_TIMING_MODE;
/// Build Configuration values for BLDCFG_POWER_DOWN_MODE
typedef enum {
POWER_DOWN_BY_CHANNEL, ///< Channel power down mode
POWER_DOWN_BY_CHIP_SELECT, ///< Chip select power down mode
POWER_DOWN_MODE_AUTO ///< AGESA to select power down mode
} POWER_DOWN_MODE;
/// Low voltage support
typedef enum {
VOLT1_5, ///< 1.5 Volt
VOLT1_35, ///< 1.35 Volt
VOLT1_25, ///< 1.25 Volt
VOLT_UNSUPPORTED = 0xFF ///< No common voltage found
} DIMM_VOLTAGE;
/// UMA Mode
typedef enum {
UMA_NONE = 0, ///< UMA None
UMA_SPECIFIED = 1, ///< UMA Specified
UMA_AUTO = 2 ///< UMA Auto
} UMA_MODE;
/// Build Configuration values for BLDCFG_UMA_ALIGNMENT
typedef enum {
NO_UMA_ALIGNED = 0x00FFFFFF, ///< NO UMA aligned
UMA_128MB_ALIGNED = 0x00FFF800, ///< UMA 128MB aligned
UMA_256MB_ALIGNED = 0x00FFF000, ///< UMA 256MB aligned
UMA_512MB_ALIGNED = 0x00FFE000, ///< UMA 512MB aligned
} UMA_ALIGNMENT;
///
/// Global MCT Configuration Status Word (GStatus)
///
typedef enum {
GsbMTRRshort, ///< Ran out of MTRRs while mapping memory
GsbAllECCDimms, ///< All banks of all Nodes are ECC capable
GsbDramECCDis, ///< Dram ECC requested but not enabled.
GsbSoftHole, ///< A Node Base gap was created
GsbHWHole, ///< A HW dram remap was created
GsbNodeIntlv, ///< Node Memory interleaving was enabled
GsbSpIntRemapHole, ///< Special condition for Node Interleave and HW remapping
GsbEnDIMMSpareNW, ///< Indicates that DIMM Spare can be used without a warm reset
GsbEOL ///< End of list
} GLOBAL_STATUS_FIELD;
///
/// Local Error Status (DIE_STRUCT.ErrStatus[31:0])
///
typedef enum {
EsbNoDimms, ///< No DIMMs
EsbSpdChkSum, ///< SPD Checksum fail
EsbDimmMismatchM, ///< dimm module type(buffer) mismatch
EsbDimmMismatchT, ///< dimm CL/T mismatch
EsbDimmMismatchO, ///< dimm organization mismatch (128-bit)
EsbNoTrcTrfc, ///< SPD missing Trc or Trfc info
EsbNoCycTime, ///< SPD missing byte 23 or 25
EsbBkIntDis, ///< Bank interleave requested but not enabled
EsbDramECCDis, ///< Dram ECC requested but not enabled
EsbSpareDis, ///< Online spare requested but not enabled
EsbMinimumMode, ///< Running in Minimum Mode
EsbNoRcvrEn, ///< No DQS Receiver Enable pass window found
EsbSmallRcvr, ///< DQS Rcvr En pass window too small (far right of dynamic range)
EsbNoDqsPos, ///< No DQS-DQ passing positions
EsbSmallDqs, ///< DQS-DQ passing window too small
EsbDCBKScrubDis, ///< DCache scrub requested but not enabled
EsbEMPNotSupported, ///< Processor is not capable for EMP.
EsbEMPConflict, ///< EMP requested but cannot be enabled since
///< channel interleaving, bank interleaving, or bank swizzle is enabled.
EsbEMPDis, ///< EMP requested but cannot be enabled since
///< memory size of each DCT is not a power of two.
EsbEOL ///< End of list
} ERROR_STATUS_FIELD;
///
/// Local Configuration Status (DIE_STRUCT.Status[31:0])
///
typedef enum {
SbRegistered, ///< All DIMMs are Registered
SbEccDimms, ///< All banks ECC capable
SbParDimms, ///< All banks Addr/CMD Parity capable
SbDiagClks, ///< Jedec ALL slots clock enable diag mode
Sb128bitmode, ///< DCT in 128-bit mode operation
Sb64MuxedMode, ///< DCT in 64-bit mux'ed mode.
Sb2TMode, ///< 2T CMD timing mode is enabled.
SbSWNodeHole, ///< Remapping of Node Base on this Node to create a gap.
SbHWHole, ///< Memory Hole created on this Node using HW remapping.
SbOver400Mhz, ///< DCT freq greater than or equal to 400MHz flag
SbDQSPosPass2, ///< Used for TrainDQSPos DIMM0/1, when freq greater than or equal to 400MHz
SbDQSRcvLimit, ///< Used for DQSRcvEnTrain to know we have reached the upper bound.
SbExtConfig, ///< Indicate the default setting for extended PCI configuration support
SbLrdimms, ///< All DIMMs are LRDIMMs
SbEOL ///< End of list
} LOCAL_STATUS_FIELD;
///< CPU MSR Register definitions ------------------------------------------
#define SYS_CFG 0xC0010010
#define TOP_MEM 0xC001001Aul
#define TOP_MEM2 0xC001001Dul
#define HWCR 0xC0010015
#define NB_CFG 0xC001001F
#define FS_BASE 0xC0000100
#define IORR0_BASE 0xC0010016
#define IORR0_MASK 0xC0010017
#define BU_CFG 0xC0011023
#define BU_CFG2 0xC001102A
#define COFVID_STAT 0xC0010071
#define TSC 0x10
//-----------------------------------------------------------------------------
///
/// SPD Data for each DIMM.
///
typedef struct _SPD_DEF_STRUCT {
IN BOOLEAN DimmPresent; ///< Indicates that the DIMM is present and Data is valid
IN UINT8 Data[256]; ///< Buffer for 256 Bytes of SPD data from DIMM
} SPD_DEF_STRUCT;
///
/// Channel Definition Structure.
/// This data structure defines entries that are specific to the channel initialization
///
typedef struct _CH_DEF_STRUCT {
OUT UINT8 ChannelID; ///< Physical channel ID of a socket(0 = CH A, 1 = CH B, 2 = CH C, 3 = CH D)
OUT TECHNOLOGY_TYPE TechType; ///< Technology type of this channel
OUT UINT8 ChDimmPresent; ///< For each bit n 0..7, 1 = DIMM n is present.
///< DIMM# Select Signal
///< 0 MA0_CS_L[0, 1]
///< 1 MB0_CS_L[0, 1]
///< 2 MA1_CS_L[0, 1]
///< 3 MB1_CS_L[0, 1]
///< 4 MA2_CS_L[0, 1]
///< 5 MB2_CS_L[0, 1]
///< 6 MA3_CS_L[0, 1]
///< 7 MB3_CS_L[0, 1]
OUT struct _DCT_STRUCT *DCTPtr; ///< Pointer to the DCT data of this channel.
OUT struct _DIE_STRUCT *MCTPtr; ///< Pointer to the node data of this channel.
OUT SPD_DEF_STRUCT *SpdPtr; ///< Pointer to the SPD data for this channel. (Setup by NB Constructor)
OUT SPD_DEF_STRUCT *DimmSpdPtr[MAX_DIMMS_PER_CHANNEL]; ///< Array of pointers to
///< SPD Data for each Dimm. (Setup by Tech Block Constructor)
OUT UINT8 ChDimmValid; ///< For each bit n 0..3, 1 = DIMM n is valid and is/will be configured where 4..7 are reserved.
///<
OUT UINT8 RegDimmPresent; ///< For each bit n 0..3, 1 = DIMM n is a registered DIMM where 4..7 are reserved.
OUT UINT8 LrDimmPresent; ///< For each bit n 0..3, 1 = DIMM n is Load Reduced DIMM where 4..7 are reserved.
OUT UINT8 SODimmPresent; ///< For each bit n 0..3, 1 = DIMM n is a SO-DIMM, where 4..7 are reserved.
OUT UINT8 Loads; ///< Number of devices loading bus
OUT UINT8 Dimms; ///< Number of DIMMs loading Channel
OUT UINT8 Ranks; ///< Number of ranks loading Channel DATA
OUT BOOLEAN SlowMode; ///< 1T or 2T CMD mode (slow access mode)
///< FALSE = 1T
///< TRUE = 2T
///< The following pointers will be pointed to dynamically allocated buffers.
///< Each buffer is two dimensional (RowCount x ColumnCount) and is lay-outed as in below.
///< Example: If DIMM and Byte based training, then
///< XX is a value in Hex
///< BYTE 0, BYTE 1, BYTE 2, BYTE 3, BYTE 4, BYTE 5, BYTE 6, BYTE 7, ECC BYTE
///< Row1 - Logical DIMM0 XX XX XX XX XX XX XX XX XX
///< Row2 - Logical DIMM1 XX XX XX XX XX XX XX XX XX
OUT UINT16 *RcvEnDlys; ///< DQS Receiver Enable Delays
OUT UINT8 *WrDqsDlys; ///< Write DQS delays (only valid for DDR3)
OUT UINT8 *RdDqsDlys; ///< Read Dqs delays
OUT UINT8 *WrDatDlys; ///< Write Data delays
OUT UINT8 *RdDqsMinDlys; ///< Minimum Window for Read DQS
OUT UINT8 *RdDqsMaxDlys; ///< Maximum Window for Read DQS
OUT UINT8 *WrDatMinDlys; ///< Minimum Window for Write data
OUT UINT8 *WrDatMaxDlys; ///< Maximum Window for Write data
OUT UINT8 RowCount; ///< Number of rows of the allocated buffer.
OUT UINT8 ColumnCount; ///< Number of columns of the allocated buffer.
OUT UINT8 *FailingBitMask; ///< Table of masks to Track Failing bits
OUT UINT32 DctOdcCtl; ///< Output Driver Strength (see BKDG FN2:Offset 9Ch, index 00h)
OUT UINT32 DctAddrTmg; ///< Address Bus Timing (see BKDG FN2:Offset 9Ch, index 04h)
OUT UINT32 PhyRODTCSLow; ///< Phy Read ODT Pattern Chip Select low (see BKDG FN2:Offset 9Ch, index 180h)
OUT UINT32 PhyRODTCSHigh; ///< Phy Read ODT Pattern Chip Select high (see BKDG FN2:Offset 9Ch, index 181h)
OUT UINT32 PhyWODTCSLow; ///< Phy Write ODT Pattern Chip Select low (see BKDG FN2:Offset 9Ch, index 182h)
OUT UINT32 PhyWODTCSHigh; ///< Phy Write ODT Pattern Chip Select high (see BKDG FN2:Offset 9Ch, index 183)
OUT UINT8 PhyWLODT[4]; ///< Write Levelization ODT Pattern for Dimm 0-3 (see BKDG FN2:Offset 9Ch, index 0x8[11:8])
OUT UINT16 DctEccDqsLike; ///< DCT DQS ECC UINT8 like...
OUT UINT8 DctEccDqsScale; ///< DCT DQS ECC UINT8 scale
OUT UINT16 PtrPatternBufA; ///< Ptr on stack to aligned DQS testing pattern
OUT UINT16 PtrPatternBufB; ///< Ptr on stack to aligned DQS testing pattern
OUT UINT8 ByteLane; ///< Current UINT8 Lane (0..7)
OUT UINT8 Direction; ///< Current DQS-DQ training write direction (0=read, 1=write)
OUT UINT8 Pattern; ///< Current pattern
OUT UINT8 DqsDelay; ///< Current DQS delay value
OUT UINT16 HostBiosSrvc1; ///< UINT16 sized general purpose field for use by host BIOS. Scratch space.
OUT UINT32 HostBiosSrvc2; ///< UINT32 sized general purpose field for use by host BIOS. Scratch space.
OUT UINT16 DctMaxRdLat; ///< Max Read Latency (ns) for the DCT
OUT UINT8 DIMMValidCh; ///< DIMM# in CH
OUT UINT8 MaxCh; ///< Max number of CH in system
OUT UINT8 Dct; ///< Dct pointer
OUT UINT8 WrDatGrossH; ///< Write Data Gross delay high value
OUT UINT8 DqsRcvEnGrossL; ///< DQS Receive Enable Gross Delay low
OUT UINT8 TrwtWB; ///< Non-SPD timing value for TrwtWB
OUT UINT8 CurrRcvrDctADelay; ///< for keep current RcvrEnDly
OUT UINT16 T1000; ///< get the T1000 figure (cycle time (ns) * 1K)
OUT UINT8 DqsRcvEnPass; ///< for TrainRcvrEn UINT8 lane pass flag
OUT UINT8 DqsRcvEnSaved; ///< for TrainRcvrEn UINT8 lane saved flag
OUT UINT8 SeedPass1Remainder; ///< for Phy assisted DQS receiver enable training
OUT UINT8 ClToNbFlag; ///< is used to restore ClLinesToNbDis bit after memory
OUT UINT32 NodeSysBase; ///< for channel interleave usage
OUT UINT8 RefRawCard[MAX_DIMMS_PER_CHANNEL]; ///< Array of rawcards detected
OUT UINT8 CtrlWrd02[MAX_DIMMS_PER_CHANNEL]; ///< Control Word 2 values per DIMM
OUT UINT8 CtrlWrd03[MAX_DIMMS_PER_CHANNEL]; ///< Control Word 3 values per DIMM
OUT UINT8 CtrlWrd04[MAX_DIMMS_PER_CHANNEL]; ///< Control Word 4 values per DIMM
OUT UINT8 CtrlWrd05[MAX_DIMMS_PER_CHANNEL]; ///< Control Word 5 values per DIMM
OUT UINT8 CtrlWrd08[MAX_DIMMS_PER_CHANNEL]; ///< Control Word 8 values per DIMM
OUT UINT16 CsPresentDCT; ///< For each bit n 0..7, 1 = Chip-select n is present
OUT UINT8 DimmMirrorPresent; ///< For each bit n 0..3, 1 = DIMM n is OnDimmMirror capable where 4..7 are reserved.
OUT UINT8 DimmSpdCse; ///< For each bit n 0..3, 1 = DIMM n SPD checksum error where 4..7 are reserved.
OUT UINT8 DimmExclude; ///< For each bit n 0..3, 1 = DIMM n gets excluded where 4..7 are reserved.
OUT UINT8 DimmYr06; ///< Bitmap indicating which Dimms have a manufacturer's year code <= 2006
OUT UINT8 DimmWk2406; ///< Bitmap indicating which Dimms have a manufacturer's week code <= 24 of 2006 (June)
OUT UINT8 DimmPlPresent; ///< Bitmap indicating that Planar (1) or Stacked (0) Dimms are present.
OUT UINT8 DimmQrPresent; ///< QuadRank DIMM present?
OUT UINT8 DimmDrPresent; ///< Bitmap indicating that Dual Rank Dimms are present
OUT UINT8 DimmSRPresent; ///< Bitmap indicating that Single Rank Dimms are present
OUT UINT8 Dimmx4Present; ///< For each bit n 0..3, 1 = DIMM n contains x4 data devices. where 4..7 are reserved.
OUT UINT8 Dimmx8Present; ///< For each bit n 0..3, 1 = DIMM n contains x8 data devices. where 4..7 are reserved.
OUT UINT8 Dimmx16Present; ///< For each bit n 0..3, 1 = DIMM n contains x16 data devices. where 4..7 are reserved.
OUT UINT8 LrdimmPhysicalRanks[MAX_DIMMS_PER_CHANNEL];///< Number of Physical Ranks for LRDIMMs
OUT UINT8 LrDimmLogicalRanks[MAX_DIMMS_PER_CHANNEL];///< Number of LRDIMM Logical ranks in this configuration
OUT UINT8 LrDimmRankMult[MAX_DIMMS_PER_CHANNEL];///< Rank Multipication factor per dimm.
OUT UINT8 *MemClkDisMap; ///< This pointer will be set to point to an array that describes
///< the routing of M[B,A]_CLK pins to the DIMMs' ranks. AGESA will
///< base on this array to disable unused MemClk to save power.
///<
///< The array must have 8 entries. Each entry, which associates with
///< one MemClkDis bit, is a bitmap of 8 CS that that MemClk is routed to.
///< Example:
///< BKDG definition of Fn2x88[MemClkDis] bitmap for AM3 package
///< is like below:
///< Bit AM3/S1g3 pin name
///< 0 M[B,A]_CLK_H/L[0]
///< 1 M[B,A]_CLK_H/L[1]
///< 2 M[B,A]_CLK_H/L[2]
///< 3 M[B,A]_CLK_H/L[3]
///< 4 M[B,A]_CLK_H/L[4]
///< 5 M[B,A]_CLK_H/L[5]
///< 6 M[B,A]_CLK_H/L[6]
///< 7 M[B,A]_CLK_H/L[7]
///< And platform has the following routing:
///< CS0 M[B,A]_CLK_H/L[4]
///< CS1 M[B,A]_CLK_H/L[2]
///< CS2 M[B,A]_CLK_H/L[3]
///< CS3 M[B,A]_CLK_H/L[5]
///< Then MemClkDisMap should be pointed to the following array:
///< CLK_2 CLK_3 CLK_4 CLK_5
///< 0x00, 0x00, 0x02, 0x04, 0x01, 0x08, 0x00, 0x00
///< Each entry of the array is the bitmask of 8 chip selects.
OUT UINT8 *CKETriMap; ///< This pointer will be set to point to an array that describes
///< the routing of CKE pins to the DIMMs' ranks.
///< The array must have 2 entries. Each entry, which associates with
///< one CKE pin, is a bitmap of 8 CS that that CKE is routed to.
///< AGESA will base on this array to disable unused CKE pins to save power.
OUT UINT8 *ODTTriMap; ///< This pointer will be set to point to an array that describes
///< the routing of ODT pins to the DIMMs' ranks.
///< The array must have 4 entries. Each entry, which associates with
///< one ODT pin, is a bitmap of 8 CS that that ODT is routed to.
///< AGESA will base on this array to disable unused ODT pins to save power.
OUT UINT8 *ChipSelTriMap; ///< This pointer will be set to point to an array that describes
///< the routing of chip select pins to the DIMMs' ranks.
///< The array must have 8 entries. Each entry is a bitmap of 8 CS.
///< AGESA will base on this array to disable unused Chip select pins to save power.
OUT BOOLEAN ExtendTmp; ///< If extended temperature is supported on all dimms on a channel.
OUT UINT8 Reserved[100]; ///< Reserved
} CH_DEF_STRUCT;
///
/// DCT Channel Timing Parameters.
/// This data structure sets timings that are specific to the channel.
///
typedef struct _CH_TIMING_STRUCT {
OUT UINT16 DctDimmValid; ///< For each bit n 0..3, 1=DIMM n is valid and is/will be configured where 4..7 are reserved.
OUT UINT16 DimmMirrorPresent; ///< For each bit n 0..3, 1=DIMM n is OnDimmMirror capable where 4..7 are reserved.
OUT UINT16 DimmSpdCse; ///< For each bit n 0..3, 1=DIMM n SPD checksum error where 4..7 are reserved.
OUT UINT16 DimmExclude; ///< For each bit n 0..3, 1 = DIMM n gets excluded where 4..7 are reserved.
OUT UINT16 CsPresent; ///< For each bit n 0..7, 1=Chip-select n is present
OUT UINT16 CsEnabled; ///< For each bit n 0..7, 1=Chip-select n is enabled
OUT UINT16 CsTestFail; ///< For each bit n 0..7, 1=Chip-select n is present but disabled
OUT UINT16 CsTrainFail; ///< Bitmap showing which chipselects failed training
OUT UINT16 DIMM1KPage; ///< For each bit n 0..3, 1=DIMM n contains 1K page devices. where 4..7 are reserved
OUT UINT16 DimmQrPresent; ///< QuadRank DIMM present?
OUT UINT16 DimmDrPresent; ///< Bitmap indicating that Dual Rank Dimms are present , where 4..7 are reserved
OUT UINT8 DimmSRPresent; ///< Bitmap indicating that Single Rank Dimms are present, where 4..7 are reserved
OUT UINT16 Dimmx4Present; ///< For each bit n 0..3, 1=DIMM n contains x4 data devices. where 4..7 are reserved
OUT UINT16 Dimmx8Present; ///< For each bit n 0..3, 1=DIMM n contains x8 data devices. where 4..7 are reserved
OUT UINT16 Dimmx16Present; ///< For each bit n 0..3, 1=DIMM n contains x16 data devices. where 4..7 are reserved
OUT UINT16 DIMMTrcd; ///< Minimax Trcd*40 (ns) of DIMMs
OUT UINT16 DIMMTrp; ///< Minimax Trp*40 (ns) of DIMMs
OUT UINT16 DIMMTrtp; ///< Minimax Trtp*40 (ns) of DIMMs
OUT UINT16 DIMMTras; ///< Minimax Tras*40 (ns) of DIMMs
OUT UINT16 DIMMTrc; ///< Minimax Trc*40 (ns) of DIMMs
OUT UINT16 DIMMTwr; ///< Minimax Twr*40 (ns) of DIMMs
OUT UINT16 DIMMTrrd; ///< Minimax Trrd*40 (ns) of DIMMs
OUT UINT16 DIMMTwtr; ///< Minimax Twtr*40 (ns) of DIMMs
OUT UINT16 DIMMTfaw; ///< Minimax Tfaw*40 (ns) of DIMMs
OUT UINT16 TargetSpeed; ///< Target DRAM bus speed in MHz
OUT UINT16 Speed; ///< DRAM bus speed in MHz
///< 400 (MHz)
///< 533 (MHz)
///< 667 (MHz)
///< 800 (MHz)
///< and so on...
OUT UINT8 CasL; ///< CAS latency DCT setting (busclocks)
OUT UINT8 Trcd; ///< DCT Trcd (busclocks)
OUT UINT8 Trp; ///< DCT Trp (busclocks)
OUT UINT8 Trtp; ///< DCT Trtp (busclocks)
OUT UINT8 Tras; ///< DCT Tras (busclocks)
OUT UINT8 Trc; ///< DCT Trc (busclocks)
OUT UINT8 Twr; ///< DCT Twr (busclocks)
OUT UINT8 Trrd; ///< DCT Trrd (busclocks)
OUT UINT8 Twtr; ///< DCT Twtr (busclocks)
OUT UINT8 Tfaw; ///< DCT Tfaw (busclocks)
OUT UINT8 Trfc0; ///< DCT Logical DIMM0 Trfc
///< 0 = 75ns (for 256Mb devs)
///< 1 = 105ns (for 512Mb devs)
///< 2 = 127.5ns (for 1Gb devs)
///< 3 = 195ns (for 2Gb devs)
///< 4 = 327.5ns (for 4Gb devs)
OUT UINT8 Trfc1; ///< DCT Logical DIMM1 Trfc (see Trfc0 for format)
OUT UINT8 Trfc2; ///< DCT Logical DIMM2 Trfc (see Trfc0 for format)
OUT UINT8 Trfc3; ///< DCT Logical DIMM3 Trfc (see Trfc0 for format)
OUT UINT32 DctMemSize; ///< Base[47:16], total DRAM size controlled by this DCT.
///<
OUT BOOLEAN SlowMode; ///< 1T or 2T CMD mode (slow access mode)
///< FALSE = 1T
///< TRUE = 2T
OUT UINT8 TrwtTO; ///< DCT TrwtTO (busclocks)
OUT UINT8 Twrrd; ///< DCT Twrrd (busclocks)
OUT UINT8 Twrwr; ///< DCT Twrwr (busclocks)
OUT UINT8 Trdrd; ///< DCT Trdrd (busclocks)
OUT UINT8 TrwtWB; ///< DCT TrwtWB (busclocks)
OUT UINT8 TrdrdSD; ///< DCT TrdrdSD (busclocks)
OUT UINT8 TwrwrSD; ///< DCT TwrwrSD (busclocks)
OUT UINT8 TwrrdSD; ///< DCT TwrrdSD (busclocks)
OUT UINT16 MaxRdLat; ///< Max Read Latency
OUT UINT8 WrDatGrossH; ///< Temporary variables must be removed
OUT UINT8 DqsRcvEnGrossL; ///< Temporary variables must be removed
} CH_TIMING_STRUCT;
///
/// Data for each DCT.
/// This data structure defines data used to configure each DRAM controller.
///
typedef struct _DCT_STRUCT {
OUT UINT8 Dct; ///< Current Dct
OUT CH_TIMING_STRUCT Timings; ///< Channel Timing structure
OUT CH_DEF_STRUCT *ChData; ///< Pointed to a dynamically allocated array of Channel structures
OUT UINT8 ChannelCount; ///< Number of channel per this DCT
} DCT_STRUCT;
///
/// Data Structure defining each Die.
/// This data structure contains information that is used to configure each Die.
///
typedef struct _DIE_STRUCT {
/// Advanced:
OUT UINT8 NodeId; ///< Node ID of current controller
OUT UINT8 SocketId; ///< Socket ID of this Die
OUT UINT8 DieId; ///< ID of this die relative to the socket
OUT PCI_ADDR PciAddr; ///< Pci bus and device number of this controller.
OUT AGESA_STATUS ErrCode; ///< Current error condition of Node
///< 0x0 = AGESA_SUCCESS
///< 0x1 = AGESA_UNSUPPORTED
///< 0x2 = AGESA_BOUNDS_CHK
///< 0x3 = AGESA_ALERT
///< 0x4 = AGESA_WARNING
///< 0x5 = AGESA_ERROR
///< 0x6 = AGESA_CRITICAL
///< 0x7 = AGESA_FATAL
///<
OUT BOOLEAN ErrStatus[EsbEOL]; ///< Error Status bit Field
///<
OUT BOOLEAN Status[SbEOL]; ///< Status bit Field
///<
OUT UINT32 NodeMemSize; ///< Base[47:16], total DRAM size controlled by both DCT0 and DCT1 of this Node.
///<
OUT UINT32 NodeSysBase; ///< Base[47:16] (system address) DRAM base address of this Node.
///<
OUT UINT32 NodeHoleBase; ///< If not zero, Base[47:16] (system address) of dram hole for HW remapping. Dram hole exists on this Node
///<
OUT UINT32 NodeSysLimit; ///< Base[47:16] (system address) DRAM limit address of this Node.
///<
OUT UINT32 DimmPresent; ///< For each bit n 0..7, 1 = DIMM n is present.
///< DIMM# Select Signal
///< 0 MA0_CS_L[0, 1]
///< 1 MB0_CS_L[0, 1]
///< 2 MA1_CS_L[0, 1]
///< 3 MB1_CS_L[0, 1]
///< 4 MA2_CS_L[0, 1]
///< 5 MB2_CS_L[0, 1]
///< 6 MA3_CS_L[0, 1]
///< 7 MB3_CS_L[0, 1]
///<
OUT UINT32 DimmValid; ///< For each bit n 0..7, 1 = DIMM n is valid and is / will be configured
OUT UINT32 RegDimmPresent; ///< For each bit n 0..7, 1 = DIMM n is registered DIMM
OUT UINT32 LrDimmPresent; ///< For each bit n 0..7, 1 = DIMM n is Load Reduced DIMM
OUT UINT32 DimmEccPresent; ///< For each bit n 0..7, 1 = DIMM n is ECC capable.
OUT UINT32 DimmParPresent; ///< For each bit n 0..7, 1 = DIMM n is ADR/CMD Parity capable.
///<
OUT UINT16 DimmTrainFail; ///< Bitmap showing which dimms failed training
OUT UINT16 ChannelTrainFail; ///< Bitmap showing the channel information about failed Chip Selects
///< 0 in any bit field indicates Channel 0
///< 1 in any bit field indicates Channel 1
OUT UINT8 Dct; ///< Need to be removed
///< DCT pointer
OUT BOOLEAN GangedMode; ///< Ganged mode
///< 0 = disabled
///< 1 = enabled
OUT CPU_LOGICAL_ID LogicalCpuid; ///< The logical CPUID of the node
///<
OUT UINT16 HostBiosSrvc1; ///< UINT16 sized general purpose field for use by host BIOS. Scratch space.
///<
OUT UINT32 HostBiosSrvc2; ///< UINT32 sized general purpose field for use by host BIOS. Scratch space.
///<
OUT UINT8 MLoad; ///< Need to be removed
///< Number of devices loading MAA bus
///<
OUT UINT8 MaxAsyncLat; ///< Legacy wrapper
///<
OUT UINT8 ChbD3Rcvrdly; ///< Legacy wrapper
///<
OUT UINT16 ChaMaxRdLat; ///< Max Read Latency (ns) for DCT 0
///<
OUT UINT8 ChbD3BcRcvrdly; ///< CHB DIMM 3 Check UINT8 Receiver Enable Delay
OUT DCT_STRUCT *DctData; ///< Pointed to a dynamically allocated array of DCT_STRUCTs
OUT UINT8 DctCount; ///< Number of DCTs per this Die
OUT UINT8 Reserved[16]; ///< Reserved
} DIE_STRUCT;
/**********************************************************************
* S3 Support structure
**********************************************************************/
/// AmdInitResume, AmdS3LateRestore, and AmdS3Save param structure
typedef struct {
OUT UINT32 Signature; ///< "ASTR" for AMD Suspend-To-RAM
OUT UINT16 Version; ///< S3 Params version number
IN OUT UINT32 Flags; ///< Indicates operation
IN OUT VOID *NvStorage; ///< Pointer to memory critical save state data
IN OUT UINT32 NvStorageSize; ///< Size in bytes of the NvStorage region
IN OUT VOID *VolatileStorage; ///< Pointer to remaining AMD save state data
IN OUT UINT32 VolatileStorageSize; ///< Size in bytes of the VolatileStorage region
} AMD_S3_PARAMS;
///===============================================================================
/// MEM_PARAMETER_STRUCT
/// This data structure is used to pass wrapper parameters to the memory configuration code
///
typedef struct _MEM_PARAMETER_STRUCT {
// Basic (Return parameters)
// (This section contains the outbound parameters from the memory init code)
OUT BOOLEAN GStatus[GsbEOL]; ///< Global Status bitfield.
///<
OUT UINT32 HoleBase; ///< If not zero Base[47:16] (system address) of sub 4GB dram hole for HW remapping.
///<
OUT UINT32 Sub4GCacheTop; ///< If not zero, the 32-bit top of cacheable memory.
///<
OUT UINT32 SysLimit; ///< Limit[47:16] (system address).
///<
OUT DIMM_VOLTAGE DDR3Voltage; ///< Find support voltage and send back to platform BIOS.
///< 0 = 1.5v
///< 1 = 1.35v
///< 2 = 1.2v
///< 0xFF = Mixed 1.5V and 1.2V in the system. 1.5V dimms get excluded
///< from the system.
///<
OUT struct _MEM_DATA_STRUCT *MemData; ///< Access to global memory init data.
// Advanced (Optional parameters)
// Optional (all defaults values will be initialized by the
// 'AmdMemInitDataStructDef' based on AMD defaults. It is up
// to the IBV/OEM to change the defaults after initialization
// but prior to the main entry to the memory code):
// Memory Map/Mgt.
IN UINT16 BottomIo; ///< Bottom of 32-bit IO space (8-bits).
///< NV_BOTTOM_IO[7:0]=Addr[31:24]
///<
IN BOOLEAN MemHoleRemapping; ///< Memory Hole Remapping (1-bit).
///< FALSE = disable
///< TRUE = enable
// Dram Timing
IN USER_MEMORY_TIMING_MODE UserTimingMode; ///< User Memclock Mode.
///< @BldCfgItem{BLDCFG_TIMING_MODE_SELECT}
IN MEMORY_BUS_SPEED MemClockValue; ///< Memory Clock Value.
///< @BldCfgItem{BLDCFG_MEMORY_CLOCK_SELECT}
// Dram Configuration
IN BOOLEAN EnableBankIntlv; ///< Dram Bank (chip-select) Interleaving (1-bit).
///< - FALSE =disable (default)
///< - TRUE = enable
///<
///< @BldCfgItem{BLDCFG_MEMORY_ENABLE_BANK_INTERLEAVING}
IN BOOLEAN EnableNodeIntlv; ///< Node Memory Interleaving (1-bit).
///< - FALSE = disable (default)
///< - TRUE = enable
///<
///< @BldCfgItem{BLDCFG_MEMORY_ENABLE_NODE_INTERLEAVING}
IN BOOLEAN EnableChannelIntlv; ///< Channel Interleaving (1-bit).
///< - FALSE = disable (default)
///< - TRUE = enable
///<
///< @BldCfgItem{BLDCFG_MEMORY_CHANNEL_INTERLEAVING}
// ECC
IN BOOLEAN EnableEccFeature; ///< enable ECC error to go into MCE.
///< - FALSE = disable (default)
///< - TRUE = enable
///<
///< @BldCfgItem{BLDCFG_ENABLE_ECC_FEATURE}
// Dram Power
IN BOOLEAN EnablePowerDown; ///< CKE based power down mode (1-bit).
///< - FALSE =disable (default)
///< - TRUE =enable
///<
///< @BldCfgItem{BLDCFG_MEMORY_POWER_DOWN}
// Online Spare
IN BOOLEAN EnableOnLineSpareCtl; ///< Chip Select Spare Control bit 0.
///< - FALSE = disable Spare (default)
///< - TRUE = enable Spare
///<
///< @BldCfgItem{BLDCFG_ONLINE_SPARE}
IN UINT8 *TableBasedAlterations; ///< Desired modifications to register settings.
IN PSO_TABLE *PlatformMemoryConfiguration;
///< A table that contains platform specific settings.
///< For example, MemClk routing, the number of DIMM slots per channel, ....
///< AGESA initializes this pointer with DefaultPlatformMemoryConfiguration that
///< contains default conservative settings. Platform BIOS can either tweak
///< DefaultPlatformMemoryConfiguration or reassign this pointer to its own table.
///<
IN BOOLEAN EnableParity; ///< Parity control.
///< - TRUE = enable
///< - FALSE = disable (default)
///<
///< @BldCfgItem{BLDCFG_MEMORY_PARITY_ENABLE}
IN BOOLEAN EnableBankSwizzle; ///< BankSwizzle control.
///< - FALSE = disable
///< - TRUE = enable (default)
///<
///< @BldCfgItem{BLDCFG_BANK_SWIZZLE}
///<
IN BOOLEAN EnableMemClr; ///< Memory Clear functionality control.
///< - FALSE = disable
///< - TRUE = enable (default)
///<
// Uma Configuration
IN UMA_MODE UmaMode; ///< Uma Mode
///< 0 = None
///< 1 = Specified
///< 2 = Auto
IN OUT UINT32 UmaSize; ///< The size of shared graphics dram (16-bits)
///< NV_UMA_Size[31:0]=Addr[47:16]
///<
OUT UINT32 UmaBase; ///< The allocated Uma base address (32-bits)
///< NV_UMA_Base[31:0]=Addr[47:16]
///<
/// Memory Restore Feature
IN BOOLEAN MemRestoreCtl; ///< Memory context restore control
///< FALSE = perform memory init as normal (AMD default)
///< TRUE = restore memory context and skip training. This requires
///< MemContext is valid before AmdInitPost
///<
IN BOOLEAN SaveMemContextCtl; ///< Control switch to save memory context at the end of MemAuto
///< TRUE = AGESA will setup MemContext block before exit AmdInitPost
///< FALSE = AGESA will not setup MemContext block. Platform is
///< expected to call S3Save later in POST if it wants to
///< use memory context restore feature.
///<
IN OUT AMD_S3_PARAMS MemContext; ///< Memory context block describes the data that platform needs to
///< save and restore for memory context restore feature to work.
///< It uses the subset of S3Save block to save/restore. Hence platform
///< may save only S3 block and uses it for both S3 resume and
///< memory context restore.
///< - If MemRestoreCtl is TRUE, platform needs to pass in MemContext
///< before AmdInitPost.
///< - If SaveMemContextCtl is TRUE, platform needs to save MemContext
///< right after AmdInitPost.
///<
} MEM_PARAMETER_STRUCT;
///
/// Function definition.
/// This data structure passes function pointers to the memory configuration code.
/// The wrapper can use this structure with customized versions.
///
typedef struct _MEM_FUNCTION_STRUCT {
// PUBLIC required Internal functions
IN OUT BOOLEAN (*amdMemGetPsCfgU) ( VOID *pMemData); ///< Proc for Unbuffered DIMMs, platform specific
IN OUT BOOLEAN (*amdMemGetPsCfgR) (VOID *pMemData); ///< Proc for Registered DIMMs, platform specific
// PUBLIC optional functions
IN OUT VOID (*amdMemEccInit) (VOID *pMemData); ///< NB proc for ECC feature
IN OUT VOID (*amdMemChipSelectInterleaveInit) (VOID *pMemData); ///< NB proc for CS interleave feature
IN OUT VOID (*amdMemDctInterleavingInit) (VOID *pMemData); ///< NB proc for Channel interleave feature
IN OUT VOID (*amdMemMctInterleavingInit) (VOID *pMemData); ///< NB proc for Node interleave feature
IN OUT VOID (*amdMemParallelTraining) (VOID *pMemData); ///< NB proc for parallel training feature
IN OUT VOID (*amdMemEarlySampleSupport) (VOID *pMemData); ///< NB code for early sample support feature
IN OUT VOID (*amdMemMultiPartInitSupport) (VOID *pMemData); ///< NB code for 'multi-part'
IN OUT VOID (*amdMemOnlineSpareSupport) (VOID *pMemData); ///< NB code for On-Line Spare feature
IN OUT VOID (*amdMemUDimmInit) (VOID *pMemData); ///< NB code for UDIMMs
IN OUT VOID (*amdMemRDimmInit) (VOID *pMemData); ///< NB code for RDIMMs
IN OUT VOID (*amdMemLrDimmInit) (VOID *pMemData); ///< NB code for LRDIMMs
IN OUT UINT32 Reserved[100]; ///< Reserved for later function definition
} MEM_FUNCTION_STRUCT;
///
/// Socket Structure
///
///
typedef struct _MEM_SOCKET_STRUCT {
OUT VOID *ChannelPtr[MAX_CHANNELS_PER_SOCKET]; ///< Pointers to each channels training data
OUT VOID *TimingsPtr[MAX_CHANNELS_PER_SOCKET]; ///< Pointers to each channels timing data
} MEM_SOCKET_STRUCT;
///
/// Contains all data relevant to Memory Initialization.
///
typedef struct _MEM_DATA_STRUCT {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN MEM_PARAMETER_STRUCT *ParameterListPtr; ///< List of input Parameters
OUT MEM_FUNCTION_STRUCT FunctionList; ///< List of function Pointers
IN OUT AGESA_STATUS (*GetPlatformCfg[MAX_PLATFORM_TYPES]) (struct _MEM_DATA_STRUCT *MemData, UINT8 SocketID, CH_DEF_STRUCT *CurrentChannel); ///< look-up platform info
IN OUT BOOLEAN (*ErrorHandling)(struct _DIE_STRUCT *MCTPtr, UINT8 DCT, UINT16 ChipSelMask, AMD_CONFIG_PARAMS *StdHeader); ///< Error Handling
OUT MEM_SOCKET_STRUCT SocketList[MAX_SOCKETS_SUPPORTED]; ///< Socket list for memory code.
///< SocketList is a shortcut for IBVs to retrieve training
///< and timing data for each channel indexed by socket/channel,
///< eliminating their need to parse die/dct/channel etc.
///< It contains pointers to the populated data structures for
///< each channel and skips the channel structures that are
///< unpopulated. In the case of channels sharing the same DCT,
///< the pTimings pointers will point to the same DCT Timing data.
OUT DIE_STRUCT *DiesPerSystem; ///< Pointed to an array of DIE_STRUCTs
OUT UINT8 DieCount; ///< Number of MCTs in the system.
IN SPD_DEF_STRUCT *SpdDataStructure; ///< Pointer to SPD Data structure
IN OUT struct _PLATFORM_CONFIGURATION *PlatFormConfig; ///< Platform profile/build option config structure
IN OUT BOOLEAN IsFlowControlSupported; ///< Indicates if flow control is supported
OUT UINT32 TscRate; ///< The rate at which the TSC increments in megahertz.
} MEM_DATA_STRUCT;
///
/// Uma Structure
///
///
typedef struct _UMA_INFO {
OUT UINT64 UmaBase; ///< UmaBase[63:0] = Addr[63:0]
OUT UINT32 UmaSize; ///< UmaSize[31:0] = Addr[31:0]
OUT UINT32 UmaAttributes; ///< Indicate the attribute of Uma
OUT UINT8 UmaMode; ///< Indicate the mode of Uma
OUT UINT16 MemClock; ///< Indicate memory running speed in MHz
OUT UINT8 Reserved[3]; ///< Reserved for future usage
} UMA_INFO;
// AGESA MEMORY ERRORS
// AGESA_ALERT Memory Errors
#define MEM_ALERT_USER_TMG_MODE_OVERRULED 0x04010000 ///< TIMING_MODE_SPECIFIC is requested but
///< cannot be applied to current configurations.
#define MEM_ALERT_ORG_MISMATCH_DIMM 0x04010100 ///< DIMM organization miss-match
#define MEM_ALERT_BK_INT_DIS 0x04010200 ///< Bank interleaving disable for internal issue
// AGESA_ERROR Memory Errors
#define MEM_ERROR_NO_DQS_POS_RD_WINDOW 0x04010300 ///< No DQS Position window for RD DQS
#define MEM_ERROR_SMALL_DQS_POS_RD_WINDOW 0x04020300 ///< Small DQS Position window for RD DQS
#define MEM_ERROR_NO_DQS_POS_WR_WINDOW 0x04030300 ///< No DQS Position window for WR DQS
#define MEM_ERROR_SMALL_DQS_POS_WR_WINDOW 0x04040300 ///< Small DQS Position window for WR DQS
#define MEM_ERROR_ECC_DIS 0x04010400 ///< ECC has been disabled as a result of an internal issue
#define MEM_ERROR_DIMM_SPARING_NOT_ENABLED 0x04010500 ///< DIMM sparing has not been enabled for an internal issues
#define MEM_ERROR_RCVR_EN_VALUE_TOO_LARGE 0x04050300 ///< Receive Enable value is too large
#define MEM_ERROR_RCVR_EN_NO_PASSING_WINDOW 0x04060300 ///< There is no DQS receiver enable window
#define MEM_ERROR_DRAM_ENABLED_TIME_OUT 0x04010600 ///< Time out when polling DramEnabled bit
#define MEM_ERROR_DCT_ACCESS_DONE_TIME_OUT 0x04010700 ///< Time out when polling DctAccessDone bit
#define MEM_ERROR_SEND_CTRL_WORD_TIME_OUT 0x04010800 ///< Time out when polling SendCtrlWord bit
#define MEM_ERROR_PREF_DRAM_TRAIN_MODE_TIME_OUT 0x04010900 ///< Time out when polling PrefDramTrainMode bit
#define MEM_ERROR_ENTER_SELF_REF_TIME_OUT 0x04010A00 ///< Time out when polling EnterSelfRef bit
#define MEM_ERROR_FREQ_CHG_IN_PROG_TIME_OUT 0x04010B00 ///< Time out when polling FreqChgInProg bit
#define MEM_ERROR_EXIT_SELF_REF_TIME_OUT 0x04020A00 ///< Time out when polling ExitSelfRef bit
#define MEM_ERROR_SEND_MRS_CMD_TIME_OUT 0x04010C00 ///< Time out when polling SendMrsCmd bit
#define MEM_ERROR_SEND_ZQ_CMD_TIME_OUT 0x04010D00 ///< Time out when polling SendZQCmd bit
#define MEM_ERROR_DCT_EXTRA_ACCESS_DONE_TIME_OUT 0x04010E00 ///< Time out when polling DctExtraAccessDone bit
#define MEM_ERROR_MEM_CLR_BUSY_TIME_OUT 0x04010F00 ///< Time out when polling MemClrBusy bit
#define MEM_ERROR_MEM_CLEARED_TIME_OUT 0x04020F00 ///< Time out when polling MemCleared bit
#define MEM_ERROR_FLUSH_WR_TIME_OUT 0x04011000 ///< Time out when polling FlushWr bit
#define MEM_ERROR_MAX_LAT_NO_WINDOW 0x04070300 ///< Fail to find pass during Max Rd Latency training
#define MEM_ERROR_PARALLEL_TRAINING_LAUNCH_FAIL 0x04080300 ///< Fail to launch training code on an AP
#define MEM_ERROR_PARALLEL_TRAINING_TIME_OUT 0x04090300 ///< Fail to finish parallel training
#define MEM_ERROR_NO_ADDRESS_MAPPING 0x04011100 ///< No address mapping found for a dimm
#define MEM_ERROR_RCVR_EN_NO_PASSING_WINDOW_EQUAL_LIMIT 0x040A0300 ///< There is no DQS receiver enable window and the value is equal to the largest value
#define MEM_ERROR_RCVR_EN_VALUE_TOO_LARGE_LIMIT_LESS_ONE 0x040B0300 ///< Receive Enable value is too large and is 1 less than limit
#define MEM_ERROR_CHECKSUM_NV_SPDCHK_RESTRT_ERROR 0x04011200 ///< SPD Checksum error for NV_SPDCHK_RESTRT
#define MEM_ERROR_NO_CHIPSELECT 0x04011300 ///< No chipselects found
#define MEM_ERROR_UNSUPPORTED_333MHZ_UDIMM 0x04011500 ///< Unbuffered dimm is not supported at 333MHz
#define MEM_ERROR_WL_PRE_OUT_OF_RANGE 0x040C0300 ///< Returned PRE value during write levelizzation was out of range
// AGESA_WARNING Memory Errors
#define MEM_WARNING_UNSUPPORTED_QRDIMM 0x04011600 ///< QR DIMMs detected but not supported
#define MEM_WARNING_UNSUPPORTED_UDIMM 0x04021600 ///< U DIMMs detected but not supported
#define MEM_WARNING_UNSUPPORTED_SODIMM 0x04031600 ///< SO-DIMMs detected but not supported
#define MEM_WARNING_UNSUPPORTED_X4DIMM 0x04041600 ///< x4 DIMMs detected but not supported
#define MEM_WARNING_UNSUPPORTED_RDIMM 0x04051600 ///< R DIMMs detected but not supported
#define MEM_WARNING_UNSUPPORTED_LRDIMM 0x04061600 ///< LR DIMMs detected but not supported
#define MEM_WARNING_EMP_NOT_SUPPORTED 0x04011700 ///< Processor is not capable for EMP
#define MEM_WARNING_EMP_CONFLICT 0x04021700 ///< EMP cannot be enabled if channel interleaving,
#define MEM_WARNING_EMP_NOT_ENABLED 0x04031700 ///< Memory size is not power of two.
#define MEM_WARNING_PERFORMANCE_ENABLED_BATTERY_LIFE_PREFERRED 0x04011800 ///< Performance has been enabled, but battery life is preferred.
///< bank interleaving, or bank swizzle is enabled.
#define MEM_WARNING_NO_SPDTRC_FOUND 0x04011900 ///< No Trc timing value found in SPD of a dimm.
#define MEM_WARNING_NODE_INTERLEAVING_NOT_ENABLED 0x04012000 ///< Node Interleaveing Requested, but could not be enabled
#define MEM_WARNING_CHANNEL_INTERLEAVING_NOT_ENABLED 0x04012100 ///< Channel Interleaveing Requested, but could not be enabled
#define MEM_WARNING_BANK_INTERLEAVING_NOT_ENABLED 0x04012200 ///< Bank Interleaveing Requested, but could not be enabled
#define MEM_WARNING_VOLTAGE_1_35_NOT_SUPPORTED 0x04012300 ///< Voltage 1.35 determined, but could not be supported
// AGESA_FATAL Memory Errors
#define MEM_ERROR_MINIMUM_MODE 0x04011A00 ///< Running in minimum mode
#define MEM_ERROR_MODULE_TYPE_MISMATCH_DIMM 0x04011B00 ///< DIMM modules are miss-matched
#define MEM_ERROR_NO_DIMM_FOUND_ON_SYSTEM 0x04011C00 ///< No DIMMs have been found
#define MEM_ERROR_MISMATCH_DIMM_CLOCKS 0x04011D00 ///< DIMM clocks miss-matched
#define MEM_ERROR_NO_CYC_TIME 0x04011E00 ///< No cycle time found
#define MEM_ERROR_HEAP_ALLOCATE_DYN_STORING_OF_TRAINED_TIMINGS 0x04011F00 ///< Heap allocation error with dynamic storing of trained timings
#define MEM_ERROR_HEAP_ALLOCATE_FOR_DCT_STRUCT_AND_CH_DEF_STRUCTs 0x04021F00 ///< Heap allocation error for DCT_STRUCT and CH_DEF_STRUCT
#define MEM_ERROR_HEAP_ALLOCATE_FOR_REMOTE_TRAINING_ENV 0x04031F00 ///< Heap allocation error with REMOTE_TRAINING_ENV
#define MEM_ERROR_HEAP_ALLOCATE_FOR_SPD 0x04041F00 ///< Heap allocation error for SPD data
#define MEM_ERROR_HEAP_ALLOCATE_FOR_RECEIVED_DATA 0x04051F00 ///< Heap allocation error for RECEIVED_DATA during parallel training
#define MEM_ERROR_HEAP_ALLOCATE_FOR_S3_SPECIAL_CASE_REGISTERS 0x04061F00 ///< Heap allocation error for S3 "SPECIAL_CASE_REGISTER"
#define MEM_ERROR_HEAP_ALLOCATE_FOR_TRAINING_DATA 0x04071F00 ///< Heap allocation error for Training Data
#define MEM_ERROR_HEAP_ALLOCATE_FOR_IDENTIFY_DIMM_MEM_NB_BLOCK 0x04081F00 ///< Heap allocation error for DIMM Identify "MEM_NB_BLOCK
#define MEM_ERROR_NO_CONSTRUCTOR_FOR_IDENTIFY_DIMM 0x04022300 ///< No Constructor for DIMM Identify
// AGESA_CRITICAL Memory Errors
#define MEM_ERROR_HEAP_ALLOCATE_FOR_DMI_TABLE_DDR3 0x04091F00 ///< Heap allocation error for DMI table for DDR3
#define MEM_ERROR_HEAP_ALLOCATE_FOR_DMI_TABLE_DDR2 0x040A1F00 ///< Heap allocation error for DMI table for DDR2
#define MEM_ERROR_UNSUPPORTED_DIMM_CONFIG 0x04011400 ///< Dimm population is not supported
/*----------------------------------------------------------------------------
*
* END OF MEMORY-SPECIFIC DATA STRUCTURES
*
*----------------------------------------------------------------------------
*/
/*----------------------------------------------------------------------------
*
* CPU RELATED DEFINITIONS
*
*----------------------------------------------------------------------------
*/
// CPU Event definitions.
// Defines used to filter CPU events based on functional blocks
#define CPU_EVENT_PM_EVENT_MASK 0xFF00FF00
#define CPU_EVENT_PM_EVENT_CLASS 0x08000400
//================================================================
// CPU General events
// Heap allocation (AppFunction = 01h)
#define CPU_ERROR_HEAP_BUFFER_IS_NOT_PRESENT 0x08000100
#define CPU_ERROR_HEAP_IS_ALREADY_INITIALIZED 0x08010100
#define CPU_ERROR_HEAP_IS_FULL 0x08020100
#define CPU_ERROR_HEAP_BUFFER_HANDLE_IS_ALREADY_USED 0x08030100
#define CPU_ERROR_HEAP_BUFFER_HANDLE_IS_NOT_PRESENT 0x08040100
// BrandId (AppFunction = 02h)
#define CPU_ERROR_BRANDID_HEAP_NOT_AVAILABLE 0x08000200
// Micro code patch (AppFunction = 03h)
#define CPU_ERROR_MICRO_CODE_PATCH_IS_NOT_LOADED 0x08000300
// Power management (AppFunction = 04h)
#define CPU_EVENT_PM_PSTATE_OVERCURRENT 0x08000400
#define CPU_EVENT_PM_ALL_PSTATE_OVERCURRENT 0x08010400
#define CPU_ERROR_PSTATE_HEAP_NOT_AVAILABLE 0x08020400
#define CPU_ERROR_PM_NB_PSTATE_MISMATCH 0x08030400
// BIST (AppFunction = 05h)
#define CPU_EVENT_BIST_ERROR 0x08000500
//=================================================================
// CPU Feature events
// Execution cache (AppFunction = 21h)
// AGESA_CACHE_SIZE_REDUCED 2101
// AGESA_CACHE_REGIONS_ACROSS_1MB 2102
// AGESA_CACHE_REGIONS_ACROSS_4GB 2103
// AGESA_REGION_NOT_ALIGNED_ON_BOUNDARY 2104
// AGESA_CACHE_START_ADDRESS_LESS_D0000 2105
// AGESA_THREE_CACHE_REGIONS_ABOVE_1MB 2106
// AGESA_DEALLOCATE_CACHE_REGIONS 2107
#define CPU_EVENT_EXECUTION_CACHE_ALLOCATION_ERROR 0x08002100
// Core Leveling (AppFunction = 22h)
#define CPU_WARNING_ADJUSTED_LEVELING_MODE 0x08002200
// HT Assist (AppFunction = 23h)
#define CPU_WARNING_NONOPTIMAL_HT_ASSIST_CFG 0x08002300
// CPU Build Configuration structures and definitions
/// Build Configuration structure for BLDCFG_AP_MTRR_SETTINGS
typedef struct {
IN UINT32 MsrAddr; ///< Fixed-Sized MTRR address
IN UINT64 MsrData; ///< MTRR Settings
} AP_MTRR_SETTINGS;
#define AMD_AP_MTRR_FIX64k_00000 0x00000250
#define AMD_AP_MTRR_FIX16k_80000 0x00000258
#define AMD_AP_MTRR_FIX16k_A0000 0x00000259
#define AMD_AP_MTRR_FIX4k_C0000 0x00000268
#define AMD_AP_MTRR_FIX4k_C8000 0x00000269
#define AMD_AP_MTRR_FIX4k_D0000 0x0000026A
#define AMD_AP_MTRR_FIX4k_D8000 0x0000026B
#define AMD_AP_MTRR_FIX4k_E0000 0x0000026C
#define AMD_AP_MTRR_FIX4k_E8000 0x0000026D
#define AMD_AP_MTRR_FIX4k_F0000 0x0000026E
#define AMD_AP_MTRR_FIX4k_F8000 0x0000026F
#define CPU_LIST_TERMINAL 0xFFFFFFFF
/************************************************************************
*
* AGESA interface Call-Out function parameter structures
*
***********************************************************************/
/// Parameters structure for interface call-out AgesaAllocateBuffer
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN OUT UINT32 BufferLength; ///< Size of buffer to allocate
IN UINT32 BufferHandle; ///< Identifier or name for the buffer
OUT VOID *BufferPointer; ///< location of the created buffer
} AGESA_BUFFER_PARAMS;
/// Parameters structure for interface call-out AgesaRunCodeOnAp
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN UINT32 FunctionNumber; ///< Index of the procedure to execute
IN VOID *RelatedDataBlock; ///< Location of data structure the procedure will use
IN UINT32 RelatedBlockLength; ///< Size of the related data block
} AP_EXE_PARAMS;
/// Parameters structure for the interface call-out AgesaReadSpd & AgesaReadSpdRecovery
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN UINT8 SocketId; ///< Address of SPD - socket ID
IN UINT8 MemChannelId; ///< Address of SPD - memory channel ID
IN UINT8 DimmId; ///< Address of SPD - DIMM ID
IN OUT UINT8 *Buffer; ///< Location where to place the SPD content
IN OUT MEM_DATA_STRUCT *MemData; ///< Location of the MemData structure, for reference
} AGESA_READ_SPD_PARAMS;
/// Buffer Handles
typedef enum {
AMD_DMI_INFO_BUFFER_HANDLE = 0x000D000, ///< Assign 0x000D000 buffer handle to DMI function
AMD_PSTATE_DATA_BUFFER_HANDLE, ///< Assign 0x000D001 buffer handle to Pstate data
AMD_PSTATE_ACPI_BUFFER_HANDLE, ///< Assign 0x000D002 buffer handle to Pstate table
AMD_BRAND_ID_BUFFER_HANDLE, ///< Assign 0x000D003 buffer handle to Brand ID
AMD_ACPI_SLIT_BUFFER_HANDLE, ///< Assign 0x000D004 buffer handle to SLIT function
AMD_SRAT_INFO_BUFFER_HANDLE, ///< Assign 0x000D005 buffer handle to SRAT function
AMD_WHEA_BUFFER_HANDLE, ///< Assign 0x000D006 buffer handle to WHEA function
AMD_S3_INFO_BUFFER_HANDLE, ///< Assign 0x000D007 buffer handle to S3 function
AMD_S3_NB_INFO_BUFFER_HANDLE, ///< Assign 0x000D008 buffer handle to S3 NB device info
AMD_ACPI_ALIB_BUFFER_HANDLE ///< Assign 0x000D009 buffer handle to ALIB SSDT table
} AMD_BUFFER_HANDLE;
/************************************************************************
*
* AGESA interface Call-Out function prototypes
*
***********************************************************************/
VOID
AgesaDoReset (
IN UINTN ResetType,
IN OUT AMD_CONFIG_PARAMS *StdHeader
);
AGESA_STATUS
AgesaAllocateBuffer (
IN UINTN FcnData,
IN OUT AGESA_BUFFER_PARAMS *AllocParams
);
AGESA_STATUS
AgesaDeallocateBuffer (
IN UINTN FcnData,
IN OUT AGESA_BUFFER_PARAMS *DeallocParams
);
AGESA_STATUS
AgesaLocateBuffer (
IN UINTN FcnData,
IN OUT AGESA_BUFFER_PARAMS *LocateParams
);
AGESA_STATUS
AgesaReadSpd (
IN UINTN FcnData,
IN OUT AGESA_READ_SPD_PARAMS *ReadSpd
);
AGESA_STATUS
AgesaReadSpdRecovery (
IN UINTN FcnData,
IN OUT AGESA_READ_SPD_PARAMS *ReadSpd
);
AGESA_STATUS
AgesaHookBeforeDramInitRecovery (
IN UINTN FcnData,
IN OUT MEM_DATA_STRUCT *MemData
);
AGESA_STATUS
AgesaRunFcnOnAp (
IN UINTN ApicIdOfCore,
IN AP_EXE_PARAMS *LaunchApParams
);
AGESA_STATUS
AgesaHookBeforeDramInit (
IN UINTN FcnData,
IN OUT MEM_DATA_STRUCT *MemData
);
AGESA_STATUS
AgesaHookBeforeDQSTraining (
IN UINTN FcnData,
IN OUT MEM_DATA_STRUCT *MemData
);
AGESA_STATUS
AgesaHookBeforeExitSelfRefresh (
IN UINTN FcnData,
IN OUT MEM_DATA_STRUCT *MemData
);
AGESA_STATUS
AgesaPcieSlotResetControl (
IN UINTN FcnData,
IN PCIe_SLOT_RESET_INFO *ResetInfo
);
/************************************************************************
*
* AGESA interface structure definition and function prototypes
*
***********************************************************************/
/**********************************************************************
* Platform Configuration: The parameters in boot branch function
**********************************************************************/
/// The possible platform control flow settings.
typedef enum {
Nfcm, ///< Normal Flow Control Mode.
UmaDr, ///< UMA using Display Refresh flow control.
UmaIfcm, ///< UMA using Isochronous Flow Control.
Ifcm, ///< Isochronous Flow Control Mode (other than for UMA).
Iommu, ///< An IOMMU is in use in the system.
MaxControlFlow ///< Not a control flow mode, use for limit checking.
} PLATFORM_CONTROL_FLOW;
/// Platform Deemphasis Levels.
///
/// The deemphasis level is set for the receiver, based on link characterization. The DCV level is
/// set based on the level of the far transmitter.
typedef enum {
DeemphasisLevelNone, ///< No Deemphasis.
DeemphasisLevelMinus3, ///< Minus 3 db deemphasis.
DeemphasisLevelMinus6, ///< Minus 6 db deemphasis.
DeemphasisLevelMinus8, ///< Minus 8 db deemphasis.
DeemphasisLevelMinus11, ///< Minus 11 db deemphasis.
DeemphasisLevelMinus11pre8, ///< Minus 11, Minus 8 precursor db deemphasis.
DcvLevelNone = 16, ///< No DCV Deemphasis.
DcvLevelMinus2, ///< Minus 2 db DCV deemphasis.
DcvLevelMinus3, ///< Minus 3 db DCV deemphasis.
DcvLevelMinus5, ///< Minus 5 db DCV deemphasis.
DcvLevelMinus6, ///< Minus 6 db DCV deemphasis.
DcvLevelMinus7, ///< Minus 7 db DCV deemphasis.
DcvLevelMinus8, ///< Minus 8 db DCV deemphasis.
DcvLevelMinus9, ///< Minus 9 db DCV deemphasis.
DcvLevelMinus11, ///< Minus 11 db DCV deemphasis.
MaxPlatformDeemphasisLevel ///< Not a deemphasis level, use for limit checking.
} PLATFORM_DEEMPHASIS_LEVEL;
/// Provide Deemphasis Levels for HT Links.
///
/// For each CPU to CPU or CPU to IO device HT link, the list of Deemphasis Levels will
/// be checked for a match. The item matches for a Socket, Link if the link frequency is
/// is in the inclusive range HighFreq:LoFreq.
/// AGESA does not set deemphasis in IO devices, only in processors.
typedef struct {
// Match fields
IN UINT8 Socket; ///< One Socket on which this Link is located
IN UINT8 Link; ///< The Link on this Processor.
IN UINT8 LoFreq; ///< If the link is set to this frequency or greater, apply these levels, and
IN UINT8 HighFreq; ///< If the link is set to this frequency or less, apply these levels.
// Value fields
IN PLATFORM_DEEMPHASIS_LEVEL ReceiverDeemphasis; ///< The deemphasis level for this link
IN PLATFORM_DEEMPHASIS_LEVEL DcvDeemphasis; ///< The DCV, or far transmitter deemphasis level.
} CPU_HT_DEEMPHASIS_LEVEL;
/// The possible platform power policy settings.
typedef enum {
Performance, ///< Optimize for performance.
BatteryLife, ///< Optimize for battery life.
MaxPowerPolicy ///< Not a power policy mode, use for limit checking.
} PLATFORM_POWER_POLICY;
/// Platform performance settings for optimized settings.
/// Several configuration settings for the processor depend upon other parts and
/// general designer choices for the system. The determination of these data points
/// is not standard for all platforms, so the host environment needs to provide these
/// to specify how the system is to be configured.
typedef struct {
IN PLATFORM_CONTROL_FLOW PlatformControlFlowMode; ///< The platform's control flow mode for optimum platform performance.
///< @BldCfgItem{BLDCFG_PLATFORM_CONTROL_FLOW_MODE}
IN BOOLEAN UseHtAssist; ///< HyperTransport link traffic optimization.
///< @BldCfgItem{BLDCFG_USE_HT_ASSIST}
IN BOOLEAN UseAtmMode; ///< HyperTransport link traffic optimization.
///< @BldCfgItem{BLDCFG_USE_ATM_MODE}
IN BOOLEAN Use32ByteRefresh; ///< Display Refresh traffic generates 32 byte requests.
///< @BldCfgItem{BLDCFG_USE_32_BYTE_REFRESH}
IN BOOLEAN UseVariableMctIsocPriority; ///< The Memory controller will be set to Variable Isoc Priority.
///< @BldCfgItem{BLDCFG_USE_VARIABLE_MCT_ISOC_PRIORITY}
IN PLATFORM_POWER_POLICY PlatformPowerPolicy; ///< The platform's desired power policy
///< @BldCfgItem{BLDCFG_PLATFORM_POWER_POLICY_MODE}
} PERFORMANCE_PROFILE;
/// Platform settings that describe the voltage regulator modules of the system.
/// Many power management settings are dependent upon the characteristics of the
/// on-board voltage regulator module (VRM). The host environment needs to provide
/// these to specify how the system is to be configured.
typedef struct {
IN UINT32 CurrentLimit; ///< Vrm Current Limit.
///< @BldCfgItem{BLDCFG_VRM_CURRENT_LIMIT}
///< @BldCfgItem{BLDCFG_VRM_NB_CURRENT_LIMIT}
IN UINT32 LowPowerThreshold; ///< Vrm Low Power Threshold.
///< @BldCfgItem{BLDCFG_VRM_LOW_POWER_THRESHOLD}
///< @BldCfgItem{BLDCFG_VRM_NB_LOW_POWER_THRESHOLD}
IN UINT32 SlewRate; ///< Vrm Slew Rate.
///< @BldCfgItem{BLDCFG_VRM_SLEW_RATE}
///< @BldCfgItem{BLDCFG_VRM_NB_SLEW_RATE}
IN UINT32 AdditionalDelay; ///< Vrm Additional Delay.
///< @BldCfgItem{BLDCFG_VRM_ADDITIONAL_DELAY}
///< @BldCfgItem{BLDCFG_VRM_NB_ADDITIONAL_DELAY}
IN BOOLEAN HiSpeedEnable; ///< Select high speed VRM.
///< @BldCfgItem{BLDCFG_VRM_HIGH_SPEED_ENABLE}
///< @BldCfgItem{BLDCFG_VRM_NB_HIGH_SPEED_ENABLE}
IN UINT32 InrushCurrentLimit; ///< Vrm Inrush Current Limit.
///< @BldCfgItem{BLDCFG_VRM_INRUSH_CURRENT_LIMIT}
///< @BldCfgItem{BLDCFG_VRM_NB_INRUSH_CURRENT_LIMIT}
} PLATFORM_VRM_CONFIGURATION;
/// The VRM types to characterize.
typedef enum {
CoreVrm, ///< VDD plane.
NbVrm, ///< VDDNB plane.
MaxVrmType ///< Not a valid VRM type, use for limit checking.
} PLATFORM_VRM_TYPE;
/// Build Option/Configuration Boolean Structure.
typedef struct {
IN AMD_CODE_HEADER VersionString; ///< AMD embedded code version string
//Build Option Area
IN BOOLEAN OptionUDimms; ///< @ref BLDOPT_REMOVE_UDIMMS_SUPPORT "BLDOPT_REMOVE_UDIMMS_SUPPORT"
IN BOOLEAN OptionRDimms; ///< @ref BLDOPT_REMOVE_RDIMMS_SUPPORT "BLDOPT_REMOVE_RDIMMS_SUPPORT"
IN BOOLEAN OptionLrDimms; ///< @ref BLDOPT_REMOVE_LRDIMMS_SUPPORT "BLDOPT_REMOVE_LRDIMMS_SUPPORT"
IN BOOLEAN OptionEcc; ///< @ref BLDOPT_REMOVE_ECC_SUPPORT "BLDOPT_REMOVE_ECC_SUPPORT"
IN BOOLEAN OptionBankInterleave; ///< @ref BLDOPT_REMOVE_BANK_INTERLEAVE "BLDOPT_REMOVE_BANK_INTERLEAVE"
IN BOOLEAN OptionDctInterleave; ///< @ref BLDOPT_REMOVE_DCT_INTERLEAVE "BLDOPT_REMOVE_DCT_INTERLEAVE"
IN BOOLEAN OptionNodeInterleave; ///< @ref BLDOPT_REMOVE_NODE_INTERLEAVE "BLDOPT_REMOVE_NODE_INTERLEAVE"
IN BOOLEAN OptionParallelTraining; ///< @ref BLDOPT_REMOVE_PARALLEL_TRAINING "BLDOPT_REMOVE_PARALLEL_TRAINING"
IN BOOLEAN OptionOnlineSpare; ///< @ref BLDOPT_REMOVE_ONLINE_SPARE_SUPPORT "BLDOPT_REMOVE_ONLINE_SPARE_SUPPORT"
IN BOOLEAN OptionMemRestore; ///< @ref BLDOPT_REMOVE_MEM_RESTORE_SUPPORT "BLDOPT_REMOVE_MEM_RESTORE_SUPPORT"
IN BOOLEAN OptionMultisocket; ///< @ref BLDOPT_REMOVE_MULTISOCKET_SUPPORT "BLDOPT_REMOVE_MULTISOCKET_SUPPORT"
IN BOOLEAN OptionAcpiPstates; ///< @ref BLDOPT_REMOVE_ACPI_PSTATES "BLDOPT_REMOVE_ACPI_PSTATES"
IN BOOLEAN OptionSrat; ///< @ref BLDOPT_REMOVE_SRAT "BLDOPT_REMOVE_SRAT"
IN BOOLEAN OptionSlit; ///< @ref BLDOPT_REMOVE_SLIT "BLDOPT_REMOVE_SLIT"
IN BOOLEAN OptionWhea; ///< @ref BLDOPT_REMOVE_WHEA "BLDOPT_REMOVE_WHEA"
IN BOOLEAN OptionDmi; ///< @ref BLDOPT_REMOVE_DMI "BLDOPT_REMOVE_DMI"
IN BOOLEAN OptionEarlySamples; ///< @ref BLDOPT_REMOVE_EARLY_SAMPLES "BLDOPT_REMOVE_EARLY_SAMPLES"
IN BOOLEAN OptionAddrToCsTranslator; ///< ADDR_TO_CS_TRANSLATOR
//Build Configuration Area
IN UINT64 CfgPciMmioAddress; ///< Pci Mmio Base Address to use for PCI Config accesses.
///< Build-time customizable only - @BldCfgItem{BLDCFG_PCI_MMIO_BASE}
IN UINT32 CfgPciMmioSize; ///< Pci Mmio region Size.
///< Build-time customizable only - @BldCfgItem{BLDCFG_PCI_MMIO_SIZE}
IN PLATFORM_VRM_CONFIGURATION CfgPlatVrmCfg[MaxVrmType]; ///< Several configuration settings for the voltage regulator modules.
IN UINT32 CfgPlatNumIoApics; ///< The number of IO APICS for the platform.
IN UINT32 CfgMemInitPstate; ///< Memory Init Pstate.
IN PLATFORM_C1E_MODES CfgPlatformC1eMode; ///< Select the C1e Mode that will used.
IN UINT32 CfgPlatformC1eOpData; ///< An IO port or additional C1e setup data, depends on C1e mode.
IN UINT32 CfgPlatformC1eOpData1; ///< An IO port or additional C1e setup data, depends on C1e mode.
IN UINT32 CfgPlatformC1eOpData2; ///< An IO port or additional C1e setup data, depends on C1e mode.
IN PLATFORM_CSTATE_MODES CfgPlatformCStateMode; ///< Select the C-State Mode that will used.
IN UINT32 CfgPlatformCStateOpData; ///< An IO port or additional C-State setup data, depends on C-State mode.
IN UINT16 CfgPlatformCStateIoBaseAddress; ///< Specifies I/O ports that can be used to allow CPU to enter CStates
IN PLATFORM_CPB_MODES CfgPlatformCpbMode; ///< Enable or disable core performance boost
IN UINT32 CfgCoreLevelingMode; ///< Apply any downcoring or core count leveling as specified.
IN PERFORMANCE_PROFILE CfgPerformanceProfile; ///< The platform's control flow mode and platform performance settings.
IN CPU_HT_DEEMPHASIS_LEVEL *CfgPlatformDeemphasisList; ///< Deemphasis levels for the platform's HT links.
IN UINT32 CfgAmdPlatformType; ///< Designate the platform as a Server, Desktop, or Mobile.
IN UINT32 CfgAmdPstateCapValue; ///< Amd pstate ceiling enabling deck
IN MEMORY_BUS_SPEED CfgMemoryBusFrequencyLimit; ///< Memory Bus Frequency Limit.
///< Build-time customizable only - @BldCfgItem{BLDCFG_MEMORY_BUS_FREQUENCY_LIMIT}
IN BOOLEAN CfgMemoryModeUnganged; ///< Memory Mode Unganged.
///< Build-time customizable only - @BldCfgItem{BLDCFG_MEMORY_MODE_UNGANGED}
IN BOOLEAN CfgMemoryQuadRankCapable; ///< Memory Quad Rank Capable.
///< Build-time customizable only - @BldCfgItem{BLDCFG_MEMORY_QUAD_RANK_CAPABLE}
IN QUANDRANK_TYPE CfgMemoryQuadrankType; ///< Memory Quadrank Type.
///< Build-time customizable only - @BldCfgItem{BLDCFG_MEMORY_QUADRANK_TYPE}
IN BOOLEAN CfgMemoryRDimmCapable; ///< Memory RDIMM Capable.
IN BOOLEAN CfgMemoryLRDimmCapable; ///< Memory LRDIMM Capable.
IN BOOLEAN CfgMemoryUDimmCapable; ///< Memory UDIMM Capable.
IN BOOLEAN CfgMemorySODimmCapable; ///< Memory SODimm Capable.
///< Build-time customizable only - @BldCfgItem{BLDCFG_MEMORY_SODIMM_CAPABLE}
IN BOOLEAN CfgMemoryEnableBankInterleaving; ///< Memory Enable Bank Interleaving.
IN BOOLEAN CfgMemoryEnableNodeInterleaving; ///< Memory Enable Node Interleaving.
IN BOOLEAN CfgMemoryChannelInterleaving; ///< Memory Channel Interleaving.
IN BOOLEAN CfgMemoryPowerDown; ///< Memory Power Down.
IN POWER_DOWN_MODE CfgPowerDownMode; ///< Power Down Mode.
IN BOOLEAN CfgOnlineSpare; ///< Online Spare.
IN BOOLEAN CfgMemoryParityEnable; ///< Memory Parity Enable.
IN BOOLEAN CfgBankSwizzle; ///< Bank Swizzle.
IN USER_MEMORY_TIMING_MODE CfgTimingModeSelect; ///< Timing Mode Select.
IN MEMORY_BUS_SPEED CfgMemoryClockSelect; ///< Memory Clock Select.
IN BOOLEAN CfgDqsTrainingControl; ///< Dqs Training Control.
///< Build-time customizable only - @BldCfgItem{BLDCFG_DQS_TRAINING_CONTROL}
IN BOOLEAN CfgIgnoreSpdChecksum; ///< Ignore Spd Checksum.
///< Build-time customizable only - @BldCfgItem{BLDCFG_IGNORE_SPD_CHECKSUM}
IN BOOLEAN CfgUseBurstMode; ///< Use Burst Mode.
///< Build-time customizable only - @BldCfgItem{BLDCFG_USE_BURST_MODE}
IN BOOLEAN CfgMemoryAllClocksOn; ///< Memory All Clocks On.
///< Build-time customizable only - @BldCfgItem{BLDCFG_MEMORY_ALL_CLOCKS_ON}
IN BOOLEAN CfgEnableEccFeature; ///< Enable ECC Feature.
IN BOOLEAN CfgEccRedirection; ///< ECC Redirection.
///< Build-time customizable only - @BldCfgItem{BLDCFG_ECC_REDIRECTION}
IN UINT16 CfgScrubDramRate; ///< Scrub Dram Rate.
///< Build-time customizable only - @BldCfgItem{BLDCFG_SCRUB_DRAM_RATE}
IN UINT16 CfgScrubL2Rate; ///< Scrub L2Rate.
///< Build-time customizable only - @BldCfgItem{BLDCFG_SCRUB_L2_RATE}
IN UINT16 CfgScrubL3Rate; ///< Scrub L3Rate.
///< Build-time customizable only - @BldCfgItem{BLDCFG_SCRUB_L3_RATE}
IN UINT16 CfgScrubIcRate; ///< Scrub Ic Rate.
///< Build-time customizable only - @BldCfgItem{BLDCFG_SCRUB_IC_RATE}
IN UINT16 CfgScrubDcRate; ///< Scrub Dc Rate.
///< Build-time customizable only - @BldCfgItem{BLDCFG_SCRUB_DC_RATE}
IN BOOLEAN CfgEccSyncFlood; ///< ECC Sync Flood.
///< Build-time customizable only - @BldCfgItem{BLDCFG_ECC_SYNC_FLOOD}
IN UINT16 CfgEccSymbolSize; ///< ECC Symbol Size.
///< Build-time customizable only - @BldCfgItem{BLDCFG_ECC_SYMBOL_SIZE}
IN UINT64 CfgHeapDramAddress; ///< Heap contents will be temporarily stored in this address during the transition.
///< Build-time customizable only - @BldCfgItem{BLDCFG_HEAP_DRAM_ADDRESS}
IN BOOLEAN CfgNodeMem1GBAlign; ///< Node Mem 1GB boundary Alignment
IN BOOLEAN CfgS3LateRestore; ///< S3 Late Restore
IN BOOLEAN CfgAcpiPstateIndependent; ///< PSD method dependent/Independent
IN AP_MTRR_SETTINGS *CfgApMtrrSettingsList; ///< The AP's MTRR settings before final halt
///< Build-time customizable only - @BldCfgItem{BLDCFG_AP_MTRR_SETTINGS_LIST}
IN UMA_MODE CfgUmaMode; ///< Uma Mode
IN UINT32 CfgUmaSize; ///< Uma Size [31:0]=Addr[47:16]
IN BOOLEAN CfgUmaAbove4G; ///< Uma Above 4G Support
IN UMA_ALIGNMENT CfgUmaAlignment; ///< Uma alignment
IN BOOLEAN CfgProcessorScopeInSb; ///< ACPI Processor Object in \\_SB scope
IN CHAR8 CfgProcessorScopeName0; ///< OEM specific 1st character of processor scope name.
IN CHAR8 CfgProcessorScopeName1; ///< OEM specific 2nd character of processor scope name.
IN UINT8 CfgGnbHdAudio; ///< GNB HD Audio
IN UINT8 CfgAbmSupport; ///< Abm Support
IN UINT8 CfgDynamicRefreshRate; ///< DRR Dynamic Refresh Rate
IN UINT16 CfgLcdBackLightControl; ///< LCD Backlight Control
IN UINT8 CfgGnb3dStereoPinIndex; ///< 3D Stereo Pin ID.
IN UINT32 CfgTempPcieMmioBaseAddress; ///< Temp pcie MMIO base Address
///< Build-time customizable only - @BldCfgItem{BLDCFG_TEMP_PCIE_MMIO_BASE_ADDRESS}
IN UINT32 CfgGnbIGPUSSID; ///< Gnb internal GPU SSID
///< Build-time customizable only - @BldCfgItem{BLDCFG_IGPU_SUBSYSTEM_ID}
IN UINT32 CfgGnbHDAudioSSID; ///< Gnb HD Audio SSID
///< Build-time customizable only - @BldCfgItem{BLDCFG_IGPU_HD_AUDIO_SUBSYSTEM_ID}
IN UINT32 CfgGnbPcieSSID; ///< Gnb PCIe SSID
///< Build-time customizable only - @BldCfgItem{BLFCFG_APU_PCIE_PORTS_SUBSYSTEM_ID}
IN UINT16 CfgLvdsSpreadSpectrum; ///< Lvds Spread Spectrum
///< Build-time customizable only - @BldCfgItem{BLDCFG_GFX_LVDS_SPREAD_SPECTRUM}
IN UINT16 CfgLvdsSpreadSpectrumRate; ///< Lvds Spread Spectrum Rate
///< Build-time customizable only - @BldCfgItem{BLDCFG_GFX_LVDS_SPREAD_SPECTRUM_RATE}
IN LVDS_MISC_CONTROL CfgLvdsMiscControl; ///< The LVDS Misc control
IN UINT16 CfgPcieRefClkSpreadSpectrum; ///< PCIe Reference Clock Spread Spectrum
///< Build-time customizable only - @BldCfgItem{BLDCFG_PCIE_REFCLK_SPREAD_SPECTRUM}
IN BOOLEAN Reserved; ///< reserved...
} BUILD_OPT_CFG;
/// A structure containing platform specific operational characteristics. This
/// structure is initially populated by the initializer with a copy of the same
/// structure that was created at build time using the build configuration controls.
typedef struct _PLATFORM_CONFIGURATION {
IN PERFORMANCE_PROFILE PlatformProfile; ///< Several configuration settings for the processor.
IN CPU_HT_DEEMPHASIS_LEVEL *PlatformDeemphasisList; ///< Deemphasis levels for the platform's HT links.
///< @BldCfgItem{BLDCFG_PLATFORM_DEEMPHASIS_LIST}.
///< @n @e Examples: See @ref DeemphasisExamples "Deemphasis List Examples".
IN UINT8 CoreLevelingMode; ///< Indicates how to balance the number of cores per processor.
///< @BldCfgItem{BLDCFG_CORE_LEVELING_MODE}
IN PLATFORM_C1E_MODES C1eMode; ///< Specifies the method of C1e enablement - Disabled, HW, or message based.
///< @BldCfgItem{BLDCFG_PLATFORM_C1E_MODE}
IN UINT32 C1ePlatformData; ///< If C1eMode is HW, specifies the P_LVL3 I/O port of the platform.
///< @BldCfgItem{BLDCFG_PLATFORM_C1E_OPDATA}
IN UINT32 C1ePlatformData1; ///< If C1eMode is SW, specifies the address of chipset's SMI command port.
///< @BldCfgItem{BLDCFG_PLATFORM_C1E_OPDATA1}
IN UINT32 C1ePlatformData2; ///< If C1eMode is SW, specifies the unique number used by the SMI handler to identify SMI source.
///< @BldCfgItem{BLDCFG_PLATFORM_C1E_OPDATA2}
IN PLATFORM_CSTATE_MODES CStateMode; ///< Specifies the method of C-State enablement - Disabled, or C6.
///< @BldCfgItem{BLDCFG_PLATFORM_CSTATE_MODE}
IN UINT32 CStatePlatformData; ///< This element specifies some pertinent data needed for the operation of the Cstate feature
///< If CStateMode is CStateModeC6, this item is reserved
///< @BldCfgItem{BLDCFG_PLATFORM_CSTATE_OPDATA}
IN UINT16 CStateIoBaseAddress; ///< This item specifies a free block of 8 consecutive bytes of I/O ports that
///< can be used to allow the CPU to enter Cstates.
///< @BldCfgItem{BLDCFG_PLATFORM_CSTATE_IO_BASE_ADDRESS}
IN PLATFORM_CPB_MODES CpbMode; ///< Specifies the method of core performance boost enablement - Disabled, or Auto.
///< @BldCfgItem{BLDCFG_PLATFORM_CPB_MODE}
IN BOOLEAN UserOptionDmi; ///< When set to TRUE, the DMI data table is generated.
IN BOOLEAN UserOptionPState; ///< When set to TRUE, the PState data tables are generated.
IN BOOLEAN UserOptionSrat; ///< When set to TRUE, the SRAT data table is generated.
IN BOOLEAN UserOptionSlit; ///< When set to TRUE, the SLIT data table is generated.
IN BOOLEAN UserOptionWhea; ///< When set to TRUE, the WHEA data table is generated.
IN UINT32 PowerCeiling; ///< P-State Ceiling Enabling Deck - Max power milli-watts.
IN BOOLEAN ForcePstateIndependent; ///< P-State _PSD independence or dependence.
///< @BldCfgItem{BLDCFG_FORCE_INDEPENDENT_PSD_OBJECT}
IN UINT32 NumberOfIoApics; ///< Number of I/O APICs in the system
///< @BldCfgItem{BLDCFG_PLATFORM_NUM_IO_APICS}
IN PLATFORM_VRM_CONFIGURATION VrmProperties[MaxVrmType]; ///< Several configuration settings for the voltage regulator modules.
IN BOOLEAN ProcessorScopeInSb; ///< ACPI Processor Object in \\_SB scope
///< @BldCfgItem{BLDCFG_PROCESSOR_SCOPE_IN_SB}
IN CHAR8 ProcessorScopeName0; ///< OEM specific 1st character of processor scope name.
///< @BldCfgItem{BLDCFG_PROCESSOR_SCOPE_NAME0}
IN CHAR8 ProcessorScopeName1; ///< OEM specific 2nd character of processor scope name.
///< @BldCfgItem{BLDCFG_PROCESSOR_SCOPE_NAME1}
IN UINT8 GnbHdAudio; ///< Control GFX HD Audio controller(Used for HDMI and DP display output),
///< essentially it enables function 1 of graphics device.
///< @li 0 = HD Audio disable
///< @li 1 = HD Audio enable
///< @BldCfgItem{BLDCFG_CFG_GNB_HD_AUDIO}
IN UINT8 AbmSupport; ///< Automatic adjust LVDS/eDP Back light level support.It is
///< characteristic specific to display panel which used by platform design.
///< @li 0 = ABM support disabled
///< @li 1 = ABM support enabled
///< @BldCfgItem{BLDCFG_CFG_ABM_SUPPORT}
IN UINT8 DynamicRefreshRate; ///< Adjust refresh rate on LVDS/eDP.
///< @BldCfgItem{BLDCFG_CFG_DYNAMIC_REFRESH_RATE}
IN UINT16 LcdBackLightControl; ///< The PWM frequency to LCD backlight control.
///< If equal to 0 backlight not controlled by iGPU
///< @BldCfgItem{BLDCFG_CFG_LCD_BACK_LIGHT_CONTROL}
} PLATFORM_CONFIGURATION;
/**********************************************************************
* Structures for: AmdInitLate
**********************************************************************/
#define PROC_VERSION_LENGTH 48
#define MAX_DIMMS_PER_SOCKET 16
/* Interface Parameter Structures */
/// DMI Type4 - Processor ID
typedef struct {
OUT UINT32 ProcIdLsd; ///< Lower half of 64b ID
OUT UINT32 ProcIdMsd; ///< Upper half of 64b ID
} TYPE4_PROC_ID;
/// DMI Type 4 - Processor information
typedef struct {
OUT UINT8 T4ProcType; ///< CPU Type
OUT UINT8 T4ProcFamily; ///< Family 1
OUT TYPE4_PROC_ID T4ProcId; ///< Id
OUT UINT8 T4Voltage; ///< Voltage
OUT UINT16 T4ExternalClock; ///< External clock
OUT UINT16 T4MaxSpeed; ///< Max speed
OUT UINT16 T4CurrentSpeed; ///< Current speed
OUT UINT8 T4Status; ///< Status
OUT UINT8 T4ProcUpgrade; ///< Up grade
OUT UINT8 T4CoreCount; ///< Core count
OUT UINT8 T4CoreEnabled; ///< Core Enable
OUT UINT8 T4ThreadCount; ///< Thread count
OUT UINT16 T4ProcCharacteristics; ///< Characteristics
OUT UINT16 T4ProcFamily2; ///< Family 2
OUT CHAR8 T4ProcVersion[PROC_VERSION_LENGTH]; ///< Cpu version
} TYPE4_DMI_INFO;
/// DMI Type 7 - Cache information
typedef struct _TYPE7_DMI_INFO {
OUT UINT16 T7CacheCfg; ///< Cache cfg
OUT UINT16 T7MaxCacheSize; ///< Max size
OUT UINT16 T7InstallSize; ///< Install size
OUT UINT16 T7SupportedSramType; ///< Supported Sram Type
OUT UINT16 T7CurrentSramType; ///< Current type
OUT UINT8 T7CacheSpeed; ///< Speed
OUT UINT8 T7ErrorCorrectionType; ///< ECC type
OUT UINT8 T7SystemCacheType; ///< Cache type
OUT UINT8 T7Associativity; ///< Associativity
} TYPE7_DMI_INFO;
/// DMI Type 16 offset 04h - Location
typedef enum {
OtherLocation = 0x01, ///< Assign 01 to Other
UnknownLocation, ///< Assign 02 to Unknown
SystemboardOrMotherboard, ///< Assign 03 to systemboard or motherboard
IsaAddonCard, ///< Assign 04 to ISA add-on card
EisaAddonCard, ///< Assign 05 to EISA add-on card
PciAddonCard, ///< Assign 06 to PCI add-on card
McaAddonCard, ///< Assign 07 to MCA add-on card
PcmciaAddonCard, ///< Assign 08 to PCMCIA add-on card
ProprietaryAddonCard, ///< Assign 09 to proprietary add-on card
NuBus, ///< Assign 0A to NuBus
Pc98C20AddonCard, ///< Assign 0A0 to PC-98/C20 add-on card
Pc98C24AddonCard, ///< Assign 0A1 to PC-98/C24 add-on card
Pc98EAddoncard, ///< Assign 0A2 to PC-98/E add-on card
Pc98LocalBusAddonCard ///< Assign 0A3 to PC-98/Local bus add-on card
} DMI_T16_LOCATION;
/// DMI Type 16 offset 05h - Memory Error Correction
typedef enum {
OtherUse = 0x01, ///< Assign 01 to Other
UnknownUse, ///< Assign 02 to Unknown
SystemMemory, ///< Assign 03 to system memory
VideoMemory, ///< Assign 04 to video memory
FlashMemory, ///< Assign 05 to flash memory
NonvolatileRam, ///< Assign 06 to non-volatile RAM
CacheMemory ///< Assign 07 to cache memory
} DMI_T16_USE;
/// DMI Type 16 offset 07h - Maximum Capacity
typedef enum {
Dmi16OtherErrCorrection = 0x01, ///< Assign 01 to Other
Dmi16UnknownErrCorrection, ///< Assign 02 to Unknown
Dmi16NoneErrCorrection, ///< Assign 03 to None
Dmi16Parity, ///< Assign 04 to parity
Dmi16SingleBitEcc, ///< Assign 05 to Single-bit ECC
Dmi16MultiBitEcc, ///< Assign 06 to Multi-bit ECC
Dmi16Crc ///< Assign 07 to CRC
} DMI_T16_ERROR_CORRECTION;
/// DMI Type 16 - Physical Memory Array
typedef struct {
OUT DMI_T16_LOCATION Location; ///< The physical location of the Memory Array,
///< whether on the system board or an add-in board.
OUT DMI_T16_USE Use; ///< Identifies the function for which the array
///< is used.
OUT DMI_T16_ERROR_CORRECTION MemoryErrorCorrection; ///< The primary hardware error correction or
///< detection method supported by this memory array.
OUT UINT32 MaximumCapacity; ///< The maximum memory capacity, in kilobytes,
///< for the array.
OUT UINT16 NumberOfMemoryDevices; ///< The number of slots or sockets available
///< for memory devices in this array.
} TYPE16_DMI_INFO;
/// DMI Type 17 offset 0Eh - Form Factor
typedef enum {
OtherFormFactor = 0x01, ///< Assign 01 to Other
UnknowFormFactor, ///< Assign 02 to Unknown
SimmFormFactor, ///< Assign 03 to SIMM
SipFormFactor, ///< Assign 04 to SIP
ChipFormFactor, ///< Assign 05 to Chip
DipFormFactor, ///< Assign 06 to DIP
ZipFormFactor, ///< Assign 07 to ZIP
ProprietaryCardFormFactor, ///< Assign 08 to Proprietary Card
DimmFormFactorFormFactor, ///< Assign 09 to DIMM
TsopFormFactor, ///< Assign 10 to TSOP
RowOfChipsFormFactor, ///< Assign 11 to Row of chips
RimmFormFactor, ///< Assign 12 to RIMM
SodimmFormFactor, ///< Assign 13 to SODIMM
SrimmFormFactor, ///< Assign 14 to SRIMM
FbDimmFormFactor ///< Assign 15 to FB-DIMM
} DMI_T17_FORM_FACTOR;
/// DMI Type 17 offset 12h - Memory Type
typedef enum {
OtherMemType = 0x01, ///< Assign 01 to Other
UnknownMemType, ///< Assign 02 to Unknown
DramMemType, ///< Assign 03 to DRAM
EdramMemType, ///< Assign 04 to EDRAM
VramMemType, ///< Assign 05 to VRAM
SramMemType, ///< Assign 06 to SRAM
RamMemType, ///< Assign 07 to RAM
RomMemType, ///< Assign 08 to ROM
FlashMemType, ///< Assign 09 to Flash
EepromMemType, ///< Assign 10 to EEPROM
FepromMemType, ///< Assign 11 to FEPROM
EpromMemType, ///< Assign 12 to EPROM
CdramMemType, ///< Assign 13 to CDRAM
ThreeDramMemType, ///< Assign 14 to 3DRAM
SdramMemType, ///< Assign 15 to SDRAM
SgramMemType, ///< Assign 16 to SGRAM
RdramMemType, ///< Assign 17 to RDRAM
DdrMemType, ///< Assign 18 to DDR
Ddr2MemType, ///< Assign 19 to DDR2
Ddr2FbdimmMemType, ///< Assign 20 to DDR2 FB-DIMM
Ddr3MemType = 0x18, ///< Assign 24 to DDR3
Fbd2MemType ///< Assign 25 to FBD2
} DMI_T17_MEMORY_TYPE;
/// DMI Type 17 offset 13h - Type Detail
typedef struct {
OUT UINT16 Reserved1:1; ///< Reserved
OUT UINT16 Other:1; ///< Other
OUT UINT16 Unknown:1; ///< Unknown
OUT UINT16 FastPaged:1; ///< Fast-Paged
OUT UINT16 StaticColumn:1; ///< Static column
OUT UINT16 PseudoStatic:1; ///< Pseudo-static
OUT UINT16 Rambus:1; ///< RAMBUS
OUT UINT16 Synchronous:1; ///< Synchronous
OUT UINT16 Cmos:1; ///< CMOS
OUT UINT16 Edo:1; ///< EDO
OUT UINT16 WindowDram:1; ///< Window DRAM
OUT UINT16 CacheDram:1; ///< Cache Dram
OUT UINT16 NonVolatile:1; ///< Non-volatile
OUT UINT16 Reserved2:3; ///< Reserved
} DMI_T17_TYPE_DETAIL;
/// DMI Type 17 - Memory Device
typedef struct {
OUT UINT16 TotalWidth; ///< Total Width, in bits, of this memory device, including any check or error-correction bits.
OUT UINT16 DataWidth; ///< Data Width, in bits, of this memory device.
OUT UINT16 MemorySize; ///< The size of the memory device.
OUT DMI_T17_FORM_FACTOR FormFactor; ///< The implementation form factor for this memory device.
OUT UINT8 DeviceSet; ///< Identifies when the Memory Device is one of a set of
///< Memory Devices that must be populated with all devices of
///< the same type and size, and the set to which this device belongs.
OUT CHAR8 DeviceLocator[8]; ///< The string number of the string that identifies the physically labeled socket or board position where the memory device is located.
OUT CHAR8 BankLocator[10]; ///< The string number of the string that identifies the physically labeled bank where the memory device is located.
OUT DMI_T17_MEMORY_TYPE MemoryType; ///< The type of memory used in this device.
OUT DMI_T17_TYPE_DETAIL TypeDetail; ///< Additional detail on the memory device type
OUT UINT16 Speed; ///< Identifies the speed of the device, in megahertz (MHz).
OUT UINT64 ManufacturerIdCode; ///< Manufacturer ID code.
OUT CHAR8 SerialNumber[9]; ///< Serial Number.
OUT CHAR8 PartNumber[19]; ///< Part Number.
OUT UINT8 Attributes; ///< Bits 7-4: Reserved, Bits 3-0: rank.
OUT UINT32 ExtSize; ///< Extended Size.
OUT UINT16 ConfigSpeed; ///< Configured memory clock speed
} TYPE17_DMI_INFO;
/// Memory DMI Type 17 and 20 - for memory use
typedef struct {
OUT UINT16 TotalWidth; ///< Total Width, in bits, of this memory device, including any check or error-correction bits.
OUT UINT16 DataWidth; ///< Data Width, in bits, of this memory device.
OUT UINT16 MemorySize; ///< The size of the memory device.
OUT DMI_T17_FORM_FACTOR FormFactor; ///< The implementation form factor for this memory device.
OUT UINT8 DeviceLocator; ///< The string number of the string that identifies the physically labeled socket or board position where the memory device is located.
OUT UINT8 BankLocator; ///< The string number of the string that identifies the physically labeled bank where the memory device is located.
OUT UINT16 Speed; ///< Identifies the speed of the device, in megahertz (MHz).
OUT UINT64 ManufacturerIdCode; ///< Manufacturer ID code.
OUT UINT8 SerialNumber[4]; ///< Serial Number.
OUT UINT8 PartNumber[18]; ///< Part Number.
OUT UINT8 Attributes; ///< Bits 7-4: Reserved, Bits 3-0: rank.
OUT UINT32 ExtSize; ///< Extended Size.
OUT UINT8 Socket:3; ///< Socket ID
OUT UINT8 Channel:2; ///< Channel ID
OUT UINT8 Dimm:2; ///< DIMM ID
OUT UINT8 DimmPresent:1; ///< Dimm Present
OUT UINT32 StartingAddr; ///< The physical address, in kilobytes, of a range
///< of memory mapped to the referenced Memory Device.
OUT UINT32 EndingAddr; ///< The handle, or instance number, associated with
///< the Memory Device structure to which this address
///< range is mapped.
OUT UINT16 ConfigSpeed; ///< Configured memory clock speed
} MEM_DMI_INFO;
/// DMI Type 19 - Memory Array Mapped Address
typedef struct {
OUT UINT32 StartingAddr; ///< The physical address, in kilobytes,
///< of a range of memory mapped to the
///< specified physical memory array.
OUT UINT32 EndingAddr; ///< The physical ending address of the
///< last kilobyte of a range of addresses
///< mapped to the specified physical memory array.
OUT UINT16 MemoryArrayHandle; ///< The handle, or instance number, associated
///< with the physical memory array to which this
///< address range is mapped.
OUT UINT8 PartitionWidth; ///< Identifies the number of memory devices that
///< form a single row of memory for the address
///< partition defined by this structure.
} TYPE19_DMI_INFO;
///DMI Type 20 - Memory Device Mapped Address
typedef struct {
OUT UINT32 StartingAddr; ///< The physical address, in kilobytes, of a range
///< of memory mapped to the referenced Memory Device.
OUT UINT32 EndingAddr; ///< The handle, or instance number, associated with
///< the Memory Device structure to which this address
///< range is mapped.
OUT UINT16 MemoryDeviceHandle; ///< The handle, or instance number, associated with
///< the Memory Device structure to which this address
///< range is mapped.
OUT UINT16 MemoryArrayMappedAddressHandle; ///< The handle, or instance number, associated
///< with the Memory Array Mapped Address structure to
///< which this device address range is mapped.
OUT UINT8 PartitionRowPosition; ///< Identifies the position of the referenced Memory
///< Device in a row of the address partition.
OUT UINT8 InterleavePosition; ///< The position of the referenced Memory Device in
///< an interleave.
OUT UINT8 InterleavedDataDepth; ///< The maximum number of consecutive rows from the
///< referenced Memory Device that are accessed in a
///< single interleaved transfer.
} TYPE20_DMI_INFO;
/// Collection of pointers to the DMI records
typedef struct {
OUT TYPE4_DMI_INFO T4[MAX_SOCKETS_SUPPORTED]; ///< Type 4 struc
OUT TYPE7_DMI_INFO T7L1[MAX_SOCKETS_SUPPORTED]; ///< Type 7 struc 1
OUT TYPE7_DMI_INFO T7L2[MAX_SOCKETS_SUPPORTED]; ///< Type 7 struc 2
OUT TYPE7_DMI_INFO T7L3[MAX_SOCKETS_SUPPORTED]; ///< Type 7 struc 3
OUT TYPE16_DMI_INFO T16; ///< Type 16 struc
OUT TYPE17_DMI_INFO T17[MAX_SOCKETS_SUPPORTED][MAX_CHANNELS_PER_SOCKET][MAX_DIMMS_PER_CHANNEL]; ///< Type 17 struc
OUT TYPE19_DMI_INFO T19; ///< Type 19 struc
OUT TYPE20_DMI_INFO T20[MAX_SOCKETS_SUPPORTED][MAX_CHANNELS_PER_SOCKET][MAX_DIMMS_PER_CHANNEL]; ///< Type 20 struc
} DMI_INFO;
/**********************************************************************
* Interface call: AllocateExecutionCache
**********************************************************************/
#define MAX_CACHE_REGIONS 3
/// AllocateExecutionCache sub param structure for cached memory region
typedef struct {
IN OUT UINT32 ExeCacheStartAddr; ///< Start address
IN OUT UINT32 ExeCacheSize; ///< Size
} EXECUTION_CACHE_REGION;
/**********************************************************************
* Interface call: AmdGetAvailableExeCacheSize
**********************************************************************/
/// Get available Cache remain
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
OUT UINT32 AvailableExeCacheSize; ///< Remain size
} AMD_GET_EXE_SIZE_PARAMS;
AGESA_STATUS
AmdGetAvailableExeCacheSize (
IN OUT AMD_GET_EXE_SIZE_PARAMS *AmdGetExeSizeParams
);
/// Selection type for core leveling
typedef enum {
CORE_LEVEL_LOWEST, ///< Level to lowest common denominator
CORE_LEVEL_TWO, ///< Level to 2 cores
CORE_LEVEL_POWER_OF_TWO, ///< Level to 1,2,4 or 8
CORE_LEVEL_NONE, ///< Do no leveling
CORE_LEVEL_COMPUTE_UNIT, ///< Level cores to one core per compute unit
CORE_LEVEL_ONE, ///< Level to 1 core
CORE_LEVEL_THREE, ///< Level to 3 cores
CORE_LEVEL_FOUR, ///< Level to 4 cores
CORE_LEVEL_FIVE, ///< Level to 5 cores
CORE_LEVEL_SIX, ///< Level to 6 cores
CORE_LEVEL_SEVEN, ///< Level to 7 cores
CORE_LEVEL_EIGHT, ///< Level to 8 cores
CORE_LEVEL_NINE, ///< Level to 9 cores
CORE_LEVEL_TEN, ///< Level to 10 cores
CORE_LEVEL_ELEVEN, ///< Level to 11 cores
CORE_LEVEL_TWELVE, ///< Level to 12 cores
CORE_LEVEL_THIRTEEN, ///< Level to 13 cores
CORE_LEVEL_FOURTEEN, ///< Level to 14 cores
CORE_LEVEL_FIFTEEN, ///< Level to 15 cores
CoreLevelModeMax ///< Used for bounds checking
} CORE_LEVELING_TYPE;
/************************************************************************
*
* AGESA Basic Level interface structure definition and function prototypes
*
***********************************************************************/
/**********************************************************************
* Interface call: AmdCreateStruct
**********************************************************************/
AGESA_STATUS
AmdCreateStruct (
IN OUT AMD_INTERFACE_PARAMS *InterfaceParams
);
/**********************************************************************
* Interface call: AmdReleaseStruct
**********************************************************************/
AGESA_STATUS
AmdReleaseStruct (
IN OUT AMD_INTERFACE_PARAMS *InterfaceParams
);
/**********************************************************************
* Interface call: AmdInitReset
**********************************************************************/
/// AmdInitReset param structure
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN EXECUTION_CACHE_REGION CacheRegion[3]; ///< The cached memory region
IN AMD_HT_RESET_INTERFACE HtConfig; ///< The interface for Ht Recovery
} AMD_RESET_PARAMS;
AGESA_STATUS
AmdInitReset (
IN OUT AMD_RESET_PARAMS *ResetParams
);
/**********************************************************************
* Interface call: AmdInitEarly
**********************************************************************/
/// InitEarly param structure
///
/// Provide defaults or customizations to each service performed in AmdInitEarly.
///
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN EXECUTION_CACHE_REGION CacheRegion[3]; ///< Execution Map Interface
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
IN AMD_HT_INTERFACE HtConfig; ///< HyperTransport Interface
IN GNB_CONFIGURATION GnbConfig; ///< GNB configuration
} AMD_EARLY_PARAMS;
AGESA_STATUS
AmdInitEarly (
IN OUT AMD_EARLY_PARAMS *EarlyParams
);
/**********************************************************************
* Interface call: AmdInitPost
**********************************************************************/
/// AmdInitPost param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
IN MEM_PARAMETER_STRUCT MemConfig; ///< Memory post param
} AMD_POST_PARAMS;
AGESA_STATUS
AmdInitPost (
IN OUT AMD_POST_PARAMS *PostParams ///< Amd Cpu init param
);
/**********************************************************************
* Interface call: AmdInitEnv
**********************************************************************/
/// AmdInitEnv param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
IN GNB_ENV_CONFIGURATION GnbEnvConfiguration; ///< platform operational characteristics.
} AMD_ENV_PARAMS;
AGESA_STATUS
AmdInitEnv (
IN OUT AMD_ENV_PARAMS *EnvParams
);
/**********************************************************************
* Interface call: AmdInitMid
**********************************************************************/
/// AmdInitMid param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
} AMD_MID_PARAMS;
AGESA_STATUS
AmdInitMid (
IN OUT AMD_MID_PARAMS *MidParams
);
/**********************************************************************
* Interface call: AmdInitLate
**********************************************************************/
/// AmdInitLate param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
OUT DMI_INFO *DmiTable; ///< DMI Interface
OUT VOID *AcpiPState; ///< Acpi Pstate SSDT Table
OUT VOID *AcpiSrat; ///< SRAT Table
OUT VOID *AcpiSlit; ///< SLIT Table
OUT VOID *AcpiWheaMce; ///< WHEA MCE Table
OUT VOID *AcpiWheaCmc; ///< WHEA CMC Table
OUT VOID *AcpiAlib; ///< ACPI SSDT table with ALIB implementation
} AMD_LATE_PARAMS;
AGESA_STATUS
AmdInitLate (
IN OUT AMD_LATE_PARAMS *LateParams
);
/**********************************************************************
* Interface call: AmdInitRecovery
**********************************************************************/
/// CPU Recovery Parameters
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
} AMD_CPU_RECOVERY_PARAMS;
/// AmdInitRecovery param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN MEM_PARAMETER_STRUCT MemConfig; ///< Memory post param
IN EXECUTION_CACHE_REGION CacheRegion[3]; ///< The cached memory region. And the max cache region is 3
IN AMD_CPU_RECOVERY_PARAMS CpuRecoveryParams; ///< Params for CPU related recovery init.
} AMD_RECOVERY_PARAMS;
AGESA_STATUS
AmdInitRecovery (
IN OUT AMD_RECOVERY_PARAMS *RecoveryParams
);
/**********************************************************************
* Interface call: AmdInitResume
**********************************************************************/
/// AmdInitResume param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< Platform operational characteristics
IN AMD_S3_PARAMS S3DataBlock; ///< Save state data
} AMD_RESUME_PARAMS;
AGESA_STATUS
AmdInitResume (
IN AMD_RESUME_PARAMS *ResumeParams
);
/**********************************************************************
* Interface call: AmdS3LateRestore
**********************************************************************/
/// AmdS3LateRestore param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
IN AMD_S3_PARAMS S3DataBlock; ///< Save state data
} AMD_S3LATE_PARAMS;
AGESA_STATUS
AmdS3LateRestore (
IN OUT AMD_S3LATE_PARAMS *S3LateParams
);
/**********************************************************************
* Interface call: AmdS3Save
**********************************************************************/
/// AmdS3Save param structure
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN PLATFORM_CONFIGURATION PlatformConfig; ///< platform operational characteristics.
OUT AMD_S3_PARAMS S3DataBlock; ///< Standard header
} AMD_S3SAVE_PARAMS;
AGESA_STATUS
AmdS3Save (
IN OUT AMD_S3SAVE_PARAMS *AmdS3SaveParams
);
/**********************************************************************
* Interface call: AmdLateRunApTask
**********************************************************************/
/**
* Entry point for AP tasking.
*/
AGESA_STATUS
AmdLateRunApTask (
IN AP_EXE_PARAMS *AmdApExeParams
);
//
// General Services API
//
/**********************************************************************
* Interface service call: AmdGetApicId
**********************************************************************/
/// Request the APIC ID of a particular core.
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN UINT8 Socket; ///< The Core's Socket.
IN UINT8 Core; ///< The Core id.
OUT BOOLEAN IsPresent; ///< The Core is present, and ApicAddress is valid.
OUT UINT8 ApicAddress; ///< The Core's APIC ID.
} AMD_APIC_PARAMS;
/**
* Get a specified Core's APIC ID.
*/
AGESA_STATUS
AmdGetApicId (
IN OUT AMD_APIC_PARAMS *AmdParamApic
);
/**********************************************************************
* Interface service call: AmdGetPciAddress
**********************************************************************/
/// Request the PCI Address of a Processor Module (that is, its Northbridge)
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN UINT8 Socket; ///< The Processor's socket
IN UINT8 Module; ///< The Module in that Processor
OUT BOOLEAN IsPresent; ///< The Core is present, and PciAddress is valid.
OUT PCI_ADDR PciAddress; ///< The Processor's PCI Config Space address (Function 0, Register 0)
} AMD_GET_PCI_PARAMS;
/**
* Get Processor Module's PCI Config Space address.
*/
AGESA_STATUS
AmdGetPciAddress (
IN OUT AMD_GET_PCI_PARAMS *AmdParamGetPci
);
/**********************************************************************
* Interface service call: AmdIdentifyCore
**********************************************************************/
/// Request the identity (Socket, Module, Core) of the current Processor Core
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
OUT UINT8 Socket; ///< The current Core's Socket
OUT UINT8 Module; ///< The current Core's Processor Module
OUT UINT8 Core; ///< The current Core's core id.
} AMD_IDENTIFY_PARAMS;
/**
* "Who am I" for the current running core.
*/
AGESA_STATUS
AmdIdentifyCore (
IN OUT AMD_IDENTIFY_PARAMS *AmdParamIdentify
);
/**********************************************************************
* Interface service call: AmdReadEventLog
**********************************************************************/
/// An Event Log Entry.
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
OUT UINT32 EventClass; ///< The severity of this event, matches AGESA_STATUS.
OUT UINT32 EventInfo; ///< The unique event identifier, zero means "no event".
OUT UINT32 DataParam1; ///< Data specific to the Event.
OUT UINT32 DataParam2; ///< Data specific to the Event.
OUT UINT32 DataParam3; ///< Data specific to the Event.
OUT UINT32 DataParam4; ///< Data specific to the Event.
} EVENT_PARAMS;
/**
* Read an Event from the Event Log.
*/
AGESA_STATUS
AmdReadEventLog (
IN EVENT_PARAMS *Event
);
/**********************************************************************
* Interface service call: AmdIdentifyDimm
**********************************************************************/
/// Request the identity of dimm from system address
typedef struct {
IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN UINT64 MemoryAddress; ///< System Address that needs to be translated to dimm identification.
OUT UINT8 SocketId; ///< The socket on which the targeted address locates.
OUT UINT8 MemChannelId; ///< The channel on which the targeted address locates.
OUT UINT8 DimmId; ///< The dimm on which the targeted address locates.
} AMD_IDENTIFY_DIMM;
/**
* Get the dimm identification for the address.
*/
AGESA_STATUS
AmdIdentifyDimm (
IN OUT AMD_IDENTIFY_DIMM *AmdDimmIdentify
);
/// Data structure for the Mapping Item between Unified ID for IDS Setup Option
/// and the option value.
///
typedef struct {
IN UINT16 IdsNvId; ///< Unified ID for IDS Setup Option.
OUT UINT16 IdsNvValue; ///< The value of IDS Setup Option.
} IDS_NV_ITEM;
/// Data Structure for IDS CallOut Function
typedef struct {
IN AMD_CONFIG_PARAMS StdHeader; ///< Standard configuration header
IN IDS_NV_ITEM *IdsNvPtr; ///< Memory Pointer of IDS NV Table
IN OUT UINTN Reserved; ///< reserved
} IDS_CALLOUT_STRUCT;
AGESA_STATUS
AmdIdsRunApTaskLate (
IN AP_EXE_PARAMS *AmdApExeParams
);
#define AGESA_IDS_DFT_VAL 0xFFFF ///< Default value of every uninitlized NV item, the action for it will be ignored
#define AGESA_IDS_NV_END 0xFFFF ///< Flag specify end of option structure
/// WARNING: Don't change the comment below, it used as signature for script
/// AGESA IDS NV ID Definitions
typedef enum {
AGESA_IDS_EXT_ID_START = 0x0000,///< 0x0000 specify the start of external NV id
AGESA_IDS_NV_UCODE, ///< 0x0001 Enable or disable microcode patching
AGESA_IDS_NV_TARGET_PSTATE, ///< 0x0002 Set the P-state required to be activated
AGESA_IDS_NV_POSTPSTATE, ///< 0x0003 Set the P-state required to be activated through POST
AGESA_IDS_NV_BANK_INTERLEAVE, ///< 0x0004 Enable or disable Bank Interleave
AGESA_IDS_NV_CHANNEL_INTERLEAVE, ///< 0x0005 Enable or disable Channel Interleave
AGESA_IDS_NV_NODE_INTERLEAVE, ///< 0x0006 Enable or disable Node Interleave
AGESA_IDS_NV_MEMHOLE, ///< 0x0007 Enables or disable memory hole
AGESA_IDS_NV_SCRUB_REDIRECTION, ///< 0x0008 Enable or disable a write to dram with corrected data
AGESA_IDS_NV_DRAM_SCRUB, ///< 0x0009 Set the rate of background scrubbing for DRAM
AGESA_IDS_NV_DCACHE_SCRUB, ///< 0x000A Set the rate of background scrubbing for the DCache.
AGESA_IDS_NV_L2_SCRUB, ///< 0x000B Set the rate of background scrubbing for the L2 cache
AGESA_IDS_NV_L3_SCRUB, ///< 0x000C Set the rate of background scrubbing for the L3 cache
AGESA_IDS_NV_ICACHE_SCRUB, ///< 0x000D Set the rate of background scrubbing for the Icache
AGESA_IDS_NV_SYNC_ON_ECC_ERROR, ///< 0x000E Enable or disable the sync flood on un-correctable ECC error
AGESA_IDS_NV_ECC_SYMBOL_SIZE, ///< 0x000F Set ECC symbol size
AGESA_IDS_NV_ALL_MEMCLKS, ///< 0x0010 Enable or disable all memory clocks enable
AGESA_IDS_NV_DCT_GANGING_MODE, ///< 0x0011 Set the Ganged mode
AGESA_IDS_NV_DRAM_BURST_LENGTH32, ///< 0x0012 Set the DRAM Burst Length 32
AGESA_IDS_NV_MEMORY_POWER_DOWN, ///< 0x0013 Enable or disable Memory power down mode
AGESA_IDS_NV_MEMORY_POWER_DOWN_MODE, ///< 0x0014 Set the Memory power down mode
AGESA_IDS_NV_DLL_SHUT_DOWN, ///< 0x0015 Enable or disable DLLShutdown
AGESA_IDS_NV_ONLINE_SPARE, ///< 0x0016 Enable or disable the Dram controller to designate a DIMM bank as a spare for logical swap
AGESA_IDS_NV_HT_ASSIST, ///< 0x0017 Enable or Disable HT Assist
AGESA_IDS_NV_ATMMODE, ///< 0x0018 Enable or Disable ATM mode
AGESA_IDS_NV_HDTOUT, ///< 0x0019 Enable or disable HDTOUT feature
AGESA_IDS_NV_HTLINKSOCKET, ///< 0x001A HT Link Socket
AGESA_IDS_NV_HTLINKPORT, ///< 0x001B HT Link Port
AGESA_IDS_NV_HTLINKFREQ, ///< 0x001C HT Link Frequency
AGESA_IDS_NV_HTLINKWIDTHIN, ///< 0x001D HT Link In Width
AGESA_IDS_NV_HTLINKWIDTHOUT, ///< 0x001E HT Link Out Width
AGESA_IDS_NV_GNBHDAUDIOEN, ///< 0x001F Enable or disable GNB HD Audio
AGESA_IDS_NV_CPB_EN, ///< 0x0020 Core Performance Boost
AGESA_IDS_NV_HTC_EN, ///< 0x0021 HTC Enable
AGESA_IDS_NV_HTC_OVERRIDE, ///< 0x0022 HTC Override
AGESA_IDS_NV_HTC_PSTATE_LIMIT, ///< 0x0023 HTC P-state limit select
AGESA_IDS_NV_HTC_TEMP_HYS, ///< 0x0024 HTC Temperature Hysteresis
AGESA_IDS_NV_HTC_ACT_TEMP, ///< 0x0025 HTC Activation Temp
AGESA_IDS_NV_POWER_POLICY, ///< 0x0026 Select Platform Power Policy
AGESA_IDS_EXT_ID_END, ///< 0x0027 specify the end of external NV ID
} IDS_EX_NV_ID;
#define IDS_NUM_EXT_NV_ITEM (AGESA_IDS_EXT_ID_END - AGESA_IDS_EXT_ID_START + 1)
#endif // _AGESA_H_
|